« back to all changes in this revision
Viewing changes to doc/html/gladexml.html
- browse files at revision 1
- compare with another revision
- download diff
- download tarball
- view history from revision 1
- Committer: Bazaar Package Importer
- Author(s): Christian Marillat
- Date: 2002-03-30 22:55:37 UTC
- Revision ID: james.westby@ubuntu.com-20020330225537-jx47zcil1ybgy9qx
Tags: upstream-1.99.10
Import upstream version 1.99.10
- files added:
- doc
- doc/html
- doc/sgml
- doc/tmpl
- examples
- glade
- tests
added
removed
doc/html/gladexml.html
1
<HTML
2
><HEAD
3
><TITLE
4
>GladeXML</TITLE
5
><META
6
NAME="GENERATOR"
7
CONTENT="Modular DocBook HTML Stylesheet Version 1.74b"><LINK
8
REL="HOME"
9
TITLE="Libglade Reference Manual"
10
HREF="libglade.html"><LINK
11
REL="UP"
12
TITLE="Libglade Library Reference"
13
HREF="libglade-lib.html"><LINK
14
REL="PREVIOUS"
15
TITLE="Libglade Initialisation"
16
HREF="libglade-libglade-initialisation.html"><LINK
17
REL="NEXT"
18
TITLE="Libglade SAX Parser"
19
HREF="libglade-libglade-sax-parser.html"></HEAD
20
><BODY
21
CLASS="REFENTRY"
22
BGCOLOR="#FFFFFF"
23
TEXT="#000000"
24
LINK="#0000FF"
25
VLINK="#840084"
26
ALINK="#0000FF"
27
><DIV
28
CLASS="NAVHEADER"
29
><TABLE
30
WIDTH="100%"
31
BORDER="0"
32
BGCOLOR="#000000"
33
CELLPADDING="1"
34
CELLSPACING="0"
35
><TR
36
><TH
37
COLSPAN="4"
38
ALIGN="center"
39
><FONT
40
COLOR="#FFFFFF"
41
SIZE="5"
42
>Libglade Reference Manual</FONT
43
></TH
44
></TR
45
><TR
46
><TD
47
WIDTH="25%"
48
BGCOLOR="#C00000"
49
ALIGN="left"
50
><A
51
HREF="libglade-libglade-initialisation.html"
52
><FONT
53
COLOR="#FFFFFF"
54
SIZE="3"
55
><B
56
><<< Previous Page</B
57
></FONT
58
></A
59
></TD
60
><TD
61
WIDTH="25%"
62
BGCOLOR="#0000C0"
63
ALIGN="center"
64
><FONT
65
COLOR="#FFFFFF"
66
SIZE="3"
67
><B
68
><A
69
HREF="libglade.html"
70
><FONT
71
COLOR="#FFFFFF"
72
SIZE="3"
73
><B
74
>Home</B
75
></FONT
76
></A
77
></B
78
></FONT
79
></TD
80
><TD
81
WIDTH="25%"
82
BGCOLOR="#00C000"
83
ALIGN="center"
84
><FONT
85
COLOR="#FFFFFF"
86
SIZE="3"
87
><B
88
><A
89
HREF="libglade-lib.html"
90
><FONT
91
COLOR="#FFFFFF"
92
SIZE="3"
93
><B
94
>Up</B
95
></FONT
96
></A
97
></B
98
></FONT
99
></TD
100
><TD
101
WIDTH="25%"
102
BGCOLOR="#C00000"
103
ALIGN="right"
104
><A
105
HREF="libglade-libglade-sax-parser.html"
106
><FONT
107
COLOR="#FFFFFF"
108
SIZE="3"
109
><B
110
>Next Page >>></B
111
></FONT
112
></A
113
></TD
114
></TR
115
></TABLE
116
></DIV
117
><H1
118
><A
119
NAME="GLADEXML"
120
>GladeXML</A
121
></H1
122
><DIV
123
CLASS="REFNAMEDIV"
124
><A
125
NAME="AEN176"
126
></A
127
><H2
128
>Name</H2
129
>GladeXML -- Allows dynamic loading of user interfaces from XML descriptions.</DIV
130
><DIV
131
CLASS="REFSYNOPSISDIV"
132
><A
133
NAME="AEN179"
134
></A
135
><H2
136
>Synopsis</H2
137
><TABLE
138
BORDER="0"
139
BGCOLOR="#D6E8FF"
140
WIDTH="100%"
141
CELLPADDING="6"
142
><TR
143
><TD
144
><PRE
145
CLASS="SYNOPSIS"
146
> #include <glade/glade-xml.h>
147
148
149
struct <A
150
HREF="gladexml.html#GLADEXML-STRUCT"
151
>GladeXML</A
152
>;
153
struct <A
154
HREF="gladexml.html#GLADEXMLCLASS"
155
>GladeXMLClass</A
156
>;
157
<A
158
HREF="gladexml.html"
159
>GladeXML</A
160
>* <A
161
HREF="gladexml.html#GLADE-XML-NEW"
162
>glade_xml_new</A
163
> (const char *fname,
164
const char *root,
165
const char *domain);
166
<A
167
HREF="gladexml.html"
168
>GladeXML</A
169
>* <A
170
HREF="gladexml.html#GLADE-XML-NEW-FROM-BUFFER"
171
>glade_xml_new_from_buffer</A
172
> (const char *buffer,
173
int size,
174
const char *root,
175
const char *domain);
176
<GTKDOCLINK
177
HREF="GBOOLEAN"
178
>gboolean</GTKDOCLINK
179
> <A
180
HREF="gladexml.html#GLADE-XML-CONSTRUCT"
181
>glade_xml_construct</A
182
> (<A
183
HREF="gladexml.html"
184
>GladeXML</A
185
> *self,
186
const char *fname,
187
const char *root,
188
const char *domain);
189
190
void <A
191
HREF="gladexml.html#GLADE-XML-SIGNAL-CONNECT"
192
>glade_xml_signal_connect</A
193
> (<A
194
HREF="gladexml.html"
195
>GladeXML</A
196
> *self,
197
const char *handlername,
198
<GTKDOCLINK
199
HREF="GCALLBACK"
200
>GCallback</GTKDOCLINK
201
> func);
202
void <A
203
HREF="gladexml.html#GLADE-XML-SIGNAL-CONNECT-DATA"
204
>glade_xml_signal_connect_data</A
205
> (<A
206
HREF="gladexml.html"
207
>GladeXML</A
208
> *self,
209
const char *handlername,
210
<GTKDOCLINK
211
HREF="GCALLBACK"
212
>GCallback</GTKDOCLINK
213
> func,
214
<GTKDOCLINK
215
HREF="GPOINTER"
216
>gpointer</GTKDOCLINK
217
> user_data);
218
void <A
219
HREF="gladexml.html#GLADE-XML-SIGNAL-AUTOCONNECT"
220
>glade_xml_signal_autoconnect</A
221
> (<A
222
HREF="gladexml.html"
223
>GladeXML</A
224
> *self);
225
226
<GTKDOCLINK
227
HREF="GTKWIDGET"
228
>GtkWidget</GTKDOCLINK
229
>* <A
230
HREF="gladexml.html#GLADE-XML-GET-WIDGET"
231
>glade_xml_get_widget</A
232
> (<A
233
HREF="gladexml.html"
234
>GladeXML</A
235
> *self,
236
const char *name);
237
<GTKDOCLINK
238
HREF="GLIST"
239
>GList</GTKDOCLINK
240
>* <A
241
HREF="gladexml.html#GLADE-XML-GET-WIDGET-PREFIX"
242
>glade_xml_get_widget_prefix</A
243
> (<A
244
HREF="gladexml.html"
245
>GladeXML</A
246
> *self,
247
const char *name);
248
const char* <A
249
HREF="gladexml.html#GLADE-GET-WIDGET-NAME"
250
>glade_get_widget_name</A
251
> (<GTKDOCLINK
252
HREF="GTKWIDGET"
253
>GtkWidget</GTKDOCLINK
254
> *widget);
255
<A
256
HREF="gladexml.html"
257
>GladeXML</A
258
>* <A
259
HREF="gladexml.html#GLADE-GET-WIDGET-TREE"
260
>glade_get_widget_tree</A
261
> (<GTKDOCLINK
262
HREF="GTKWIDGET"
263
>GtkWidget</GTKDOCLINK
264
> *widget);
265
266
void (<A
267
HREF="gladexml.html#GLADEXMLCONNECTFUNC"
268
>*GladeXMLConnectFunc</A
269
>) (const <GTKDOCLINK
270
HREF="GCHAR"
271
>gchar</GTKDOCLINK
272
> *handler_name,
273
<GTKDOCLINK
274
HREF="GOBJECT"
275
>GObject</GTKDOCLINK
276
> *object,
277
const <GTKDOCLINK
278
HREF="GCHAR"
279
>gchar</GTKDOCLINK
280
> *signal_name,
281
const <GTKDOCLINK
282
HREF="GCHAR"
283
>gchar</GTKDOCLINK
284
> *signal_data,
285
<GTKDOCLINK
286
HREF="GOBJECT"
287
>GObject</GTKDOCLINK
288
> *connect_object,
289
<GTKDOCLINK
290
HREF="GBOOLEAN"
291
>gboolean</GTKDOCLINK
292
> after,
293
<GTKDOCLINK
294
HREF="GPOINTER"
295
>gpointer</GTKDOCLINK
296
> user_data);
297
void <A
298
HREF="gladexml.html#GLADE-XML-SIGNAL-CONNECT-FULL"
299
>glade_xml_signal_connect_full</A
300
> (<A
301
HREF="gladexml.html"
302
>GladeXML</A
303
> *self,
304
const <GTKDOCLINK
305
HREF="GCHAR"
306
>gchar</GTKDOCLINK
307
> *handler_name,
308
<A
309
HREF="gladexml.html#GLADEXMLCONNECTFUNC"
310
>GladeXMLConnectFunc</A
311
> func,
312
<GTKDOCLINK
313
HREF="GPOINTER"
314
>gpointer</GTKDOCLINK
315
> user_data);
316
void <A
317
HREF="gladexml.html#GLADE-XML-SIGNAL-AUTOCONNECT-FULL"
318
>glade_xml_signal_autoconnect_full</A
319
>
320
(<A
321
HREF="gladexml.html"
322
>GladeXML</A
323
> *self,
324
<A
325
HREF="gladexml.html#GLADEXMLCONNECTFUNC"
326
>GladeXMLConnectFunc</A
327
> func,
328
<GTKDOCLINK
329
HREF="GPOINTER"
330
>gpointer</GTKDOCLINK
331
> user_data);
332
<GTKDOCLINK
333
HREF="GTKWIDGET"
334
>GtkWidget</GTKDOCLINK
335
>* (<A
336
HREF="gladexml.html#GLADEXMLCUSTOMWIDGETHANDLER"
337
>*GladeXMLCustomWidgetHandler</A
338
>) (<A
339
HREF="gladexml.html"
340
>GladeXML</A
341
> *xml,
342
<GTKDOCLINK
343
HREF="GCHAR"
344
>gchar</GTKDOCLINK
345
> *func_name,
346
<GTKDOCLINK
347
HREF="GCHAR"
348
>gchar</GTKDOCLINK
349
> *name,
350
<GTKDOCLINK
351
HREF="GCHAR"
352
>gchar</GTKDOCLINK
353
> *string1,
354
<GTKDOCLINK
355
HREF="GCHAR"
356
>gchar</GTKDOCLINK
357
> *string2,
358
<GTKDOCLINK
359
HREF="GINT"
360
>gint</GTKDOCLINK
361
> int1,
362
<GTKDOCLINK
363
HREF="GINT"
364
>gint</GTKDOCLINK
365
> int2,
366
<GTKDOCLINK
367
HREF="GPOINTER"
368
>gpointer</GTKDOCLINK
369
> user_data);
370
void <A
371
HREF="gladexml.html#GLADE-SET-CUSTOM-HANDLER"
372
>glade_set_custom_handler</A
373
> (<A
374
HREF="gladexml.html#GLADEXMLCUSTOMWIDGETHANDLER"
375
>GladeXMLCustomWidgetHandler</A
376
> handler,
377
<GTKDOCLINK
378
HREF="GPOINTER"
379
>gpointer</GTKDOCLINK
380
> user_data);
381
</PRE
382
></TD
383
></TR
384
></TABLE
385
></DIV
386
><DIV
387
CLASS="REFSECT1"
388
><A
389
NAME="AEN241"
390
></A
391
><H2
392
>Object Hierarchy</H2
393
><TABLE
394
BORDER="0"
395
BGCOLOR="#D6E8FF"
396
WIDTH="100%"
397
CELLPADDING="6"
398
><TR
399
><TD
400
><PRE
401
CLASS="SYNOPSIS"
402
> <GTKDOCLINK
403
HREF="GOBJECT"
404
>GObject</GTKDOCLINK
405
>
406
+----GladeXML</PRE
407
></TD
408
></TR
409
></TABLE
410
></DIV
411
><DIV
412
CLASS="REFSECT1"
413
><A
414
NAME="AEN245"
415
></A
416
><H2
417
>Description</H2
418
><P
419
>This object represents an `instantiation' of an XML interface description.
420
When one of these objects is created, the XML file is read, and the
421
interface is created. The GladeXML object then provides an interface for
422
accessing the widgets in the interface by the names assigned to them
423
inside the XML description.</P
424
><P
425
>The GladeXML object can also be used to connect handlers to the named
426
signals in the description. Libglade also provides an interface by which
427
it can look up the signal handler names in the program's symbol table and
428
automatically connect as many handlers up as it can that way.</P
429
></DIV
430
><DIV
431
CLASS="REFSECT1"
432
><A
433
NAME="AEN249"
434
></A
435
><H2
436
>Details</H2
437
><DIV
438
CLASS="REFSECT2"
439
><A
440
NAME="AEN251"
441
></A
442
><H3
443
><A
444
NAME="GLADEXML-STRUCT"
445
></A
446
>struct GladeXML</H3
447
><TABLE
448
BORDER="0"
449
BGCOLOR="#D6E8FF"
450
WIDTH="100%"
451
CELLPADDING="6"
452
><TR
453
><TD
454
><PRE
455
CLASS="PROGRAMLISTING"
456
>struct GladeXML {
457
GObject parent;
458
459
char *filename;
460
461
};</PRE
462
></TD
463
></TR
464
></TABLE
465
><P
466
></P
467
></DIV
468
><HR><DIV
469
CLASS="REFSECT2"
470
><A
471
NAME="AEN256"
472
></A
473
><H3
474
><A
475
NAME="GLADEXMLCLASS"
476
></A
477
>struct GladeXMLClass</H3
478
><TABLE
479
BORDER="0"
480
BGCOLOR="#D6E8FF"
481
WIDTH="100%"
482
CELLPADDING="6"
483
><TR
484
><TD
485
><PRE
486
CLASS="PROGRAMLISTING"
487
>struct GladeXMLClass;</PRE
488
></TD
489
></TR
490
></TABLE
491
><P
492
></P
493
></DIV
494
><HR><DIV
495
CLASS="REFSECT2"
496
><A
497
NAME="AEN261"
498
></A
499
><H3
500
><A
501
NAME="GLADE-XML-NEW"
502
></A
503
>glade_xml_new ()</H3
504
><TABLE
505
BORDER="0"
506
BGCOLOR="#D6E8FF"
507
WIDTH="100%"
508
CELLPADDING="6"
509
><TR
510
><TD
511
><PRE
512
CLASS="PROGRAMLISTING"
513
><A
514
HREF="gladexml.html"
515
>GladeXML</A
516
>* glade_xml_new (const char *fname,
517
const char *root,
518
const char *domain);</PRE
519
></TD
520
></TR
521
></TABLE
522
><P
523
>Creates a new GladeXML object (and the corresponding widgets) from the
524
XML file <TT
525
CLASS="PARAMETER"
526
><I
527
>fname</I
528
></TT
529
>. Optionally it will only build the interface from the
530
widget node <TT
531
CLASS="PARAMETER"
532
><I
533
>root</I
534
></TT
535
> (if it is not <TT
536
CLASS="LITERAL"
537
>NULL</TT
538
>). This feature is useful if you
539
only want to build say a toolbar or menu from the XML file, but not the
540
window it is embedded in. Note also that the XML parse tree is cached
541
to speed up creating another GladeXML object for the same file</P
542
><P
543
></P
544
><DIV
545
CLASS="INFORMALTABLE"
546
><A
547
NAME="AEN271"
548
></A
549
><P
550
></P
551
><TABLE
552
BORDER="0"
553
WIDTH="100%"
554
BGCOLOR="#FFD0D0"
555
CELLSPACING="0"
556
CELLPADDING="4"
557
CLASS="CALSTABLE"
558
><TBODY
559
><TR
560
><TD
561
WIDTH="20%"
562
ALIGN="RIGHT"
563
VALIGN="TOP"
564
><TT
565
CLASS="PARAMETER"
566
><I
567
>fname</I
568
></TT
569
> :</TD
570
><TD
571
WIDTH="80%"
572
ALIGN="LEFT"
573
VALIGN="TOP"
574
> the XML file name.</TD
575
></TR
576
><TR
577
><TD
578
WIDTH="20%"
579
ALIGN="RIGHT"
580
VALIGN="TOP"
581
><TT
582
CLASS="PARAMETER"
583
><I
584
>root</I
585
></TT
586
> :</TD
587
><TD
588
WIDTH="80%"
589
ALIGN="LEFT"
590
VALIGN="TOP"
591
> the widget node in <TT
592
CLASS="PARAMETER"
593
><I
594
>fname</I
595
></TT
596
> to start building from (or <TT
597
CLASS="LITERAL"
598
>NULL</TT
599
>)</TD
600
></TR
601
><TR
602
><TD
603
WIDTH="20%"
604
ALIGN="RIGHT"
605
VALIGN="TOP"
606
><TT
607
CLASS="PARAMETER"
608
><I
609
>domain</I
610
></TT
611
> :</TD
612
><TD
613
WIDTH="80%"
614
ALIGN="LEFT"
615
VALIGN="TOP"
616
> the translation domain for the XML file (or <TT
617
CLASS="LITERAL"
618
>NULL</TT
619
> for default)</TD
620
></TR
621
><TR
622
><TD
623
WIDTH="20%"
624
ALIGN="RIGHT"
625
VALIGN="TOP"
626
><SPAN
627
CLASS="emphasis"
628
><I
629
CLASS="EMPHASIS"
630
>Returns</I
631
></SPAN
632
> :</TD
633
><TD
634
WIDTH="80%"
635
ALIGN="LEFT"
636
VALIGN="TOP"
637
> the newly created GladeXML object, or NULL on failure.</TD
638
></TR
639
></TBODY
640
></TABLE
641
><P
642
></P
643
></DIV
644
></DIV
645
><HR><DIV
646
CLASS="REFSECT2"
647
><A
648
NAME="AEN295"
649
></A
650
><H3
651
><A
652
NAME="GLADE-XML-NEW-FROM-BUFFER"
653
></A
654
>glade_xml_new_from_buffer ()</H3
655
><TABLE
656
BORDER="0"
657
BGCOLOR="#D6E8FF"
658
WIDTH="100%"
659
CELLPADDING="6"
660
><TR
661
><TD
662
><PRE
663
CLASS="PROGRAMLISTING"
664
><A
665
HREF="gladexml.html"
666
>GladeXML</A
667
>* glade_xml_new_from_buffer (const char *buffer,
668
int size,
669
const char *root,
670
const char *domain);</PRE
671
></TD
672
></TR
673
></TABLE
674
><P
675
>Creates a new GladeXML object (and the corresponding widgets) from the
676
buffer <TT
677
CLASS="PARAMETER"
678
><I
679
>buffer</I
680
></TT
681
>. Optionally it will only build the interface from the
682
widget node <TT
683
CLASS="PARAMETER"
684
><I
685
>root</I
686
></TT
687
> (if it is not <TT
688
CLASS="LITERAL"
689
>NULL</TT
690
>). This feature is useful if you
691
only want to build say a toolbar or menu from the XML document, but not the
692
window it is embedded in.</P
693
><P
694
></P
695
><DIV
696
CLASS="INFORMALTABLE"
697
><A
698
NAME="AEN305"
699
></A
700
><P
701
></P
702
><TABLE
703
BORDER="0"
704
WIDTH="100%"
705
BGCOLOR="#FFD0D0"
706
CELLSPACING="0"
707
CELLPADDING="4"
708
CLASS="CALSTABLE"
709
><TBODY
710
><TR
711
><TD
712
WIDTH="20%"
713
ALIGN="RIGHT"
714
VALIGN="TOP"
715
><TT
716
CLASS="PARAMETER"
717
><I
718
>buffer</I
719
></TT
720
> :</TD
721
><TD
722
WIDTH="80%"
723
ALIGN="LEFT"
724
VALIGN="TOP"
725
> the memory buffer containing the XML document.</TD
726
></TR
727
><TR
728
><TD
729
WIDTH="20%"
730
ALIGN="RIGHT"
731
VALIGN="TOP"
732
><TT
733
CLASS="PARAMETER"
734
><I
735
>size</I
736
></TT
737
> :</TD
738
><TD
739
WIDTH="80%"
740
ALIGN="LEFT"
741
VALIGN="TOP"
742
> the size of the buffer.</TD
743
></TR
744
><TR
745
><TD
746
WIDTH="20%"
747
ALIGN="RIGHT"
748
VALIGN="TOP"
749
><TT
750
CLASS="PARAMETER"
751
><I
752
>root</I
753
></TT
754
> :</TD
755
><TD
756
WIDTH="80%"
757
ALIGN="LEFT"
758
VALIGN="TOP"
759
> the widget node in <TT
760
CLASS="PARAMETER"
761
><I
762
>buffer</I
763
></TT
764
> to start building from (or <TT
765
CLASS="LITERAL"
766
>NULL</TT
767
>)</TD
768
></TR
769
><TR
770
><TD
771
WIDTH="20%"
772
ALIGN="RIGHT"
773
VALIGN="TOP"
774
><TT
775
CLASS="PARAMETER"
776
><I
777
>domain</I
778
></TT
779
> :</TD
780
><TD
781
WIDTH="80%"
782
ALIGN="LEFT"
783
VALIGN="TOP"
784
> the translation domain to use for this interface (or <TT
785
CLASS="LITERAL"
786
>NULL</TT
787
>)</TD
788
></TR
789
><TR
790
><TD
791
WIDTH="20%"
792
ALIGN="RIGHT"
793
VALIGN="TOP"
794
><SPAN
795
CLASS="emphasis"
796
><I
797
CLASS="EMPHASIS"
798
>Returns</I
799
></SPAN
800
> :</TD
801
><TD
802
WIDTH="80%"
803
ALIGN="LEFT"
804
VALIGN="TOP"
805
> the newly created GladeXML object, or NULL on failure.</TD
806
></TR
807
></TBODY
808
></TABLE
809
><P
810
></P
811
></DIV
812
></DIV
813
><HR><DIV
814
CLASS="REFSECT2"
815
><A
816
NAME="AEN333"
817
></A
818
><H3
819
><A
820
NAME="GLADE-XML-CONSTRUCT"
821
></A
822
>glade_xml_construct ()</H3
823
><TABLE
824
BORDER="0"
825
BGCOLOR="#D6E8FF"
826
WIDTH="100%"
827
CELLPADDING="6"
828
><TR
829
><TD
830
><PRE
831
CLASS="PROGRAMLISTING"
832
><GTKDOCLINK
833
HREF="GBOOLEAN"
834
>gboolean</GTKDOCLINK
835
> glade_xml_construct (<A
836
HREF="gladexml.html"
837
>GladeXML</A
838
> *self,
839
const char *fname,
840
const char *root,
841
const char *domain);</PRE
842
></TD
843
></TR
844
></TABLE
845
><P
846
>This routine can be used by bindings (such as gtk--) to help construct
847
a GladeXML object, if it is needed.</P
848
><P
849
></P
850
><DIV
851
CLASS="INFORMALTABLE"
852
><A
853
NAME="AEN341"
854
></A
855
><P
856
></P
857
><TABLE
858
BORDER="0"
859
WIDTH="100%"
860
BGCOLOR="#FFD0D0"
861
CELLSPACING="0"
862
CELLPADDING="4"
863
CLASS="CALSTABLE"
864
><TBODY
865
><TR
866
><TD
867
WIDTH="20%"
868
ALIGN="RIGHT"
869
VALIGN="TOP"
870
><TT
871
CLASS="PARAMETER"
872
><I
873
>self</I
874
></TT
875
> :</TD
876
><TD
877
WIDTH="80%"
878
ALIGN="LEFT"
879
VALIGN="TOP"
880
> the GladeXML object</TD
881
></TR
882
><TR
883
><TD
884
WIDTH="20%"
885
ALIGN="RIGHT"
886
VALIGN="TOP"
887
><TT
888
CLASS="PARAMETER"
889
><I
890
>fname</I
891
></TT
892
> :</TD
893
><TD
894
WIDTH="80%"
895
ALIGN="LEFT"
896
VALIGN="TOP"
897
> the XML filename</TD
898
></TR
899
><TR
900
><TD
901
WIDTH="20%"
902
ALIGN="RIGHT"
903
VALIGN="TOP"
904
><TT
905
CLASS="PARAMETER"
906
><I
907
>root</I
908
></TT
909
> :</TD
910
><TD
911
WIDTH="80%"
912
ALIGN="LEFT"
913
VALIGN="TOP"
914
> the root widget node (or <TT
915
CLASS="LITERAL"
916
>NULL</TT
917
> for none)</TD
918
></TR
919
><TR
920
><TD
921
WIDTH="20%"
922
ALIGN="RIGHT"
923
VALIGN="TOP"
924
><TT
925
CLASS="PARAMETER"
926
><I
927
>domain</I
928
></TT
929
> :</TD
930
><TD
931
WIDTH="80%"
932
ALIGN="LEFT"
933
VALIGN="TOP"
934
> the translation domain (or <TT
935
CLASS="LITERAL"
936
>NULL</TT
937
> for the default)</TD
938
></TR
939
><TR
940
><TD
941
WIDTH="20%"
942
ALIGN="RIGHT"
943
VALIGN="TOP"
944
><SPAN
945
CLASS="emphasis"
946
><I
947
CLASS="EMPHASIS"
948
>Returns</I
949
></SPAN
950
> :</TD
951
><TD
952
WIDTH="80%"
953
ALIGN="LEFT"
954
VALIGN="TOP"
955
> TRUE if the construction succeeded.</TD
956
></TR
957
></TBODY
958
></TABLE
959
><P
960
></P
961
></DIV
962
></DIV
963
><HR><DIV
964
CLASS="REFSECT2"
965
><A
966
NAME="AEN368"
967
></A
968
><H3
969
><A
970
NAME="GLADE-XML-SIGNAL-CONNECT"
971
></A
972
>glade_xml_signal_connect ()</H3
973
><TABLE
974
BORDER="0"
975
BGCOLOR="#D6E8FF"
976
WIDTH="100%"
977
CELLPADDING="6"
978
><TR
979
><TD
980
><PRE
981
CLASS="PROGRAMLISTING"
982
>void glade_xml_signal_connect (<A
983
HREF="gladexml.html"
984
>GladeXML</A
985
> *self,
986
const char *handlername,
987
<GTKDOCLINK
988
HREF="GCALLBACK"
989
>GCallback</GTKDOCLINK
990
> func);</PRE
991
></TD
992
></TR
993
></TABLE
994
><P
995
>In the glade interface descriptions, signal handlers are specified for
996
widgets by name. This function allows you to connect a C function to
997
all signals in the GladeXML file with the given signal handler name.</P
998
><P
999
></P
1000
><DIV
1001
CLASS="INFORMALTABLE"
1002
><A
1003
NAME="AEN376"
1004
></A
1005
><P
1006
></P
1007
><TABLE
1008
BORDER="0"
1009
WIDTH="100%"
1010
BGCOLOR="#FFD0D0"
1011
CELLSPACING="0"
1012
CELLPADDING="4"
1013
CLASS="CALSTABLE"
1014
><TBODY
1015
><TR
1016
><TD
1017
WIDTH="20%"
1018
ALIGN="RIGHT"
1019
VALIGN="TOP"
1020
><TT
1021
CLASS="PARAMETER"
1022
><I
1023
>self</I
1024
></TT
1025
> :</TD
1026
><TD
1027
WIDTH="80%"
1028
ALIGN="LEFT"
1029
VALIGN="TOP"
1030
> the GladeXML object</TD
1031
></TR
1032
><TR
1033
><TD
1034
WIDTH="20%"
1035
ALIGN="RIGHT"
1036
VALIGN="TOP"
1037
><TT
1038
CLASS="PARAMETER"
1039
><I
1040
>handlername</I
1041
></TT
1042
> :</TD
1043
><TD
1044
WIDTH="80%"
1045
ALIGN="LEFT"
1046
VALIGN="TOP"
1047
> the signal handler name</TD
1048
></TR
1049
><TR
1050
><TD
1051
WIDTH="20%"
1052
ALIGN="RIGHT"
1053
VALIGN="TOP"
1054
><TT
1055
CLASS="PARAMETER"
1056
><I
1057
>func</I
1058
></TT
1059
> :</TD
1060
><TD
1061
WIDTH="80%"
1062
ALIGN="LEFT"
1063
VALIGN="TOP"
1064
> the signal handler function</TD
1065
></TR
1066
></TBODY
1067
></TABLE
1068
><P
1069
></P
1070
></DIV
1071
></DIV
1072
><HR><DIV
1073
CLASS="REFSECT2"
1074
><A
1075
NAME="AEN393"
1076
></A
1077
><H3
1078
><A
1079
NAME="GLADE-XML-SIGNAL-CONNECT-DATA"
1080
></A
1081
>glade_xml_signal_connect_data ()</H3
1082
><TABLE
1083
BORDER="0"
1084
BGCOLOR="#D6E8FF"
1085
WIDTH="100%"
1086
CELLPADDING="6"
1087
><TR
1088
><TD
1089
><PRE
1090
CLASS="PROGRAMLISTING"
1091
>void glade_xml_signal_connect_data (<A
1092
HREF="gladexml.html"
1093
>GladeXML</A
1094
> *self,
1095
const char *handlername,
1096
<GTKDOCLINK
1097
HREF="GCALLBACK"
1098
>GCallback</GTKDOCLINK
1099
> func,
1100
<GTKDOCLINK
1101
HREF="GPOINTER"
1102
>gpointer</GTKDOCLINK
1103
> user_data);</PRE
1104
></TD
1105
></TR
1106
></TABLE
1107
><P
1108
>In the glade interface descriptions, signal handlers are specified for
1109
widgets by name. This function allows you to connect a C function to
1110
all signals in the GladeXML file with the given signal handler name.</P
1111
><P
1112
>It differs from glade_xml_signal_connect since it allows you to
1113
specify the data parameter for the signal handler. It is also a small
1114
demonstration of how to use glade_xml_signal_connect_full.</P
1115
><P
1116
></P
1117
><DIV
1118
CLASS="INFORMALTABLE"
1119
><A
1120
NAME="AEN403"
1121
></A
1122
><P
1123
></P
1124
><TABLE
1125
BORDER="0"
1126
WIDTH="100%"
1127
BGCOLOR="#FFD0D0"
1128
CELLSPACING="0"
1129
CELLPADDING="4"
1130
CLASS="CALSTABLE"
1131
><TBODY
1132
><TR
1133
><TD
1134
WIDTH="20%"
1135
ALIGN="RIGHT"
1136
VALIGN="TOP"
1137
><TT
1138
CLASS="PARAMETER"
1139
><I
1140
>self</I
1141
></TT
1142
> :</TD
1143
><TD
1144
WIDTH="80%"
1145
ALIGN="LEFT"
1146
VALIGN="TOP"
1147
> the GladeXML object</TD
1148
></TR
1149
><TR
1150
><TD
1151
WIDTH="20%"
1152
ALIGN="RIGHT"
1153
VALIGN="TOP"
1154
><TT
1155
CLASS="PARAMETER"
1156
><I
1157
>handlername</I
1158
></TT
1159
> :</TD
1160
><TD
1161
WIDTH="80%"
1162
ALIGN="LEFT"
1163
VALIGN="TOP"
1164
> the signal handler name</TD
1165
></TR
1166
><TR
1167
><TD
1168
WIDTH="20%"
1169
ALIGN="RIGHT"
1170
VALIGN="TOP"
1171
><TT
1172
CLASS="PARAMETER"
1173
><I
1174
>func</I
1175
></TT
1176
> :</TD
1177
><TD
1178
WIDTH="80%"
1179
ALIGN="LEFT"
1180
VALIGN="TOP"
1181
> the signal handler function</TD
1182
></TR
1183
><TR
1184
><TD
1185
WIDTH="20%"
1186
ALIGN="RIGHT"
1187
VALIGN="TOP"
1188
><TT
1189
CLASS="PARAMETER"
1190
><I
1191
>user_data</I
1192
></TT
1193
> :</TD
1194
><TD
1195
WIDTH="80%"
1196
ALIGN="LEFT"
1197
VALIGN="TOP"
1198
> the signal handler data</TD
1199
></TR
1200
></TBODY
1201
></TABLE
1202
><P
1203
></P
1204
></DIV
1205
></DIV
1206
><HR><DIV
1207
CLASS="REFSECT2"
1208
><A
1209
NAME="AEN424"
1210
></A
1211
><H3
1212
><A
1213
NAME="GLADE-XML-SIGNAL-AUTOCONNECT"
1214
></A
1215
>glade_xml_signal_autoconnect ()</H3
1216
><TABLE
1217
BORDER="0"
1218
BGCOLOR="#D6E8FF"
1219
WIDTH="100%"
1220
CELLPADDING="6"
1221
><TR
1222
><TD
1223
><PRE
1224
CLASS="PROGRAMLISTING"
1225
>void glade_xml_signal_autoconnect (<A
1226
HREF="gladexml.html"
1227
>GladeXML</A
1228
> *self);</PRE
1229
></TD
1230
></TR
1231
></TABLE
1232
><P
1233
>This function is a variation of glade_xml_signal_connect. It uses
1234
gmodule's introspective features (by openning the module <TT
1235
CLASS="LITERAL"
1236
>NULL</TT
1237
>) to
1238
look at the application's symbol table. From here it tries to match
1239
the signal handler names given in the interface description with
1240
symbols in the application and connects the signals.</P
1241
><P
1242
>Note that this function will not work correctly if gmodule is not
1243
supported on the platform.</P
1244
><P
1245
></P
1246
><DIV
1247
CLASS="INFORMALTABLE"
1248
><A
1249
NAME="AEN433"
1250
></A
1251
><P
1252
></P
1253
><TABLE
1254
BORDER="0"
1255
WIDTH="100%"
1256
BGCOLOR="#FFD0D0"
1257
CELLSPACING="0"
1258
CELLPADDING="4"
1259
CLASS="CALSTABLE"
1260
><TBODY
1261
><TR
1262
><TD
1263
WIDTH="20%"
1264
ALIGN="RIGHT"
1265
VALIGN="TOP"
1266
><TT
1267
CLASS="PARAMETER"
1268
><I
1269
>self</I
1270
></TT
1271
> :</TD
1272
><TD
1273
WIDTH="80%"
1274
ALIGN="LEFT"
1275
VALIGN="TOP"
1276
> the GladeXML object.</TD
1277
></TR
1278
></TBODY
1279
></TABLE
1280
><P
1281
></P
1282
></DIV
1283
></DIV
1284
><HR><DIV
1285
CLASS="REFSECT2"
1286
><A
1287
NAME="AEN442"
1288
></A
1289
><H3
1290
><A
1291
NAME="GLADE-XML-GET-WIDGET"
1292
></A
1293
>glade_xml_get_widget ()</H3
1294
><TABLE
1295
BORDER="0"
1296
BGCOLOR="#D6E8FF"
1297
WIDTH="100%"
1298
CELLPADDING="6"
1299
><TR
1300
><TD
1301
><PRE
1302
CLASS="PROGRAMLISTING"
1303
><GTKDOCLINK
1304
HREF="GTKWIDGET"
1305
>GtkWidget</GTKDOCLINK
1306
>* glade_xml_get_widget (<A
1307
HREF="gladexml.html"
1308
>GladeXML</A
1309
> *self,
1310
const char *name);</PRE
1311
></TD
1312
></TR
1313
></TABLE
1314
><P
1315
>This function is used to get a pointer to the GtkWidget corresponding to
1316
<TT
1317
CLASS="PARAMETER"
1318
><I
1319
>name</I
1320
></TT
1321
> in the interface description. You would use this if you have to do
1322
anything to the widget after loading.</P
1323
><P
1324
></P
1325
><DIV
1326
CLASS="INFORMALTABLE"
1327
><A
1328
NAME="AEN451"
1329
></A
1330
><P
1331
></P
1332
><TABLE
1333
BORDER="0"
1334
WIDTH="100%"
1335
BGCOLOR="#FFD0D0"
1336
CELLSPACING="0"
1337
CELLPADDING="4"
1338
CLASS="CALSTABLE"
1339
><TBODY
1340
><TR
1341
><TD
1342
WIDTH="20%"
1343
ALIGN="RIGHT"
1344
VALIGN="TOP"
1345
><TT
1346
CLASS="PARAMETER"
1347
><I
1348
>self</I
1349
></TT
1350
> :</TD
1351
><TD
1352
WIDTH="80%"
1353
ALIGN="LEFT"
1354
VALIGN="TOP"
1355
> the GladeXML object.</TD
1356
></TR
1357
><TR
1358
><TD
1359
WIDTH="20%"
1360
ALIGN="RIGHT"
1361
VALIGN="TOP"
1362
><TT
1363
CLASS="PARAMETER"
1364
><I
1365
>name</I
1366
></TT
1367
> :</TD
1368
><TD
1369
WIDTH="80%"
1370
ALIGN="LEFT"
1371
VALIGN="TOP"
1372
> the name of the widget.</TD
1373
></TR
1374
><TR
1375
><TD
1376
WIDTH="20%"
1377
ALIGN="RIGHT"
1378
VALIGN="TOP"
1379
><SPAN
1380
CLASS="emphasis"
1381
><I
1382
CLASS="EMPHASIS"
1383
>Returns</I
1384
></SPAN
1385
> :</TD
1386
><TD
1387
WIDTH="80%"
1388
ALIGN="LEFT"
1389
VALIGN="TOP"
1390
> the widget matching <TT
1391
CLASS="PARAMETER"
1392
><I
1393
>name</I
1394
></TT
1395
>, or <TT
1396
CLASS="LITERAL"
1397
>NULL</TT
1398
> if none exists.</TD
1399
></TR
1400
></TBODY
1401
></TABLE
1402
><P
1403
></P
1404
></DIV
1405
></DIV
1406
><HR><DIV
1407
CLASS="REFSECT2"
1408
><A
1409
NAME="AEN470"
1410
></A
1411
><H3
1412
><A
1413
NAME="GLADE-XML-GET-WIDGET-PREFIX"
1414
></A
1415
>glade_xml_get_widget_prefix ()</H3
1416
><TABLE
1417
BORDER="0"
1418
BGCOLOR="#D6E8FF"
1419
WIDTH="100%"
1420
CELLPADDING="6"
1421
><TR
1422
><TD
1423
><PRE
1424
CLASS="PROGRAMLISTING"
1425
><GTKDOCLINK
1426
HREF="GLIST"
1427
>GList</GTKDOCLINK
1428
>* glade_xml_get_widget_prefix (<A
1429
HREF="gladexml.html"
1430
>GladeXML</A
1431
> *self,
1432
const char *name);</PRE
1433
></TD
1434
></TR
1435
></TABLE
1436
><P
1437
>This function is used to get a list of pointers to the GtkWidget(s)
1438
with names that start with the string <TT
1439
CLASS="PARAMETER"
1440
><I
1441
>name</I
1442
></TT
1443
> in the interface description.
1444
You would use this if you have to do something to all of these widgets
1445
after loading.</P
1446
><P
1447
></P
1448
><DIV
1449
CLASS="INFORMALTABLE"
1450
><A
1451
NAME="AEN479"
1452
></A
1453
><P
1454
></P
1455
><TABLE
1456
BORDER="0"
1457
WIDTH="100%"
1458
BGCOLOR="#FFD0D0"
1459
CELLSPACING="0"
1460
CELLPADDING="4"
1461
CLASS="CALSTABLE"
1462
><TBODY
1463
><TR
1464
><TD
1465
WIDTH="20%"
1466
ALIGN="RIGHT"
1467
VALIGN="TOP"
1468
><TT
1469
CLASS="PARAMETER"
1470
><I
1471
>self</I
1472
></TT
1473
> :</TD
1474
><TD
1475
WIDTH="80%"
1476
ALIGN="LEFT"
1477
VALIGN="TOP"
1478
> the GladeXML object.</TD
1479
></TR
1480
><TR
1481
><TD
1482
WIDTH="20%"
1483
ALIGN="RIGHT"
1484
VALIGN="TOP"
1485
><TT
1486
CLASS="PARAMETER"
1487
><I
1488
>name</I
1489
></TT
1490
> :</TD
1491
><TD
1492
WIDTH="80%"
1493
ALIGN="LEFT"
1494
VALIGN="TOP"
1495
> the name of the widget.</TD
1496
></TR
1497
><TR
1498
><TD
1499
WIDTH="20%"
1500
ALIGN="RIGHT"
1501
VALIGN="TOP"
1502
><SPAN
1503
CLASS="emphasis"
1504
><I
1505
CLASS="EMPHASIS"
1506
>Returns</I
1507
></SPAN
1508
> :</TD
1509
><TD
1510
WIDTH="80%"
1511
ALIGN="LEFT"
1512
VALIGN="TOP"
1513
> A list of the widget that match <TT
1514
CLASS="PARAMETER"
1515
><I
1516
>name</I
1517
></TT
1518
> as the start of their
1519
name, or <TT
1520
CLASS="LITERAL"
1521
>NULL</TT
1522
> if none exists.</TD
1523
></TR
1524
></TBODY
1525
></TABLE
1526
><P
1527
></P
1528
></DIV
1529
></DIV
1530
><HR><DIV
1531
CLASS="REFSECT2"
1532
><A
1533
NAME="AEN498"
1534
></A
1535
><H3
1536
><A
1537
NAME="GLADE-GET-WIDGET-NAME"
1538
></A
1539
>glade_get_widget_name ()</H3
1540
><TABLE
1541
BORDER="0"
1542
BGCOLOR="#D6E8FF"
1543
WIDTH="100%"
1544
CELLPADDING="6"
1545
><TR
1546
><TD
1547
><PRE
1548
CLASS="PROGRAMLISTING"
1549
>const char* glade_get_widget_name (<GTKDOCLINK
1550
HREF="GTKWIDGET"
1551
>GtkWidget</GTKDOCLINK
1552
> *widget);</PRE
1553
></TD
1554
></TR
1555
></TABLE
1556
><P
1557
>Used to get the name of a widget that was generated by a GladeXML object.</P
1558
><P
1559
></P
1560
><DIV
1561
CLASS="INFORMALTABLE"
1562
><A
1563
NAME="AEN505"
1564
></A
1565
><P
1566
></P
1567
><TABLE
1568
BORDER="0"
1569
WIDTH="100%"
1570
BGCOLOR="#FFD0D0"
1571
CELLSPACING="0"
1572
CELLPADDING="4"
1573
CLASS="CALSTABLE"
1574
><TBODY
1575
><TR
1576
><TD
1577
WIDTH="20%"
1578
ALIGN="RIGHT"
1579
VALIGN="TOP"
1580
><TT
1581
CLASS="PARAMETER"
1582
><I
1583
>widget</I
1584
></TT
1585
> :</TD
1586
><TD
1587
WIDTH="80%"
1588
ALIGN="LEFT"
1589
VALIGN="TOP"
1590
> the widget</TD
1591
></TR
1592
><TR
1593
><TD
1594
WIDTH="20%"
1595
ALIGN="RIGHT"
1596
VALIGN="TOP"
1597
><SPAN
1598
CLASS="emphasis"
1599
><I
1600
CLASS="EMPHASIS"
1601
>Returns</I
1602
></SPAN
1603
> :</TD
1604
><TD
1605
WIDTH="80%"
1606
ALIGN="LEFT"
1607
VALIGN="TOP"
1608
> the name of the widget.</TD
1609
></TR
1610
></TBODY
1611
></TABLE
1612
><P
1613
></P
1614
></DIV
1615
></DIV
1616
><HR><DIV
1617
CLASS="REFSECT2"
1618
><A
1619
NAME="AEN518"
1620
></A
1621
><H3
1622
><A
1623
NAME="GLADE-GET-WIDGET-TREE"
1624
></A
1625
>glade_get_widget_tree ()</H3
1626
><TABLE
1627
BORDER="0"
1628
BGCOLOR="#D6E8FF"
1629
WIDTH="100%"
1630
CELLPADDING="6"
1631
><TR
1632
><TD
1633
><PRE
1634
CLASS="PROGRAMLISTING"
1635
><A
1636
HREF="gladexml.html"
1637
>GladeXML</A
1638
>* glade_get_widget_tree (<GTKDOCLINK
1639
HREF="GTKWIDGET"
1640
>GtkWidget</GTKDOCLINK
1641
> *widget);</PRE
1642
></TD
1643
></TR
1644
></TABLE
1645
><P
1646
>This function is used to get the GladeXML object that built this widget.</P
1647
><P
1648
></P
1649
><DIV
1650
CLASS="INFORMALTABLE"
1651
><A
1652
NAME="AEN526"
1653
></A
1654
><P
1655
></P
1656
><TABLE
1657
BORDER="0"
1658
WIDTH="100%"
1659
BGCOLOR="#FFD0D0"
1660
CELLSPACING="0"
1661
CELLPADDING="4"
1662
CLASS="CALSTABLE"
1663
><TBODY
1664
><TR
1665
><TD
1666
WIDTH="20%"
1667
ALIGN="RIGHT"
1668
VALIGN="TOP"
1669
><TT
1670
CLASS="PARAMETER"
1671
><I
1672
>widget</I
1673
></TT
1674
> :</TD
1675
><TD
1676
WIDTH="80%"
1677
ALIGN="LEFT"
1678
VALIGN="TOP"
1679
> the widget</TD
1680
></TR
1681
><TR
1682
><TD
1683
WIDTH="20%"
1684
ALIGN="RIGHT"
1685
VALIGN="TOP"
1686
><SPAN
1687
CLASS="emphasis"
1688
><I
1689
CLASS="EMPHASIS"
1690
>Returns</I
1691
></SPAN
1692
> :</TD
1693
><TD
1694
WIDTH="80%"
1695
ALIGN="LEFT"
1696
VALIGN="TOP"
1697
> the GladeXML object that built this widget.</TD
1698
></TR
1699
></TBODY
1700
></TABLE
1701
><P
1702
></P
1703
></DIV
1704
></DIV
1705
><HR><DIV
1706
CLASS="REFSECT2"
1707
><A
1708
NAME="AEN539"
1709
></A
1710
><H3
1711
><A
1712
NAME="GLADEXMLCONNECTFUNC"
1713
></A
1714
>GladeXMLConnectFunc ()</H3
1715
><TABLE
1716
BORDER="0"
1717
BGCOLOR="#D6E8FF"
1718
WIDTH="100%"
1719
CELLPADDING="6"
1720
><TR
1721
><TD
1722
><PRE
1723
CLASS="PROGRAMLISTING"
1724
>void (*GladeXMLConnectFunc) (const <GTKDOCLINK
1725
HREF="GCHAR"
1726
>gchar</GTKDOCLINK
1727
> *handler_name,
1728
<GTKDOCLINK
1729
HREF="GOBJECT"
1730
>GObject</GTKDOCLINK
1731
> *object,
1732
const <GTKDOCLINK
1733
HREF="GCHAR"
1734
>gchar</GTKDOCLINK
1735
> *signal_name,
1736
const <GTKDOCLINK
1737
HREF="GCHAR"
1738
>gchar</GTKDOCLINK
1739
> *signal_data,
1740
<GTKDOCLINK
1741
HREF="GOBJECT"
1742
>GObject</GTKDOCLINK
1743
> *connect_object,
1744
<GTKDOCLINK
1745
HREF="GBOOLEAN"
1746
>gboolean</GTKDOCLINK
1747
> after,
1748
<GTKDOCLINK
1749
HREF="GPOINTER"
1750
>gpointer</GTKDOCLINK
1751
> user_data);</PRE
1752
></TD
1753
></TR
1754
></TABLE
1755
><P
1756
>This is the signature of a function used to connect signals. It is used
1757
by the glade_xml_signal_connect_full and glade_xml_signal_autoconnect_full
1758
functions. It is mainly intented for interpreted language bindings, but
1759
could be useful where the programmer wants more control over the signal
1760
connection process.</P
1761
><P
1762
></P
1763
><DIV
1764
CLASS="INFORMALTABLE"
1765
><A
1766
NAME="AEN552"
1767
></A
1768
><P
1769
></P
1770
><TABLE
1771
BORDER="0"
1772
WIDTH="100%"
1773
BGCOLOR="#FFD0D0"
1774
CELLSPACING="0"
1775
CELLPADDING="4"
1776
CLASS="CALSTABLE"
1777
><TBODY
1778
><TR
1779
><TD
1780
WIDTH="20%"
1781
ALIGN="RIGHT"
1782
VALIGN="TOP"
1783
><TT
1784
CLASS="PARAMETER"
1785
><I
1786
>handler_name</I
1787
></TT
1788
> :</TD
1789
><TD
1790
WIDTH="80%"
1791
ALIGN="LEFT"
1792
VALIGN="TOP"
1793
> the name of the handler function to connect.</TD
1794
></TR
1795
><TR
1796
><TD
1797
WIDTH="20%"
1798
ALIGN="RIGHT"
1799
VALIGN="TOP"
1800
><TT
1801
CLASS="PARAMETER"
1802
><I
1803
>object</I
1804
></TT
1805
> :</TD
1806
><TD
1807
WIDTH="80%"
1808
ALIGN="LEFT"
1809
VALIGN="TOP"
1810
> the object to connect the signal to.</TD
1811
></TR
1812
><TR
1813
><TD
1814
WIDTH="20%"
1815
ALIGN="RIGHT"
1816
VALIGN="TOP"
1817
><TT
1818
CLASS="PARAMETER"
1819
><I
1820
>signal_name</I
1821
></TT
1822
> :</TD
1823
><TD
1824
WIDTH="80%"
1825
ALIGN="LEFT"
1826
VALIGN="TOP"
1827
> the name of the signal.</TD
1828
></TR
1829
><TR
1830
><TD
1831
WIDTH="20%"
1832
ALIGN="RIGHT"
1833
VALIGN="TOP"
1834
><TT
1835
CLASS="PARAMETER"
1836
><I
1837
>signal_data</I
1838
></TT
1839
> :</TD
1840
><TD
1841
WIDTH="80%"
1842
ALIGN="LEFT"
1843
VALIGN="TOP"
1844
> the string value of the signal data given in the XML file.</TD
1845
></TR
1846
><TR
1847
><TD
1848
WIDTH="20%"
1849
ALIGN="RIGHT"
1850
VALIGN="TOP"
1851
><TT
1852
CLASS="PARAMETER"
1853
><I
1854
>connect_object</I
1855
></TT
1856
> :</TD
1857
><TD
1858
WIDTH="80%"
1859
ALIGN="LEFT"
1860
VALIGN="TOP"
1861
> non NULL if gtk_signal_connect_object should be used.</TD
1862
></TR
1863
><TR
1864
><TD
1865
WIDTH="20%"
1866
ALIGN="RIGHT"
1867
VALIGN="TOP"
1868
><TT
1869
CLASS="PARAMETER"
1870
><I
1871
>after</I
1872
></TT
1873
> :</TD
1874
><TD
1875
WIDTH="80%"
1876
ALIGN="LEFT"
1877
VALIGN="TOP"
1878
> TRUE if the connection should be made with gtk_signal_connect_after.</TD
1879
></TR
1880
><TR
1881
><TD
1882
WIDTH="20%"
1883
ALIGN="RIGHT"
1884
VALIGN="TOP"
1885
><TT
1886
CLASS="PARAMETER"
1887
><I
1888
>user_data</I
1889
></TT
1890
> :</TD
1891
><TD
1892
WIDTH="80%"
1893
ALIGN="LEFT"
1894
VALIGN="TOP"
1895
> the user data argument.</TD
1896
></TR
1897
></TBODY
1898
></TABLE
1899
><P
1900
></P
1901
></DIV
1902
></DIV
1903
><HR><DIV
1904
CLASS="REFSECT2"
1905
><A
1906
NAME="AEN585"
1907
></A
1908
><H3
1909
><A
1910
NAME="GLADE-XML-SIGNAL-CONNECT-FULL"
1911
></A
1912
>glade_xml_signal_connect_full ()</H3
1913
><TABLE
1914
BORDER="0"
1915
BGCOLOR="#D6E8FF"
1916
WIDTH="100%"
1917
CELLPADDING="6"
1918
><TR
1919
><TD
1920
><PRE
1921
CLASS="PROGRAMLISTING"
1922
>void glade_xml_signal_connect_full (<A
1923
HREF="gladexml.html"
1924
>GladeXML</A
1925
> *self,
1926
const <GTKDOCLINK
1927
HREF="GCHAR"
1928
>gchar</GTKDOCLINK
1929
> *handler_name,
1930
<A
1931
HREF="gladexml.html#GLADEXMLCONNECTFUNC"
1932
>GladeXMLConnectFunc</A
1933
> func,
1934
<GTKDOCLINK
1935
HREF="GPOINTER"
1936
>gpointer</GTKDOCLINK
1937
> user_data);</PRE
1938
></TD
1939
></TR
1940
></TABLE
1941
><P
1942
>This function is similar to glade_xml_signal_connect, except that it
1943
allows you to give an arbitrary function that will be used for actually
1944
connecting the signals. This is mainly useful for writers of interpreted
1945
language bindings, or applications where you need more control over the
1946
signal connection process.</P
1947
><P
1948
></P
1949
><DIV
1950
CLASS="INFORMALTABLE"
1951
><A
1952
NAME="AEN595"
1953
></A
1954
><P
1955
></P
1956
><TABLE
1957
BORDER="0"
1958
WIDTH="100%"
1959
BGCOLOR="#FFD0D0"
1960
CELLSPACING="0"
1961
CELLPADDING="4"
1962
CLASS="CALSTABLE"
1963
><TBODY
1964
><TR
1965
><TD
1966
WIDTH="20%"
1967
ALIGN="RIGHT"
1968
VALIGN="TOP"
1969
><TT
1970
CLASS="PARAMETER"
1971
><I
1972
>self</I
1973
></TT
1974
> :</TD
1975
><TD
1976
WIDTH="80%"
1977
ALIGN="LEFT"
1978
VALIGN="TOP"
1979
> the GladeXML object.</TD
1980
></TR
1981
><TR
1982
><TD
1983
WIDTH="20%"
1984
ALIGN="RIGHT"
1985
VALIGN="TOP"
1986
><TT
1987
CLASS="PARAMETER"
1988
><I
1989
>handler_name</I
1990
></TT
1991
> :</TD
1992
><TD
1993
WIDTH="80%"
1994
ALIGN="LEFT"
1995
VALIGN="TOP"
1996
> the name of the signal handler that we want to connect.</TD
1997
></TR
1998
><TR
1999
><TD
2000
WIDTH="20%"
2001
ALIGN="RIGHT"
2002
VALIGN="TOP"
2003
><TT
2004
CLASS="PARAMETER"
2005
><I
2006
>func</I
2007
></TT
2008
> :</TD
2009
><TD
2010
WIDTH="80%"
2011
ALIGN="LEFT"
2012
VALIGN="TOP"
2013
> the function to use to connect the signals.</TD
2014
></TR
2015
><TR
2016
><TD
2017
WIDTH="20%"
2018
ALIGN="RIGHT"
2019
VALIGN="TOP"
2020
><TT
2021
CLASS="PARAMETER"
2022
><I
2023
>user_data</I
2024
></TT
2025
> :</TD
2026
><TD
2027
WIDTH="80%"
2028
ALIGN="LEFT"
2029
VALIGN="TOP"
2030
> arbitrary data to pass to the connect function.</TD
2031
></TR
2032
></TBODY
2033
></TABLE
2034
><P
2035
></P
2036
></DIV
2037
></DIV
2038
><HR><DIV
2039
CLASS="REFSECT2"
2040
><A
2041
NAME="AEN616"
2042
></A
2043
><H3
2044
><A
2045
NAME="GLADE-XML-SIGNAL-AUTOCONNECT-FULL"
2046
></A
2047
>glade_xml_signal_autoconnect_full ()</H3
2048
><TABLE
2049
BORDER="0"
2050
BGCOLOR="#D6E8FF"
2051
WIDTH="100%"
2052
CELLPADDING="6"
2053
><TR
2054
><TD
2055
><PRE
2056
CLASS="PROGRAMLISTING"
2057
>void glade_xml_signal_autoconnect_full
2058
(<A
2059
HREF="gladexml.html"
2060
>GladeXML</A
2061
> *self,
2062
<A
2063
HREF="gladexml.html#GLADEXMLCONNECTFUNC"
2064
>GladeXMLConnectFunc</A
2065
> func,
2066
<GTKDOCLINK
2067
HREF="GPOINTER"
2068
>gpointer</GTKDOCLINK
2069
> user_data);</PRE
2070
></TD
2071
></TR
2072
></TABLE
2073
><P
2074
>This function is similar to glade_xml_signal_connect_full, except that it
2075
will try to connect all signals in the interface, not just a single
2076
named handler. It can be thought of the interpeted language binding
2077
version of glade_xml_signal_autoconnect, except that it does not
2078
require gmodule to function correctly.</P
2079
><P
2080
></P
2081
><DIV
2082
CLASS="INFORMALTABLE"
2083
><A
2084
NAME="AEN625"
2085
></A
2086
><P
2087
></P
2088
><TABLE
2089
BORDER="0"
2090
WIDTH="100%"
2091
BGCOLOR="#FFD0D0"
2092
CELLSPACING="0"
2093
CELLPADDING="4"
2094
CLASS="CALSTABLE"
2095
><TBODY
2096
><TR
2097
><TD
2098
WIDTH="20%"
2099
ALIGN="RIGHT"
2100
VALIGN="TOP"
2101
><TT
2102
CLASS="PARAMETER"
2103
><I
2104
>self</I
2105
></TT
2106
> :</TD
2107
><TD
2108
WIDTH="80%"
2109
ALIGN="LEFT"
2110
VALIGN="TOP"
2111
> the GladeXML object.</TD
2112
></TR
2113
><TR
2114
><TD
2115
WIDTH="20%"
2116
ALIGN="RIGHT"
2117
VALIGN="TOP"
2118
><TT
2119
CLASS="PARAMETER"
2120
><I
2121
>func</I
2122
></TT
2123
> :</TD
2124
><TD
2125
WIDTH="80%"
2126
ALIGN="LEFT"
2127
VALIGN="TOP"
2128
> the function used to connect the signals.</TD
2129
></TR
2130
><TR
2131
><TD
2132
WIDTH="20%"
2133
ALIGN="RIGHT"
2134
VALIGN="TOP"
2135
><TT
2136
CLASS="PARAMETER"
2137
><I
2138
>user_data</I
2139
></TT
2140
> :</TD
2141
><TD
2142
WIDTH="80%"
2143
ALIGN="LEFT"
2144
VALIGN="TOP"
2145
> arbitrary data that will be passed to the connection function.</TD
2146
></TR
2147
></TBODY
2148
></TABLE
2149
><P
2150
></P
2151
></DIV
2152
></DIV
2153
><HR><DIV
2154
CLASS="REFSECT2"
2155
><A
2156
NAME="AEN642"
2157
></A
2158
><H3
2159
><A
2160
NAME="GLADEXMLCUSTOMWIDGETHANDLER"
2161
></A
2162
>GladeXMLCustomWidgetHandler ()</H3
2163
><TABLE
2164
BORDER="0"
2165
BGCOLOR="#D6E8FF"
2166
WIDTH="100%"
2167
CELLPADDING="6"
2168
><TR
2169
><TD
2170
><PRE
2171
CLASS="PROGRAMLISTING"
2172
><GTKDOCLINK
2173
HREF="GTKWIDGET"
2174
>GtkWidget</GTKDOCLINK
2175
>* (*GladeXMLCustomWidgetHandler) (<A
2176
HREF="gladexml.html"
2177
>GladeXML</A
2178
> *xml,
2179
<GTKDOCLINK
2180
HREF="GCHAR"
2181
>gchar</GTKDOCLINK
2182
> *func_name,
2183
<GTKDOCLINK
2184
HREF="GCHAR"
2185
>gchar</GTKDOCLINK
2186
> *name,
2187
<GTKDOCLINK
2188
HREF="GCHAR"
2189
>gchar</GTKDOCLINK
2190
> *string1,
2191
<GTKDOCLINK
2192
HREF="GCHAR"
2193
>gchar</GTKDOCLINK
2194
> *string2,
2195
<GTKDOCLINK
2196
HREF="GINT"
2197
>gint</GTKDOCLINK
2198
> int1,
2199
<GTKDOCLINK
2200
HREF="GINT"
2201
>gint</GTKDOCLINK
2202
> int2,
2203
<GTKDOCLINK
2204
HREF="GPOINTER"
2205
>gpointer</GTKDOCLINK
2206
> user_data);</PRE
2207
></TD
2208
></TR
2209
></TABLE
2210
><P
2211
>This prototype is for a function that creates custom widgets.</P
2212
><P
2213
></P
2214
><DIV
2215
CLASS="INFORMALTABLE"
2216
><A
2217
NAME="AEN657"
2218
></A
2219
><P
2220
></P
2221
><TABLE
2222
BORDER="0"
2223
WIDTH="100%"
2224
BGCOLOR="#FFD0D0"
2225
CELLSPACING="0"
2226
CELLPADDING="4"
2227
CLASS="CALSTABLE"
2228
><TBODY
2229
><TR
2230
><TD
2231
WIDTH="20%"
2232
ALIGN="RIGHT"
2233
VALIGN="TOP"
2234
><TT
2235
CLASS="PARAMETER"
2236
><I
2237
>xml</I
2238
></TT
2239
> :</TD
2240
><TD
2241
WIDTH="80%"
2242
ALIGN="LEFT"
2243
VALIGN="TOP"
2244
> the GladeXML object.</TD
2245
></TR
2246
><TR
2247
><TD
2248
WIDTH="20%"
2249
ALIGN="RIGHT"
2250
VALIGN="TOP"
2251
><TT
2252
CLASS="PARAMETER"
2253
><I
2254
>func_name</I
2255
></TT
2256
> :</TD
2257
><TD
2258
WIDTH="80%"
2259
ALIGN="LEFT"
2260
VALIGN="TOP"
2261
> the function name.</TD
2262
></TR
2263
><TR
2264
><TD
2265
WIDTH="20%"
2266
ALIGN="RIGHT"
2267
VALIGN="TOP"
2268
><TT
2269
CLASS="PARAMETER"
2270
><I
2271
>name</I
2272
></TT
2273
> :</TD
2274
><TD
2275
WIDTH="80%"
2276
ALIGN="LEFT"
2277
VALIGN="TOP"
2278
> the name of the widget to be created.</TD
2279
></TR
2280
><TR
2281
><TD
2282
WIDTH="20%"
2283
ALIGN="RIGHT"
2284
VALIGN="TOP"
2285
><TT
2286
CLASS="PARAMETER"
2287
><I
2288
>string1</I
2289
></TT
2290
> :</TD
2291
><TD
2292
WIDTH="80%"
2293
ALIGN="LEFT"
2294
VALIGN="TOP"
2295
> the string1 property.</TD
2296
></TR
2297
><TR
2298
><TD
2299
WIDTH="20%"
2300
ALIGN="RIGHT"
2301
VALIGN="TOP"
2302
><TT
2303
CLASS="PARAMETER"
2304
><I
2305
>string2</I
2306
></TT
2307
> :</TD
2308
><TD
2309
WIDTH="80%"
2310
ALIGN="LEFT"
2311
VALIGN="TOP"
2312
> the string2 property.</TD
2313
></TR
2314
><TR
2315
><TD
2316
WIDTH="20%"
2317
ALIGN="RIGHT"
2318
VALIGN="TOP"
2319
><TT
2320
CLASS="PARAMETER"
2321
><I
2322
>int1</I
2323
></TT
2324
> :</TD
2325
><TD
2326
WIDTH="80%"
2327
ALIGN="LEFT"
2328
VALIGN="TOP"
2329
> the int1 property.</TD
2330
></TR
2331
><TR
2332
><TD
2333
WIDTH="20%"
2334
ALIGN="RIGHT"
2335
VALIGN="TOP"
2336
><TT
2337
CLASS="PARAMETER"
2338
><I
2339
>int2</I
2340
></TT
2341
> :</TD
2342
><TD
2343
WIDTH="80%"
2344
ALIGN="LEFT"
2345
VALIGN="TOP"
2346
> the int2 property.</TD
2347
></TR
2348
><TR
2349
><TD
2350
WIDTH="20%"
2351
ALIGN="RIGHT"
2352
VALIGN="TOP"
2353
><TT
2354
CLASS="PARAMETER"
2355
><I
2356
>user_data</I
2357
></TT
2358
> :</TD
2359
><TD
2360
WIDTH="80%"
2361
ALIGN="LEFT"
2362
VALIGN="TOP"
2363
> the data passed to <A
2364
HREF="gladexml.html#GLADE-SET-CUSTOM-HANDLER"
2365
>glade_set_custom_handler</A
2366
>()</TD
2367
></TR
2368
><TR
2369
><TD
2370
WIDTH="20%"
2371
ALIGN="RIGHT"
2372
VALIGN="TOP"
2373
><SPAN
2374
CLASS="emphasis"
2375
><I
2376
CLASS="EMPHASIS"
2377
>Returns</I
2378
></SPAN
2379
> :</TD
2380
><TD
2381
WIDTH="80%"
2382
ALIGN="LEFT"
2383
VALIGN="TOP"
2384
> the GtkWidget.</TD
2385
></TR
2386
></TBODY
2387
></TABLE
2388
><P
2389
></P
2390
></DIV
2391
></DIV
2392
><HR><DIV
2393
CLASS="REFSECT2"
2394
><A
2395
NAME="AEN699"
2396
></A
2397
><H3
2398
><A
2399
NAME="GLADE-SET-CUSTOM-HANDLER"
2400
></A
2401
>glade_set_custom_handler ()</H3
2402
><TABLE
2403
BORDER="0"
2404
BGCOLOR="#D6E8FF"
2405
WIDTH="100%"
2406
CELLPADDING="6"
2407
><TR
2408
><TD
2409
><PRE
2410
CLASS="PROGRAMLISTING"
2411
>void glade_set_custom_handler (<A
2412
HREF="gladexml.html#GLADEXMLCUSTOMWIDGETHANDLER"
2413
>GladeXMLCustomWidgetHandler</A
2414
> handler,
2415
<GTKDOCLINK
2416
HREF="GPOINTER"
2417
>gpointer</GTKDOCLINK
2418
> user_data);</PRE
2419
></TD
2420
></TR
2421
></TABLE
2422
><P
2423
>Calling this function allows you to override the default behaviour
2424
when a Custom widget is found in an interface. This could be used by
2425
a language binding to call some other function, or to limit what
2426
functions can be called to create custom widgets.</P
2427
><P
2428
></P
2429
><DIV
2430
CLASS="INFORMALTABLE"
2431
><A
2432
NAME="AEN707"
2433
></A
2434
><P
2435
></P
2436
><TABLE
2437
BORDER="0"
2438
WIDTH="100%"
2439
BGCOLOR="#FFD0D0"
2440
CELLSPACING="0"
2441
CELLPADDING="4"
2442
CLASS="CALSTABLE"
2443
><TBODY
2444
><TR
2445
><TD
2446
WIDTH="20%"
2447
ALIGN="RIGHT"
2448
VALIGN="TOP"
2449
><TT
2450
CLASS="PARAMETER"
2451
><I
2452
>handler</I
2453
></TT
2454
> :</TD
2455
><TD
2456
WIDTH="80%"
2457
ALIGN="LEFT"
2458
VALIGN="TOP"
2459
> the custom widget handler</TD
2460
></TR
2461
><TR
2462
><TD
2463
WIDTH="20%"
2464
ALIGN="RIGHT"
2465
VALIGN="TOP"
2466
><TT
2467
CLASS="PARAMETER"
2468
><I
2469
>user_data</I
2470
></TT
2471
> :</TD
2472
><TD
2473
WIDTH="80%"
2474
ALIGN="LEFT"
2475
VALIGN="TOP"
2476
> user data passed to the custom handler</TD
2477
></TR
2478
></TBODY
2479
></TABLE
2480
><P
2481
></P
2482
></DIV
2483
></DIV
2484
></DIV
2485
><DIV
2486
CLASS="NAVFOOTER"
2487
><BR
2488
CLEAR="all"><BR><TABLE
2489
WIDTH="100%"
2490
BORDER="0"
2491
BGCOLOR="#000000"
2492
CELLPADDING="1"
2493
CELLSPACING="0"
2494
><TR
2495
><TD
2496
WIDTH="25%"
2497
BGCOLOR="#C00000"
2498
ALIGN="left"
2499
><A
2500
HREF="libglade-libglade-initialisation.html"
2501
><FONT
2502
COLOR="#FFFFFF"
2503
SIZE="3"
2504
><B
2505
><<< Previous Page</B
2506
></FONT
2507
></A
2508
></TD
2509
><TD
2510
WIDTH="25%"
2511
BGCOLOR="#0000C0"
2512
ALIGN="center"
2513
><FONT
2514
COLOR="#FFFFFF"
2515
SIZE="3"
2516
><B
2517
><A
2518
HREF="libglade.html"
2519
><FONT
2520
COLOR="#FFFFFF"
2521
SIZE="3"
2522
><B
2523
>Home</B
2524
></FONT
2525
></A
2526
></B
2527
></FONT
2528
></TD
2529
><TD
2530
WIDTH="25%"
2531
BGCOLOR="#00C000"
2532
ALIGN="center"
2533
><FONT
2534
COLOR="#FFFFFF"
2535
SIZE="3"
2536
><B
2537
><A
2538
HREF="libglade-lib.html"
2539
><FONT
2540
COLOR="#FFFFFF"
2541
SIZE="3"
2542
><B
2543
>Up</B
2544
></FONT
2545
></A
2546
></B
2547
></FONT
2548
></TD
2549
><TD
2550
WIDTH="25%"
2551
BGCOLOR="#C00000"
2552
ALIGN="right"
2553
><A
2554
HREF="libglade-libglade-sax-parser.html"
2555
><FONT
2556
COLOR="#FFFFFF"
2557
SIZE="3"
2558
><B
2559
>Next Page >>></B
2560
></FONT
2561
></A
2562
></TD
2563
></TR
2564
><TR
2565
><TD
2566
COLSPAN="2"
2567
ALIGN="left"
2568
><FONT
2569
COLOR="#FFFFFF"
2570
SIZE="3"
2571
><B
2572
>Libglade Initialisation</B
2573
></FONT
2574
></TD
2575
><TD
2576
COLSPAN="2"
2577
ALIGN="right"
2578
><FONT
2579
COLOR="#FFFFFF"
2580
SIZE="3"
2581
><B
2582
>Libglade SAX Parser</B
2583
></FONT
2584
></TD
2585
></TR
2586
></TABLE
2587
></DIV
2588
></BODY
2589
></HTML
2590
>
b'\\ No newline at end of file'
Loggerhead is a web-based interface for Breezy
Version: 2.0.1