forked from AuroraMiddleware/gtk
449 lines
18 KiB
XML
449 lines
18 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+ 4 Reference Manual</title>
|
|
<releaseinfo>
|
|
This document is for the GTK+ 4 library, version &version;.
|
|
The latest versions can be found online at
|
|
<ulink role="online-location" url="https://developer.gnome.org/gtk4/">https://developer.gnome.org/gtk4/</ulink>.
|
|
If you are looking for the older GTK+ 3 series of libraries,
|
|
see <ulink role="online-location" url="https://developer.gnome.org/gtk3/">https://developer.gnome.org/gtk3/</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="xml/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/gtkwindowgroup.xml" />
|
|
</chapter>
|
|
|
|
<chapter id="LayoutContainers">
|
|
<title>Layout Containers</title>
|
|
<xi:include href="xml/gtkbox.xml" />
|
|
<xi:include href="xml/gtkcenterbox.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/gtkstacksidebar.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/gtkfilechoosernative.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="ShortcutsOverview">
|
|
<title>Shortcuts Overview</title>
|
|
<xi:include href="xml/gtkshortcutswindow.xml" />
|
|
<xi:include href="xml/gtkshortcutssection.xml" />
|
|
<xi:include href="xml/gtkshortcutsgroup.xml" />
|
|
<xi:include href="xml/gtkshortcutsshortcut.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/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" />
|
|
<xi:include href="xml/gtksnapshot.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" />
|
|
<xi:include href="xml/gtknativedialog.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 and event handling</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" />
|
|
<xi:include href="xml/gtkpadcontroller.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="css-overview.xml" />
|
|
<xi:include href="css-properties.xml" />
|
|
<xi:include href="xml/gtkstylecontext.xml" />
|
|
<xi:include href="xml/gtkcssprovider.xml" />
|
|
<xi:include href="xml/gtkstyleprovider.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-2to4.xml" />
|
|
<xi:include href="xml/migrating-3to4.xml" />
|
|
</part>
|
|
|
|
<part>
|
|
<title>GTK+ Tools</title>
|
|
<xi:include href="gtk4-demo.xml" />
|
|
<xi:include href="gtk4-demo-application.xml" />
|
|
<xi:include href="gtk4-widget-factory.xml" />
|
|
<xi:include href="gtk4-icon-browser.xml" />
|
|
<xi:include href="gtk4-query-immodules.xml" />
|
|
<xi:include href="gtk4-update-icon-cache.xml" />
|
|
<xi:include href="gtk4-encode-symbolic-svg.xml" />
|
|
<xi:include href="gtk4-builder-tool.xml" />
|
|
<xi:include href="gtk4-launch.xml" />
|
|
<xi:include href="gtk4-query-settings.xml" />
|
|
<xi:include href="gtk4-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>
|
|
<index id="api-index-3-18" role="3.18">
|
|
<title>Index of new symbols in 3.18</title>
|
|
<xi:include href="xml/api-index-3.18.xml"><xi:fallback /></xi:include>
|
|
</index>
|
|
<index id="api-index-3-20" role="3.20">
|
|
<title>Index of new symbols in 3.20</title>
|
|
<xi:include href="xml/api-index-3.20.xml"><xi:fallback /></xi:include>
|
|
</index>
|
|
<index id="api-index-3-22" role="3.22">
|
|
<title>Index of new symbols in 3.22</title>
|
|
<xi:include href="xml/api-index-3.22.xml"><xi:fallback /></xi:include>
|
|
</index>
|
|
<index id="api-index-3-90" role="3.90">
|
|
<title>Index of new symbols in 3.90</title>
|
|
<xi:include href="xml/api-index-3.90.xml"><xi:fallback /></xi:include>
|
|
</index>
|
|
|
|
<xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
|
|
|
|
</book>
|