forked from AuroraMiddleware/gtk
22527e802c
I think it's confusing for a lot the developers out there who may not even be aware of GTK+ 3 coming, if suddenly GTK+ 3 becomes the "stable" version of "gtk" on library.gnome.org. It may not even be feasible for them to port to GTK+3 if it's not shipped in the operating systems they're targeting (for example, RHEL 6). Since practically speaking, we expect people to consume GTK+ 2 for several years at least, redirect these people to the right pages. (I didn't attempt to explain the differences between the libraries here, but hopefully the major version difference is enough of a hint) As a side effect, this makes the generated HTML look better; previously it looked rather crappy, since the "for GTK &version;" was totally offset and in a different group from the documentation title.
381 lines
15 KiB
XML
381 lines
15 KiB
XML
<?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 GTK+ 3 library; the latest version can be found online at
|
|
<ulink role="online-location" url="http://library.gnome.org/devel/gtk/unstable/">http://library.gnome.org/devel/gtk/unstable/</ulink>.
|
|
If you're looking for the older GTK+ 2 series of libraries, they can be found under their version numbers; for example, 2.22 is available at <ulink role="online-location" url="http://library.gnome.org/devel/gtk/2.22/">http://library.gnome.org/devel/gtk/2.22/</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="building.sgml" />
|
|
<xi:include href="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="resources.sgml" />
|
|
<xi:include href="xml/question_index.sgml" />
|
|
<xi:include href="drawing-model.xml" />
|
|
</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/gtkstock.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/gtkthemingengine.xml" />
|
|
<xi:include href="xml/gtkwidgetpath.xml" />
|
|
<xi:include href="xml/gtksymboliccolor.xml" />
|
|
<xi:include href="xml/gtkgradient.xml" />
|
|
<xi:include href="xml/gtkicontheme.xml" />
|
|
<xi:include href="xml/gtkiconfactory.xml" />
|
|
<xi:include href="xml/gtknumerableicon.xml" />
|
|
<xi:include href="xml/gtkrc.xml" />
|
|
<xi:include href="xml/gtkstyle.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="WindowWidgets">
|
|
<title>Windows</title>
|
|
<xi:include href="xml/gtkdialog.xml" />
|
|
<xi:include href="xml/gtkinvisible.xml" />
|
|
<xi:include href="xml/gtkmessagedialog.xml" />
|
|
<xi:include href="xml/gtkwindow.xml" />
|
|
<xi:include href="xml/gtkwindowgroup.xml" />
|
|
<xi:include href="xml/gtkaboutdialog.xml" />
|
|
<xi:include href="xml/gtkassistant.xml" />
|
|
<xi:include href="xml/gtkoffscreenwindow.xml" />
|
|
</chapter>
|
|
|
|
<chapter id="DisplayWidgets">
|
|
<title>Display Widgets</title>
|
|
<xi:include href="xml/gtkaccellabel.xml" />
|
|
<xi:include href="xml/gtkimage.xml" />
|
|
<xi:include href="xml/gtklabel.xml" />
|
|
<xi:include href="xml/gtkprogressbar.xml" />
|
|
<xi:include href="xml/gtkstatusbar.xml" />
|
|
<xi:include href="xml/gtkinfobar.xml" />
|
|
<xi:include href="xml/gtkstatusicon.xml" />
|
|
<xi:include href="xml/gtkspinner.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/gtkscalebutton.xml" />
|
|
<xi:include href="xml/gtkvolumebutton.xml" />
|
|
<xi:include href="xml/gtkswitch.xml" />
|
|
</chapter>
|
|
|
|
<chapter id="NumericEntry">
|
|
<title>Numeric/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/gtkhscale.xml" />
|
|
<xi:include href="xml/gtkvscale.xml" />
|
|
<xi:include href="xml/gtkspinbutton.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/gtkimagemenuitem.xml" />
|
|
<xi:include href="xml/gtkradiomenuitem.xml" />
|
|
<xi:include href="xml/gtkcheckmenuitem.xml" />
|
|
<xi:include href="xml/gtkseparatormenuitem.xml" />
|
|
<xi:include href="xml/gtktearoffmenuitem.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" />
|
|
</chapter>
|
|
|
|
<chapter id="Actions">
|
|
<title>Action-based menus and toolbars</title>
|
|
<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" />
|
|
</chapter>
|
|
|
|
<chapter id="SelectorWidgets">
|
|
<title>Selectors (Color/File/Font)</title>
|
|
<xi:include href="xml/gtkcolorbutton.xml" />
|
|
<xi:include href="xml/gtkcolorseldlg.xml" />
|
|
<xi:include href="xml/gtkcolorsel.xml" />
|
|
<xi:include href="xml/gtkhsv.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/gtkfontbutton.xml" />
|
|
<xi:include href="xml/gtkfontsel.xml" />
|
|
<xi:include href="xml/gtkfontseldlg.xml" />
|
|
</chapter>
|
|
|
|
<chapter id="LayoutContainers">
|
|
<title>Layout Containers</title>
|
|
<xi:include href="xml/gtkgrid.xml" />
|
|
<xi:include href="xml/gtkalignment.xml" />
|
|
<xi:include href="xml/gtkaspectframe.xml" />
|
|
<xi:include href="xml/gtkbox.xml" />
|
|
<xi:include href="xml/gtkhbox.xml" />
|
|
<xi:include href="xml/gtkvbox.xml" />
|
|
<xi:include href="xml/gtkbbox.xml" />
|
|
<xi:include href="xml/gtkhbbox.xml" />
|
|
<xi:include href="xml/gtkvbbox.xml" />
|
|
<xi:include href="xml/gtkfixed.xml" />
|
|
<xi:include href="xml/gtkpaned.xml" />
|
|
<xi:include href="xml/gtkhpaned.xml" />
|
|
<xi:include href="xml/gtkvpaned.xml" />
|
|
<xi:include href="xml/gtklayout.xml" />
|
|
<xi:include href="xml/gtknotebook.xml" />
|
|
<xi:include href="xml/gtktable.xml" />
|
|
<xi:include href="xml/gtkexpander.xml" />
|
|
<xi:include href="xml/gtkorientable.xml" />
|
|
</chapter>
|
|
|
|
<chapter id="Ornaments">
|
|
<title>Ornaments</title>
|
|
<xi:include href="xml/gtkframe.xml" />
|
|
<xi:include href="xml/gtkseparator.xml" />
|
|
<xi:include href="xml/gtkhseparator.xml" />
|
|
<xi:include href="xml/gtkvseparator.xml" />
|
|
</chapter>
|
|
|
|
<chapter id="ScrollingWidgets">
|
|
<title>Scrolling</title>
|
|
<xi:include href="xml/gtkscrollbar.xml" />
|
|
<xi:include href="xml/gtkhscrollbar.xml" />
|
|
<xi:include href="xml/gtkvscrollbar.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/gtkarrow.xml" />
|
|
<xi:include href="xml/gtkcalendar.xml" />
|
|
<xi:include href="xml/gtkdrawingarea.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/gtkmisc.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="Builder">
|
|
<title>Interface builder</title>
|
|
<xi:include href="xml/gtkbuildable.xml" />
|
|
<xi:include href="xml/gtkbuilder.xml" />
|
|
</chapter>
|
|
|
|
<chapter id="Application">
|
|
<title>Application support</title>
|
|
<xi:include href="xml/gtkapplication.xml" />
|
|
</chapter>
|
|
</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-checklist.sgml" />
|
|
<xi:include href="xml/migrating-2to3.xml" />
|
|
<xi:include href="xml/migrating-GtkApplication.xml" />
|
|
<xi:include href="xml/migrating-GtkStyleContext.xml" />
|
|
</part>
|
|
|
|
<part>
|
|
<title>GTK+ Tools</title>
|
|
<xi:include href="gtk-query-immodules-3.0.xml" />
|
|
<xi:include href="gtk-update-icon-cache.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>
|
|
|
|
<xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
|
|
|
|
</book>
|