← Back to branch summary

~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

Viewing changes to docs/styles.txt

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2007-05-04 12:24:25 UTC
  • mfrom: (1.1.21 upstream)
  • Revision ID: james.westby@ubuntu.com-20070504122425-0m8midgzrp40y8w2
Tags: 2.10.12-1ubuntu1
* Sync with Debian
* New upstream version:
  Fixed bugs:
  - 379414 file chooser warnings when changing path in the entry
  - 418585 GtkFileChooserDefault sizing code is not DPI independent
  - 419568 Crash in search if start with special letter
  - 435062 build dies with icon cache validation
  - 379399 Segfault to call gtk_print_operation_run twice.
  - 387889 cups backend has problems when there are too many printers
  - 418531 invalid read to gtkicontheme.c gtk_icon_theme_lookup_icon...
  - 423916 crash in color scheme code
  - 424042 Segmentation fault while quickly pressing Alt+arrows
  - 415260 Protect against negative indices when setting values in G...
  - 419171 XGetVisualInfo() may not set nxvisuals
  - 128852 Gdk cursors don't look good on win32
  - 344657 Ctrl-H doesn't toggle "Show Hidden Files" setting
  - 345345 PrintOperation::paginate is not emitted for class handler
  - 347567 GtkPrintOperation::end-print is not emitted if it's cance...
  - 369112 gtk_ui_manager_add_ui should accept unnamed separator
  - 392015 Selected menu item invisible on Windows Vista
  - 399253 MS-Windows Theme Bottom Tab placement rendering glitches
  - 399425 gtk_input_dialog_fill_axes() adds child to gtkscrolledwin...
  - 403251 [patch] little memory leak in GtkPrintJob
  - 403267 [patch] memory leak in GtkPageSetupUnixDialog
  - 403470 MS-Windows Theme tab placement other than on top leaks a ...
  - 404506 Windows system fonts that have multi-byte font names cann...
  - 405089 Incorrect window placement for GtkEventBox private window
  - 405515 Minor leak in gtkfilesystemmodel.c
  - 405539 gdk_pixbuf_save() for PNG saver can return FALSE without ...
  - 415681 gdk_window_clear_area includes an extra line and column o...
  - 418219 GtkRecentChooser should apply filter before sorting and c...
  - 418403 Scroll to printer after selecting it from settings
  - 421985 _gtk_print_operation_platform_backend_launch_preview
  - 421990 gtk_print_job_get_surface
  - 421993 gtk_print_operation_init
  - 423064 Conditional jump or move depends on uninitialised value(s...
  - 423722 Fix printing header in gtk-demo
  - 424168 gtk_print_operation_run on async preview
  - 425655 Don't install gtk+-unix-print-2.0.pc on non-UNIX platforms
  - 425786 GDK segfaults if XineramaQueryScreens fails
  - 428665 Lpr Backend gets stuck in infinite loop during gtk_enumer...
  - 429902 GtkPrintOperation leaks cairo contextes
  - 431997 First delay of GdkPixbufAnimationIter is wrong
  - 433242 Inconsistent scroll arrow position calculations
  - 433972 Placing gtk.Expander inside a gtk.TextView() changes gtk....
  - 434261 _gtk_toolbar_elide_underscores incorrectly handles some s...
  - 383354 ctrl-L should make 'Location' entry disappear
  - 418673 gtk_recent_manager_add_item
  - 429732 gtk_accel_group_finalize accesses invalid memory
  - 435028 WM_CLIENT_LEADER is wrong on the leader_window
  - 431067 Background of the header window is not updated
  - 338843 add recent files support inside the ui manager
  - 148535 add drop shadow to menus, tooltips, etc. under Windows XP
* debian/control.in:
  - Conflicts on ubuntulooks (<= 0.9.11-1)
* debian/patches/15_default-fallback-icon-theme.patch:
  - patch from Debian, fallback on gnome icon theme

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/styles.txt
 
1
HANDLING WIDGET STYLES
 
2
======================
 
3
 
 
4
 
 
5
A widget gets created with a default style.
 
6
The global default style can be affected by gtk_widget_set_default_style()
 
7
and can be queried by gtk_widget_get_default_style().
 
8
The initial style that is assigned to a widget as default style upon
 
9
creation can be affected by wrapping the widget's creation as follows:
 
10
gtk_widget_push_style (my_style);
 
11
widget = gtk_type_new (gtk_button_get_type ());
 
12
gtk_widget_pop_style ();
 
13
 
 
14
There are certain functions to affect widget styles after a widget's
 
15
creation:
 
16
 
 
17
gtk_widget_set_style ()
 
18
  Save the default style and set a user style.
 
19
  This will override a previously set user style or
 
20
  previously set rc styles.
 
21
 
 
22
gtk_widget_set_rc_style ()
 
23
  Set GTK_RC_STYLE to indicate that an rc lookup has been performed.
 
24
  If there is an rc style for a widget, set it and save the default style,
 
25
  restore the default style otherwise.
 
26
  This will override a previously set user style or rc style.
 
27
 
 
28
gtk_widget_reset_rc_styles ()
 
29
  Descends through a widget heirarchy and sets the rc style
 
30
  on all widgets that don't have a user style set.
 
31
 
 
32
gtk_widget_restore_default_style ()
 
33
  Reset the widget's style to the default style, this is only usefull if
 
34
  the widgets default style had been saved by previous calls to
 
35
  gtk_widget_set_style() or gtk_widget_set_rc_style().
 
36
 
 
37
gtk_widget_ensure_style ()
 
38
  Ensure that the widget either has a user style set, or an rc lookup
 
39
  has been performed.
 
40
 
 
41
gtk_rc_get_style ()
 
42
  Return an rc style for a widget if there is one.
 
43
 
 
44
gtk_widget_set_name ()
 
45
  Change widget name, and perform a new rc lookup if no user style
 
46
  is set.
 
47
 
 
48
gtk_widget_realize ()
 
49
  Besides realizing the widget this function will:
 
50
  - perform an rc lookup if neccessary,
 
51
  - attach a widget's style.
 
52
 
 
53
gtk_widget_get_style ()
 
54
  Return a widgets style, this function will perform an rc lookup
 
55
  if neccessary.
 
56
 
 
57
gtk_widget_set_parent ()
 
58
  This function will perform rc lookups recursively for all widgets
 
59
  that do not have a user style set.
 
60
 
 
61
gtk_style_copy ()
 
62
  This function can be used to copy a widget's style.
 
63
  The style can subsequntly be changed (e.g., by modifications to the
 
64
  red/green/blue values of a certain color) and then be applied to the
 
65
  widget via gtk_widget_set_style().
 
66
 
 
67
 
 
68
GtkWidget::style_set
 
69
  This signal will be emitted for a widget once its style changes with
 
70
  an additional argument previous_style wich will hold the widget->style
 
71
  avlue from a previous emission.
 
72
  The initial emission of this signal is guaranteed to happen prior
 
73
  to any GtkWidget::size_request emission, and will have the previous_style
 
74
  argument set to NULL.
 
75
  The GtkWidgetClass implements a default handler for this signal that
 
76
  will set the widget's window's background of widgets that provide their
 
77
  own windows according to the new style.
 
78
  Derived widgets need to overide this default handler, if:
 
79
  - their size requisition depends on the current style.
 
80
    (e.g., on the style's fonts)
 
81
  - they set the background of widget->window to something other than.
 
82
    style->bg. (e.g., GtkListItem)
 
83
  - the widget provides windows other than widget->window.
 
84
  - the widget has any other stored dependencies on the style.
 
85
                   
 
86
 
 
87
 
 
88
Flag indications:
 
89
 
 
90
!GTK_RC_STYLE && !GTK_USER_STYLE:
 
91
  The widget has its default style set, no rc lookup has been
 
92
  performed, the widget has not been size requested yet and is
 
93
  therefore not yet realized.
 
94
 
 
95
GTK_USER_STYLE:
 
96
  GTK_RC_STYLE is not set.
 
97
  The widget has a user style assigned, and its default style has been
 
98
  saved.
 
99
 
 
100
GTK_RC_STYLE:
 
101
  GTK_USER_STYLE is not set.
 
102
  If the widget has a saved default style, it has been assigned an
 
103
  rc style. If the widget does not have a saved default style, it still
 
104
  has its default style but an rc lookup has already been performed.
 
105
 
 
106
 
 
107
        - Tim Janik <timj@gimp.org>
 
108
          1998/02/27