]> Pileus Git - ~andy/gtk/blob - docs/reference/gtk/gtk-docs.sgml
Merge branch 'master' into open-with-dialog
[~andy/gtk] / docs / reference / gtk / gtk-docs.sgml
1 <?xml version="1.0"?>
2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3                "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
4 <!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
5 <!ENTITY version SYSTEM "version.xml">
6 ]>
7 <book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
8   <bookinfo>
9     <title>GTK+ Reference Manual</title>
10     <releaseinfo>
11       for GTK+ &version;
12       The latest version of this documentation can be found on-line at
13       <ulink role="online-location" url="http://library.gnome.org/devel/gtk/unstable/">http://library.gnome.org/devel/gtk/unstable/</ulink>.
14     </releaseinfo>
15   </bookinfo>
16
17   <part id="gtk">
18     <title>GTK+ Overview</title>
19     <xi:include href="overview.xml"/>
20     <xi:include href="xml/getting_started.xml"/>
21     <xi:include href="building.sgml" />
22     <xi:include href="compiling.sgml" />
23     <xi:include href="running.sgml" />
24     <xi:include href="x11.sgml" />
25     <xi:include href="windows.sgml" />
26     <xi:include href="osx.sgml" />
27     <xi:include href="resources.sgml" />
28     <xi:include href="xml/question_index.sgml" />
29     <xi:include href="drawing-model.xml" />
30   </part>
31
32
33   <part  id="gtkbase">
34     <title>GTK+ Core Reference</title>
35     <xi:include href="xml/gtkmain.xml" />
36     <xi:include href="xml/gtkfeatures.xml" />
37     <xi:include href="xml/gtkaccelgroup.xml" />
38     <xi:include href="xml/gtkaccelmap.xml" />
39     <xi:include href="xml/gtkclipboard.xml" />
40     <xi:include href="xml/gtkdnd.xml" />
41     <xi:include href="xml/gtkicontheme.xml" />
42     <xi:include href="xml/gtkstock.xml" />
43     <xi:include href="xml/gtkiconfactory.xml" />
44     <xi:include href="xml/gtkrc.xml" />
45     <xi:include href="xml/gtksettings.xml" />
46     <xi:include href="xml/gtkbindings.xml" />
47     <xi:include href="xml/gtkenums.xml" />
48     <xi:include href="xml/gtkstyle.xml" />
49     <xi:include href="xml/gtkselection.xml" />
50     <xi:include href="xml/gtktesting.xml" />
51     <xi:include href="xml/filesystem.xml" />
52   </part>
53
54   <part id="gtkobjects">
55     <title>GTK+ Widgets and Objects</title>
56
57     <chapter>
58       <title>Object Hierarchy</title>
59       <xi:include href="xml/tree_index.sgml" />
60     </chapter>
61
62     <chapter>
63       <title>Widget Gallery</title>
64       <xi:include href="visual_index.xml" />
65     </chapter>
66
67     <chapter id="WindowWidgets">
68       <title>Windows</title>
69       <xi:include href="xml/gtkdialog.xml" />
70       <xi:include href="xml/gtkinvisible.xml" />
71       <xi:include href="xml/gtkmessagedialog.xml" />
72       <xi:include href="xml/gtkwindow.xml" />
73       <xi:include href="xml/gtkwindowgroup.xml" />
74       <xi:include href="xml/gtkaboutdialog.xml" />
75       <xi:include href="xml/gtkassistant.xml" />
76       <xi:include href="xml/gtkoffscreenwindow.xml" />
77     </chapter>
78
79     <chapter id="DisplayWidgets">
80       <title>Display Widgets</title>
81       <xi:include href="xml/gtkaccellabel.xml" />
82       <xi:include href="xml/gtkimage.xml" />
83       <xi:include href="xml/gtklabel.xml" />
84       <xi:include href="xml/gtkprogressbar.xml" />
85       <xi:include href="xml/gtkstatusbar.xml" />
86       <xi:include href="xml/gtkinfobar.xml" />
87       <xi:include href="xml/gtkstatusicon.xml" />
88       <xi:include href="xml/gtkspinner.xml" />
89     </chapter>
90
91     <chapter id="ButtonWidgets">
92       <title>Buttons and Toggles</title>
93       <xi:include href="xml/gtkbutton.xml" />
94       <xi:include href="xml/gtkcheckbutton.xml" />
95       <xi:include href="xml/gtkradiobutton.xml" />
96       <xi:include href="xml/gtktogglebutton.xml" />
97       <xi:include href="xml/gtklinkbutton.xml" />
98       <xi:include href="xml/gtkscalebutton.xml" />
99       <xi:include href="xml/gtkvolumebutton.xml" />
100       <xi:include href="xml/gtkswitch.xml" />
101     </chapter>
102
103     <chapter id="NumericEntry">
104       <title>Numeric/Text Data Entry</title>
105       <xi:include href="xml/gtkentry.xml" />
106       <xi:include href="xml/gtkentrybuffer.xml" />
107       <xi:include href="xml/gtkentrycompletion.xml" />
108       <xi:include href="xml/gtkscale.xml" />
109       <xi:include href="xml/gtkhscale.xml" />
110       <xi:include href="xml/gtkvscale.xml" />
111       <xi:include href="xml/gtkspinbutton.xml" />
112       <xi:include href="xml/gtkeditable.xml" />
113     </chapter>
114
115     <chapter id="TextWidgetObjects">
116       <title>Multiline Text Editor</title>
117       <xi:include href="xml/text_widget.sgml" />
118       <xi:include href="xml/gtktextiter.xml" />
119       <xi:include href="xml/gtktextmark.xml" />
120       <xi:include href="xml/gtktextbuffer.xml" />
121       <xi:include href="xml/gtktexttag.xml" />
122       <xi:include href="xml/gtktexttagtable.xml" />
123       <xi:include href="xml/gtktextview.xml" />
124     </chapter>
125
126     <chapter id="TreeWidgetObjects">
127       <title>Tree, List and Icon Grid Widgets</title>
128       <xi:include href="xml/tree_widget.sgml" />
129       <xi:include href="xml/gtktreemodel.xml" />
130       <xi:include href="xml/gtktreeselection.xml" />
131       <xi:include href="xml/gtktreeviewcolumn.xml" />
132       <xi:include href="xml/gtktreeview.xml" />
133       <xi:include href="xml/gtktreednd.xml" />
134       <xi:include href="xml/gtkcellview.xml" />
135       <xi:include href="xml/gtkiconview.xml" />
136       <xi:include href="xml/gtktreesortable.xml" />
137       <xi:include href="xml/gtktreemodelsort.xml" />
138       <xi:include href="xml/gtktreemodelfilter.xml" />
139       <xi:include href="xml/gtkcelllayout.xml" />
140       <xi:include href="xml/gtkcellrenderer.xml" />
141       <xi:include href="xml/gtkcelleditable.xml" />
142       <xi:include href="xml/gtkcellrendereraccel.xml" />
143       <xi:include href="xml/gtkcellrenderercombo.xml" />
144       <xi:include href="xml/gtkcellrendererpixbuf.xml" />
145       <xi:include href="xml/gtkcellrendererprogress.xml" />
146       <xi:include href="xml/gtkcellrendererspin.xml" />
147       <xi:include href="xml/gtkcellrenderertext.xml" />
148       <xi:include href="xml/gtkcellrenderertoggle.xml" />
149       <xi:include href="xml/gtkcellrendererspinner.xml" />
150       <xi:include href="xml/gtkliststore.xml" />
151       <xi:include href="xml/gtktreestore.xml" />
152     </chapter>
153
154     <chapter id="MenusAndCombos">
155       <title>Menus, Combo Box, Toolbar</title>
156       <xi:include href="xml/gtkcombobox.xml" />
157       <xi:include href="xml/gtkcomboboxtext.xml" />
158       <xi:include href="xml/gtkmenu.xml" />
159       <xi:include href="xml/gtkmenubar.xml" />
160       <xi:include href="xml/gtkmenuitem.xml" />
161       <xi:include href="xml/gtkimagemenuitem.xml" />
162       <xi:include href="xml/gtkradiomenuitem.xml" />
163       <xi:include href="xml/gtkcheckmenuitem.xml" />
164       <xi:include href="xml/gtkseparatormenuitem.xml" />
165       <xi:include href="xml/gtktearoffmenuitem.xml" />
166       <xi:include href="xml/gtktoolshell.xml" />
167       <xi:include href="xml/gtktoolbar.xml" />
168       <xi:include href="xml/gtktoolitem.xml" />
169       <xi:include href="xml/gtktoolpalette.xml" />
170       <xi:include href="xml/gtktoolitemgroup.xml" />
171       <xi:include href="xml/gtkseparatortoolitem.xml" />
172       <xi:include href="xml/gtktoolbutton.xml" />
173       <xi:include href="xml/gtkmenutoolbutton.xml" />
174       <xi:include href="xml/gtktoggletoolbutton.xml" />
175       <xi:include href="xml/gtkradiotoolbutton.xml" />
176     </chapter>
177
178     <chapter id="Actions">
179       <title>Action-based menus and toolbars</title>
180       <xi:include href="xml/gtkuimanager.xml" />
181       <xi:include href="xml/gtkactiongroup.xml" />
182       <xi:include href="xml/gtkaction.xml" />
183       <xi:include href="xml/gtktoggleaction.xml" />
184       <xi:include href="xml/gtkradioaction.xml" />
185       <xi:include href="xml/gtkrecentaction.xml" />
186       <xi:include href="xml/gtkactivatable.xml" />
187     </chapter>
188
189     <chapter id="SelectorWidgets">
190       <title>Selectors (Color/File/Font)</title>
191       <xi:include href="xml/gtkcolorbutton.xml" />
192       <xi:include href="xml/gtkcolorseldlg.xml" />
193       <xi:include href="xml/gtkcolorsel.xml" />
194       <xi:include href="xml/gtkhsv.xml" />
195       <xi:include href="xml/gtkfilechooser.xml" />
196       <xi:include href="xml/gtkfilechooserbutton.xml" />
197       <xi:include href="xml/gtkfilechooserdialog.xml" />
198       <xi:include href="xml/gtkfilechooserwidget.xml" />
199       <xi:include href="xml/gtkfilefilter.xml" />
200       <xi:include href="xml/gtkfontbutton.xml" />
201       <xi:include href="xml/gtkfontsel.xml" />
202       <xi:include href="xml/gtkfontseldlg.xml" />
203       <xi:include href="xml/gtkopenwithdialog.xml" />
204     </chapter>
205     
206     <chapter id="LayoutContainers">
207       <title>Layout Containers</title>
208       <xi:include href="xml/gtkgrid.xml" />
209       <xi:include href="xml/gtkalignment.xml" />
210       <xi:include href="xml/gtkaspectframe.xml" />
211       <xi:include href="xml/gtkbox.xml" />
212       <xi:include href="xml/gtkhbox.xml" />
213       <xi:include href="xml/gtkvbox.xml" />
214       <xi:include href="xml/gtkbbox.xml" />
215       <xi:include href="xml/gtkhbbox.xml" />
216       <xi:include href="xml/gtkvbbox.xml" />
217       <xi:include href="xml/gtkfixed.xml" />
218       <xi:include href="xml/gtkpaned.xml" />
219       <xi:include href="xml/gtkhpaned.xml" />
220       <xi:include href="xml/gtkvpaned.xml" />
221       <xi:include href="xml/gtklayout.xml" />
222       <xi:include href="xml/gtknotebook.xml" />
223       <xi:include href="xml/gtktable.xml" />
224       <xi:include href="xml/gtkexpander.xml" />
225       <xi:include href="xml/gtkorientable.xml" />
226     </chapter>
227
228     <chapter id="Ornaments">
229       <title>Ornaments</title>
230       <xi:include href="xml/gtkframe.xml" />
231       <xi:include href="xml/gtkseparator.xml" />
232       <xi:include href="xml/gtkhseparator.xml" />
233       <xi:include href="xml/gtkvseparator.xml" />
234     </chapter>
235
236     <chapter id="ScrollingWidgets">
237       <title>Scrolling</title>
238       <xi:include href="xml/gtkscrollbar.xml" />
239       <xi:include href="xml/gtkhscrollbar.xml" />
240       <xi:include href="xml/gtkvscrollbar.xml" />
241       <xi:include href="xml/gtkscrolledwindow.xml" />
242       <xi:include href="xml/gtkscrollable.xml" />
243     </chapter>
244
245     <chapter id="Printing">
246       <title>Printing</title>
247       <xi:include href="xml/gtkprintoperation.xml" />
248       <xi:include href="xml/gtkprintcontext.xml" />
249       <xi:include href="xml/gtkprintsettings.xml" />
250       <xi:include href="xml/gtkpagesetup.xml" />
251       <xi:include href="xml/gtkpapersize.xml" />
252       <xi:include href="xml/gtkprinter.xml" />
253       <xi:include href="xml/gtkprintjob.xml" />
254       <xi:include href="xml/gtkprintunixdialog.xml" />
255       <xi:include href="xml/gtkpagesetupunixdialog.xml" />
256     </chapter>
257
258     <chapter id="MiscObjects">
259       <title>Miscellaneous</title>
260       <xi:include href="xml/gtkadjustment.xml" />
261       <xi:include href="xml/gtkarrow.xml" />
262       <xi:include href="xml/gtkcalendar.xml" />
263       <xi:include href="xml/gtkdrawingarea.xml" />
264       <xi:include href="xml/gtkeventbox.xml" />
265       <xi:include href="xml/gtkhandlebox.xml" />
266       <xi:include href="xml/gtkimcontextsimple.xml" />
267       <xi:include href="xml/gtkimmulticontext.xml" />
268       <xi:include href="xml/gtksizegroup.xml" />
269       <xi:include href="xml/gtktooltip.xml" />
270       <xi:include href="xml/gtkviewport.xml" />
271       <xi:include href="xml/gtkaccessible.xml" />
272     </chapter>
273
274     <chapter id="AbstractObjects">
275       <title>Abstract Base Classes</title>
276       <xi:include href="xml/gtkwidget.xml" />
277       <xi:include href="xml/gtkcontainer.xml" />
278       <xi:include href="xml/gtkbin.xml" />
279       <xi:include href="xml/gtkmenushell.xml" />
280       <xi:include href="xml/gtkmisc.xml" />
281       <xi:include href="xml/gtkrange.xml" />
282       <xi:include href="xml/gtkimcontext.xml" />
283     </chapter>
284
285     <chapter id="PlugSocket">
286       <title>Cross-process Embedding</title>
287       <xi:include href="xml/gtkplug.xml" />
288       <xi:include href="xml/gtksocket.xml" />
289     </chapter>
290
291     <chapter id="RecentDocuments">
292       <title>Recently Used Documents</title>
293       <xi:include href="xml/gtkrecentmanager.xml" />
294       <xi:include href="xml/gtkrecentchooser.xml" />
295       <xi:include href="xml/gtkrecentchooserdialog.xml" />
296       <xi:include href="xml/gtkrecentchoosermenu.xml" />
297       <xi:include href="xml/gtkrecentchooserwidget.xml" />
298       <xi:include href="xml/gtkrecentfilter.xml" />
299     </chapter>
300
301     <chapter id="Builder">
302       <title>Interface builder</title>
303       <xi:include href="xml/gtkbuildable.xml" />
304       <xi:include href="xml/gtkbuilder.xml" />
305     </chapter>
306
307     <chapter id="Application">
308       <title>Application support</title>
309       <xi:include href="xml/gtkapplication.xml" />
310     </chapter>
311   </part>
312
313   <part id="migrating">
314     <title>Migrating from Previous Versions of GTK+</title>
315
316     <partintro>
317       <para>
318         This part describes what you need to change in programs use
319         older versions of GTK+ so that they can use the new features.
320         It also mentions how to convert applications using widgets
321         found in the libgnomeui library to use their counterparts
322         in GTK+.
323       </para>
324     </partintro>
325
326     <xi:include href="xml/migrating-checklist.sgml" />
327     <xi:include href="xml/migrating-2to3.xml" />
328     <xi:include href="xml/migrating-GtkApplication.xml" />
329   </part>
330
331   <part>
332     <title>GTK+ Tools</title>
333     <xi:include href="gtk-query-immodules-3.0.xml" />
334     <xi:include href="gtk-update-icon-cache-3.0.xml" />
335     <xi:include href="gtk-builder-convert-3.0.xml" />
336   </part>
337
338   <xi:include href="glossary.xml" />
339
340   <index id="api-index-full">
341     <title>Index of all symbols</title>
342     <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
343   </index>
344   <index id="api-index-deprecated" role="deprecated">
345     <title>Index of deprecated symbols</title>
346     <xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
347   </index>
348   <index id="api-index-3-0" role="3.0">
349     <title>Index of new symbols in 3.0</title>
350     <xi:include href="xml/api-index-3.0.xml"><xi:fallback /></xi:include>
351   </index>
352
353   <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
354
355 </book>