]> Pileus Git - ~andy/gtk/blob - docs/reference/gtk/gtk-docs.sgml
Make GtkMenuShell abstract
[~andy/gtk] / docs / reference / gtk / gtk-docs.sgml
1 <?xml version="1.0"?>
2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
3                "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
4 <!ENTITY GtkAboutDialog SYSTEM "xml/gtkaboutdialog.xml">
5 <!ENTITY GtkAccelLabel SYSTEM "xml/gtkaccellabel.xml">
6 <!ENTITY GtkAction SYSTEM "xml/gtkaction.xml">
7 <!ENTITY GtkActionGroup SYSTEM "xml/gtkactiongroup.xml">
8 <!ENTITY GtkAdjustment SYSTEM "xml/gtkadjustment.xml">
9 <!ENTITY GtkAlignment SYSTEM "xml/gtkalignment.xml">
10 <!ENTITY GtkArrow SYSTEM "xml/gtkarrow.xml">
11 <!ENTITY GtkAspectFrame SYSTEM "xml/gtkaspectframe.xml">
12 <!ENTITY GtkAssistant SYSTEM "xml/gtkassistant.xml">
13 <!ENTITY GtkButtonBox SYSTEM "xml/gtkbbox.xml">
14 <!ENTITY GtkBin SYSTEM "xml/gtkbin.xml">
15 <!ENTITY GtkBox SYSTEM "xml/gtkbox.xml">
16 <!ENTITY GtkButton SYSTEM "xml/gtkbutton.xml">
17 <!ENTITY GtkBuildable SYSTEM "xml/gtkbuildable.xml">
18 <!ENTITY GtkBuilder SYSTEM "xml/gtkbuilder.xml">
19 <!ENTITY GtkCalendar SYSTEM "xml/gtkcalendar.xml">
20 <!ENTITY GtkCheckButton SYSTEM "xml/gtkcheckbutton.xml">
21 <!ENTITY GtkCheckMenuItem SYSTEM "xml/gtkcheckmenuitem.xml">
22 <!ENTITY GtkCList SYSTEM "xml/gtkclist.xml">
23 <!ENTITY GtkColorButton SYSTEM "xml/gtkcolorbutton.xml">
24 <!ENTITY GtkColorSelection SYSTEM "xml/gtkcolorsel.xml">
25 <!ENTITY GtkColorSelectionDialog SYSTEM "xml/gtkcolorseldlg.xml">
26 <!ENTITY GtkCombo SYSTEM "xml/gtkcombo.xml">
27 <!ENTITY GtkComboBox SYSTEM "xml/gtkcombobox.xml">
28 <!ENTITY GtkComboBoxEntry SYSTEM "xml/gtkcomboboxentry.xml">
29 <!ENTITY GtkContainer SYSTEM "xml/gtkcontainer.xml">
30 <!ENTITY GtkCTree SYSTEM "xml/gtkctree.xml">
31 <!ENTITY GtkCurve SYSTEM "xml/gtkcurve.xml">
32 <!ENTITY GtkDialog SYSTEM "xml/gtkdialog.xml">
33 <!ENTITY GtkDrawingArea SYSTEM "xml/gtkdrawingarea.xml">
34 <!ENTITY GtkEditable SYSTEM "xml/gtkeditable.xml">
35 <!ENTITY GtkOldEditable SYSTEM "xml/gtkoldeditable.xml">
36 <!ENTITY GtkEntry SYSTEM "xml/gtkentry.xml">
37 <!ENTITY GtkEntryCompletion SYSTEM "xml/gtkentrycompletion.xml">
38 <!ENTITY GtkEventBox SYSTEM "xml/gtkeventbox.xml">
39 <!ENTITY GtkExpander SYSTEM "xml/gtkexpander.xml">
40 <!ENTITY GtkFileChooser SYSTEM "xml/gtkfilechooser.xml">
41 <!ENTITY GtkFileChooserButton SYSTEM "xml/gtkfilechooserbutton.xml">
42 <!ENTITY GtkFileChooserDialog SYSTEM "xml/gtkfilechooserdialog.xml">
43 <!ENTITY GtkFileChooserWidget SYSTEM "xml/gtkfilechooserwidget.xml">
44 <!ENTITY GtkFileFilter SYSTEM "xml/gtkfilefilter.xml">
45 <!ENTITY GtkFileSelection SYSTEM "xml/gtkfilesel.xml">
46 <!ENTITY GtkFixed SYSTEM "xml/gtkfixed.xml">
47 <!ENTITY GtkFontButton SYSTEM "xml/gtkfontbutton.xml">
48 <!ENTITY GtkFontSelection SYSTEM "xml/gtkfontsel.xml">
49 <!ENTITY GtkFontSelectionDialog SYSTEM "xml/gtkfontseldlg.xml">
50 <!ENTITY GtkFrame SYSTEM "xml/gtkframe.xml">
51 <!ENTITY GtkGammaCurve SYSTEM "xml/gtkgamma.xml">
52 <!ENTITY GtkHandleBox SYSTEM "xml/gtkhandlebox.xml">
53 <!ENTITY GtkHButtonBox SYSTEM "xml/gtkhbbox.xml">
54 <!ENTITY GtkHBox SYSTEM "xml/gtkhbox.xml">
55 <!ENTITY GtkHPaned SYSTEM "xml/gtkhpaned.xml">
56 <!ENTITY GtkHRuler SYSTEM "xml/gtkhruler.xml">
57 <!ENTITY GtkHScale SYSTEM "xml/gtkhscale.xml">
58 <!ENTITY GtkHScrollbar SYSTEM "xml/gtkhscrollbar.xml">
59 <!ENTITY GtkHSeparator SYSTEM "xml/gtkhseparator.xml">
60 <!ENTITY GtkIconView SYSTEM "xml/gtkiconview.xml">
61 <!ENTITY GtkImage SYSTEM "xml/gtkimage.xml">
62 <!ENTITY GtkImageMenuItem SYSTEM "xml/gtkimagemenuitem.xml">
63 <!ENTITY GtkIMContext SYSTEM "xml/gtkimcontext.xml">
64 <!ENTITY GtkIMContextSimple SYSTEM "xml/gtkimcontextsimple.xml">
65 <!ENTITY GtkIMMulticontext SYSTEM "xml/gtkimmulticontext.xml">
66 <!ENTITY GtkInputDialog SYSTEM "xml/gtkinputdialog.xml">
67 <!ENTITY GtkInvisible SYSTEM "xml/gtkinvisible.xml">
68 <!ENTITY GtkItem SYSTEM "xml/gtkitem.xml">
69 <!ENTITY GtkItemFactory SYSTEM "xml/gtkitemfactory.xml">
70 <!ENTITY GtkLabel SYSTEM "xml/gtklabel.xml">
71 <!ENTITY GtkLayout SYSTEM "xml/gtklayout.xml">
72 <!ENTITY GtkLinkButton SYSTEM "xml/gtklinkbutton.xml">
73 <!ENTITY GtkList SYSTEM "xml/gtklist.xml">
74 <!ENTITY GtkListItem SYSTEM "xml/gtklistitem.xml">
75 <!ENTITY GtkMenu SYSTEM "xml/gtkmenu.xml">
76 <!ENTITY GtkMenuBar SYSTEM "xml/gtkmenubar.xml">
77 <!ENTITY GtkMenuItem SYSTEM "xml/gtkmenuitem.xml">
78 <!ENTITY GtkMenuShell SYSTEM "xml/gtkmenushell.xml">
79 <!ENTITY GtkMenuToolButton SYSTEM "xml/gtkmenutoolbutton.xml">
80 <!ENTITY GtkMessageDialog SYSTEM "xml/gtkmessagedialog.xml">
81 <!ENTITY GtkMisc SYSTEM "xml/gtkmisc.xml">
82 <!ENTITY GtkNotebook SYSTEM "xml/gtknotebook.xml">
83 <!ENTITY GtkObject SYSTEM "xml/gtkobject.xml">
84 <!ENTITY GtkOptionMenu SYSTEM "xml/gtkoptionmenu.xml">
85 <!ENTITY GtkPaned SYSTEM "xml/gtkpaned.xml">
86 <!ENTITY GtkPixmap SYSTEM "xml/gtkpixmap.xml">
87 <!ENTITY GtkPlug SYSTEM "xml/gtkplug.xml">
88 <!ENTITY GtkPreview SYSTEM "xml/gtkpreview.xml">
89 <!ENTITY GtkPrintOperation SYSTEM "xml/gtkprintoperation.xml">
90 <!ENTITY GtkPrintContext SYSTEM "xml/gtkprintcontext.xml">
91 <!ENTITY GtkPrintSettings SYSTEM "xml/gtkprintsettings.xml">
92 <!ENTITY GtkPageSetup SYSTEM "xml/gtkpagesetup.xml">
93 <!ENTITY GtkPaperSize SYSTEM "xml/gtkpapersize.xml">
94 <!ENTITY GtkPrinter SYSTEM "xml/gtkprinter.xml">
95 <!ENTITY GtkPrintJob SYSTEM "xml/gtkprintjob.xml">
96 <!ENTITY GtkPrintUnixDialog SYSTEM "xml/gtkprintunixdialog.xml">
97 <!ENTITY GtkPageSetupUnixDialog SYSTEM "xml/gtkpagesetupunixdialog.xml">
98 <!ENTITY GtkProgress SYSTEM "xml/gtkprogress.xml">
99 <!ENTITY GtkProgressBar SYSTEM "xml/gtkprogressbar.xml">
100 <!ENTITY GtkRadioAction SYSTEM "xml/gtkradioaction.xml">
101 <!ENTITY GtkRadioButton SYSTEM "xml/gtkradiobutton.xml">
102 <!ENTITY GtkRadioMenuItem SYSTEM "xml/gtkradiomenuitem.xml">
103 <!ENTITY GtkRadioToolButton SYSTEM "xml/gtkradiotoolbutton.xml">
104 <!ENTITY GtkRange SYSTEM "xml/gtkrange.xml">
105 <!ENTITY GtkRecentChooser SYSTEM "xml/gtkrecentchooser.xml">
106 <!ENTITY GtkRecentChooserDialog SYSTEM "xml/gtkrecentchooserdialog.xml">
107 <!ENTITY GtkRecentChooserMenu SYSTEM "xml/gtkrecentchoosermenu.xml">
108 <!ENTITY GtkRecentChooserWidget SYSTEM "xml/gtkrecentchooserwidget.xml">
109 <!ENTITY GtkRecentFilter SYSTEM "xml/gtkrecentfilter.xml">
110 <!ENTITY GtkRecentManager SYSTEM "xml/gtkrecentmanager.xml">
111 <!ENTITY GtkRecentAction SYSTEM "xml/gtkrecentaction.xml">
112 <!ENTITY GtkRuler SYSTEM "xml/gtkruler.xml">
113 <!ENTITY GtkScale SYSTEM "xml/gtkscale.xml">
114 <!ENTITY GtkScaleButton SYSTEM "xml/gtkscalebutton.xml">
115 <!ENTITY GtkScrollbar SYSTEM "xml/gtkscrollbar.xml">
116 <!ENTITY GtkScrolledWindow SYSTEM "xml/gtkscrolledwindow.xml">
117 <!ENTITY GtkSeparator SYSTEM "xml/gtkseparator.xml">
118 <!ENTITY GtkSeparatorMenuItem SYSTEM "xml/gtkseparatormenuitem.xml">
119 <!ENTITY GtkSeparatorToolItem SYSTEM "xml/gtkseparatortoolitem.xml">
120 <!ENTITY GtkSizeGroup SYSTEM "xml/gtksizegroup.xml">
121 <!ENTITY GtkSocket SYSTEM "xml/gtksocket.xml">
122 <!ENTITY GtkSpinButton SYSTEM "xml/gtkspinbutton.xml">
123 <!ENTITY GtkStatusbar SYSTEM "xml/gtkstatusbar.xml">
124 <!ENTITY GtkStatusIcon SYSTEM "xml/gtkstatusicon.xml">
125 <!ENTITY GtkTable SYSTEM "xml/gtktable.xml">
126 <!ENTITY GtkTearoffMenuItem SYSTEM "xml/gtktearoffmenuitem.xml">
127 <!ENTITY GtkText SYSTEM "xml/gtktext.xml">
128 <!ENTITY GtkTextBuffer SYSTEM "xml/gtktextbuffer.xml">
129 <!ENTITY GtkTextIter SYSTEM "xml/gtktextiter.xml">
130 <!ENTITY GtkTextMark SYSTEM "xml/gtktextmark.xml">
131 <!ENTITY GtkTextTag SYSTEM "xml/gtktexttag.xml">
132 <!ENTITY GtkTextTagTable SYSTEM "xml/gtktexttagtable.xml">
133 <!ENTITY GtkTextView SYSTEM "xml/gtktextview.xml">
134 <!ENTITY GtkTipsQuery SYSTEM "xml/gtktipsquery.xml">
135 <!ENTITY GtkToggleAction SYSTEM "xml/gtktoggleaction.xml">
136 <!ENTITY GtkToggleButton SYSTEM "xml/gtktogglebutton.xml">
137 <!ENTITY GtkToggleToolButton SYSTEM "xml/gtktoggletoolbutton.xml">
138 <!ENTITY GtkToolbar SYSTEM "xml/gtktoolbar.xml">
139 <!ENTITY GtkToolButton SYSTEM "xml/gtktoolbutton.xml">
140 <!ENTITY GtkToolItem SYSTEM "xml/gtktoolitem.xml">
141 <!ENTITY GtkTooltips SYSTEM "xml/gtktooltips.xml">
142 <!ENTITY GtkTooltip SYSTEM "xml/gtktooltip.xml">
143 <!ENTITY GtkTree SYSTEM "xml/gtktree.xml">
144 <!ENTITY GtkTreeItem SYSTEM "xml/gtktreeitem.xml">
145 <!ENTITY GtkTreeModel SYSTEM "xml/gtktreemodel.xml">
146 <!ENTITY GtkTreeSortable SYSTEM "xml/gtktreesortable.xml">
147 <!ENTITY GtkTreeModelSort SYSTEM "xml/gtktreemodelsort.xml">
148 <!ENTITY GtkTreeModelFilter SYSTEM "xml/gtktreemodelfilter.xml">
149 <!ENTITY GtkTreeSelection SYSTEM "xml/gtktreeselection.xml">
150 <!ENTITY GtkTreeStore SYSTEM "xml/gtktreestore.xml">
151 <!ENTITY GtkTreeViewColumn SYSTEM "xml/gtktreeviewcolumn.xml">
152 <!ENTITY GtkTreeView SYSTEM "xml/gtktreeview.xml">
153 <!ENTITY GtkUIManager SYSTEM "xml/gtkuimanager.xml">
154 <!ENTITY GtkCellEditable SYSTEM "xml/gtkcelleditable.xml">
155 <!ENTITY GtkCellLayout SYSTEM "xml/gtkcelllayout.xml">
156 <!ENTITY GtkCellRenderer SYSTEM "xml/gtkcellrenderer.xml">
157 <!ENTITY GtkCellRendererAccel SYSTEM "xml/gtkcellrendereraccel.xml">
158 <!ENTITY GtkCellRendererCombo SYSTEM "xml/gtkcellrenderercombo.xml">
159 <!ENTITY GtkCellRendererPixbuf SYSTEM "xml/gtkcellrendererpixbuf.xml">
160 <!ENTITY GtkCellRendererProgress SYSTEM "xml/gtkcellrendererprogress.xml">
161 <!ENTITY GtkCellRendererSpin SYSTEM "xml/gtkcellrendererspin.xml">
162 <!ENTITY GtkCellRendererText SYSTEM "xml/gtkcellrenderertext.xml">
163 <!ENTITY GtkCellRendererToggle SYSTEM "xml/gtkcellrenderertoggle.xml">
164 <!ENTITY GtkCellView SYSTEM "xml/gtkcellview.xml">
165 <!ENTITY GtkListStore SYSTEM "xml/gtkliststore.xml">
166 <!ENTITY GtkTreeDND SYSTEM "xml/gtktreednd.xml">
167 <!ENTITY GtkVButtonBox SYSTEM "xml/gtkvbbox.xml">
168 <!ENTITY GtkVBox SYSTEM "xml/gtkvbox.xml">
169 <!ENTITY GtkViewport SYSTEM "xml/gtkviewport.xml">
170 <!ENTITY GtkVolumeButton SYSTEM "xml/gtkvolumebutton.xml">
171 <!ENTITY GtkVPaned SYSTEM "xml/gtkvpaned.xml">
172 <!ENTITY GtkVRuler SYSTEM "xml/gtkvruler.xml">
173 <!ENTITY GtkVScale SYSTEM "xml/gtkvscale.xml">
174 <!ENTITY GtkVScrollbar SYSTEM "xml/gtkvscrollbar.xml">
175 <!ENTITY GtkVSeparator SYSTEM "xml/gtkvseparator.xml">
176 <!ENTITY GtkWidget SYSTEM "xml/gtkwidget.xml">
177 <!ENTITY GtkWindow SYSTEM "xml/gtkwindow.xml">
178 <!ENTITY GtkWindowGroup SYSTEM "xml/gtkwindowgroup.xml">
179 <!ENTITY GtkAccessible SYSTEM "xml/gtkaccessible.xml">
180 <!ENTITY gtk-General SYSTEM "xml/gtkmain.xml">
181 <!ENTITY gtk-Feature-Test-Macros SYSTEM "xml/gtkfeatures.xml">
182 <!ENTITY gtk-Graphics-Contexts SYSTEM "xml/gtkgc.xml">
183 <!ENTITY gtk-Styles SYSTEM "xml/gtkstyle.xml">
184 <!ENTITY gtk-Themes SYSTEM "xml/gtkthemes.xml">
185 <!ENTITY gtk-Resource-Files SYSTEM "xml/gtkrc.xml">
186 <!ENTITY GtkAccelGroup SYSTEM "xml/gtkaccelgroup.xml">
187 <!ENTITY gtk-accel-map SYSTEM "xml/gtkaccelmap.xml">
188 <!ENTITY gtk-Selections SYSTEM "xml/gtkselection.xml">
189 <!ENTITY gtk-Clipboards SYSTEM "xml/gtkclipboard.xml">
190 <!ENTITY gtk-Drag-and-Drop SYSTEM "xml/gtkdnd.xml">
191 <!ENTITY gtk-Signals SYSTEM "xml/gtksignal.xml">
192 <!ENTITY gtk-Types SYSTEM "xml/gtktypeutils.xml">
193 <!ENTITY gtk-Bindings SYSTEM "xml/gtkbindings.xml">
194 <!ENTITY gtk-Standard-Enumerations SYSTEM "xml/gtkenums.xml">
195 <!ENTITY gtk-Named-Icons SYSTEM "xml/gtkicontheme.xml">
196 <!ENTITY gtk-Stock-Items SYSTEM "xml/gtkstock.xml">
197 <!ENTITY gtk-Themeable-Stock-Images SYSTEM "xml/gtkiconfactory.xml">
198 <!ENTITY gtk-Settings SYSTEM "xml/gtksettings.xml">
199
200 <!ENTITY index-Object-Tree SYSTEM "xml/tree_index.sgml">
201 <!ENTITY visual-index SYSTEM "visual_index.xml">
202
203 <!ENTITY index-Objects-Grouped SYSTEM "objects_grouped.sgml">
204 <!ENTITY gtk-TextWidget SYSTEM "xml/text_widget.sgml">
205 <!ENTITY gtk-TreeWidget SYSTEM "xml/tree_widget.sgml">
206 <!ENTITY gtk-Compiling SYSTEM "compiling.sgml">
207 <!ENTITY gtk-Building SYSTEM "building.sgml">
208 <!ENTITY gtk-Running SYSTEM "running.sgml">
209 <!ENTITY gtk-Resources SYSTEM "resources.sgml">
210 <!ENTITY gtk-Windows SYSTEM "windows.sgml">
211 <!ENTITY gtk-X11 SYSTEM "x11.sgml">
212 <!ENTITY gtk-OSX SYSTEM "osx.sgml">
213 <!ENTITY gtk-DirectFB SYSTEM "directfb.sgml">
214 <!ENTITY gtk-Questions SYSTEM "xml/question_index.sgml">
215 <!ENTITY gtk-Changes-1-2 SYSTEM "changes-1.2.sgml">
216 <!ENTITY gtk-Changes-2-0 SYSTEM "changes-2.0.sgml">
217 <!ENTITY gtk-migrating-checklist SYSTEM "xml/migrating-checklist.sgml">
218 <!ENTITY gtk-migrating-Cairo SYSTEM "xml/migrating-Cairo.sgml">
219 <!ENTITY gtk-migrating-GtkFileChooser SYSTEM "xml/migrating-GtkFileChooser.sgml">
220 <!ENTITY gtk-migrating-GtkAction SYSTEM "xml/migrating-GtkAction.sgml">
221 <!ENTITY gtk-migrating-GtkComboBox SYSTEM "xml/migrating-GtkComboBox.sgml">
222 <!ENTITY gtk-migrating-GtkIconView SYSTEM "xml/migrating-GtkIconView.sgml">
223 <!ENTITY gtk-migrating-GtkAboutDialog SYSTEM "xml/migrating-GtkAboutDialog.sgml">
224 <!ENTITY gtk-migrating-GtkColorButton SYSTEM "xml/migrating-GtkColorButton.sgml">
225 <!ENTITY gtk-migrating-GtkAssistant SYSTEM "xml/migrating-GtkAssistant.sgml">
226 <!ENTITY gtk-migrating-GtkRecentChooser SYSTEM "xml/migrating-GtkRecentChooser.sgml">
227 <!ENTITY gtk-migrating-GtkLinkButton SYSTEM "xml/migrating-GtkLinkButton.sgml">
228 <!ENTITY version SYSTEM "version.xml">
229 <!ENTITY gtk-query-immodules SYSTEM "gtk-query-immodules-2.0.xml">
230 <!ENTITY gtk-update-icon-cache SYSTEM "gtk-update-icon-cache.xml">
231 <!ENTITY gtk-glossary SYSTEM "xml/glossary.xml">
232 ]>
233 <book id="index">
234   <bookinfo>
235     <title>GTK+ Reference Manual</title>
236     <releaseinfo>for GTK+ &version;</releaseinfo>
237   </bookinfo>
238
239   <part id="gtk">
240     <title>GTK+ Overview</title>
241     <partintro>
242     <para>
243 GTK+ is a library for creating graphical user interfaces. It
244 works on many UNIX-like platforms, Windows, and on framebuffer
245 devices. GTK+ is released under the GNU Library General Public License
246 (GNU LGPL), which allows for flexible licensing of client
247 applications. GTK+ has a C-based object-oriented architecture that
248 allows for maximum flexibility.  Bindings for other languages have
249 been written, including C++, Objective-C, Guile/Scheme, Perl, Python,
250 TOM, Ada95, Free Pascal, and Eiffel.
251     </para>
252     <para>
253 GTK+ depends on the following libraries:
254 <variablelist>
255
256 <varlistentry>
257 <term>GLib</term>
258 <listitem><para>
259 A general-purpose utility library, not specific to graphical user interfaces.
260 GLib provides many useful data types, macros, type conversions,
261 string utilities, file utilities, a main loop abstraction, and so on.
262 </para></listitem>
263 </varlistentry>
264
265 <varlistentry>
266 <term>Pango</term>
267 <listitem><para>
268 Pango is a library for internationalized text handling. It centers
269 around the #PangoLayout object, representing a paragraph of text. 
270 Pango provides the engine for #GtkTextView, #GtkLabel, #GtkEntry, and
271 other widgets that display text.
272 </para></listitem>
273 </varlistentry>
274
275 <varlistentry>
276 <term>ATK</term>
277 <listitem><para>
278 ATK is the Accessibility Toolkit. It provides a set of generic
279 interfaces allowing accessibility technologies to interact with a
280 graphical user interface. For example, a screen reader uses ATK to
281 discover the text in an interface and read it to blind users.  GTK+
282 widgets have built-in support for accessibility using the ATK
283 framework.
284 </para></listitem>
285 </varlistentry>
286
287 <varlistentry>
288 <term>GdkPixbuf</term>
289 <listitem><para>
290 This is a small library which allows you to create #GdkPixbuf
291 ("pixel buffer") objects from image data or image files. 
292 Use a #GdkPixbuf in combination with #GtkImage to display images.
293 </para></listitem>
294 </varlistentry>
295
296 <varlistentry>
297 <term>GDK</term>
298 <listitem><para>
299 GDK is the abstraction layer that allows GTK+ to support multiple
300 windowing systems. GDK provides drawing and window system facilities
301 on X11, Windows, and the Linux framebuffer device.
302 </para></listitem>
303 </varlistentry>
304
305 <varlistentry>
306 <term>GTK+</term>
307 <listitem><para>
308 The GTK+ library itself contains <firstterm>widgets</firstterm>, 
309 that is, GUI components such as #GtkButton or #GtkTextView.
310 </para></listitem>
311 </varlistentry>
312 </variablelist>
313     </para>
314 </partintro>
315     &gtk-Building;
316     &gtk-Compiling;
317     &gtk-Running;
318     &gtk-X11;
319     &gtk-Windows;
320     &gtk-OSX;
321     &gtk-DirectFB;
322     &gtk-Resources;
323     &gtk-Questions;
324   </part>
325
326
327   <part  id="gtkbase">
328     <title>GTK+ Core Reference</title>
329     &gtk-General;
330     &GtkAccelGroup;
331     &gtk-accel-map;
332     &gtk-Clipboards;
333     &gtk-Drag-and-Drop;
334     &gtk-Named-Icons;
335     &gtk-Stock-Items;
336     &gtk-Themeable-Stock-Images;
337     &gtk-Resource-Files;   
338     &gtk-Settings;
339     &gtk-Bindings;
340     &gtk-Standard-Enumerations;
341     &gtk-Graphics-Contexts;
342     &gtk-Styles;
343     &gtk-Selections;
344     &gtk-Feature-Test-Macros;
345     &gtk-Signals;
346     &gtk-Types;
347   </part>
348
349   <part id="gtkobjects">
350     <title>GTK+ Widgets and Objects</title>
351
352     <chapter>
353       <title>Object Hierarchy</title>
354     &index-Object-Tree;
355     </chapter>
356
357     <chapter>
358       <title>Widget Gallery</title>
359     &visual-index;
360     </chapter>
361
362     <chapter id="WindowWidgets">
363       <title>Windows</title>
364         &GtkDialog;
365         &GtkInvisible;
366         &GtkMessageDialog;
367         &GtkWindow;
368         &GtkWindowGroup;
369         &GtkAboutDialog;
370         &GtkAssistant;
371     </chapter>
372
373     <chapter id="DisplayWidgets">
374       <title>Display Widgets</title>
375         &GtkAccelLabel;
376         &GtkImage;
377         &GtkLabel;
378         &GtkProgressBar;
379         &GtkStatusbar;
380         &GtkStatusIcon;
381     </chapter>
382
383     <chapter id="ButtonWidgets">
384       <title>Buttons and Toggles</title>
385         &GtkButton;
386         &GtkCheckButton;
387         &GtkRadioButton;
388         &GtkToggleButton;
389         &GtkLinkButton;
390         &GtkScaleButton;
391         &GtkVolumeButton;
392     </chapter>
393
394     <chapter id="NumericEntry">
395       <title>Numeric/Text Data Entry</title>
396         &GtkEntry;
397         &GtkEntryCompletion;
398         &GtkHScale;      
399         &GtkVScale;
400         &GtkSpinButton;
401         &GtkEditable;
402     </chapter>
403
404     <chapter id="TextWidgetObjects">
405       <title>Multiline Text Editor</title>
406         &gtk-TextWidget;
407         &GtkTextIter;
408         &GtkTextMark;
409         &GtkTextBuffer;
410         &GtkTextTag;
411         &GtkTextTagTable;
412         &GtkTextView;
413     </chapter>
414
415     <chapter id="TreeWidgetObjects">
416       <title>Tree, List and Icon Grid Widgets</title>
417         &gtk-TreeWidget;
418         &GtkTreeModel;
419         &GtkTreeSelection;
420         &GtkTreeViewColumn;
421         &GtkTreeView;
422         &GtkTreeDND;
423         &GtkCellView;
424         &GtkIconView;
425         &GtkTreeSortable;
426         &GtkTreeModelSort;
427         &GtkTreeModelFilter;
428         &GtkCellLayout;
429         &GtkCellRenderer;
430         &GtkCellEditable;
431         &GtkCellRendererAccel;
432         &GtkCellRendererCombo;
433         &GtkCellRendererPixbuf;
434         &GtkCellRendererProgress;
435         &GtkCellRendererSpin;
436         &GtkCellRendererText;
437         &GtkCellRendererToggle;
438         &GtkListStore;
439         &GtkTreeStore;
440     </chapter>
441
442     <chapter id="MenusAndCombos">
443       <title>Menus, Combo Box, Toolbar</title>
444         &GtkComboBox;
445         &GtkComboBoxEntry;
446         &GtkMenu;
447         &GtkMenuBar;
448         &GtkMenuItem;
449         &GtkImageMenuItem;
450         &GtkRadioMenuItem;
451         &GtkCheckMenuItem;      
452         &GtkSeparatorMenuItem;
453         &GtkTearoffMenuItem;
454         &GtkToolbar;
455         &GtkToolItem;
456         &GtkSeparatorToolItem;
457         &GtkToolButton;
458         &GtkMenuToolButton;
459         &GtkToggleToolButton;
460         &GtkRadioToolButton;
461     </chapter>
462  
463     <chapter id="Actions">
464       <title>Action-based menus and toolbars</title>
465         &GtkUIManager;
466         &GtkActionGroup;
467         &GtkAction;
468         &GtkToggleAction;
469         &GtkRadioAction;
470         &GtkRecentAction;
471     </chapter>
472
473     <chapter id="SelectorWidgets">
474       <title>Selectors (File/Font/Color/Input Devices)</title>
475         &GtkColorButton;
476         &GtkColorSelection;
477         &GtkColorSelectionDialog;
478         &GtkFileSelection;
479         &GtkFileChooser;
480         &GtkFileChooserButton;
481         &GtkFileChooserDialog;
482         &GtkFileChooserWidget;
483         &GtkFileFilter;
484         &GtkFontButton;
485         &GtkFontSelection;
486         &GtkFontSelectionDialog;
487         &GtkInputDialog;
488     </chapter>
489     
490     <chapter id="LayoutContainers">
491       <title>Layout Containers</title>
492         &GtkAlignment;
493         &GtkAspectFrame;
494         &GtkHBox;
495         &GtkVBox;
496         &GtkHButtonBox;
497         &GtkVButtonBox;
498         &GtkFixed;
499         &GtkHPaned;
500         &GtkVPaned;
501         &GtkLayout;
502         &GtkNotebook;
503         &GtkTable;
504         &GtkExpander;
505     </chapter>
506
507     <chapter id="Ornaments">
508       <title>Ornaments</title>
509         &GtkFrame;
510         &GtkHSeparator;
511         &GtkVSeparator;
512     </chapter>
513
514     <chapter id="ScrollingWidgets">
515       <title>Scrolling</title>
516         &GtkHScrollbar;
517         &GtkVScrollbar;
518         &GtkScrolledWindow;
519     </chapter>
520
521     <chapter id="Printing">
522       <title>Printing</title>
523       &GtkPrintOperation;
524       &GtkPrintContext;
525       &GtkPrintSettings;
526       &GtkPageSetup;
527       &GtkPaperSize;
528       &GtkPrinter;
529       &GtkPrintJob; 
530       &GtkPrintUnixDialog;
531       &GtkPageSetupUnixDialog;
532     </chapter>
533
534     <chapter id="MiscObjects">
535       <title>Miscellaneous</title>
536         &GtkAdjustment;
537         &GtkArrow;
538         &GtkCalendar;
539         &GtkDrawingArea;
540         &GtkEventBox;
541         &GtkHandleBox;
542         &GtkIMContextSimple;
543         &GtkIMMulticontext;
544         &GtkSizeGroup;
545         &GtkTooltip;
546         &GtkTooltips;
547         &GtkViewport;
548         &GtkAccessible;
549     </chapter>
550
551     <chapter id="AbstractObjects">
552       <title>Abstract Base Classes</title>
553         &GtkBin;
554         &GtkBox;
555         &GtkButtonBox;
556         &GtkContainer;
557         &GtkItem;
558         &GtkMenuShell;
559         &GtkMisc;
560         &GtkObject;
561         &GtkPaned;
562         &GtkRange;
563         &GtkScale;
564         &GtkScrollbar;
565         &GtkSeparator;
566         &GtkWidget;
567         &GtkIMContext;
568     </chapter>    
569
570     <chapter id="PlugSocket">
571       <title>Cross-process Embedding</title>
572         &GtkPlug;
573         &GtkSocket;
574     </chapter>
575
576     <chapter id="SpecialObjects">
577       <title>Special-purpose features</title>
578         &GtkCurve;
579         &GtkGammaCurve;
580         &GtkRuler;
581         &GtkHRuler;
582         &GtkVRuler;
583     </chapter>
584
585     <chapter id="RecentDocuments">
586       <title>Recently Used Documents</title>
587       &GtkRecentManager;
588       &GtkRecentChooser;
589       &GtkRecentChooserDialog;
590       &GtkRecentChooserMenu;
591       &GtkRecentChooserWidget;
592       &GtkRecentFilter;
593     </chapter>
594
595     <chapter id="Builder">
596       <title>Interface builder</title>
597       &GtkBuildable;
598       &GtkBuilder;
599     </chapter>
600
601     <chapter id="DeprecatedObjects">
602       <title>Deprecated</title>
603         &GtkCList;      
604         &GtkCTree;
605         &GtkCombo;
606         &GtkItemFactory;
607         &GtkList;
608         &GtkListItem;
609         &GtkOldEditable;
610         &GtkOptionMenu;
611         &GtkPixmap;
612         &GtkPreview;
613         &GtkProgress;
614         &GtkText;
615         &GtkTipsQuery;
616         &GtkTree;
617         &GtkTreeItem;
618     </chapter>
619   </part>
620
621   <part id="migrating">
622     <title>Migrating from Previous Versions of GTK+</title>
623
624     <partintro>
625       <para>
626         This part describes what you need to change in programs use
627         older versions of GTK+ so that they can use the new features.
628         It also mentions how to convert applications using widgets
629         found in the libgnomeui library to use their counterparts
630         in GTK+.
631       </para>
632     </partintro>
633
634     &gtk-migrating-checklist;
635     &gtk-Changes-1-2;
636     &gtk-Changes-2-0;
637     &gtk-migrating-GtkFileChooser;
638     &gtk-migrating-GtkAction;
639     &gtk-migrating-GtkComboBox;
640     &gtk-migrating-GtkIconView;
641     &gtk-migrating-GtkAboutDialog;
642     &gtk-migrating-GtkColorButton;
643     &gtk-migrating-GtkAssistant;
644     &gtk-migrating-GtkRecentChooser;
645     &gtk-migrating-GtkLinkButton;
646   </part>
647
648   <part>
649     <title>GTK+ Tools</title>
650
651      &gtk-query-immodules;
652      &gtk-update-icon-cache;
653   </part>
654
655   &gtk-glossary;
656
657   <index>
658     <title>Index</title>
659   </index>
660   <index role="deprecated">
661     <title>Index of deprecated symbols</title>
662   </index>
663   <index role="2.2">
664     <title>Index of new symbols in 2.2</title>
665   </index>
666   <index role="2.4">
667     <title>Index of new symbols in 2.4</title>
668   </index>  
669   <index role="2.6">
670     <title>Index of new symbols in 2.6</title>
671   </index>  
672   <index role="2.8">
673     <title>Index of new symbols in 2.8</title>
674   </index>  
675   <index role="2.10">
676     <title>Index of new symbols in 2.10</title>
677   </index>  
678   <index role="2.12">
679     <title>Index of new symbols in 2.12</title>
680   </index>  
681
682 </book>