| 1 <?xml version='1.0' encoding="ISO-8859-1"?> |
1 <?xml version='1.0' encoding="ISO-8859-1"?> |
| 2 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" |
2 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" |
| 3 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ |
3 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ |
| 4 ]> |
4 ]> |
| 5 <chapter id="chapter-signals-gtkimhtml"> |
5 <chapter id="chapter-signals-gtkimhtml"> |
| 6 <title>IMHtml signals</title> |
6 <title>IMHtml signals</title> |
| 7 |
7 |
| |
8 <refsect1 id="gtkimhtml.signals" role="signal_proto"> |
| |
9 <title role="signal_proto.title">List of signals</title> |
| |
10 <synopsis> |
| |
11 "<link linkend="gtkimhtml-url_clicked">url_clicked</link>" |
| |
12 "<link linkend="gtkimhtml-format_buttons_update">format_buttons_update</link>" |
| |
13 "<link linkend="gtkimhtml-format_function_clear">format_function_clear</link>" |
| |
14 "<link linkend="gtkimhtml-format_function_toggle">format_function_toggle</link>" |
| |
15 "<link linkend="gtkimhtml-format_function_update">format_function_update</link>" |
| |
16 "<link linkend="gtkimhtml-paste">paste</link>" |
| |
17 </synopsis> |
| |
18 </refsect1> |
| |
19 |
| |
20 <refsect1 id="gtkimhtml.signal-details" role="signals"> |
| |
21 <title role="signals.title">Signal details</title> |
| |
22 |
| |
23 <refsect2 id="gtkimhtml-url_clicked" role="signal"> |
| |
24 <title>The <literal>"url_clicked"</literal> signal</title> |
| 8 <programlisting> |
25 <programlisting> |
| 9 @signals |
26 void user_function (GtkIMHtml *imhtml, |
| 10 @signal url_clicked |
27 char *uri, |
| 11 @signal format_buttons_update |
28 gpointer user_data)</programlisting> |
| 12 @signal format_function_clear |
29 <para> |
| 13 @signal format_function_toggle |
30 Emitted when a link is clicked. |
| 14 @signal format_function_update |
31 </para> |
| 15 @signal paste |
32 <variablelist role="params"> |
| 16 @endsignals |
33 <varlistentry> |
| |
34 <term><parameter>imhtml</parameter> :</term> |
| |
35 <listitem><simpara>The GtkIMHtml emitting the signal.</simpara></listitem> |
| |
36 </varlistentry> |
| |
37 <varlistentry> |
| |
38 <term><parameter>url</parameter> :</term> |
| |
39 <listitem><simpara>The uri.</simpara></listitem> |
| |
40 </varlistentry> |
| |
41 <varlistentry> |
| |
42 <term><parameter>user_data</parameter> :</term> |
| |
43 <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem> |
| |
44 </varlistentry> |
| |
45 </variablelist> |
| |
46 </refsect2> |
| 17 |
47 |
| 18 @see gtkimhtml.h |
48 <refsect2 id="gtkimhtml-format_buttons_update" role="signal"> |
| |
49 <title>The <literal>"format_buttons_update"</literal> signal</title> |
| |
50 <programlisting> |
| |
51 void user_function (GtkIMHtml *imhtml, |
| |
52 GtkIMHtmlButtons buttons, |
| |
53 gpointer data)</programlisting> |
| |
54 <para> |
| |
55 Emitted when allowed formatting has changed. |
| |
56 </para> |
| |
57 <variablelist role="params"> |
| |
58 <varlistentry> |
| |
59 <term><parameter>imhtml</parameter> :</term> |
| |
60 <listitem><simpara>The GtkIMHtml emitting the signal.</simpara></listitem> |
| |
61 </varlistentry> |
| |
62 <varlistentry> |
| |
63 <term><parameter>buttons</parameter> :</term> |
| |
64 <listitem><simpara>GtkIMHtmlButtons for the GtkIMHtml.</simpara></listitem> |
| |
65 </varlistentry> |
| |
66 <varlistentry> |
| |
67 <term><parameter>data</parameter> :</term> |
| |
68 <listitem><simpara>User defined data.</simpara></listitem> |
| |
69 </varlistentry> |
| |
70 </variablelist> |
| |
71 </refsect2> |
| 19 |
72 |
| 20 @signaldef url_clicked |
73 <refsect2 id="gtkimhtml-format_function_clear" role="signal"> |
| 21 @signalproto |
74 <title>The <literal>"format_function_clear"</literal> signal</title> |
| 22 void (*url_clicked)(GtkIMHtml *imhtml, char *uri); |
75 <programlisting> |
| 23 @endsignalproto |
76 void user_function (GtkIMHtml *imhtml, |
| 24 @signaldesc Emitted when a link is clicked |
77 gpointer data)</programlisting> |
| 25 @param imhtml The GtkIMHtml emitting the signal. |
78 <para> |
| 26 @param url The uri. |
79 Emitted when clearing the formatting for the GtkIMHtml. |
| 27 @endsignaldef |
80 </para> |
| |
81 <variablelist role="params"> |
| |
82 <varlistentry> |
| |
83 <term><parameter>imhtml</parameter> :</term> |
| |
84 <listitem><simpara>The GtkIMHtml emitting the signal.</simpara></listitem> |
| |
85 </varlistentry> |
| |
86 <varlistentry> |
| |
87 <term><parameter>data</parameter> :</term> |
| |
88 <listitem><simpara>User defined data.</simpara></listitem> |
| |
89 </varlistentry> |
| |
90 </variablelist> |
| |
91 </refsect2> |
| 28 |
92 |
| 29 @signaldef format_buttons_update |
93 <refsect2 id="gtkimhtml-format_function_toggle" role="signal"> |
| 30 @signalproto |
94 <title>The <literal>"format_function_toggle"</literal> signal</title> |
| 31 void (*format_buttons_update)(GtkIMHtml *imhtml, GtkIMHtmlButtons buttons, gpointer data); |
95 <programlisting> |
| 32 @endsignalproto |
96 void user_function (GtkIMHtml *imhtml, |
| 33 @signaldesc Emitted when allowed formatting has changed. |
97 GtkIMHtmlButtons buttons, |
| 34 @param imhtml The GtkIMHtml emitting the signal. |
98 gpointer data)</programlisting> |
| 35 @param buttons GtkIMHtmlButtons for the GtkIMHtml. |
99 <para> |
| 36 @param data User defined data. |
100 Emitted when a format has been toggled. |
| 37 @endsignaldef |
101 </para> |
| |
102 <variablelist role="params"> |
| |
103 <varlistentry> |
| |
104 <term><parameter>imhtml</parameter> :</term> |
| |
105 <listitem><simpara>The GtkIMHtml emitting the signal.</simpara></listitem> |
| |
106 </varlistentry> |
| |
107 <varlistentry> |
| |
108 <term><parameter>buttons</parameter> :</term> |
| |
109 <listitem><simpara>GtkIMHtmlButtons for the GtkIMHtml.</simpara></listitem> |
| |
110 </varlistentry> |
| |
111 <varlistentry> |
| |
112 <term><parameter>data</parameter> :</term> |
| |
113 <listitem><simpara>User defined data.</simpara></listitem> |
| |
114 </varlistentry> |
| |
115 </variablelist> |
| |
116 </refsect2> |
| 38 |
117 |
| 39 @signaldef format_function_clear |
118 <refsect2 id="gtkimhtml-format_function_update" role="signal"> |
| 40 @signalproto |
119 <title>The <literal>"format_function_update"</literal> signal</title> |
| 41 void (*format_function_clear)(GtkIMHtml *imhtml, gpointer data); |
120 <programlisting> |
| 42 @endsignalproto |
121 void user_function (GtkIMHtml *imhtml, |
| 43 @signaldesc Emitted when clearing the formatting for the GtkIMHtml. |
122 gpointer data)</programlisting> |
| 44 @param imhtml The GtkIMHtml emitting the signal. |
123 <para> |
| 45 @param data User defined data. |
124 Emitted when the cursor has moved and formatting has changed. |
| 46 @endsignaldef |
125 </para> |
| |
126 <variablelist role="params"> |
| |
127 <varlistentry> |
| |
128 <term><parameter>imhtml</parameter> :</term> |
| |
129 <listitem><simpara>The GtkIMHtml emitting the signal.</simpara></listitem> |
| |
130 </varlistentry> |
| |
131 <varlistentry> |
| |
132 <term><parameter>data</parameter> :</term> |
| |
133 <listitem><simpara>User defined data.</simpara></listitem> |
| |
134 </varlistentry> |
| |
135 </variablelist> |
| |
136 </refsect2> |
| 47 |
137 |
| 48 @signaldef format_function_toggle |
138 <refsect2 id="gtkimhtml-paste" role="signal"> |
| 49 @signalproto |
139 <title>The <literal>"paste"</literal> signal</title> |
| 50 void (*format_function_toggle)(GtkIMHtml *imhtml, GtkIMHtmlButtons buttons, gpointer data); |
140 <programlisting> |
| 51 @endsignalproto |
141 void user_function (GtkIMHtml *imhtml, |
| 52 @signaldesc Emitted when a format has been toggled. |
142 char *format, |
| 53 @param imhtml The GtkIMHtml emitting the signal. |
143 gpointer user_data)</programlisting> |
| 54 @param buttons GtkIMHtmlButtons for the GtkIMHtml. |
144 <para> |
| 55 @param data User defined data. |
145 Emitted when paste from the clipboard is requested. |
| 56 @endsignaldef |
146 </para> |
| |
147 <variablelist role="params"> |
| |
148 <varlistentry> |
| |
149 <term><parameter>imhtml</parameter> :</term> |
| |
150 <listitem><simpara>The GtkIMHtml emitting the signal.</simpara></listitem> |
| |
151 </varlistentry> |
| |
152 <varlistentry> |
| |
153 <term><parameter>format</parameter> :</term> |
| |
154 <listitem><simpara>If 'text', then the formatting of the clipboard content will be removed before pasting. If empty or 'html', then the formatting will not be removed. Any other value for this parameter is ignored and nothing is pasted.</simpara></listitem> |
| |
155 </varlistentry> |
| |
156 <varlistentry> |
| |
157 <term><parameter>user_data</parameter> :</term> |
| |
158 <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem> |
| |
159 </varlistentry> |
| |
160 </variablelist> |
| |
161 </refsect2> |
| 57 |
162 |
| 58 @signaldef format_function_update |
163 </refsect1> |
| 59 @signalproto |
|
| 60 void (*format_function_update)(GtkIMHtml *imhtml, gpointer data); |
|
| 61 @endsignalproto |
|
| 62 @signaldesc Emitted when the cursor has moved and formatting has changed |
|
| 63 @param imhtml The GtkIMHtml emitting the signal. |
|
| 64 @param data User defined data. |
|
| 65 @endsignaldef |
|
| 66 |
164 |
| 67 @signaldef paste |
|
| 68 @signalproto |
|
| 69 void (*paste) (GtkIMHtml *imhtml, char *format) |
|
| 70 @endsignalproto |
|
| 71 @signaldesc Emitted when paste from the clipboard is requested. |
|
| 72 @param imhtml The GtkIMHtml emitting the signal. |
|
| 73 @param format If 'text', then the formatting of the clipboard content |
|
| 74 will be removed before pasting. If empty or 'html', then |
|
| 75 the formatting will not be removed. Any other value for |
|
| 76 this parameter is ignored and nothing is pasted. |
|
| 77 @endsignaldef |
|
| 78 |
|
| 79 </programlisting> |
|
| 80 </chapter> |
165 </chapter> |