<?xml version="1.0"?> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ <!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'"> <!ENTITY version SYSTEM "version.xml"> <!ENTITY pi "π"> <!ENTITY solidus "⁄"> ]> <book id="index" xmlns:xi="http://www.w3.org/2003/XInclude"> <bookinfo> <title>GTK+ 3 Reference Manual</title> <releaseinfo> This document is for the GTK+ 3 library, version &version;. The latest versions can be found online at <ulink role="online-location" url="http://developer.gnome.org/gtk3/">http://developer.gnome.org/gtk3/</ulink>. If you are looking for the older GTK+ 2 series of libraries, see <ulink role="online-location" url="http://developer.gnome.org/gtk2/">http://developer.gnome.org/gtk2/</ulink>. </releaseinfo> </bookinfo> <part id="gtk"> <title>GTK+ Overview</title> <xi:include href="overview.xml"/> <xi:include href="xml/getting_started.xml"/> <xi:include href="resources.sgml" /> <xi:include href="xml/question_index.sgml" /> <xi:include href="drawing-model.xml" /> <xi:include href="input-handling.xml" /> </part> <part id="gtkobjects"> <title>GTK+ Widgets and Objects</title> <chapter> <title>Object Hierarchy</title> <xi:include href="xml/tree_index.sgml" /> </chapter> <chapter> <title>Widget Gallery</title> <xi:include href="visual_index.xml" /> </chapter> <chapter id="Application"> <title>Application support</title> <xi:include href="xml/gtkapplication.xml" /> <xi:include href="xml/gtkapplicationwindow.xml" /> <xi:include href="xml/gtkactionable.xml" /> </chapter> <chapter id="Builder"> <title>Interface builder</title> <xi:include href="xml/gtkbuilder.xml" /> <xi:include href="xml/gtkbuildable.xml" /> </chapter> <chapter id="WindowWidgets"> <title>Windows</title> <xi:include href="xml/gtkwindow.xml" /> <xi:include href="xml/gtkdialog.xml" /> <xi:include href="xml/gtkmessagedialog.xml" /> <xi:include href="xml/gtkaboutdialog.xml" /> <xi:include href="xml/gtkassistant.xml" /> <xi:include href="xml/gtkinvisible.xml" /> <xi:include href="xml/gtkoffscreenwindow.xml" /> <xi:include href="xml/gtkwindowgroup.xml" /> </chapter> <chapter id="LayoutContainers"> <title>Layout Containers</title> <xi:include href="xml/gtkbox.xml" /> <xi:include href="xml/gtkgrid.xml" /> <xi:include href="xml/gtkrevealer.xml" /> <xi:include href="xml/gtklistbox.xml" /> <xi:include href="xml/gtkflowbox.xml" /> <xi:include href="xml/gtkstack.xml" /> <xi:include href="xml/gtkstackswitcher.xml" /> <xi:include href="xml/gtksidebar.xml" /> <xi:include href="xml/gtkactionbar.xml" /> <xi:include href="xml/gtkheaderbar.xml" /> <xi:include href="xml/gtkoverlay.xml" /> <xi:include href="xml/gtkbbox.xml" /> <xi:include href="xml/gtkpaned.xml" /> <xi:include href="xml/gtklayout.xml" /> <xi:include href="xml/gtknotebook.xml" /> <xi:include href="xml/gtkexpander.xml" /> <xi:include href="xml/gtkorientable.xml" /> <xi:include href="xml/gtkaspectframe.xml" /> <xi:include href="xml/gtkfixed.xml" /> </chapter> <chapter id="DisplayWidgets"> <title>Display Widgets</title> <xi:include href="xml/gtklabel.xml" /> <xi:include href="xml/gtkimage.xml" /> <xi:include href="xml/gtkspinner.xml" /> <xi:include href="xml/gtkinfobar.xml" /> <xi:include href="xml/gtkprogressbar.xml" /> <xi:include href="xml/gtklevelbar.xml" /> <xi:include href="xml/gtkstatusbar.xml" /> <xi:include href="xml/gtkaccellabel.xml" /> </chapter> <chapter id="ButtonWidgets"> <title>Buttons and Toggles</title> <xi:include href="xml/gtkbutton.xml" /> <xi:include href="xml/gtkcheckbutton.xml" /> <xi:include href="xml/gtkradiobutton.xml" /> <xi:include href="xml/gtktogglebutton.xml" /> <xi:include href="xml/gtklinkbutton.xml" /> <xi:include href="xml/gtkmenubutton.xml" /> <xi:include href="xml/gtkswitch.xml" /> <xi:include href="xml/gtkscalebutton.xml" /> <xi:include href="xml/gtkvolumebutton.xml" /> <xi:include href="xml/gtklockbutton.xml" /> <xi:include href="xml/gtkmodelbutton.xml" /> </chapter> <chapter id="NumericEntry"> <title>Numeric and Text Data Entry</title> <xi:include href="xml/gtkentry.xml" /> <xi:include href="xml/gtkentrybuffer.xml" /> <xi:include href="xml/gtkentrycompletion.xml" /> <xi:include href="xml/gtkscale.xml" /> <xi:include href="xml/gtkspinbutton.xml" /> <xi:include href="xml/gtksearchentry.xml" /> <xi:include href="xml/gtksearchbar.xml" /> <xi:include href="xml/gtkeditable.xml" /> </chapter> <chapter id="TextWidgetObjects"> <title>Multiline Text Editor</title> <xi:include href="xml/text_widget.sgml" /> <xi:include href="xml/gtktextiter.xml" /> <xi:include href="xml/gtktextmark.xml" /> <xi:include href="xml/gtktextbuffer.xml" /> <xi:include href="xml/gtktexttag.xml" /> <xi:include href="xml/gtktexttagtable.xml" /> <xi:include href="xml/gtktextview.xml" /> </chapter> <chapter id="TreeWidgetObjects"> <title>Tree, List and Icon Grid Widgets</title> <xi:include href="xml/tree_widget.sgml" /> <xi:include href="xml/gtktreemodel.xml" /> <xi:include href="xml/gtktreeselection.xml" /> <xi:include href="xml/gtktreeviewcolumn.xml" /> <xi:include href="xml/gtktreeview.xml" /> <xi:include href="xml/gtktreednd.xml" /> <xi:include href="xml/gtkcellview.xml" /> <xi:include href="xml/gtkiconview.xml" /> <xi:include href="xml/gtktreesortable.xml" /> <xi:include href="xml/gtktreemodelsort.xml" /> <xi:include href="xml/gtktreemodelfilter.xml" /> <xi:include href="xml/gtkcelllayout.xml" /> <xi:include href="xml/gtkcellarea.xml" /> <xi:include href="xml/gtkcellareabox.xml" /> <xi:include href="xml/gtkcellareacontext.xml" /> <xi:include href="xml/gtkcellrenderer.xml" /> <xi:include href="xml/gtkcelleditable.xml" /> <xi:include href="xml/gtkcellrendereraccel.xml" /> <xi:include href="xml/gtkcellrenderercombo.xml" /> <xi:include href="xml/gtkcellrendererpixbuf.xml" /> <xi:include href="xml/gtkcellrendererprogress.xml" /> <xi:include href="xml/gtkcellrendererspin.xml" /> <xi:include href="xml/gtkcellrenderertext.xml" /> <xi:include href="xml/gtkcellrenderertoggle.xml" /> <xi:include href="xml/gtkcellrendererspinner.xml" /> <xi:include href="xml/gtkliststore.xml" /> <xi:include href="xml/gtktreestore.xml" /> </chapter> <chapter id="MenusAndCombos"> <title>Menus, Combo Box, Toolbar</title> <xi:include href="xml/gtkcombobox.xml" /> <xi:include href="xml/gtkcomboboxtext.xml" /> <xi:include href="xml/gtkmenu.xml" /> <xi:include href="xml/gtkmenubar.xml" /> <xi:include href="xml/gtkmenuitem.xml" /> <xi:include href="xml/gtkradiomenuitem.xml" /> <xi:include href="xml/gtkcheckmenuitem.xml" /> <xi:include href="xml/gtkseparatormenuitem.xml" /> <xi:include href="xml/gtktoolshell.xml" /> <xi:include href="xml/gtktoolbar.xml" /> <xi:include href="xml/gtktoolitem.xml" /> <xi:include href="xml/gtktoolpalette.xml" /> <xi:include href="xml/gtktoolitemgroup.xml" /> <xi:include href="xml/gtkseparatortoolitem.xml" /> <xi:include href="xml/gtktoolbutton.xml" /> <xi:include href="xml/gtkmenutoolbutton.xml" /> <xi:include href="xml/gtktoggletoolbutton.xml" /> <xi:include href="xml/gtkradiotoolbutton.xml" /> <xi:include href="xml/gtkpopover.xml" /> <xi:include href="xml/gtkpopovermenu.xml" /> </chapter> <chapter id="SelectorWidgets"> <title>Selector Widgets and Dialogs</title> <xi:include href="xml/gtkcolorchooser.xml" /> <xi:include href="xml/gtkcolorbutton.xml" /> <xi:include href="xml/gtkcolorchooserwidget.xml" /> <xi:include href="xml/gtkcolorchooserdialog.xml" /> <xi:include href="xml/gtkfilechooser.xml" /> <xi:include href="xml/gtkfilechooserbutton.xml" /> <xi:include href="xml/gtkfilechooserdialog.xml" /> <xi:include href="xml/gtkfilechooserwidget.xml" /> <xi:include href="xml/gtkfilefilter.xml" /> <xi:include href="xml/gtkfontchooser.xml" /> <xi:include href="xml/gtkfontbutton.xml" /> <xi:include href="xml/gtkfontchooserwidget.xml" /> <xi:include href="xml/gtkfontchooserdialog.xml" /> <xi:include href="xml/gtkplacessidebar.xml" /> </chapter> <chapter id="Ornaments"> <title>Ornaments</title> <xi:include href="xml/gtkframe.xml" /> <xi:include href="xml/gtkseparator.xml" /> </chapter> <chapter id="ScrollingWidgets"> <title>Scrolling</title> <xi:include href="xml/gtkscrollbar.xml" /> <xi:include href="xml/gtkscrolledwindow.xml" /> <xi:include href="xml/gtkscrollable.xml" /> </chapter> <chapter id="Printing"> <title>Printing</title> <xi:include href="xml/gtkprintoperation.xml" /> <xi:include href="xml/gtkprintcontext.xml" /> <xi:include href="xml/gtkprintsettings.xml" /> <xi:include href="xml/gtkpagesetup.xml" /> <xi:include href="xml/gtkpapersize.xml" /> <xi:include href="xml/gtkprinter.xml" /> <xi:include href="xml/gtkprintjob.xml" /> <xi:include href="xml/gtkprintunixdialog.xml" /> <xi:include href="xml/gtkpagesetupunixdialog.xml" /> </chapter> <chapter id="MiscObjects"> <title>Miscellaneous</title> <xi:include href="xml/gtkadjustment.xml" /> <xi:include href="xml/gtkcalendar.xml" /> <xi:include href="xml/gtkdrawingarea.xml" /> <xi:include href="xml/gtkglarea.xml" /> <xi:include href="xml/gtkeventbox.xml" /> <xi:include href="xml/gtkhandlebox.xml" /> <xi:include href="xml/gtkimcontextsimple.xml" /> <xi:include href="xml/gtkimmulticontext.xml" /> <xi:include href="xml/gtksizegroup.xml" /> <xi:include href="xml/gtktooltip.xml" /> <xi:include href="xml/gtkviewport.xml" /> <xi:include href="xml/gtkaccessible.xml" /> </chapter> <chapter id="AbstractObjects"> <title>Abstract Base Classes</title> <xi:include href="xml/gtkwidget.xml" /> <xi:include href="xml/gtkcontainer.xml" /> <xi:include href="xml/gtkbin.xml" /> <xi:include href="xml/gtkmenushell.xml" /> <xi:include href="xml/gtkrange.xml" /> <xi:include href="xml/gtkimcontext.xml" /> </chapter> <chapter id="PlugSocket"> <title>Cross-process Embedding</title> <xi:include href="xml/gtkplug.xml" /> <xi:include href="xml/gtksocket.xml" /> </chapter> <chapter id="RecentDocuments"> <title>Recently Used Documents</title> <xi:include href="xml/gtkrecentmanager.xml" /> <xi:include href="xml/gtkrecentchooser.xml" /> <xi:include href="xml/gtkrecentchooserdialog.xml" /> <xi:include href="xml/gtkrecentchoosermenu.xml" /> <xi:include href="xml/gtkrecentchooserwidget.xml" /> <xi:include href="xml/gtkrecentfilter.xml" /> </chapter> <chapter id="ApplicationChoosing"> <title>Choosing from installed applications</title> <xi:include href="xml/gtkappchooser.xml" /> <xi:include href="xml/gtkappchooserbutton.xml" /> <xi:include href="xml/gtkappchooserdialog.xml" /> <xi:include href="xml/gtkappchooserwidget.xml" /> </chapter> <chapter id="Gestures"> <title>Gestures</title> <xi:include href="xml/gtkeventcontroller.xml" /> <xi:include href="xml/gtkgesture.xml" /> <xi:include href="xml/gtkgesturesingle.xml" /> <xi:include href="xml/gtkgesturedrag.xml" /> <xi:include href="xml/gtkgesturelongpress.xml" /> <xi:include href="xml/gtkgesturemultipress.xml" /> <xi:include href="xml/gtkgesturepan.xml" /> <xi:include href="xml/gtkgestureswipe.xml" /> <xi:include href="xml/gtkgesturerotate.xml" /> <xi:include href="xml/gtkgesturezoom.xml" /> </chapter> <chapter id="DeprecatedObjects"> <title>Deprecated</title> <xi:include href="xml/gtksymboliccolor.xml" /> <xi:include href="xml/gtkgradient.xml" /> <xi:include href="xml/gtkrc.xml" /> <xi:include href="xml/gtkstyle.xml" /> <xi:include href="xml/gtkhscale.xml" /> <xi:include href="xml/gtkvscale.xml" /> <xi:include href="xml/gtktearoffmenuitem.xml" /> <xi:include href="xml/gtkcolorsel.xml" /> <xi:include href="xml/gtkcolorseldlg.xml" /> <xi:include href="xml/gtkhsv.xml" /> <xi:include href="xml/gtkfontsel.xml" /> <xi:include href="xml/gtkfontseldlg.xml" /> <xi:include href="xml/gtkhbox.xml" /> <xi:include href="xml/gtkvbox.xml" /> <xi:include href="xml/gtkhbbox.xml" /> <xi:include href="xml/gtkvbbox.xml" /> <xi:include href="xml/gtkhpaned.xml" /> <xi:include href="xml/gtkvpaned.xml" /> <xi:include href="xml/gtktable.xml" /> <xi:include href="xml/gtkhseparator.xml" /> <xi:include href="xml/gtkvseparator.xml" /> <xi:include href="xml/gtkhscrollbar.xml" /> <xi:include href="xml/gtkvscrollbar.xml" /> <xi:include href="xml/gtkuimanager.xml" /> <xi:include href="xml/gtkactiongroup.xml" /> <xi:include href="xml/gtkaction.xml" /> <xi:include href="xml/gtktoggleaction.xml" /> <xi:include href="xml/gtkradioaction.xml" /> <xi:include href="xml/gtkrecentaction.xml" /> <xi:include href="xml/gtkactivatable.xml" /> <xi:include href="xml/gtkimagemenuitem.xml" /> <xi:include href="xml/gtkmisc.xml" /> <xi:include href="xml/gtkstock.xml" /> <xi:include href="xml/gtkiconfactory.xml" /> <xi:include href="xml/gtknumerableicon.xml" /> <xi:include href="xml/gtkarrow.xml" /> <xi:include href="xml/gtkstatusicon.xml" /> <xi:include href="xml/gtkthemingengine.xml" /> <xi:include href="xml/gtkalignment.xml" /> </chapter> </part> <part id="gtkbase"> <title>GTK+ Core Reference</title> <xi:include href="xml/gtkmain.xml" /> <xi:include href="xml/gtkfeatures.xml" /> <xi:include href="xml/gtkaccelgroup.xml" /> <xi:include href="xml/gtkaccelmap.xml" /> <xi:include href="xml/gtkclipboard.xml" /> <xi:include href="xml/gtkdnd.xml" /> <xi:include href="xml/gtksettings.xml" /> <xi:include href="xml/gtkbindings.xml" /> <xi:include href="xml/gtkenums.xml" /> <xi:include href="xml/gtkselection.xml" /> <xi:include href="xml/gtktesting.xml" /> <xi:include href="xml/filesystem.xml" /> </part> <part id="theming"> <title>Theming in GTK+</title> <xi:include href="xml/gtkstylecontext.xml" /> <xi:include href="xml/gtkcssprovider.xml" /> <xi:include href="xml/gtkstyleprovider.xml" /> <xi:include href="xml/gtkstyleproperties.xml" /> <xi:include href="xml/gtkwidgetpath.xml" /> <xi:include href="xml/gtkicontheme.xml" /> </part> <part id="migrating"> <title>Migrating from Previous Versions of GTK+</title> <partintro> <para> This part describes what you need to change in programs use older versions of GTK+ so that they can use the new features. It also mentions how to convert applications using widgets found in the libgnomeui library to use their counterparts in GTK+. </para> </partintro> <xi:include href="xml/migrating-2to3.xml" /> <xi:include href="xml/migrating-GtkStyleContext.xml" /> <xi:include href="xml/migrating-unique-GtkApplication.xml" /> <xi:include href="xml/migrating-smclient-GtkApplication.xml" /> <xi:include href="xml/migrating-GtkGrid.xml" /> <xi:include href="xml/migrating-checklist.sgml" /> </part> <part> <title>GTK+ Tools</title> <xi:include href="gtk3-demo.xml" /> <xi:include href="gtk3-demo-application.xml" /> <xi:include href="gtk3-widget-factory.xml" /> <xi:include href="gtk3-icon-browser.xml" /> <xi:include href="gtk-query-immodules-3.0.xml" /> <xi:include href="gtk-update-icon-cache.xml" /> <xi:include href="gtk-encode-symbolic-svg.xml" /> <xi:include href="gtk-launch.xml" /> <xi:include href="broadwayd.xml" /> </part> <part id="platform-support"> <title>GTK+ Platform Support</title> <xi:include href="building.sgml" /> <xi:include href="xml/compiling.sgml" /> <xi:include href="running.sgml" /> <xi:include href="x11.sgml" /> <xi:include href="windows.sgml" /> <xi:include href="osx.sgml" /> <xi:include href="broadway.xml" /> <xi:include href="wayland.xml" /> <xi:include href="mir.xml" /> </part> <xi:include href="glossary.xml" /> <index id="api-index-full"> <title>Index of all symbols</title> <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include> </index> <index id="api-index-deprecated" role="deprecated"> <title>Index of deprecated symbols</title> <xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include> </index> <index id="api-index-3-0" role="3.0"> <title>Index of new symbols in 3.0</title> <xi:include href="xml/api-index-3.0.xml"><xi:fallback /></xi:include> </index> <index id="api-index-3-2" role="3.2"> <title>Index of new symbols in 3.2</title> <xi:include href="xml/api-index-3.2.xml"><xi:fallback /></xi:include> </index> <index id="api-index-3-4" role="3.4"> <title>Index of new symbols in 3.4</title> <xi:include href="xml/api-index-3.4.xml"><xi:fallback /></xi:include> </index> <index id="api-index-3-6" role="3.6"> <title>Index of new symbols in 3.6</title> <xi:include href="xml/api-index-3.6.xml"><xi:fallback /></xi:include> </index> <index id="api-index-3-8" role="3.8"> <title>Index of new symbols in 3.8</title> <xi:include href="xml/api-index-3.8.xml"><xi:fallback /></xi:include> </index> <index id="api-index-3-10" role="3.10"> <title>Index of new symbols in 3.10</title> <xi:include href="xml/api-index-3.10.xml"><xi:fallback /></xi:include> </index> <index id="api-index-3-12" role="3.12"> <title>Index of new symbols in 3.12</title> <xi:include href="xml/api-index-3.12.xml"><xi:fallback /></xi:include> </index> <index id="api-index-3-14" role="3.14"> <title>Index of new symbols in 3.14</title> <xi:include href="xml/api-index-3.14.xml"><xi:fallback /></xi:include> </index> <index id="api-index-3-16" role="3.16"> <title>Index of new symbols in 3.16</title> <xi:include href="xml/api-index-3.16.xml"><xi:fallback /></xi:include> </index> <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include> </book>