/usr/share/doc/libgtk-3-doc/gtk3/glossary.html is in libgtk-3-doc 3.4.2-0ubuntu0.9.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Glossary</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
<link rel="up" href="index.html" title="GTK+ 3 Reference Manual">
<link rel="prev" href="gtk-update-icon-cache.html" title="gtk-update-icon-cache">
<link rel="next" href="api-index-full.html" title="Index of all symbols">
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
<td><a accesskey="p" href="gtk-update-icon-cache.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td> </td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ 3 Reference Manual</th>
<td><a accesskey="n" href="api-index-full.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
<div class="glossary">
<div class="titlepage"><div><div><h2 class="title">
<a name="glossary"></a>Glossary</h2></div></div></div>
<dl>
<dt>
<a name="allocation"></a>allocation</dt>
<dd>
<p>
The final size of a <a class="glossterm" href="glossary.html#widget"><em class="glossterm">widget</em></a> within its <a class="glossterm" href="glossary.html#parent"><em class="glossterm">parent</em></a>. For example, a widget
may request a minimum size of 20×20 pixels, but its
parent may decide to allocate 50×20 pixels for it
instead.
</p>
<p>See Also
<a class="glossterm" href="glossary.html#requisition"><em class="glossterm">requisition</em></a>
.</p>
</dd>
<dt>
<a name="bin"></a>bin</dt>
<dd>
<p>
A <a class="glossterm" href="glossary.html#container"><em class="glossterm">container</em></a> that
can hold at most one child widget. The base class for bins is
#GtkBin.
</p>
<p>See Also
<a class="glossterm" href="glossary.html#container"><em class="glossterm">container</em></a>
.</p>
</dd>
<dt>
<a name="child"></a>child</dt>
<dd><p>
A <a class="glossterm" href="glossary.html#container"><em class="glossterm">container's</em></a> child
is a <a class="glossterm" href="glossary.html#widget"><em class="glossterm">widget</em></a> contained
inside it.
</p></dd>
<dt>
<a name="column"></a>column</dt>
<dd>
<p>
GTK+ contains several widgets which display data in columns,
e.g. the #GtkTreeView.
These <a class="glossterm" href="glossary.html#view-column"><em class="glossterm">view columns</em></a> in
the tree view are represented by #GtkTreeViewColumn
objects inside GTK+. They should not be confused with
<a class="glossterm" href="glossary.html#model-column"><em class="glossterm">model columns</em></a> which
are used to organize the data in tree models.
</p>
<p>See Also model-view widget.</p>
</dd>
<dt>
<a name="container"></a>container</dt>
<dd>
<p>
A <a class="glossterm" href="glossary.html#widget"><em class="glossterm">widget</em></a> that contains
other widgets; in that case, the container is the
<span class="emphasis"><em>parent</em></span> of the <span class="emphasis"><em>child</em></span>
widgets. Some containers don't draw anything on their own,
but rather just organize their children's <a class="glossterm" href="glossary.html#geometry"><em class="glossterm">geometry</em></a>; for example, #GtkVBox lays out
its children vertically without painting anything on its own. Other
containers include decorative elements; for example, #GtkFrame contains
the frame's child and a label in addition to the shaded frame it draws.
The base class for containers is #GtkContainer.
</p>
<p>See Also
<a class="glossterm" href="glossary.html#container"><em class="glossterm">widget</em></a>
<a class="glossterm" href="glossary.html#container"><em class="glossterm">geometry</em></a>
.</p>
</dd>
<dt>
<a name="display"></a>display</dt>
<dd><p>
GDK inherited the concept of display from the X window system,
which considers a display to be the combination
of a keyboard, a pointing device and one or more
<a class="glossterm" href="glossary.html#screen"><em class="glossterm">screens</em></a>.
Applications open a display to show windows and interact with the user.
In GDK, a display is represented by a #GdkDisplay.
</p></dd>
<dt><a name="ellipsization"></a></dt>
<dd><p>
Ellipsization is the process of replacing some part
of a text by an ellipsis (usually "...") to make the
text fit in a smaller space. Pango can ellipsize text
at the beginning, at the end or in the middle.
</p></dd>
<dt>
<a name="event"></a>event</dt>
<dd><p>
Events are the way in which GDK informs GTK+ about external events
like pointer motion, button clicks, key presses, etc.
</p></dd>
<dt>
<a name="geometry"></a>geometry</dt>
<dd><p>
A <a class="glossterm" href="glossary.html#widget"><em class="glossterm">widget's</em></a> position
and size. Within its parent, this is called the widget's
<a class="glossterm" href="glossary.html#allocation"><em class="glossterm">allocation</em></a>.
</p></dd>
<dt>
<a name="mapping"></a>mapping</dt>
<dd>
<p>
This is the step in a <a class="glossterm" href="glossary.html#widget"><em class="glossterm">widget's</em></a> life cycle where it
actually shows the GdkWindows it created when it was
<a class="glossterm" href="glossary.html#realization"><em class="glossterm">realized</em></a>. When a
widget is mapped, it must turn on its
%GTK_MAPPED flag.
</p>
<p>
Note that due to the asynchronous nature of the X window
system, a widget's window may not appear on the screen
immediatly after one calls gdk_window_show():
you must wait for the corresponding map <a class="glossterm" href="glossary.html#event"><em class="glossterm">event</em></a> to be received. You can do
this with the <a class="link" href="GtkWidget.html#GtkWidget-map-event" title='The "map-event" signal'><code class="methodname">GtkWidget::map-event</code>
signal</a>.
</p>
</dd>
<dt>
<a name="model-column"></a>model column</dt>
<dd>
<p>
A column in a tree model, holding data of a certain type.
The types which can be stored in the columns of a model
have to be specified when the model is constructed, see
e.g. gtk_list_store_new().
</p>
<p>See Also
<a class="glossterm" href="glossary.html#view-column"><em class="glossterm">view column</em></a>
.</p>
</dd>
<dt>
<a name="model-view"></a>model-view widget</dt>
<dd>
<p>
These widgets follow the well-known model-view pattern, which separates
the data (the model) to be displayed from the component which does the
actual visualization (the view). Examples of this pattern in GTK+ are
the #GtkTreeView/#GtkTreeModel and #GtkTextView/#GtkTextBuffer
</p>
<p>
One important advantage of this pattern is that it is possible to
display the same model in multiple views; another one that the
separation of the model allows a great deal of flexibility, as
demonstrated by e.g. #GtkTreeModelSort or #GtkTreeModelFilter.
</p>
</dd>
<dt>
<a name="no-window"></a>no-window widget</dt>
<dd><p>
A widget that does not have a GdkWindow of its own on which to
draw its contents, but rather shares its <a class="glossterm" href="glossary.html#parent"><em class="glossterm">parent's</em></a>. This can be tested with
the gtk_widget_get_has_window() function. See
<a class="xref" href="chap-drawing-model.html#window-no-window-widgets" title="Window and no-window widgets">the section called “Window and no-window widgets”</a> for a detailed
description of this flag.
</p></dd>
<dt>
<a name="parent"></a>parent</dt>
<dd><p>
A <a class="glossterm" href="glossary.html#widget"><em class="glossterm">widget's</em></a> parent is
the <a class="glossterm" href="glossary.html#container"><em class="glossterm">container</em></a>
inside which it resides.
</p></dd>
<dt>
<a name="realization"></a>realization</dt>
<dd>
<p>
This is the step in a <a class="glossterm" href="glossary.html#widget"><em class="glossterm">widget's</em></a> life cycle where it
creates its own GdkWindow, or otherwise associates itself with
its <a class="glossterm" href="glossary.html#parent"><em class="glossterm">parent's</em></a>
GdkWindow. If the widget has its own window, then it must
also attach a <a class="glossterm" href="glossary.html#style"><em class="glossterm">style</em></a> to
it. A widget becomes unrealized by destroying its associated
GdkWindow. When a widget is realized, it must turn on its
%GTK_REALIZED flag.
</p>
<p>
Widgets that don't own the GdkWindow on which they draw are
called <a class="glossterm" href="glossary.html#no-window"><em class="glossterm">no-window widgets</em></a>.
This can be tested with the gtk_widget_get_has_window() function. Normally,
these widgets draw on their parent's GdkWindow.
</p>
<p>
Note that when a widget creates a window in its <code class="methodname">::realize()</code>
handler, it does not actually show the window. That is, the
window's structure is just created in memory. The widget
actually shows the window when it gets <a class="glossterm" href="glossary.html#mapping"><em class="glossterm">mapped</em></a>.
</p>
</dd>
<dt>
<a name="requisition"></a>requisition</dt>
<dd>
<p>
The size requisition of a <a class="glossterm" href="glossary.html#widget"><em class="glossterm">widget</em></a> is the minimum amount of
space it requests from its <a class="glossterm" href="glossary.html#parent"><em class="glossterm">parent</em></a>. Once the parent computes
the widget's final size, it gives it its <a class="glossterm" href="glossary.html#allocation"><em class="glossterm">size allocation</em></a>.
</p>
<p>See Also
<a class="glossterm" href="glossary.html#allocation"><em class="glossterm">allocation</em></a>
.</p>
</dd>
<dt>
<a name="screen"></a>screen</dt>
<dd>
<p>
GDK inherited the concept of screen from the X window system,
which considers a screen to be a rectangular area, on which
applications may place their windows. Screens under X may have
quite dissimilar <a class="glossterm" href="glossary.html#visual"><em class="glossterm">visuals</em></a>.
Each screen can stretch across multiple physical monitors.
</p>
<p>
In GDK, screens are represented by #GdkScreen objects.
</p>
</dd>
<dt>
<a name="style"></a>style</dt>
<dd><p>
A style encapsulates what GTK+ needs to know in order to draw
a widget. Styles can be modified with
resource files.
</p></dd>
<dt>
<a name="toplevel"></a>toplevel</dt>
<dd>
<p>
A <a class="glossterm" href="glossary.html#widget"><em class="glossterm">widget</em></a> that does not
require a <a class="glossterm" href="glossary.html#parent"><em class="glossterm">parent</em></a> container.
The only toplevel widgets in GTK+ are #GtkWindow and widgets derived from it.
</p>
<p>See Also
<a class="glossterm" href="glossary.html#container"><em class="glossterm">container</em></a>
.</p>
</dd>
<dt>
<a name="unmap"></a>unmap</dt>
<dd><p>See <a class="glossterm" href="glossary.html#mapping"><em class="glossterm">mapping</em></a>.</p></dd>
<dt>
<a name="unrealize"></a>unrealize</dt>
<dd><p>See <a class="glossterm" href="glossary.html#realization"><em class="glossterm">realization</em></a>.</p></dd>
<dt>
<a name="view-column"></a>view column</dt>
<dd>
<p>
A displayed column in a tree view, represented by a
#GtkTreeViewColumn object.
</p>
<p>See Also
<a class="glossterm" href="glossary.html#model-column"><em class="glossterm">model column</em></a>
.</p>
</dd>
<dt>
<a name="visual"></a>visual</dt>
<dd>
<p>
A visual describes how color information is stored in pixels.
A <a class="glossterm" href="glossary.html#screen"><em class="glossterm">screen</em></a> may support
multiple visuals. On modern hardware, the most common visuals
are truecolor visuals, which store a fixed number of bits
(typically 8) for the red, green and blue components of a color.
</p>
<p>
On ancient hardware, one may still meet indexed visuals, which
store color information as an index into a color map, or even
monochrome visuals.
</p>
</dd>
<dt>
<a name="widget"></a>widget</dt>
<dd>
<p>
A control in a graphical user interface. Widgets can draw
themselves and process events from the mouse and keyboard.
Widget types include buttons, menus, text entry lines, and
lists. Widgets can be arranged into <a class="glossterm" href="glossary.html#container"><em class="glossterm">containers</em></a>, and these take
care of assigning the <a class="glossterm" href="glossary.html#geometry"><em class="glossterm">geometry</em></a> of the widgets: every
widget thus has a parent except those widgets which are
<a class="glossterm" href="glossary.html#toplevel"><em class="glossterm">toplevels</em></a>. The base
class for widgets is #GtkWidget.
</p>
<p>See Also
<a class="glossterm" href="glossary.html#container"><em class="glossterm">container</em></a>
.</p>
</dd>
</dl>
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.18</div>
</body>
</html>
|