~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/gtk-question-index.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2009-09-23 09:50:04 UTC
  • mfrom: (1.5.3 upstream)
  • mto: This revision was merged to the branch mainline in revision 129.
  • Revision ID: james.westby@ubuntu.com-20090923095004-e9xauadn4bjs5n7m
Tags: upstream-2.18.0
Import upstream version 2.18.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
85
85
<td valign="top" align="right"></td>
86
86
</tr></table></div>
87
87
<div class="refsect1" title="Questions and Answers">
88
 
<a name="id469613"></a><h2>Questions and Answers</h2>
 
88
<a name="id399000"></a><h2>Questions and Answers</h2>
89
89
<p>
90
90
This is an "index" of the reference manual organized by common "How do
91
91
I..." questions. If you aren't sure which documentation to read for
92
92
the question you have, this list is a good place to start.
93
93
</p>
94
94
<div class="qandaset" title="Frequently Asked Questions">
95
 
<a name="id407452"></a><table border="0" width="100%" summary="Q and A Set">
 
95
<a name="id418564"></a><table border="0" width="100%" summary="Q and A Set">
96
96
<col align="left" width="1%">
97
97
<col>
98
98
<tbody>
99
99
<tr class="qandadiv"><td align="left" valign="top" colspan="2"><h5 class="title">
100
 
<a name="id463895"></a>1. General</h5></td></tr>
 
100
<a name="id362664"></a>1. General</h5></td></tr>
101
101
<tr class="question" title="1.1.">
102
102
<td align="left" valign="top">
103
 
<a name="id472778"></a><a name="id437857"></a><p><b>1.1.</b></p>
 
103
<a name="id382958"></a><a name="id408660"></a><p><b>1.1.</b></p>
104
104
</td>
105
105
<td align="left" valign="top"><p>
106
106
How do I get started with GTK+?
120
120
</tr>
121
121
<tr class="question" title="1.2.">
122
122
<td align="left" valign="top">
123
 
<a name="id435363"></a><a name="id441659"></a><p><b>1.2.</b></p>
 
123
<a name="id388142"></a><a name="id387993"></a><p><b>1.2.</b></p>
124
124
</td>
125
125
<td align="left" valign="top"><p>
126
126
Where can I get help with GTK+, submit a bug report, or make a feature 
135
135
</tr>
136
136
<tr class="question" title="1.3.">
137
137
<td align="left" valign="top">
138
 
<a name="id455137"></a><a name="id452428"></a><p><b>1.3.</b></p>
 
138
<a name="id424258"></a><a name="id423626"></a><p><b>1.3.</b></p>
139
139
</td>
140
140
<td align="left" valign="top"><p>How do I port from one GTK+ 
141
141
version to another?</p></td>
160
160
</tr>
161
161
<tr class="question" title="1.4.">
162
162
<td align="left" valign="top">
163
 
<a name="id460436"></a><a name="id438317"></a><p><b>1.4.</b></p>
 
163
<a name="id414072"></a><a name="id396807"></a><p><b>1.4.</b></p>
164
164
</td>
165
165
<td align="left" valign="top"><p>
166
166
How does memory management work in GTK+? Should I free data returned
177
177
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
178
178
><span class="type">GObject</span></a> note 
179
179
specifically <a
180
 
href="/usr/share/gtk-doc/html/libmissioncontrol-server/libmissioncontrol-server-mcd-debug.html#g-object-ref"
 
180
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"
181
181
><code class="function">g_object_ref()</code></a> and <a
182
 
href="/usr/share/gtk-doc/html/libmissioncontrol-server/libmissioncontrol-server-mcd-debug.html#g-object-unref"
 
182
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"
183
183
><code class="function">g_object_unref()</code></a>. <a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> is a subclass 
184
184
of <a
185
185
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
200
200
</tr>
201
201
<tr class="question" title="1.5.">
202
202
<td align="left" valign="top">
203
 
<a name="id446265"></a><a name="id446268"></a><p><b>1.5.</b></p>
 
203
<a name="id424163"></a><a name="id424165"></a><p><b>1.5.</b></p>
204
204
</td>
205
205
<td align="left" valign="top"><p>
206
206
Why does my program leak memory, if I destroy a widget immediately 
252
252
</tr>
253
253
<tr class="question" title="1.6.">
254
254
<td align="left" valign="top">
255
 
<a name="id456685"></a><a name="id456687"></a><p><b>1.6.</b></p>
 
255
<a name="id402598"></a><a name="id402600"></a><p><b>1.6.</b></p>
256
256
</td>
257
257
<td align="left" valign="top"><p>
258
258
How do I use GTK+ with threads?
272
272
</tr>
273
273
<tr class="question" title="1.7.">
274
274
<td align="left" valign="top">
275
 
<a name="id456713"></a><a name="id456715"></a><p><b>1.7.</b></p>
 
275
<a name="id402626"></a><a name="id402629"></a><p><b>1.7.</b></p>
276
276
</td>
277
277
<td align="left" valign="top"><p>
278
278
How do I internationalize a GTK+ program?
377
377
</tr>
378
378
<tr class="question" title="1.8.">
379
379
<td align="left" valign="top">
380
 
<a name="id476684"></a><a name="id476686"></a><p><b>1.8.</b></p>
 
380
<a name="id425637"></a><a name="id425640"></a><p><b>1.8.</b></p>
381
381
</td>
382
382
<td align="left" valign="top"><p>
383
383
How do I use non-ASCII characters in GTK+ programs ?
510
510
</tr>
511
511
<tr class="question" title="1.9.">
512
512
<td align="left" valign="top">
513
 
<a name="id476886"></a><a name="id476888"></a><p><b>1.9.</b></p>
 
513
<a name="id425838"></a><a name="id425840"></a><p><b>1.9.</b></p>
514
514
</td>
515
515
<td align="left" valign="top"><p>
516
516
How do I use GTK+ with C++?
555
555
</tr>
556
556
<tr class="question" title="1.10.">
557
557
<td align="left" valign="top">
558
 
<a name="id476942"></a><a name="id476945"></a><p><b>1.10.</b></p>
 
558
<a name="id425894"></a><a name="id425896"></a><p><b>1.10.</b></p>
559
559
</td>
560
560
<td align="left" valign="top"><p>
561
561
How do I use GTK+ with other non-C languages?
570
570
</tr>
571
571
<tr class="question" title="1.11.">
572
572
<td align="left" valign="top">
573
 
<a name="id476970"></a><a name="id476973"></a><p><b>1.11.</b></p>
 
573
<a name="id425922"></a><a name="id425924"></a><p><b>1.11.</b></p>
574
574
</td>
575
575
<td align="left" valign="top"><p>
576
576
How do I load an image or animation from a file?
581
581
<td align="left" valign="top">
582
582
<p>
583
583
To load an image file straight into a display widget, use 
584
 
<a class="link" href="GtkImage.html#gtk-image-new-from-file" title="gtk_image_new_from_file ()"><code class="function">gtk_image_new_from_file()</code></a> <sup>[<a name="id476992" href="#ftn.id476992" class="footnote">1</a>]</sup>. 
 
584
<a class="link" href="GtkImage.html#gtk-image-new-from-file" title="gtk_image_new_from_file ()"><code class="function">gtk_image_new_from_file()</code></a> <sup>[<a name="id425943" href="#ftn.id425943" class="footnote">1</a>]</sup>. 
585
585
To load an image for another purpose, use <a
586
586
href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-file-loading.html#gdk-pixbuf-new-from-file"
587
587
><code class="function">gdk_pixbuf_new_from_file()</code></a>. To i
606
606
</tr>
607
607
<tr class="question" title="1.12.">
608
608
<td align="left" valign="top">
609
 
<a name="id477079"></a><a name="id477081"></a><p><b>1.12.</b></p>
 
609
<a name="id426030"></a><a name="id426032"></a><p><b>1.12.</b></p>
610
610
</td>
611
611
<td align="left" valign="top"><p>
612
612
How do I draw text ?
645
645
</tr>
646
646
<tr class="question" title="1.13.">
647
647
<td align="left" valign="top">
648
 
<a name="id477141"></a><a name="id477144"></a><p><b>1.13.</b></p>
 
648
<a name="id426093"></a><a name="id426095"></a><p><b>1.13.</b></p>
649
649
</td>
650
650
<td align="left" valign="top"><p>
651
651
How do I measure the size of a piece of text ?
682
682
</tr>
683
683
<tr class="question" title="1.14.">
684
684
<td align="left" valign="top">
685
 
<a name="id477200"></a><a name="id477203"></a><p><b>1.14.</b></p>
 
685
<a name="id426152"></a><a name="id426154"></a><p><b>1.14.</b></p>
686
686
</td>
687
687
<td align="left" valign="top"><p>
688
688
Why are types not registered if I use their <code class="literal">GTK_TYPE_BLAH</code> 
713
713
</tr>
714
714
<tr class="question" title="1.15.">
715
715
<td align="left" valign="top">
716
 
<a name="id477278"></a><a name="id477281"></a><p><b>1.15.</b></p>
 
716
<a name="id426230"></a><a name="id426232"></a><p><b>1.15.</b></p>
717
717
</td>
718
718
<td align="left" valign="top"><p>
719
719
How do I create a transparent toplevel window ?
762
762
</td>
763
763
</tr>
764
764
<tr class="qandadiv"><td align="left" valign="top" colspan="2"><h5 class="title">
765
 
<a name="id477362"></a>2. Which widget should I use...</h5></td></tr>
 
765
<a name="id426314"></a>2. Which widget should I use...</h5></td></tr>
766
766
<tr class="question" title="2.1.">
767
767
<td align="left" valign="top">
768
 
<a name="id477367"></a><a name="id477369"></a><p><b>2.1.</b></p>
 
768
<a name="id426318"></a><a name="id426321"></a><p><b>2.1.</b></p>
769
769
</td>
770
770
<td align="left" valign="top"><p>
771
771
...for lists and trees?
783
783
</tr>
784
784
<tr class="question" title="2.2.">
785
785
<td align="left" valign="top">
786
 
<a name="id477419"></a><a name="id477422"></a><p><b>2.2.</b></p>
 
786
<a name="id426371"></a><a name="id426373"></a><p><b>2.2.</b></p>
787
787
</td>
788
788
<td align="left" valign="top"><p>
789
789
...for multi-line text display or editing?
806
806
</tr>
807
807
<tr class="question" title="2.3.">
808
808
<td align="left" valign="top">
809
 
<a name="id477483"></a><a name="id477486"></a><p><b>2.3.</b></p>
 
809
<a name="id426435"></a><a name="id426437"></a><p><b>2.3.</b></p>
810
810
</td>
811
811
<td align="left" valign="top"><p>
812
812
...to display an image or animation?
822
822
</tr>
823
823
<tr class="question" title="2.4.">
824
824
<td align="left" valign="top">
825
 
<a name="id477515"></a><a name="id477517"></a><p><b>2.4.</b></p>
 
825
<a name="id426466"></a><a name="id426468"></a><p><b>2.4.</b></p>
826
826
</td>
827
827
<td align="left" valign="top"><p>
828
828
...for presenting a set of mutually-exclusive choices, where Windows
838
838
</p></td>
839
839
</tr>
840
840
<tr class="qandadiv"><td align="left" valign="top" colspan="2"><h5 class="title">
841
 
<a name="id477548"></a>3. GtkWidget</h5></td></tr>
 
841
<a name="id426500"></a>3. GtkWidget</h5></td></tr>
842
842
<tr class="question" title="3.1.">
843
843
<td align="left" valign="top">
844
 
<a name="id477553"></a><a name="id477555"></a><p><b>3.1.</b></p>
 
844
<a name="id426504"></a><a name="id426507"></a><p><b>3.1.</b></p>
845
845
</td>
846
846
<td align="left" valign="top"><p>
847
847
How do I change the color of a widget?
866
866
</tr>
867
867
<tr class="question" title="3.2.">
868
868
<td align="left" valign="top">
869
 
<a name="id477638"></a><a name="id477640"></a><p><b>3.2.</b></p>
 
869
<a name="id426589"></a><a name="id426592"></a><p><b>3.2.</b></p>
870
870
</td>
871
871
<td align="left" valign="top"><p>
872
872
How do I change the font of a widget?
918
918
</tr>
919
919
<tr class="question" title="3.3.">
920
920
<td align="left" valign="top">
921
 
<a name="id477728"></a><a name="id477730"></a><p><b>3.3.</b></p>
 
921
<a name="id426679"></a><a name="id426682"></a><p><b>3.3.</b></p>
922
922
</td>
923
923
<td align="left" valign="top"><p>
924
924
How do I disable/ghost/desensitize a widget?
931
931
</p></td>
932
932
</tr>
933
933
<tr class="qandadiv"><td align="left" valign="top" colspan="2"><h5 class="title">
934
 
<a name="id477752"></a>4. GtkTextView</h5></td></tr>
 
934
<a name="id426704"></a>4. GtkTextView</h5></td></tr>
935
935
<tr class="question" title="4.1.">
936
936
<td align="left" valign="top">
937
 
<a name="id477757"></a><a name="id477759"></a><p><b>4.1.</b></p>
 
937
<a name="id426708"></a><a name="id426711"></a><p><b>4.1.</b></p>
938
938
</td>
939
939
<td align="left" valign="top"><p>
940
940
How do I get the contents of the entire text widget as a string?
966
966
</tr>
967
967
<tr class="question" title="4.2.">
968
968
<td align="left" valign="top">
969
 
<a name="id477812"></a><a name="id477815"></a><p><b>4.2.</b></p>
 
969
<a name="id426764"></a><a name="id426766"></a><p><b>4.2.</b></p>
970
970
</td>
971
971
<td align="left" valign="top"><p>
972
972
How do I make a text widget display its complete contents in a specific font?
989
989
</tr>
990
990
<tr class="question" title="4.3.">
991
991
<td align="left" valign="top">
992
 
<a name="id477851"></a><a name="id477853"></a><p><b>4.3.</b></p>
 
992
<a name="id426802"></a><a name="id426804"></a><p><b>4.3.</b></p>
993
993
</td>
994
994
<td align="left" valign="top"><p>
995
995
How do I make a text view scroll to the end of the buffer automatically ?
1016
1016
</td>
1017
1017
</tr>
1018
1018
<tr class="qandadiv"><td align="left" valign="top" colspan="2"><h5 class="title">
1019
 
<a name="id477900"></a>5. <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a>
 
1019
<a name="id426851"></a>5. <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a>
1020
1020
</h5></td></tr>
1021
1021
<tr class="question" title="5.1.">
1022
1022
<td align="left" valign="top">
1023
 
<a name="id477909"></a><a name="id477912"></a><p><b>5.1.</b></p>
 
1023
<a name="id426861"></a><a name="id426863"></a><p><b>5.1.</b></p>
1024
1024
</td>
1025
1025
<td align="left" valign="top"><p>
1026
1026
How do I associate some data with a row in the tree?
1037
1037
</tr>
1038
1038
<tr class="question" title="5.2.">
1039
1039
<td align="left" valign="top">
1040
 
<a name="id477948"></a><a name="id477951"></a><p><b>5.2.</b></p>
 
1040
<a name="id426900"></a><a name="id426902"></a><p><b>5.2.</b></p>
1041
1041
</td>
1042
1042
<td align="left" valign="top"><p>
1043
1043
What's the <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> equivalent of <a class="link" href="GtkCList.html#gtk-clist-find-row-from-data" title="gtk_clist_find_row_from_data ()"><code class="function">gtk_clist_find_row_from_data()</code></a>?
1054
1054
</tr>
1055
1055
<tr class="question" title="5.3.">
1056
1056
<td align="left" valign="top">
1057
 
<a name="id477998"></a><a name="id478001"></a><p><b>5.3.</b></p>
 
1057
<a name="id426950"></a><a name="id426952"></a><p><b>5.3.</b></p>
1058
1058
</td>
1059
1059
<td align="left" valign="top"><p>
1060
1060
How do I put an image and some text in the same column?
1071
1071
</tr>
1072
1072
<tr class="question" title="5.4.">
1073
1073
<td align="left" valign="top">
1074
 
<a name="id478062"></a><a name="id478065"></a><p><b>5.4.</b></p>
 
1074
<a name="id427014"></a><a name="id427016"></a><p><b>5.4.</b></p>
1075
1075
</td>
1076
1076
<td align="left" valign="top"><p>
1077
1077
I can set data easily on my <a class="link" href="GtkTreeStore.html" title="GtkTreeStore"><span class="type">GtkTreeStore</span></a>/<a class="link" href="GtkListStore.html" title="GtkListStore"><span class="type">GtkListStore</span></a> models using 
1089
1089
</tr>
1090
1090
<tr class="question" title="5.5.">
1091
1091
<td align="left" valign="top">
1092
 
<a name="id478143"></a><a name="id478145"></a><p><b>5.5.</b></p>
 
1092
<a name="id427094"></a><a name="id427097"></a><p><b>5.5.</b></p>
1093
1093
</td>
1094
1094
<td align="left" valign="top"><p>
1095
1095
How do I change the way that numbers are formatted by <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a>?
1180
1180
</tr>
1181
1181
<tr class="question" title="5.6.">
1182
1182
<td align="left" valign="top">
1183
 
<a name="id478227"></a><a name="id478229"></a><p><b>5.6.</b></p>
 
1183
<a name="id427178"></a><a name="id427181"></a><p><b>5.6.</b></p>
1184
1184
</td>
1185
1185
<td align="left" valign="top"><p>
1186
1186
How do I hide the expander arrows in my tree view ?
1194
1194
</p></td>
1195
1195
</tr>
1196
1196
<tr class="qandadiv"><td align="left" valign="top" colspan="2"><h5 class="title">
1197
 
<a name="id478261"></a>6. Using cairo with GTK+</h5></td></tr>
 
1197
<a name="id427213"></a>6. Using cairo with GTK+</h5></td></tr>
1198
1198
<tr class="question" title="6.1.">
1199
1199
<td align="left" valign="top">
1200
 
<a name="id478266"></a><a name="id478268"></a><p><b>6.1.</b></p>
 
1200
<a name="id427217"></a><a name="id427220"></a><p><b>6.1.</b></p>
1201
1201
</td>
1202
1202
<td align="left" valign="top"><p>
1203
1203
How do I use cairo to draw in GTK+ applications ?
1217
1217
</tr>
1218
1218
<tr class="question" title="6.2.">
1219
1219
<td align="left" valign="top">
1220
 
<a name="id478295"></a><a name="id478297"></a><p><b>6.2.</b></p>
 
1220
<a name="id427246"></a><a name="id427249"></a><p><b>6.2.</b></p>
1221
1221
</td>
1222
1222
<td align="left" valign="top"><p>
1223
1223
I have created a cairo context with <a
1259
1259
</tr>
1260
1260
<tr class="question" title="6.3.">
1261
1261
<td align="left" valign="top">
1262
 
<a name="id478362"></a><a name="id478364"></a><p><b>6.3.</b></p>
 
1262
<a name="id427313"></a><a name="id427316"></a><p><b>6.3.</b></p>
1263
1263
</td>
1264
1264
<td align="left" valign="top"><p>
1265
1265
Can I improve the performance of my application by using the
1279
1279
</tr>
1280
1280
<tr class="question" title="6.4.">
1281
1281
<td align="left" valign="top">
1282
 
<a name="id478378"></a><a name="id478381"></a><p><b>6.4.</b></p>
 
1282
<a name="id427330"></a><a name="id427332"></a><p><b>6.4.</b></p>
1283
1283
</td>
1284
1284
<td align="left" valign="top"><p>
1285
1285
Can I use cairo to draw on a <a
1300
1300
</div>
1301
1301
<div class="footnotes">
1302
1302
<br><hr width="100" align="left">
1303
 
<div class="footnote"><p><sup>[<a name="ftn.id476992" href="#id476992" class="para">1</a>] </sup> If the file load fails, 
 
1303
<div class="footnote"><p><sup>[<a name="ftn.id425943" href="#id425943" class="para">1</a>] </sup> If the file load fails, 
1304
1304
<a class="link" href="GtkImage.html#gtk-image-new-from-file" title="gtk_image_new_from_file ()"><code class="function">gtk_image_new_from_file()</code></a> will display no image graphic — to detect 
1305
1305
a failed load yourself, use <a
1306
1306
href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-file-loading.html#gdk-pixbuf-new-from-file"