← Back to branch summary

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

« back to all changes in this revision

Viewing changes to docs/reference/gtk/xml/glossary.xml

  • 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/reference/gtk/xml/glossary.xml
 
1
<glossary id="glossary">
 
2
  <title>Glossary</title>
 
3
 
 
4
  <glossentry id="allocation">
 
5
    <glossterm>allocation</glossterm>
 
6
    <glossdef>
 
7
      <para>
 
8
        The final size of a <glossterm
 
9
        linkend="widget">widget</glossterm> within its <glossterm
 
10
        linkend="parent">parent</glossterm>.  For example, a widget
 
11
        may request a minimum size of 20&times;20 pixels, but its
 
12
        parent may decide to allocate 50&times;20 pixels for it
 
13
        instead.
 
14
      </para>
 
15
      <glossseealso>
 
16
        <glossterm linkend="requisition">requisition</glossterm>
 
17
      </glossseealso>
 
18
    </glossdef>
 
19
  </glossentry>
 
20
 
 
21
  <glossentry id="bin">
 
22
    <glossterm>bin</glossterm>
 
23
    <glossdef>
 
24
      <para>
 
25
        A <glossterm linkend="container">container</glossterm> that
 
26
        can hold at most one child widget.  The base class for bins is
 
27
        <link linkend="GtkBin"><type>GtkBin</type></link>.
 
28
      </para>
 
29
      <glossseealso>
 
30
        <glossterm linkend="container">container</glossterm>
 
31
      </glossseealso>
 
32
    </glossdef>
 
33
  </glossentry>
 
34
 
 
35
  <glossentry id="child">
 
36
    <glossterm>child</glossterm>
 
37
    <glossdef>
 
38
      <para>
 
39
        A <glossterm linkend="container">container's</glossterm> child
 
40
        is a <glossterm linkend="widget">widget</glossterm> contained
 
41
        inside it.
 
42
      </para>
 
43
    </glossdef>
 
44
  </glossentry>
 
45
 
 
46
  <glossentry id="column">
 
47
    <glossterm>column</glossterm>
 
48
    <glossdef>
 
49
      <para>
 
50
        GTK+ contains several widgets which display data in columns,
 
51
        e.g. the <link linkend="GtkTreeView"><type>GtkTreeView</type></link>. 
 
52
        These <glossterm linkend="view-column">view columns</glossterm> in 
 
53
        the tree view are represented by <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link>
 
54
        objects inside GTK+. They should not be confused with 
 
55
        <glossterm linkend="model-column">model columns</glossterm> which
 
56
        are used to organize the data in tree models.
 
57
      </para>
 
58
      <glossseealso>model-view widget</glossseealso>
 
59
    </glossdef>
 
60
  </glossentry>
 
61
 
 
62
  <glossentry id="container">
 
63
    <glossterm>container</glossterm>
 
64
    <glossdef>
 
65
      <para>
 
66
        A <glossterm linkend="widget">widget</glossterm> that contains
 
67
        other widgets; in that case, the container is the
 
68
        <emphasis>parent</emphasis> of the <emphasis>child</emphasis>
 
69
        widgets.  Some containers don't draw anything on their own,
 
70
        but rather just organize their children's <glossterm
 
71
        linkend="geometry">geometry</glossterm>; for example, <link linkend="GtkVBox"><type>GtkVBox</type></link> lays out 
 
72
        its children vertically without painting anything on its own.  Other
 
73
        containers include decorative elements; for example, <link linkend="GtkFrame"><type>GtkFrame</type></link> contains 
 
74
        the frame's child and a label in addition to the shaded frame it draws.  
 
75
        The base class for containers is <link linkend="GtkContainer"><type>GtkContainer</type></link>.
 
76
      </para>
 
77
      <glossseealso>
 
78
        <glossterm linkend="container">widget</glossterm>
 
79
        <glossterm linkend="container">geometry</glossterm>
 
80
      </glossseealso>
 
81
    </glossdef>
 
82
  </glossentry>
 
83
 
 
84
  <glossentry id="display">
 
85
    <glossterm>display</glossterm>
 
86
    <glossdef>
 
87
      <para>
 
88
        GDK inherited the concept of display from the X window system,
 
89
        which considers a display to be the combination
 
90
        of a keyboard, a pointing device and one or more 
 
91
        <glossterm linkend="screen">screens</glossterm>. 
 
92
        Applications open a display to show windows and interact with the user.
 
93
        In GDK, a display is represented by a <link linkend="GdkDisplay"><type>GdkDisplay</type></link>.
 
94
      </para>
 
95
    </glossdef>
 
96
  </glossentry>
 
97
 
 
98
  <glossentry id="event">
 
99
    <glossterm>event</glossterm>
 
100
    <glossdef>
 
101
      <para>
 
102
        Events are the way in which GDK informs GTK+ about external events
 
103
        like pointer motion, button clicks, key presses, etc. 
 
104
      </para>
 
105
    </glossdef>
 
106
  </glossentry>
 
107
 
 
108
  <glossentry id="geometry">
 
109
    <glossterm>geometry</glossterm>
 
110
    <glossdef>
 
111
      <para>
 
112
        A <glossterm linkend="widget">widget's</glossterm> position
 
113
        and size.  Within its parent, this is called the widget's
 
114
        <glossterm linkend="allocation">allocation</glossterm>.
 
115
      </para>
 
116
    </glossdef>
 
117
  </glossentry>
 
118
 
 
119
  <glossentry id="mapping">
 
120
    <glossterm>mapping</glossterm>
 
121
    <glossdef>
 
122
      <para>
 
123
        This is the step in a <glossterm
 
124
        linkend="widget">widget's</glossterm> life cycle where it
 
125
        actually shows the GdkWindows it created when it was
 
126
        <glossterm linkend="realization">realized</glossterm>.  When a
 
127
        widget is mapped, it must turn on its
 
128
        <link linkend="GTK-MAPPED:CAPS"><literal>GTK_MAPPED</literal></link> <link linkend="GtkWidgetFlags">flag</link>.
 
129
      </para>
 
130
 
 
131
      <para>
 
132
        Note that due to the asynchronous nature of the X window
 
133
        system, a widget's window may not appear on the screen
 
134
        immediatly after one calls <link linkend="gdk-window-show"><function>gdk_window_show()</function></link>:
 
135
        you must wait for the corresponding map <glossterm
 
136
        linkend="event">event</glossterm> to be received.  You can do
 
137
        this with the <link
 
138
        linkend="GtkWidget-map-event"><methodname>GtkWidget::map-event</methodname>
 
139
        signal</link>.
 
140
      </para>
 
141
    </glossdef>
 
142
  </glossentry>
 
143
 
 
144
  <glossentry id="model-column">
 
145
    <glossterm>model column</glossterm>
 
146
    <glossdef>
 
147
      <para>
 
148
        A column in a tree model, holding data of a certain type. 
 
149
        The types which can be stored in the columns of a model 
 
150
        have to be specified when the model is constructed, see 
 
151
        e.g. <link linkend="gtk-list-store-new"><function>gtk_list_store_new()</function></link>.
 
152
      </para>
 
153
      <glossseealso>
 
154
        <glossterm linkend="view-column">view column</glossterm>
 
155
      </glossseealso>
 
156
    </glossdef>
 
157
  </glossentry>
 
158
 
 
159
  <glossentry id="model-view">
 
160
    <glossterm>model-view widget</glossterm>
 
161
    <glossdef>
 
162
      <para>
 
163
        These widgets follow the well-known model-view pattern, which separates
 
164
        the data (the model) to be displayed from the component which does the 
 
165
        actual visualization (the view). Examples of this pattern in GTK+ are 
 
166
        the <link linkend="GtkTreeView"><type>GtkTreeView</type></link>/<link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> and <link linkend="GtkTextView"><type>GtkTextView</type></link>/<link linkend="GtkTextBuffer"><type>GtkTextBuffer</type></link>
 
167
      </para>
 
168
      <para>
 
169
        One important advantage of this pattern is that it is possible to 
 
170
        display the same model in multiple views; another one that the 
 
171
        separation of the model allows a great deal of flexibility, as 
 
172
        demonstrated by e.g. <link linkend="GtkTreeModelSort"><type>GtkTreeModelSort</type></link> or <link linkend="GtkTreeModelFilter"><type>GtkTreeModelFilter</type></link>.
 
173
      </para>
 
174
    </glossdef>
 
175
  </glossentry>
 
176
 
 
177
  <glossentry id="no-window">
 
178
    <glossterm>no-window widget</glossterm>
 
179
    <glossdef>
 
180
      <para>
 
181
        A widget that does not have a GdkWindow of its own on which to
 
182
        draw its contents, but rather shares its <glossterm
 
183
        linkend="parent">parent's</glossterm>.  Such a widget has the
 
184
        <link linkend="GTK-NO-WINDOW:CAPS"><literal>GTK_NO_WINDOW</literal></link> <link linkend="GtkWidgetFlags">flag</link> set, and 
 
185
        can be tested with the <link linkend="GTK-WIDGET-NO-WINDOW:CAPS"><function>GTK_WIDGET_NO_WINDOW()</function></link> macro.
 
186
      </para>
 
187
    </glossdef>
 
188
  </glossentry>
 
189
 
 
190
  <glossentry id="parent">
 
191
    <glossterm>parent</glossterm>
 
192
    <glossdef>
 
193
      <para>
 
194
        A <glossterm linkend="widget">widget's</glossterm> parent is
 
195
        the <glossterm linkend="container">container</glossterm>
 
196
        inside which it resides.
 
197
      </para>
 
198
    </glossdef>
 
199
  </glossentry>
 
200
 
 
201
  <glossentry id="realization">
 
202
    <glossterm>realization</glossterm>
 
203
    <glossdef>
 
204
      <para>
 
205
        This is the step in a <glossterm
 
206
        linkend="widget">widget's</glossterm> life cycle where it
 
207
        creates its own GdkWindow, or otherwise associates itself with
 
208
        its <glossterm linkend="parent">parent's</glossterm>
 
209
        GdkWindow.  If the widget has its own window, then it must
 
210
        also attach a <glossterm linkend="style">style</glossterm> to
 
211
        it.  A widget becomes unrealized by destroying its associated
 
212
        GdkWindow.  When a widget is realized, it must turn on its
 
213
        <link linkend="GTK-REALIZED:CAPS"><literal>GTK_REALIZED</literal></link> <link linkend="GtkWidgetFlags">flag</link>.
 
214
      </para>
 
215
 
 
216
      <para>
 
217
        Widgets that don't own the GdkWindow on which they draw are
 
218
        called <glossterm linkend="no-window">no-window widgets</glossterm>.  
 
219
        This can be tested with the <link linkend="GTK-WIDGET-NO-WINDOW:CAPS"><function>GTK_WIDGET_NO_WINDOW()</function></link> macro.  Normally, 
 
220
        these widgets draw on their parent's GdkWindow.
 
221
      </para>
 
222
 
 
223
      <para>
 
224
        Note that when a widget creates a window in its <link
 
225
        linkend="gtkwidget-realize"><methodname>::<link linkend="realize"><function>realize()</function></link></methodname></link>
 
226
        handler, it does not actually show the window.  That is, the
 
227
        window's structure is just created in memory.  The widget
 
228
        actually shows the window when it gets <glossterm
 
229
        linkend="mapping">mapped</glossterm>.
 
230
      </para>
 
231
    </glossdef>
 
232
  </glossentry>
 
233
 
 
234
  <glossentry id="requisition">
 
235
    <glossterm>requisition</glossterm>
 
236
    <glossdef>
 
237
      <para>
 
238
        The size requisition of a <glossterm
 
239
        linkend="widget">widget</glossterm> is the minimum amount of
 
240
        space it requests from its <glossterm
 
241
        linkend="parent">parent</glossterm>.  Once the parent computes
 
242
        the widget's final size, it gives it its <glossterm
 
243
        linkend="allocation">size allocation</glossterm>.
 
244
      </para>
 
245
      <glossseealso>
 
246
        <glossterm linkend="allocation">allocation</glossterm>
 
247
      </glossseealso>
 
248
    </glossdef>
 
249
  </glossentry>
 
250
 
 
251
  <glossentry id="screen">
 
252
    <glossterm>screen</glossterm>
 
253
    <glossdef>
 
254
      <para>
 
255
        GDK inherited the concept of screen from the X window system, 
 
256
        which considers a screen to be a rectangular area, on which 
 
257
        applications may place their windows. Screens under X may have 
 
258
        quite dissimilar <glossterm linkend="visual">visuals</glossterm>.
 
259
        Each screen can stretch across multiple physical monitors.
 
260
      </para>
 
261
      <para>
 
262
        In GDK, screens are represented by <link linkend="GdkScreen"><type>GdkScreen</type></link> objects.
 
263
      </para>
 
264
    </glossdef>
 
265
  </glossentry>
 
266
 
 
267
  <glossentry id="style">
 
268
    <glossterm>style</glossterm>
 
269
    <glossdef>
 
270
      <para>
 
271
        A style encapsulates what GTK+ needs to know in order to draw
 
272
        a widget. Styles can be modified with 
 
273
        <link linkend="gtk-Resource-Files">resource files</link>.
 
274
      </para>
 
275
    </glossdef>
 
276
  </glossentry>
 
277
 
 
278
  <glossentry id="toplevel">
 
279
    <glossterm>toplevel</glossterm>
 
280
    <glossdef>
 
281
      <para>
 
282
        A <glossterm linkend="widget">widget</glossterm> that does not
 
283
        require a <glossterm linkend="parent">parent</glossterm> container.  
 
284
        The only toplevel widgets in GTK+ are <link linkend="GtkWindow"><type>GtkWindow</type></link> and widgets derived from it.
 
285
      </para>
 
286
      <glossseealso>
 
287
        <glossterm linkend="container">container</glossterm>
 
288
      </glossseealso>
 
289
    </glossdef>
 
290
  </glossentry>
 
291
 
 
292
  <glossentry id="unmap">
 
293
    <glossterm>unmap</glossterm>
 
294
    <glosssee><glossterm linkend="mapping">mapping</glossterm></glosssee>
 
295
  </glossentry>
 
296
 
 
297
  <glossentry id="unrealize">
 
298
    <glossterm>unrealize</glossterm>
 
299
    <glosssee><glossterm linkend="realization">realization</glossterm></glosssee>
 
300
  </glossentry>
 
301
 
 
302
  <glossentry id="view-column">
 
303
    <glossterm>view column</glossterm>
 
304
    <glossdef>
 
305
      <para>
 
306
        A displayed column in a tree view, represented by a
 
307
        <link linkend="GtkTreeViewColumn"><type>GtkTreeViewColumn</type></link> object.
 
308
      </para>
 
309
      <glossseealso>
 
310
        <glossterm linkend="model-column">model column</glossterm>
 
311
      </glossseealso>
 
312
    </glossdef>
 
313
  </glossentry>
 
314
 
 
315
  <glossentry id="visual">
 
316
    <glossterm>visual</glossterm>
 
317
    <glossdef>
 
318
      <para>
 
319
        A visual describes how color information is stored in pixels.
 
320
        A <glossterm linkend="screen">screen</glossterm> may support
 
321
        multiple visuals. On modern hardware, the most common visuals
 
322
        are truecolor visuals, which store a fixed number of bits 
 
323
        (typically 8) for the red, green and blue components of a color.
 
324
      </para>
 
325
      <para>
 
326
        On ancient hardware, one may still meet indexed visuals, which 
 
327
        store color information as an index into a color map, or even
 
328
        monochrome visuals. 
 
329
      </para>
 
330
    </glossdef>
 
331
  </glossentry>
 
332
 
 
333
  <glossentry id="widget">
 
334
    <glossterm>widget</glossterm>
 
335
    <glossdef>
 
336
      <para>
 
337
        A control in a graphical user interface.  Widgets can draw
 
338
        themselves and process events from the mouse and keyboard.
 
339
        Widget types include buttons, menus, text entry lines, and
 
340
        lists.  Widgets can be arranged into <glossterm
 
341
        linkend="container">containers</glossterm>, and these take
 
342
        care of assigning the <glossterm
 
343
        linkend="geometry">geometry</glossterm> of the widgets:  every
 
344
        widget thus has a parent except those widgets which are
 
345
        <glossterm linkend="toplevel">toplevels</glossterm>.  The base
 
346
        class for widgets is <link linkend="GtkWidget"><type>GtkWidget</type></link>.
 
347
      </para>
 
348
      <glossseealso>
 
349
        <glossterm linkend="container">container</glossterm>
 
350
      </glossseealso>
 
351
    </glossdef>
 
352
  </glossentry>
 
353
</glossary>
 
354
 
 
355
<!--
 
356
Local variables:
 
357
mode: sgml
 
358
sgml-parent-document: ("gtk-docs.sgml" "book" "glossary")
 
359
End:
 
360
-->