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