atk 2.0.2-x86-mingw32 → 2.0.3-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (95) hide show
  1. checksums.yaml +7 -0
  2. data/README +2 -2
  3. data/Rakefile +2 -1
  4. data/ext/atk/extconf.rb +1 -1
  5. data/ext/atk/rbatkcomponent.c +0 -4
  6. data/ext/atk/rbatkdocument.c +0 -4
  7. data/ext/atk/rbatkrelation.c +0 -4
  8. data/ext/atk/rbatkrelationset.c +0 -4
  9. data/ext/atk/rbatkutil.c +0 -4
  10. data/lib/1.9/atk.so +0 -0
  11. data/lib/2.0/atk.so +0 -0
  12. data/vendor/local/bin/libatk-1.0-0.dll +0 -0
  13. data/vendor/local/include/atk-1.0/atk/atk-enum-types.h +2 -0
  14. data/vendor/local/include/atk-1.0/atk/atkaction.h +0 -1
  15. data/vendor/local/include/atk-1.0/atk/atkcomponent.h +38 -2
  16. data/vendor/local/include/atk-1.0/atk/atkdocument.h +7 -7
  17. data/vendor/local/include/atk-1.0/atk/atkeditabletext.h +0 -3
  18. data/vendor/local/include/atk-1.0/atk/atkhyperlink.h +1 -2
  19. data/vendor/local/include/atk-1.0/atk/atkhyperlinkimpl.h +10 -19
  20. data/vendor/local/include/atk-1.0/atk/atkhypertext.h +0 -4
  21. data/vendor/local/include/atk-1.0/atk/atkimage.h +0 -3
  22. data/vendor/local/include/atk-1.0/atk/atkobject.h +40 -78
  23. data/vendor/local/include/atk-1.0/atk/atkregistry.h +15 -0
  24. data/vendor/local/include/atk-1.0/atk/atkselection.h +0 -3
  25. data/vendor/local/include/atk-1.0/atk/atktable.h +0 -5
  26. data/vendor/local/include/atk-1.0/atk/atktext.h +72 -11
  27. data/vendor/local/include/atk-1.0/atk/atkutil.h +4 -0
  28. data/vendor/local/include/atk-1.0/atk/atkvalue.h +0 -1
  29. data/vendor/local/include/atk-1.0/atk/atkversion.h +2 -2
  30. data/vendor/local/include/atk-1.0/atk/atkwindow.h +0 -2
  31. data/vendor/local/lib/atk-1.0.def +2 -0
  32. data/vendor/local/lib/girepository-1.0/Atk-1.0.typelib +0 -0
  33. data/vendor/local/lib/libatk-1.0.dll.a +0 -0
  34. data/vendor/local/lib/libatk-1.0.la +2 -2
  35. data/vendor/local/lib/pkgconfig/atk.pc +1 -1
  36. data/vendor/local/share/gir-1.0/Atk-1.0.gir +2497 -2086
  37. data/vendor/local/share/gtk-doc/html/atk/AtkAction.html +80 -43
  38. data/vendor/local/share/gtk-doc/html/atk/AtkComponent.html +246 -33
  39. data/vendor/local/share/gtk-doc/html/atk/AtkDocument.html +94 -39
  40. data/vendor/local/share/gtk-doc/html/atk/AtkEditableText.html +22 -27
  41. data/vendor/local/share/gtk-doc/html/atk/AtkGObjectAccessible.html +17 -21
  42. data/vendor/local/share/gtk-doc/html/atk/AtkHyperlink.html +34 -25
  43. data/vendor/local/share/gtk-doc/html/atk/AtkHypertext.html +25 -30
  44. data/vendor/local/share/gtk-doc/html/atk/AtkImage.html +26 -26
  45. data/vendor/local/share/gtk-doc/html/atk/AtkNoOpObject.html +15 -18
  46. data/vendor/local/share/gtk-doc/html/atk/AtkNoOpObjectFactory.html +14 -18
  47. data/vendor/local/share/gtk-doc/html/atk/AtkObject.html +119 -77
  48. data/vendor/local/share/gtk-doc/html/atk/AtkObjectFactory.html +15 -25
  49. data/vendor/local/share/gtk-doc/html/atk/AtkRegistry.html +12 -22
  50. data/vendor/local/share/gtk-doc/html/atk/AtkRelation.html +17 -20
  51. data/vendor/local/share/gtk-doc/html/atk/AtkRelationSet.html +21 -22
  52. data/vendor/local/share/gtk-doc/html/atk/AtkSelection.html +24 -33
  53. data/vendor/local/share/gtk-doc/html/atk/AtkStateSet.html +13 -16
  54. data/vendor/local/share/gtk-doc/html/atk/AtkStreamableContent.html +28 -29
  55. data/vendor/local/share/gtk-doc/html/atk/AtkTable.html +47 -54
  56. data/vendor/local/share/gtk-doc/html/atk/AtkText.html +451 -191
  57. data/vendor/local/share/gtk-doc/html/atk/AtkUtil.html +43 -20
  58. data/vendor/local/share/gtk-doc/html/atk/AtkValue.html +21 -24
  59. data/vendor/local/share/gtk-doc/html/atk/AtkWindow.html +12 -15
  60. data/vendor/local/share/gtk-doc/html/atk/api-index-1-12.html +8 -8
  61. data/vendor/local/share/gtk-doc/html/atk/api-index-1-13.html +8 -8
  62. data/vendor/local/share/gtk-doc/html/atk/api-index-1-18.html +8 -8
  63. data/vendor/local/share/gtk-doc/html/atk/api-index-1-20.html +8 -8
  64. data/vendor/local/share/gtk-doc/html/atk/api-index-1-22.html +8 -8
  65. data/vendor/local/share/gtk-doc/html/atk/api-index-1-24.html +8 -8
  66. data/vendor/local/share/gtk-doc/html/atk/api-index-1-26.html +8 -8
  67. data/vendor/local/share/gtk-doc/html/atk/api-index-1-28.html +8 -8
  68. data/vendor/local/share/gtk-doc/html/atk/api-index-1-3.html +8 -8
  69. data/vendor/local/share/gtk-doc/html/atk/api-index-1-30.html +10 -8
  70. data/vendor/local/share/gtk-doc/html/atk/api-index-1-32.html +8 -8
  71. data/vendor/local/share/gtk-doc/html/atk/api-index-1-4.html +8 -8
  72. data/vendor/local/share/gtk-doc/html/atk/api-index-1-6.html +8 -8
  73. data/vendor/local/share/gtk-doc/html/atk/api-index-deprecated.html +34 -8
  74. data/vendor/local/share/gtk-doc/html/atk/api-index-full.html +26 -10
  75. data/vendor/local/share/gtk-doc/html/atk/atk-AtkHyperlinkImpl.html +50 -37
  76. data/vendor/local/share/gtk-doc/html/atk/atk-AtkPlug.html +34 -15
  77. data/vendor/local/share/gtk-doc/html/atk/atk-AtkSocket.html +51 -22
  78. data/vendor/local/share/gtk-doc/html/atk/atk-AtkState.html +14 -17
  79. data/vendor/local/share/gtk-doc/html/atk/atk-Versioning-Utilities.html +14 -17
  80. data/vendor/local/share/gtk-doc/html/atk/atk.devhelp2 +27 -14
  81. data/vendor/local/share/gtk-doc/html/atk/atk.html +114 -15
  82. data/vendor/local/share/gtk-doc/html/atk/home.png +0 -0
  83. data/vendor/local/share/gtk-doc/html/atk/index.html +43 -35
  84. data/vendor/local/share/gtk-doc/html/atk/index.sgml +16 -7
  85. data/vendor/local/share/gtk-doc/html/atk/left-insensitive.png +0 -0
  86. data/vendor/local/share/gtk-doc/html/atk/left.png +0 -0
  87. data/vendor/local/share/gtk-doc/html/atk/right-insensitive.png +0 -0
  88. data/vendor/local/share/gtk-doc/html/atk/right.png +0 -0
  89. data/vendor/local/share/gtk-doc/html/atk/style.css +71 -16
  90. data/vendor/local/share/gtk-doc/html/atk/up-insensitive.png +0 -0
  91. data/vendor/local/share/gtk-doc/html/atk/up.png +0 -0
  92. data/vendor/local/share/gtk-doc/html/atk/utilities.html +33 -0
  93. data/vendor/local/share/locale/an/LC_MESSAGES/atk10.mo +0 -0
  94. data/vendor/local/share/locale/ja/LC_MESSAGES/atk10.mo +0 -0
  95. metadata +15 -14
data/vendor/local/share/gtk-doc/html/atk/AtkStreamableContent.html CHANGED
@@ -8,32 +8,30 @@
8
8
  <link rel="up" href="atk.html" title="ATK Library">
9
9
  <link rel="prev" href="AtkStateSet.html" title="AtkStateSet">
10
10
  <link rel="next" href="AtkTable.html" title="AtkTable">
11
- <meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
11
+ <meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
12
12
  <link rel="stylesheet" href="style.css" type="text/css">
13
13
  </head>
14
14
  <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
- <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
- <tr valign="middle">
17
- <td><a accesskey="p" href="AtkStateSet.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
- <td><a accesskey="u" href="atk.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
- <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
- <th width="100%" align="center">ATK - Accessibility Toolkit</th>
21
- <td><a accesskey="n" href="AtkTable.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
- </tr>
23
- <tr><td colspan="5" class="shortcuts">
24
- <a href="#AtkStreamableContent.synopsis" class="shortcut">Top</a>
15
+ <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
+ <td width="100%" align="left">
17
+ <a href="#" class="shortcut">Top</a>
25
18
   | 
26
19
  <a href="#AtkStreamableContent.description" class="shortcut">Description</a>
27
20
   | 
28
21
  <a href="#AtkStreamableContent.object-hierarchy" class="shortcut">Object Hierarchy</a>
29
- </td></tr>
30
- </table>
22
+ </td>
23
+ <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
24
+ <td><a accesskey="u" href="atk.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
25
+ <td><a accesskey="p" href="AtkStateSet.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
26
+ <td><a accesskey="n" href="AtkTable.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
27
+ </tr></table>
31
28
  <div class="refentry">
32
29
  <a name="AtkStreamableContent"></a><div class="titlepage"></div>
33
30
  <div class="refnamediv"><table width="100%"><tr>
34
31
  <td valign="top">
35
32
  <h2><span class="refentrytitle"><a name="AtkStreamableContent.top_of_page"></a>AtkStreamableContent</span></h2>
36
- <p>AtkStreamableContent — The ATK interface which provides access to streamable content.</p>
33
+ <p>AtkStreamableContent — The ATK interface which provides access to
34
+ streamable content.</p>
37
35
  </td>
38
36
  <td valign="top" align="right"></td>
39
37
  </tr></table></div>
@@ -61,22 +59,24 @@ const <span class="returnvalue">gchar</span> * <a class="link" href="AtkSt
61
59
  <div class="refsect1">
62
60
  <a name="AtkStreamableContent.description"></a><h2>Description</h2>
63
61
  <p>
64
- An interface whereby an object allows its backing content to be streamed to
65
- clients. Typical implementors would be images or icons, HTML content, or
66
- multimedia display/rendering widgets.
62
+ An interface whereby an object allows its backing content to be
63
+ streamed to clients. Typical implementors would be images or
64
+ icons, HTML content, or multimedia display/rendering widgets.
67
65
  </p>
68
66
  <p>
69
- Negotiation of content type is allowed. Clients may examine the backing data
70
- and transform, convert, or parse the content in order to present it in an alternate form to end-users.
67
+ Negotiation of content type is allowed. Clients may examine the
68
+ backing data and transform, convert, or parse the content in order
69
+ to present it in an alternate form to end-users.
71
70
  </p>
72
71
  <p>
73
- The AtkStreamableContent interface is particularly useful for saving,
74
- printing, or post-processing entire documents, or for persisting alternate
75
- views of a document. If document content itself is being serialized,
76
- stored, or converted, then use of the AtkStreamableContent interface can help
77
- address performance issues. Unlike most ATK interfaces,
78
- this interface is not strongly tied to the current user-agent view of the
79
- a particular document, but may in some cases give access to the underlying model data.
72
+ The AtkStreamableContent interface is particularly useful for
73
+ saving, printing, or post-processing entire documents, or for
74
+ persisting alternate views of a document. If document content
75
+ itself is being serialized, stored, or converted, then use of the
76
+ AtkStreamableContent interface can help address performance
77
+ issues. Unlike most ATK interfaces, this interface is not strongly
78
+ tied to the current user-agent view of the a particular document,
79
+ but may in some cases give access to the underlying model data.
80
80
  </p>
81
81
  </div>
82
82
  <div class="refsect1">
@@ -85,7 +85,6 @@ a particular document, but may in some cases give access to the underlying model
85
85
  <a name="AtkStreamableContent-struct"></a><h3>AtkStreamableContent</h3>
86
86
  <pre class="programlisting">typedef struct _AtkStreamableContent AtkStreamableContent;</pre>
87
87
  <p>
88
- The AtkStreamableContent structure does not contain any fields.
89
88
  </p>
90
89
  </div>
91
90
  <hr>
@@ -133,7 +132,7 @@ type is at position 0, the second at position 1, and so on.
133
132
  </tr>
134
133
  <tr>
135
134
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
136
- <td>: a gchar* representing the specified mime type; the caller
135
+ <td>a gchar* representing the specified mime type; the caller
137
136
  should not free the character string.</td>
138
137
  </tr>
139
138
  </tbody>
@@ -208,6 +207,6 @@ can be constructed.</td>
208
207
  </div>
209
208
  <div class="footer">
210
209
  <hr>
211
- Generated by GTK-Doc V1.18.1</div>
210
+ Generated by GTK-Doc V1.19.1</div>
212
211
  </body>
213
212
  </html>
data/vendor/local/share/gtk-doc/html/atk/AtkTable.html CHANGED
@@ -8,20 +8,13 @@
8
8
  <link rel="up" href="atk.html" title="ATK Library">
9
9
  <link rel="prev" href="AtkStreamableContent.html" title="AtkStreamableContent">
10
10
  <link rel="next" href="AtkText.html" title="AtkText">
11
- <meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
11
+ <meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
12
12
  <link rel="stylesheet" href="style.css" type="text/css">
13
13
  </head>
14
14
  <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
- <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
- <tr valign="middle">
17
- <td><a accesskey="p" href="AtkStreamableContent.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
- <td><a accesskey="u" href="atk.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
- <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
- <th width="100%" align="center">ATK - Accessibility Toolkit</th>
21
- <td><a accesskey="n" href="AtkText.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
- </tr>
23
- <tr><td colspan="5" class="shortcuts">
24
- <a href="#AtkTable.synopsis" class="shortcut">Top</a>
15
+ <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
+ <td width="100%" align="left">
17
+ <a href="#" class="shortcut">Top</a>
25
18
   | 
26
19
  <a href="#AtkTable.description" class="shortcut">Description</a>
27
20
   | 
@@ -30,15 +23,19 @@
30
23
  <a href="#AtkTable.implementations" class="shortcut">Known Implementations</a>
31
24
   | 
32
25
  <a href="#AtkTable.signals" class="shortcut">Signals</a>
33
- </td></tr>
34
- </table>
26
+ </td>
27
+ <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
28
+ <td><a accesskey="u" href="atk.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
29
+ <td><a accesskey="p" href="AtkStreamableContent.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
30
+ <td><a accesskey="n" href="AtkText.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
31
+ </tr></table>
35
32
  <div class="refentry">
36
33
  <a name="AtkTable"></a><div class="titlepage"></div>
37
34
  <div class="refnamediv"><table width="100%"><tr>
38
35
  <td valign="top">
39
36
  <h2><span class="refentrytitle"><a name="AtkTable.top_of_page"></a>AtkTable</span></h2>
40
- <p>AtkTable — The ATK interface implemented for UI components which contain tabular or
41
- row/column information.</p>
37
+ <p>AtkTable — The ATK interface implemented for UI components
38
+ which contain tabular or row/column information.</p>
42
39
  </td>
43
40
  <td valign="top" align="right"></td>
44
41
  </tr></table></div>
@@ -138,25 +135,25 @@ AtkTable is implemented by
138
135
  <div class="refsect1">
139
136
  <a name="AtkTable.description"></a><h2>Description</h2>
140
137
  <p>
141
- <a class="link" href="AtkTable.html" title="AtkTable"><span class="type">AtkTable</span></a> should be implemented by components which present elements
142
- ordered via rows and columns. It may also be used to present
143
- tree-structured information if the nodes of the trees can be said to
144
- contain multiple "columns". Individual elements of an <a class="link" href="AtkTable.html" title="AtkTable"><span class="type">AtkTable</span></a> are
145
- typically referred to as "cells", and these cells are exposed by
146
- <a class="link" href="AtkTable.html" title="AtkTable"><span class="type">AtkTable</span></a> as child <a href="AtkObject.html"><span class="type">AtkObjects</span></a> of the <a class="link" href="AtkTable.html" title="AtkTable"><span class="type">AtkTable</span></a>. Both row/column and
147
- child-index-based access to these children is provided.
148
- </p>
149
- <p>
150
- Children of <a class="link" href="AtkTable.html" title="AtkTable"><span class="type">AtkTable</span></a> are frequently "lightweight" objects, that is,
151
- they may not have backing widgets in the host UI toolkit. They are
152
- therefore often transient.
138
+ <a class="link" href="AtkTable.html" title="AtkTable"><span class="type">AtkTable</span></a> should be implemented by components which present
139
+ elements ordered via rows and columns. It may also be used to
140
+ present tree-structured information if the nodes of the trees can
141
+ be said to contain multiple "columns". Individual elements of an
142
+ <a class="link" href="AtkTable.html" title="AtkTable"><span class="type">AtkTable</span></a> are typically referred to as "cells", and these cells are
143
+ exposed by <a class="link" href="AtkTable.html" title="AtkTable"><span class="type">AtkTable</span></a> as child <a href="AtkObject.html"><span class="type">AtkObjects</span></a> of the <a class="link" href="AtkTable.html" title="AtkTable"><span class="type">AtkTable</span></a>. Both
144
+ row/column and child-index-based access to these children is
145
+ provided.
153
146
  </p>
154
147
  <p>
155
- Since tables are often very complex, <a class="link" href="AtkTable.html" title="AtkTable"><span class="type">AtkTable</span></a> includes provision for
156
- offering simplified summary information, as well as row and column
157
- headers and captions. Headers and captions are <a href="AtkObject.html"><span class="type">AtkObjects</span></a> which may
158
- implement other interfaces (<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>, <a class="link" href="AtkImage.html" title="AtkImage"><span class="type">AtkImage</span></a>, etc.) as appropriate.
159
- <a class="link" href="AtkTable.html" title="AtkTable"><span class="type">AtkTable</span></a> summaries may themselves be (simplified) <a href="AtkTable.html"><span class="type">AtkTables</span></a>, etc.
148
+ Children of <a class="link" href="AtkTable.html" title="AtkTable"><span class="type">AtkTable</span></a> are frequently "lightweight" objects, that
149
+ is, they may not have backing widgets in the host UI toolkit. They
150
+ are therefore often transient.
151
+ Since tables are often very complex, <a class="link" href="AtkTable.html" title="AtkTable"><span class="type">AtkTable</span></a> includes provision
152
+ for offering simplified summary information, as well as row and
153
+ column headers and captions. Headers and captions are <a href="AtkObject.html"><span class="type">AtkObjects</span></a>
154
+ which may implement other interfaces (<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>, <a class="link" href="AtkImage.html" title="AtkImage"><span class="type">AtkImage</span></a>, etc.) as
155
+ appropriate. <a class="link" href="AtkTable.html" title="AtkTable"><span class="type">AtkTable</span></a> summaries may themselves be (simplified)
156
+ <a href="AtkTable.html"><span class="type">AtkTables</span></a>, etc.
160
157
  </p>
161
158
  </div>
162
159
  <div class="refsect1">
@@ -165,7 +162,6 @@ implement other interfaces (<a class="link" href="AtkText.html" title="AtkText">
165
162
  <a name="AtkTable-struct"></a><h3>AtkTable</h3>
166
163
  <pre class="programlisting">typedef struct _AtkTable AtkTable;</pre>
167
164
  <p>
168
- The AtkTable structure does not contain any fields.
169
165
  </p>
170
166
  </div>
171
167
  <hr>
@@ -1002,8 +998,8 @@ the selection, or 0 if value does not implement this interface.</td>
1002
998
  <span class="type">gint</span> arg2,
1003
999
  <span class="type">gpointer</span> user_data) : <code class="literal">Run Last</code></pre>
1004
1000
  <p>
1005
- The "column-deleted" signal is emitted by an object which implements the
1006
- AtkTable interface when a column is deleted.
1001
+ The "column-deleted" signal is emitted by an object which
1002
+ implements the AtkTable interface when a column is deleted.
1007
1003
  </p>
1008
1004
  <div class="variablelist"><table border="0">
1009
1005
  <col align="left" valign="top">
@@ -1035,8 +1031,8 @@ AtkTable interface when a column is deleted.
1035
1031
  <span class="type">gint</span> arg2,
1036
1032
  <span class="type">gpointer</span> user_data) : <code class="literal">Run Last</code></pre>
1037
1033
  <p>
1038
- The "column-inserted" signal is emitted by an object which implements the
1039
- AtkTable interface when a column is inserted.
1034
+ The "column-inserted" signal is emitted by an object which
1035
+ implements the AtkTable interface when a column is inserted.
1040
1036
  </p>
1041
1037
  <div class="variablelist"><table border="0">
1042
1038
  <col align="left" valign="top">
@@ -1066,8 +1062,9 @@ AtkTable interface when a column is inserted.
1066
1062
  <pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="AtkTable.html" title="AtkTable"><span class="type">AtkTable</span></a> *atktable,
1067
1063
  <span class="type">gpointer</span> user_data) : <code class="literal">Run Last</code></pre>
1068
1064
  <p>
1069
- The "column-reordered" signal is emitted by an object which implements the
1070
- AtkTable interface when the columns are reordered.
1065
+ The "column-reordered" signal is emitted by an object which
1066
+ implements the AtkTable interface when the columns are
1067
+ reordered.
1071
1068
  </p>
1072
1069
  <div class="variablelist"><table border="0">
1073
1070
  <col align="left" valign="top">
@@ -1089,8 +1086,9 @@ AtkTable interface when the columns are reordered.
1089
1086
  <pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="AtkTable.html" title="AtkTable"><span class="type">AtkTable</span></a> *atktable,
1090
1087
  <span class="type">gpointer</span> user_data) : <code class="literal">Run Last</code></pre>
1091
1088
  <p>
1092
- The "model-changed" signal is emitted by an object which implements the
1093
- AtkTable interface when the model displayed by the table changes.
1089
+ The "model-changed" signal is emitted by an object which
1090
+ implements the AtkTable interface when the model displayed by
1091
+ the table changes.
1094
1092
  </p>
1095
1093
  <div class="variablelist"><table border="0">
1096
1094
  <col align="left" valign="top">
@@ -1114,8 +1112,8 @@ AtkTable interface when the model displayed by the table changes.
1114
1112
  <span class="type">gint</span> arg2,
1115
1113
  <span class="type">gpointer</span> user_data) : <code class="literal">Run Last</code></pre>
1116
1114
  <p>
1117
- The "row-deleted" signal is emitted by an object which implements the
1118
- AtkTable interface when a row is deleted.
1115
+ The "row-deleted" signal is emitted by an object which
1116
+ implements the AtkTable interface when a row is deleted.
1119
1117
  </p>
1120
1118
  <div class="variablelist"><table border="0">
1121
1119
  <col align="left" valign="top">
@@ -1147,8 +1145,8 @@ AtkTable interface when a row is deleted.
1147
1145
  <span class="type">gint</span> arg2,
1148
1146
  <span class="type">gpointer</span> user_data) : <code class="literal">Run Last</code></pre>
1149
1147
  <p>
1150
- The "row-inserted" signal is emitted by an object which implements the
1151
- AtkTable interface when a row is inserted.
1148
+ The "row-inserted" signal is emitted by an object which
1149
+ implements the AtkTable interface when a row is inserted.
1152
1150
  </p>
1153
1151
  <div class="variablelist"><table border="0">
1154
1152
  <col align="left" valign="top">
@@ -1178,8 +1176,9 @@ AtkTable interface when a row is inserted.
1178
1176
  <pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="AtkTable.html" title="AtkTable"><span class="type">AtkTable</span></a> *atktable,
1179
1177
  <span class="type">gpointer</span> user_data) : <code class="literal">Run Last</code></pre>
1180
1178
  <p>
1181
- The "row-reordered" signal is emitted by an object which implements the
1182
- AtkTable interface when the rows are reordered.
1179
+ The "row-reordered" signal is emitted by an object which
1180
+ implements the AtkTable interface when the rows are
1181
+ reordered.
1183
1182
  </p>
1184
1183
  <div class="variablelist"><table border="0">
1185
1184
  <col align="left" valign="top">
@@ -1196,15 +1195,9 @@ AtkTable interface when the rows are reordered.
1196
1195
  </table></div>
1197
1196
  </div>
1198
1197
  </div>
1199
- <div class="refsect1">
1200
- <a name="AtkTable.see-also"></a><h2>See Also</h2>
1201
- <p>
1202
- <a class="link" href="AtkObject.html" title="AtkObject"><span class="type">AtkObject</span></a>, <a class="link" href="atk-AtkState.html#ATK-STATE-TRANSIENT:CAPS"><span class="type">ATK_STATE_TRANSIENT</span></a>
1203
- </p>
1204
- </div>
1205
1198
  </div>
1206
1199
  <div class="footer">
1207
1200
  <hr>
1208
- Generated by GTK-Doc V1.18.1</div>
1201
+ Generated by GTK-Doc V1.19.1</div>
1209
1202
  </body>
1210
1203
  </html>
data/vendor/local/share/gtk-doc/html/atk/AtkText.html CHANGED
@@ -8,20 +8,13 @@
8
8
  <link rel="up" href="atk.html" title="ATK Library">
9
9
  <link rel="prev" href="AtkTable.html" title="AtkTable">
10
10
  <link rel="next" href="AtkUtil.html" title="AtkUtil">
11
- <meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
11
+ <meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
12
12
  <link rel="stylesheet" href="style.css" type="text/css">
13
13
  </head>
14
14
  <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
- <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
- <tr valign="middle">
17
- <td><a accesskey="p" href="AtkTable.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
- <td><a accesskey="u" href="atk.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
- <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
- <th width="100%" align="center">ATK - Accessibility Toolkit</th>
21
- <td><a accesskey="n" href="AtkUtil.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
- </tr>
23
- <tr><td colspan="5" class="shortcuts">
24
- <a href="#AtkText.synopsis" class="shortcut">Top</a>
15
+ <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
+ <td width="100%" align="left">
17
+ <a href="#" class="shortcut">Top</a>
25
18
   | 
26
19
  <a href="#AtkText.description" class="shortcut">Description</a>
27
20
   | 
@@ -30,21 +23,28 @@
30
23
  <a href="#AtkText.implementations" class="shortcut">Known Implementations</a>
31
24
   | 
32
25
  <a href="#AtkText.signals" class="shortcut">Signals</a>
33
- </td></tr>
34
- </table>
26
+ </td>
27
+ <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
28
+ <td><a accesskey="u" href="atk.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
29
+ <td><a accesskey="p" href="AtkTable.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
30
+ <td><a accesskey="n" href="AtkUtil.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
31
+ </tr></table>
35
32
  <div class="refentry">
36
33
  <a name="AtkText"></a><div class="titlepage"></div>
37
34
  <div class="refnamediv"><table width="100%"><tr>
38
35
  <td valign="top">
39
36
  <h2><span class="refentrytitle"><a name="AtkText.top_of_page"></a>AtkText</span></h2>
40
- <p>AtkText — The ATK interface implemented by components with text content.</p>
37
+ <p>AtkText — The ATK interface implemented by components
38
+ with text content.</p>
41
39
  </td>
42
40
  <td valign="top" align="right"></td>
43
41
  </tr></table></div>
44
42
  <div class="refsynopsisdiv">
45
43
  <a name="AtkText.synopsis"></a><h2>Synopsis</h2>
46
44
  <pre class="synopsis"> <a class="link" href="AtkText.html#AtkText-struct" title="AtkText">AtkText</a>;
45
+ struct <a class="link" href="AtkText.html#AtkTextIface" title="struct AtkTextIface">AtkTextIface</a>;
47
46
  enum <a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary">AtkTextBoundary</a>;
47
+ enum <a class="link" href="AtkText.html#AtkTextGranularity" title="enum AtkTextGranularity">AtkTextGranularity</a>;
48
48
  enum <a class="link" href="AtkText.html#AtkTextClipType" title="enum AtkTextClipType">AtkTextClipType</a>;
49
49
  struct <a class="link" href="AtkText.html#AtkTextRange" title="struct AtkTextRange">AtkTextRange</a>;
50
50
  struct <a class="link" href="AtkText.html#AtkTextRectangle" title="struct AtkTextRectangle">AtkTextRectangle</a>;
@@ -71,6 +71,11 @@ enum <a class="link" href="AtkText.html#AtkTextAttribute" title="
71
71
  <em class="parameter"><code><a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a> boundary_type</code></em>,
72
72
  <em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
73
73
  <em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);
74
+ <span class="returnvalue">gchar</span> * <a class="link" href="AtkText.html#atk-text-get-string-at-offset" title="atk_text_get_string_at_offset ()">atk_text_get_string_at_offset</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
75
+ <em class="parameter"><code><span class="type">gint</span> offset</code></em>,
76
+ <em class="parameter"><code><a class="link" href="AtkText.html#AtkTextGranularity" title="enum AtkTextGranularity"><span class="type">AtkTextGranularity</span></a> granularity</code></em>,
77
+ <em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
78
+ <em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);
74
79
  <span class="returnvalue">gint</span> <a class="link" href="AtkText.html#atk-text-get-caret-offset" title="atk_text_get_caret_offset ()">atk_text_get_caret_offset</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>);
75
80
  <span class="returnvalue">void</span> <a class="link" href="AtkText.html#atk-text-get-character-extents" title="atk_text_get_character_extents ()">atk_text_get_character_extents</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
76
81
  <em class="parameter"><code><span class="type">gint</span> offset</code></em>,
@@ -146,30 +151,31 @@ AtkText is implemented by
146
151
  "<a class="link" href="AtkText.html#AtkText-text-insert" title='The "text-insert" signal'>text-insert</a>" : <code class="literal">Has Details</code>
147
152
  "<a class="link" href="AtkText.html#AtkText-text-remove" title='The "text-remove" signal'>text-remove</a>" : <code class="literal">Has Details</code>
148
153
  "<a class="link" href="AtkText.html#AtkText-text-selection-changed" title='The "text-selection-changed" signal'>text-selection-changed</a>" : <code class="literal">Run Last</code>
149
- "<a class="link" href="AtkText.html#AtkText-text-update" title='The "text-update" signal'>text-update</a>" : <code class="literal">Has Details</code>
150
154
  </pre>
151
155
  </div>
152
156
  <div class="refsect1">
153
157
  <a name="AtkText.description"></a><h2>Description</h2>
154
158
  <p>
155
- <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> should be implemented by <a href="AtkObject.html"><span class="type">AtkObjects</span></a> on behalf of widgets that
156
- have text content which is either attributed or otherwise non-trivial.
157
- <a href="AtkObject.html"><span class="type">AtkObjects</span></a> whose text content is simple, unattributed, and very brief
158
- may expose that content via <a class="link" href="AtkObject.html#atk-object-get-name" title="atk_object_get_name ()"><span class="type">atk_object_get_name</span></a> instead; however if the
159
- text is editable, multi-line, typically longer than three or four words,
160
- attributed, selectable, or if the object already uses the 'name' ATK
161
- property for other information, the <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> interface should be used
162
- to expose the text content. In the case of editable text content,
159
+ <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> should be implemented by <a href="AtkObject.html"><span class="type">AtkObjects</span></a> on behalf of widgets
160
+ that have text content which is either attributed or otherwise
161
+ non-trivial. <a href="AtkObject.html"><span class="type">AtkObjects</span></a> whose text content is simple,
162
+ unattributed, and very brief may expose that content via
163
+ <a class="link" href="AtkObject.html#atk-object-get-name" title="atk_object_get_name ()"><span class="type">atk_object_get_name</span></a> instead; however if the text is editable,
164
+ multi-line, typically longer than three or four words, attributed,
165
+ selectable, or if the object already uses the 'name' ATK property
166
+ for other information, the <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> interface should be used to
167
+ expose the text content. In the case of editable text content,
163
168
  <a class="link" href="AtkEditableText.html" title="AtkEditableText"><span class="type">AtkEditableText</span></a> (a subtype of the <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> interface) should be
164
169
  implemented instead.
165
170
  </p>
166
171
  <p>
167
- <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> provides not only traversal facilities and change notification
168
- for text content, but also caret tracking and glyph bounding box
169
- calculations. Note that the text strings are exposed as UTF-8, and are
170
- therefore potentially multi-byte, and caret-to-byte offset mapping makes
171
- no assumptions about the character length; also bounding box
172
- glyph-to-offset mapping may be complex for languages which use ligatures.
172
+ <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> provides not only traversal facilities and change
173
+ notification for text content, but also caret tracking and glyph
174
+ bounding box calculations. Note that the text strings are exposed
175
+ as UTF-8, and are therefore potentially multi-byte, and
176
+ caret-to-byte offset mapping makes no assumptions about the
177
+ character length; also bounding box glyph-to-offset mapping may be
178
+ complex for languages which use ligatures.
173
179
  </p>
174
180
  </div>
175
181
  <div class="refsect1">
@@ -178,11 +184,217 @@ glyph-to-offset mapping may be complex for languages which use ligatures.
178
184
  <a name="AtkText-struct"></a><h3>AtkText</h3>
179
185
  <pre class="programlisting">typedef struct _AtkText AtkText;</pre>
180
186
  <p>
181
- The AtkText structure does not contain any fields.
182
187
  </p>
183
188
  </div>
184
189
  <hr>
185
190
  <div class="refsect2">
191
+ <a name="AtkTextIface"></a><h3>struct AtkTextIface</h3>
192
+ <pre class="programlisting">struct AtkTextIface {
193
+ GTypeInterface parent;
194
+
195
+ gchar* (* get_text) (AtkText *text,
196
+ gint start_offset,
197
+ gint end_offset);
198
+ gchar* (* get_text_after_offset) (AtkText *text,
199
+ gint offset,
200
+ AtkTextBoundary boundary_type,
201
+ gint *start_offset,
202
+ gint *end_offset);
203
+ gchar* (* get_text_at_offset) (AtkText *text,
204
+ gint offset,
205
+ AtkTextBoundary boundary_type,
206
+ gint *start_offset,
207
+ gint *end_offset);
208
+ gunichar (* get_character_at_offset) (AtkText *text,
209
+ gint offset);
210
+ gchar* (* get_text_before_offset) (AtkText *text,
211
+ gint offset,
212
+ AtkTextBoundary boundary_type,
213
+ gint *start_offset,
214
+ gint *end_offset);
215
+ gint (* get_caret_offset) (AtkText *text);
216
+ AtkAttributeSet* (* get_run_attributes) (AtkText *text,
217
+ gint offset,
218
+ gint *start_offset,
219
+ gint *end_offset);
220
+ AtkAttributeSet* (* get_default_attributes) (AtkText *text);
221
+ void (* get_character_extents) (AtkText *text,
222
+ gint offset,
223
+ gint *x,
224
+ gint *y,
225
+ gint *width,
226
+ gint *height,
227
+ AtkCoordType coords);
228
+ gint (* get_character_count) (AtkText *text);
229
+ gint (* get_offset_at_point) (AtkText *text,
230
+ gint x,
231
+ gint y,
232
+ AtkCoordType coords);
233
+ gint (* get_n_selections) (AtkText *text);
234
+ gchar* (* get_selection) (AtkText *text,
235
+ gint selection_num,
236
+ gint *start_offset,
237
+ gint *end_offset);
238
+ gboolean (* add_selection) (AtkText *text,
239
+ gint start_offset,
240
+ gint end_offset);
241
+ gboolean (* remove_selection) (AtkText *text,
242
+ gint selection_num);
243
+ gboolean (* set_selection) (AtkText *text,
244
+ gint selection_num,
245
+ gint start_offset,
246
+ gint end_offset);
247
+ gboolean (* set_caret_offset) (AtkText *text,
248
+ gint offset);
249
+
250
+ /*
251
+ * signal handlers
252
+ */
253
+ void (* text_changed) (AtkText *text,
254
+ gint position,
255
+ gint length);
256
+ void (* text_caret_moved) (AtkText *text,
257
+ gint location);
258
+ void (* text_selection_changed) (AtkText *text);
259
+
260
+ void (* text_attributes_changed) (AtkText *text);
261
+
262
+
263
+ void (* get_range_extents) (AtkText *text,
264
+ gint start_offset,
265
+ gint end_offset,
266
+ AtkCoordType coord_type,
267
+ AtkTextRectangle *rect);
268
+
269
+ AtkTextRange** (* get_bounded_ranges) (AtkText *text,
270
+ AtkTextRectangle *rect,
271
+ AtkCoordType coord_type,
272
+ AtkTextClipType x_clip_type,
273
+ AtkTextClipType y_clip_type);
274
+
275
+ gchar* (* get_string_at_offset) (AtkText *text,
276
+ gint offset,
277
+ AtkTextGranularity granularity,
278
+ gint *start_offset,
279
+ gint *end_offset);
280
+ };
281
+ </pre>
282
+ <div class="variablelist"><table border="0">
283
+ <col align="left" valign="top">
284
+ <tbody>
285
+ <tr>
286
+ <td><p><span class="term"><span class="type">GTypeInterface</span> <em class="structfield"><code><a name="AtkTextIface.parent"></a>parent</code></em>;</span></p></td>
287
+ <td></td>
288
+ </tr>
289
+ <tr>
290
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.get-text"></a>get_text</code></em> ()</span></p></td>
291
+ <td></td>
292
+ </tr>
293
+ <tr>
294
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.get-text-after-offset"></a>get_text_after_offset</code></em> ()</span></p></td>
295
+ <td>Gets specified text. This virtual function
296
+ is deprecated and it should not be overridden.</td>
297
+ </tr>
298
+ <tr>
299
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.get-text-at-offset"></a>get_text_at_offset</code></em> ()</span></p></td>
300
+ <td>Gets specified text. This virtual function
301
+ is deprecated and it should not be overridden.</td>
302
+ </tr>
303
+ <tr>
304
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.get-character-at-offset"></a>get_character_at_offset</code></em> ()</span></p></td>
305
+ <td></td>
306
+ </tr>
307
+ <tr>
308
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.get-text-before-offset"></a>get_text_before_offset</code></em> ()</span></p></td>
309
+ <td>Gets specified text. This virtual function
310
+ is deprecated and it should not be overridden.</td>
311
+ </tr>
312
+ <tr>
313
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.get-caret-offset"></a>get_caret_offset</code></em> ()</span></p></td>
314
+ <td></td>
315
+ </tr>
316
+ <tr>
317
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.get-run-attributes"></a>get_run_attributes</code></em> ()</span></p></td>
318
+ <td></td>
319
+ </tr>
320
+ <tr>
321
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.get-default-attributes"></a>get_default_attributes</code></em> ()</span></p></td>
322
+ <td></td>
323
+ </tr>
324
+ <tr>
325
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.get-character-extents"></a>get_character_extents</code></em> ()</span></p></td>
326
+ <td></td>
327
+ </tr>
328
+ <tr>
329
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.get-character-count"></a>get_character_count</code></em> ()</span></p></td>
330
+ <td></td>
331
+ </tr>
332
+ <tr>
333
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.get-offset-at-point"></a>get_offset_at_point</code></em> ()</span></p></td>
334
+ <td></td>
335
+ </tr>
336
+ <tr>
337
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.get-n-selections"></a>get_n_selections</code></em> ()</span></p></td>
338
+ <td></td>
339
+ </tr>
340
+ <tr>
341
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.get-selection"></a>get_selection</code></em> ()</span></p></td>
342
+ <td></td>
343
+ </tr>
344
+ <tr>
345
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.add-selection"></a>add_selection</code></em> ()</span></p></td>
346
+ <td></td>
347
+ </tr>
348
+ <tr>
349
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.remove-selection"></a>remove_selection</code></em> ()</span></p></td>
350
+ <td></td>
351
+ </tr>
352
+ <tr>
353
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.set-selection"></a>set_selection</code></em> ()</span></p></td>
354
+ <td></td>
355
+ </tr>
356
+ <tr>
357
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.set-caret-offset"></a>set_caret_offset</code></em> ()</span></p></td>
358
+ <td></td>
359
+ </tr>
360
+ <tr>
361
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.text-changed"></a>text_changed</code></em> ()</span></p></td>
362
+ <td>the signal handler which is executed when there is a
363
+ text change. This virtual function is deprecated sice 2.9.4 and
364
+ it should not be overriden.</td>
365
+ </tr>
366
+ <tr>
367
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.text-caret-moved"></a>text_caret_moved</code></em> ()</span></p></td>
368
+ <td></td>
369
+ </tr>
370
+ <tr>
371
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.text-selection-changed"></a>text_selection_changed</code></em> ()</span></p></td>
372
+ <td></td>
373
+ </tr>
374
+ <tr>
375
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.text-attributes-changed"></a>text_attributes_changed</code></em> ()</span></p></td>
376
+ <td></td>
377
+ </tr>
378
+ <tr>
379
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.get-range-extents"></a>get_range_extents</code></em> ()</span></p></td>
380
+ <td></td>
381
+ </tr>
382
+ <tr>
383
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.get-bounded-ranges"></a>get_bounded_ranges</code></em> ()</span></p></td>
384
+ <td></td>
385
+ </tr>
386
+ <tr>
387
+ <td><p><span class="term"><em class="structfield"><code><a name="AtkTextIface.get-string-at-offset"></a>get_string_at_offset</code></em> ()</span></p></td>
388
+ <td>Gets a portion of the text exposed through
389
+ an AtkText according to a given offset and a specific
390
+ granularity, along with the start and end offsets defining the
391
+ boundaries of such a portion of text.</td>
392
+ </tr>
393
+ </tbody>
394
+ </table></div>
395
+ </div>
396
+ <hr>
397
+ <div class="refsect2">
186
398
  <a name="AtkTextBoundary"></a><h3>enum AtkTextBoundary</h3>
187
399
  <pre class="programlisting">typedef enum {
188
400
  ATK_TEXT_BOUNDARY_CHAR,
@@ -195,25 +407,28 @@ The AtkText structure does not contain any fields.
195
407
  } AtkTextBoundary;
196
408
  </pre>
197
409
  <p>
198
- Text boundary types used for specifying boundaries for regions of text
410
+ Text boundary types used for specifying boundaries for regions of text.
411
+ This enumerationis deprecated since 2.9.4 and should not be used. Use
412
+ AtkTextGranularity with <a class="link" href="AtkText.html#atk-text-get-string-at-offset" title="atk_text_get_string_at_offset ()"><span class="type">atk_text_get_string_at_offset</span></a> instead.
199
413
  </p>
200
414
  <div class="variablelist"><table border="0">
201
415
  <col align="left" valign="top">
202
416
  <tbody>
203
417
  <tr>
204
418
  <td><p><a name="ATK-TEXT-BOUNDARY-CHAR:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_BOUNDARY_CHAR</code></span></p></td>
205
- <td>Boundary is the boundary between characters
419
+ <td>Boundary is the boundary between characters
206
420
  (including non-printing characters)
207
421
  </td>
208
422
  </tr>
209
423
  <tr>
210
424
  <td><p><a name="ATK-TEXT-BOUNDARY-WORD-START:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_BOUNDARY_WORD_START</code></span></p></td>
211
- <td>Boundary is the start (i.e. first character) of a word.
425
+ <td>Boundary is the start (i.e. first character) of a word.
212
426
  </td>
213
427
  </tr>
214
428
  <tr>
215
429
  <td><p><a name="ATK-TEXT-BOUNDARY-WORD-END:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_BOUNDARY_WORD_END</code></span></p></td>
216
- <td>Boundary is the end (i.e. last character) of a word.
430
+ <td>Boundary is the end (i.e. last
431
+ character) of a word.
217
432
  </td>
218
433
  </tr>
219
434
  <tr>
@@ -223,20 +438,77 @@ Text boundary types used for specifying boundaries for regions of text
223
438
  </tr>
224
439
  <tr>
225
440
  <td><p><a name="ATK-TEXT-BOUNDARY-SENTENCE-END:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_BOUNDARY_SENTENCE_END</code></span></p></td>
226
- <td>Boundary is the last (terminal) character in a sentence;
227
- in languages which use "sentence stop" punctuation such as English, the boundary is thus the
228
- '.', '?', or similar terminal punctuation character.
441
+ <td>Boundary is the last (terminal)
442
+ character in a sentence; in languages which use "sentence stop"
443
+ punctuation such as English, the boundary is thus the '.', '?', or
444
+ similar terminal punctuation character.
229
445
  </td>
230
446
  </tr>
231
447
  <tr>
232
448
  <td><p><a name="ATK-TEXT-BOUNDARY-LINE-START:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_BOUNDARY_LINE_START</code></span></p></td>
233
- <td>Boundary is the initial character of the content or a
449
+ <td>Boundary is the initial character of the content or a
234
450
  character immediately following a newline, linefeed, or return character.
235
451
  </td>
236
452
  </tr>
237
453
  <tr>
238
454
  <td><p><a name="ATK-TEXT-BOUNDARY-LINE-END:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_BOUNDARY_LINE_END</code></span></p></td>
239
- <td>Boundary is the linefeed, or return character.
455
+ <td>Boundary is the linefeed, or return
456
+ character.
457
+ </td>
458
+ </tr>
459
+ </tbody>
460
+ </table></div>
461
+ </div>
462
+ <hr>
463
+ <div class="refsect2">
464
+ <a name="AtkTextGranularity"></a><h3>enum AtkTextGranularity</h3>
465
+ <pre class="programlisting">typedef enum {
466
+ ATK_TEXT_GRANULARITY_CHAR,
467
+ ATK_TEXT_GRANULARITY_WORD,
468
+ ATK_TEXT_GRANULARITY_SENTENCE,
469
+ ATK_TEXT_GRANULARITY_LINE,
470
+ ATK_TEXT_GRANULARITY_PARAGRAPH
471
+ } AtkTextGranularity;
472
+ </pre>
473
+ <p>
474
+ Text granularity types used for specifying the granularity of the region of
475
+ text we are interested in.
476
+ </p>
477
+ <div class="variablelist"><table border="0">
478
+ <col align="left" valign="top">
479
+ <tbody>
480
+ <tr>
481
+ <td><p><a name="ATK-TEXT-GRANULARITY-CHAR:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_GRANULARITY_CHAR</code></span></p></td>
482
+ <td>Granularity is defined by the boundaries between characters
483
+ (including non-printing characters)
484
+ </td>
485
+ </tr>
486
+ <tr>
487
+ <td><p><a name="ATK-TEXT-GRANULARITY-WORD:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_GRANULARITY_WORD</code></span></p></td>
488
+ <td>Granularity is defined by the boundaries of a word,
489
+ starting at the beginning of the current word and finishing at the beginning of
490
+ the following one, if present.
491
+ </td>
492
+ </tr>
493
+ <tr>
494
+ <td><p><a name="ATK-TEXT-GRANULARITY-SENTENCE:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_GRANULARITY_SENTENCE</code></span></p></td>
495
+ <td>Granularity is defined by the boundaries of a sentence,
496
+ starting at the beginning of the current sentence and finishing at the beginning of
497
+ the following one, if present.
498
+ </td>
499
+ </tr>
500
+ <tr>
501
+ <td><p><a name="ATK-TEXT-GRANULARITY-LINE:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_GRANULARITY_LINE</code></span></p></td>
502
+ <td>Granularity is defined by the boundaries of a line,
503
+ starting at the beginning of the current line and finishing at the beginning of
504
+ the following one, if present.
505
+ </td>
506
+ </tr>
507
+ <tr>
508
+ <td><p><a name="ATK-TEXT-GRANULARITY-PARAGRAPH:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_GRANULARITY_PARAGRAPH</code></span></p></td>
509
+ <td>Granularity is defined by the boundaries of a paragraph,
510
+ starting at the beginning of the current paragraph and finishing at the beginning of
511
+ the following one, if present.
240
512
  </td>
241
513
  </tr>
242
514
  </tbody>
@@ -648,56 +920,14 @@ Gets the specified text.
648
920
  <em class="parameter"><code><a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a> boundary_type</code></em>,
649
921
  <em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
650
922
  <em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);</pre>
923
+ <div class="warning">
924
+ <h3 class="title">Warning</h3>
925
+ <p><code class="literal">atk_text_get_text_after_offset</code> is deprecated and should not be used in newly-written code. This method is deprecated since ATK version
926
+ 2.9.3. Please use <a class="link" href="AtkText.html#atk-text-get-string-at-offset" title="atk_text_get_string_at_offset ()"><code class="function">atk_text_get_string_at_offset()</code></a> instead.</p>
927
+ </div>
651
928
  <p>
652
929
  Gets the specified text.
653
930
  </p>
654
- <p>
655
- If the boundary_type if ATK_TEXT_BOUNDARY_CHAR the character after the
656
- offset is returned.
657
- </p>
658
- <p>
659
- If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string
660
- is from the word start after the offset to the next word start.
661
- </p>
662
- <p>
663
- The returned string will contain the word after the offset if the offset
664
- is inside a word or if the offset is not inside a word.
665
- </p>
666
- <p>
667
- If the boundary_type is ATK_TEXT_BOUNDARY_WORD_END the returned string
668
- is from the word end at or after the offset to the next work end.
669
- </p>
670
- <p>
671
- The returned string will contain the word after the offset if the offset
672
- is inside a word and will contain the word after the word after the offset
673
- if the offset is not inside a word.
674
- </p>
675
- <p>
676
- If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the returned
677
- string is from the sentence start after the offset to the next sentence
678
- start.
679
- </p>
680
- <p>
681
- The returned string will contain the sentence after the offset if the offset
682
- is inside a sentence or if the offset is not inside a sentence.
683
- </p>
684
- <p>
685
- If the boundary_type is ATK_TEXT_BOUNDARY_SENTENCE_END the returned string
686
- is from the sentence end at or after the offset to the next sentence end.
687
- </p>
688
- <p>
689
- The returned string will contain the sentence after the offset if the offset
690
- is inside a sentence and will contain the sentence after the sentence
691
- after the offset if the offset is not inside a sentence.
692
- </p>
693
- <p>
694
- If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned
695
- string is from the line start after the offset to the next line start.
696
- </p>
697
- <p>
698
- If the boundary_type is ATK_TEXT_BOUNDARY_LINE_END the returned string
699
- is from the line end at or after the offset to the next line end.
700
- </p>
701
931
  <div class="variablelist"><table border="0">
702
932
  <col align="left" valign="top">
703
933
  <tbody>
@@ -742,6 +972,11 @@ by the specified <em class="parameter"><code>boundary_type</code></em>. Use <cod
742
972
  <em class="parameter"><code><a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a> boundary_type</code></em>,
743
973
  <em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
744
974
  <em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);</pre>
975
+ <div class="warning">
976
+ <h3 class="title">Warning</h3>
977
+ <p><code class="literal">atk_text_get_text_at_offset</code> is deprecated and should not be used in newly-written code. This method is deprecated since ATK version
978
+ 2.9.4. Please use <a class="link" href="AtkText.html#atk-text-get-string-at-offset" title="atk_text_get_string_at_offset ()"><code class="function">atk_text_get_string_at_offset()</code></a> instead.</p>
979
+ </div>
745
980
  <p>
746
981
  Gets the specified text.
747
982
  </p>
@@ -751,22 +986,12 @@ offset is returned.
751
986
  </p>
752
987
  <p>
753
988
  If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string
754
- is from the word start at or before the offset to the word start after
989
+ is from the word start at or before the offset to the word start after
755
990
  the offset.
756
991
  </p>
757
992
  <p>
758
993
  The returned string will contain the word at the offset if the offset
759
- is inside a word and will contain the word before the offset if the
760
- offset is not inside a word.
761
- </p>
762
- <p>
763
- If the boundary_type is ATK_TEXT_BOUNDARY_WORD_END the returned string
764
- is from the word end before the offset to the word end at or after the
765
- offset.
766
- </p>
767
- <p>
768
- The returned string will contain the word at the offset if the offset
769
- is inside a word and will contain the word after to the offset if the
994
+ is inside a word and will contain the word before the offset if the
770
995
  offset is not inside a word.
771
996
  </p>
772
997
  <p>
@@ -776,17 +1001,7 @@ start after the offset.
776
1001
  </p>
777
1002
  <p>
778
1003
  The returned string will contain the sentence at the offset if the offset
779
- is inside a sentence and will contain the sentence before the offset
780
- if the offset is not inside a sentence.
781
- </p>
782
- <p>
783
- If the boundary_type is ATK_TEXT_BOUNDARY_SENTENCE_END the returned string
784
- is from the sentence end before the offset to the sentence end at or
785
- after the offset.
786
- </p>
787
- <p>
788
- The returned string will contain the sentence at the offset if the offset
789
- is inside a sentence and will contain the sentence after the offset
1004
+ is inside a sentence and will contain the sentence before the offset
790
1005
  if the offset is not inside a sentence.
791
1006
  </p>
792
1007
  <p>
@@ -794,11 +1009,6 @@ If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned
794
1009
  string is from the line start at or before the offset to the line
795
1010
  start after the offset.
796
1011
  </p>
797
- <p>
798
- If the boundary_type is ATK_TEXT_BOUNDARY_LINE_END the returned string
799
- is from the line end before the offset to the line end at or after
800
- the offset.
801
- </p>
802
1012
  <div class="variablelist"><table border="0">
803
1013
  <col align="left" valign="top">
804
1014
  <tbody>
@@ -843,60 +1053,96 @@ the specified <em class="parameter"><code>boundary_type</code></em>. Use <code c
843
1053
  <em class="parameter"><code><a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a> boundary_type</code></em>,
844
1054
  <em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
845
1055
  <em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);</pre>
1056
+ <div class="warning">
1057
+ <h3 class="title">Warning</h3>
1058
+ <p><code class="literal">atk_text_get_text_before_offset</code> is deprecated and should not be used in newly-written code. This method is deprecated since ATK version
1059
+ 2.9.3. Please use <a class="link" href="AtkText.html#atk-text-get-string-at-offset" title="atk_text_get_string_at_offset ()"><code class="function">atk_text_get_string_at_offset()</code></a> instead.</p>
1060
+ </div>
846
1061
  <p>
847
1062
  Gets the specified text.
848
1063
  </p>
1064
+ <div class="variablelist"><table border="0">
1065
+ <col align="left" valign="top">
1066
+ <tbody>
1067
+ <tr>
1068
+ <td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
1069
+ <td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
1070
+ </td>
1071
+ </tr>
1072
+ <tr>
1073
+ <td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
1074
+ <td>position</td>
1075
+ </tr>
1076
+ <tr>
1077
+ <td><p><span class="term"><em class="parameter"><code>boundary_type</code></em> :</span></p></td>
1078
+ <td>An <a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a>
1079
+ </td>
1080
+ </tr>
1081
+ <tr>
1082
+ <td><p><span class="term"><em class="parameter"><code>start_offset</code></em> :</span></p></td>
1083
+ <td>the start offset of the returned string. <span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span>
1084
+ </td>
1085
+ </tr>
1086
+ <tr>
1087
+ <td><p><span class="term"><em class="parameter"><code>end_offset</code></em> :</span></p></td>
1088
+ <td>the offset of the first character after the
1089
+ returned substring. <span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span>
1090
+ </td>
1091
+ </tr>
1092
+ <tr>
1093
+ <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1094
+ <td>a newly allocated string containing the text before <em class="parameter"><code>offset</code></em> bounded
1095
+ by the specified <em class="parameter"><code>boundary_type</code></em>. Use <code class="function">g_free()</code> to free the returned string.</td>
1096
+ </tr>
1097
+ </tbody>
1098
+ </table></div>
1099
+ </div>
1100
+ <hr>
1101
+ <div class="refsect2">
1102
+ <a name="atk-text-get-string-at-offset"></a><h3>atk_text_get_string_at_offset ()</h3>
1103
+ <pre class="programlisting"><span class="returnvalue">gchar</span> * atk_text_get_string_at_offset (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
1104
+ <em class="parameter"><code><span class="type">gint</span> offset</code></em>,
1105
+ <em class="parameter"><code><a class="link" href="AtkText.html#AtkTextGranularity" title="enum AtkTextGranularity"><span class="type">AtkTextGranularity</span></a> granularity</code></em>,
1106
+ <em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
1107
+ <em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);</pre>
849
1108
  <p>
850
- If the boundary_type if ATK_TEXT_BOUNDARY_CHAR the character before the
851
- offset is returned.
852
- </p>
853
- <p>
854
- If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string
855
- is from the word start before the word start before or at the offset to
856
- the word start before or at the offset.
857
- </p>
858
- <p>
859
- The returned string will contain the word before the offset if the offset
860
- is inside a word and will contain the word before the word before the
861
- offset if the offset is not inside a word.
862
- </p>
863
- <p>
864
- If the boundary_type is ATK_TEXT_BOUNDARY_WORD_END the returned string
865
- is from the word end before the word end before the offset to the word
866
- end before the offset.
1109
+ Gets a portion of the text exposed through an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> according to a given <em class="parameter"><code>offset</code></em>
1110
+ and a specific <em class="parameter"><code>granularity</code></em>, along with the start and end offsets defining the
1111
+ boundaries of such a portion of text.
867
1112
  </p>
868
1113
  <p>
869
- The returned string will contain the word before the offset if the offset
870
- is inside a word or if the offset is not inside a word.
1114
+ If <em class="parameter"><code>granularity</code></em> is ATK_TEXT_GRANULARITY_CHAR the character at the
1115
+ offset is returned.
871
1116
  </p>
872
1117
  <p>
873
- If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the returned
874
- string is from the sentence start before the sentence start before
875
- the offset to the sentence start before the offset.
1118
+ If <em class="parameter"><code>granularity</code></em> is ATK_TEXT_GRANULARITY_WORD the returned string
1119
+ is from the word start at or before the offset to the word start after
1120
+ the offset.
876
1121
  </p>
877
1122
  <p>
878
- The returned string will contain the sentence before the offset if the
879
- offset is inside a sentence and will contain the sentence before the
880
- sentence before the offset if the offset is not inside a sentence.
1123
+ The returned string will contain the word at the offset if the offset
1124
+ is inside a word and will contain the word before the offset if the
1125
+ offset is not inside a word.
881
1126
  </p>
882
1127
  <p>
883
- If the boundary_type is ATK_TEXT_BOUNDARY_SENTENCE_END the returned string
884
- is from the sentence end before the sentence end at or before the offset to
885
- the sentence end at or before the offset.
1128
+ If <em class="parameter"><code>granularity</code></em> is ATK_TEXT_GRANULARITY_SENTENCE the returned string
1129
+ is from the sentence start at or before the offset to the sentence
1130
+ start after the offset.
886
1131
  </p>
887
1132
  <p>
888
- The returned string will contain the sentence before the offset if the
889
- offset is inside a sentence or if the offset is not inside a sentence.
1133
+ The returned string will contain the sentence at the offset if the offset
1134
+ is inside a sentence and will contain the sentence before the offset
1135
+ if the offset is not inside a sentence.
890
1136
  </p>
891
1137
  <p>
892
- If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned
893
- string is from the line start before the line start ar or before the offset
894
- to the line start ar or before the offset.
1138
+ If <em class="parameter"><code>granularity</code></em> is ATK_TEXT_GRANULARITY_LINE the returned string
1139
+ is from the line start at or before the offset to the line
1140
+ start after the offset.
895
1141
  </p>
896
1142
  <p>
897
- If the boundary_type is ATK_TEXT_BOUNDARY_LINE_END the returned string
898
- is from the line end before the line end before the offset to the
899
- line end before the offset.
1143
+ If <em class="parameter"><code>granularity</code></em> is ATK_TEXT_GRANULARITY_PARAGRAPH the returned string
1144
+ is from the start of the paragraph at or before the offset to the start
1145
+ of the following paragraph after the offset.
900
1146
  </p>
901
1147
  <div class="variablelist"><table border="0">
902
1148
  <col align="left" valign="top">
@@ -911,28 +1157,31 @@ line end before the offset.
911
1157
  <td>position</td>
912
1158
  </tr>
913
1159
  <tr>
914
- <td><p><span class="term"><em class="parameter"><code>boundary_type</code></em> :</span></p></td>
915
- <td>An <a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a>
1160
+ <td><p><span class="term"><em class="parameter"><code>granularity</code></em> :</span></p></td>
1161
+ <td>An <a class="link" href="AtkText.html#AtkTextGranularity" title="enum AtkTextGranularity"><span class="type">AtkTextGranularity</span></a>
916
1162
  </td>
917
1163
  </tr>
918
1164
  <tr>
919
1165
  <td><p><span class="term"><em class="parameter"><code>start_offset</code></em> :</span></p></td>
920
- <td>the start offset of the returned string. <span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span>
1166
+ <td>the start offset of the returned string, or -1
1167
+ if an error has occurred (e.g. invalid offset, not implemented). <span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span>
921
1168
  </td>
922
1169
  </tr>
923
1170
  <tr>
924
1171
  <td><p><span class="term"><em class="parameter"><code>end_offset</code></em> :</span></p></td>
925
- <td>the offset of the first character after the
926
- returned substring. <span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span>
1172
+ <td>the offset of the first character after the returned string,
1173
+ or -1 if an error has occurred (e.g. invalid offset, not implemented). <span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span>
927
1174
  </td>
928
1175
  </tr>
929
1176
  <tr>
930
1177
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
931
- <td>a newly allocated string containing the text before <em class="parameter"><code>offset</code></em> bounded
932
- by the specified <em class="parameter"><code>boundary_type</code></em>. Use <code class="function">g_free()</code> to free the returned string.</td>
1178
+ <td>a newly allocated string containing the text at the <em class="parameter"><code>offset</code></em> bounded
1179
+ by the specified <em class="parameter"><code>granularity</code></em>. Use <code class="function">g_free()</code> to free the returned string.
1180
+ Returns <code class="literal">NULL</code> if the offset is invalid or no implementation is available.</td>
933
1181
  </tr>
934
1182
  </tbody>
935
1183
  </table></div>
1184
+ <p class="since">Since 2.9.4</p>
936
1185
  </div>
937
1186
  <hr>
938
1187
  <div class="refsect2">
@@ -1573,8 +1822,9 @@ NULL is returned if there are no values maintained for the attr value.</td>
1573
1822
  <pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *atktext,
1574
1823
  <span class="type">gpointer</span> user_data) : <code class="literal">Run Last</code></pre>
1575
1824
  <p>
1576
- The "text-attributes-changed" signal is emitted when the text attributes of
1577
- the text of an object which implements AtkText changes.
1825
+ The "text-attributes-changed" signal is emitted when the text
1826
+ attributes of the text of an object which implements AtkText
1827
+ changes.
1578
1828
  </p>
1579
1829
  <div class="variablelist"><table border="0">
1580
1830
  <col align="left" valign="top">
@@ -1597,8 +1847,9 @@ the text of an object which implements AtkText changes.
1597
1847
  <span class="type">gint</span> arg1,
1598
1848
  <span class="type">gpointer</span> user_data) : <code class="literal">Run Last</code></pre>
1599
1849
  <p>
1600
- The "text-caret-moved" signal is emitted when the caret position of
1601
- the text of an object which implements AtkText changes.
1850
+ The "text-caret-moved" signal is emitted when the caret
1851
+ position of the text of an object which implements AtkText
1852
+ changes.
1602
1853
  </p>
1603
1854
  <div class="variablelist"><table border="0">
1604
1855
  <col align="left" valign="top">
@@ -1625,11 +1876,17 @@ the text of an object which implements AtkText changes.
1625
1876
  <span class="type">gint</span> arg1,
1626
1877
  <span class="type">gint</span> arg2,
1627
1878
  <span class="type">gpointer</span> user_data) : <code class="literal">Has Details</code></pre>
1879
+ <div class="warning">
1880
+ <h3 class="title">Warning</h3>
1881
+ <p><code class="literal">AtkText::text-changed</code> is deprecated and should not be used in newly-written code. Since 2.9.4. Use <span class="type">"text-insert"</span> or
1882
+ <span class="type">"text-remove"</span> instead.</p>
1883
+ </div>
1628
1884
  <p>
1629
- The "text-changed" signal is emitted when the text of the object which
1630
- implements the AtkText interface changes, This signal will have a detail
1631
- which is either "insert" or "delete" which identifies whether the text
1632
- change was an insertion or a deletion
1885
+ The "text-changed" signal is emitted when the text of the
1886
+ object which implements the AtkText interface changes, This
1887
+ signal will have a detail which is either "insert" or
1888
+ "delete" which identifies whether the text change was an
1889
+ insertion or a deletion.
1633
1890
  </p>
1634
1891
  <div class="variablelist"><table border="0">
1635
1892
  <col align="left" valign="top">
@@ -1662,6 +1919,8 @@ change was an insertion or a deletion
1662
1919
  <span class="type">gchar</span> *arg3,
1663
1920
  <span class="type">gpointer</span> user_data) : <code class="literal">Has Details</code></pre>
1664
1921
  <p>
1922
+ The "text-insert" signal is emitted when a new text is
1923
+ inserted.
1665
1924
  </p>
1666
1925
  <div class="variablelist"><table border="0">
1667
1926
  <col align="left" valign="top">
@@ -1671,6 +1930,18 @@ change was an insertion or a deletion
1671
1930
  <td>the object which received the signal.</td>
1672
1931
  </tr>
1673
1932
  <tr>
1933
+ <td><p><span class="term"><em class="parameter"><code>arg1</code></em> :</span></p></td>
1934
+ <td>The position (character offset) of the insertion.</td>
1935
+ </tr>
1936
+ <tr>
1937
+ <td><p><span class="term"><em class="parameter"><code>arg2</code></em> :</span></p></td>
1938
+ <td>The length (in characters) of text inserted.</td>
1939
+ </tr>
1940
+ <tr>
1941
+ <td><p><span class="term"><em class="parameter"><code>arg3</code></em> :</span></p></td>
1942
+ <td>The new text inserted</td>
1943
+ </tr>
1944
+ <tr>
1674
1945
  <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1675
1946
  <td>user data set when the signal handler was connected.</td>
1676
1947
  </tr>
@@ -1686,6 +1957,8 @@ change was an insertion or a deletion
1686
1957
  <span class="type">gchar</span> *arg3,
1687
1958
  <span class="type">gpointer</span> user_data) : <code class="literal">Has Details</code></pre>
1688
1959
  <p>
1960
+ The "text-remove" signal is emitted when a new text is
1961
+ removed.
1689
1962
  </p>
1690
1963
  <div class="variablelist"><table border="0">
1691
1964
  <col align="left" valign="top">
@@ -1695,27 +1968,16 @@ change was an insertion or a deletion
1695
1968
  <td>the object which received the signal.</td>
1696
1969
  </tr>
1697
1970
  <tr>
1698
- <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1699
- <td>user data set when the signal handler was connected.</td>
1971
+ <td><p><span class="term"><em class="parameter"><code>arg1</code></em> :</span></p></td>
1972
+ <td>The position (character offset) of the removal.</td>
1700
1973
  </tr>
1701
- </tbody>
1702
- </table></div>
1703
- </div>
1704
- <hr>
1705
- <div class="refsect2">
1706
- <a name="AtkText-text-selection-changed"></a><h3>The <code class="literal">"text-selection-changed"</code> signal</h3>
1707
- <pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *atktext,
1708
- <span class="type">gpointer</span> user_data) : <code class="literal">Run Last</code></pre>
1709
- <p>
1710
- The "text-selection-changed" signal is emitted when the selected text of
1711
- an object which implements AtkText changes.
1712
- </p>
1713
- <div class="variablelist"><table border="0">
1714
- <col align="left" valign="top">
1715
- <tbody>
1716
1974
  <tr>
1717
- <td><p><span class="term"><em class="parameter"><code>atktext</code></em> :</span></p></td>
1718
- <td>the object which received the signal.</td>
1975
+ <td><p><span class="term"><em class="parameter"><code>arg2</code></em> :</span></p></td>
1976
+ <td>The length (in characters) of text removed.</td>
1977
+ </tr>
1978
+ <tr>
1979
+ <td><p><span class="term"><em class="parameter"><code>arg3</code></em> :</span></p></td>
1980
+ <td>The old text removed</td>
1719
1981
  </tr>
1720
1982
  <tr>
1721
1983
  <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
@@ -1726,14 +1988,12 @@ an object which implements AtkText changes.
1726
1988
  </div>
1727
1989
  <hr>
1728
1990
  <div class="refsect2">
1729
- <a name="AtkText-text-update"></a><h3>The <code class="literal">"text-update"</code> signal</h3>
1991
+ <a name="AtkText-text-selection-changed"></a><h3>The <code class="literal">"text-selection-changed"</code> signal</h3>
1730
1992
  <pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *atktext,
1731
- <span class="type">gint</span> arg1,
1732
- <span class="type">gint</span> arg2,
1733
- <span class="type">gint</span> arg3,
1734
- <span class="type">gchar</span> *arg4,
1735
- <span class="type">gpointer</span> user_data) : <code class="literal">Has Details</code></pre>
1993
+ <span class="type">gpointer</span> user_data) : <code class="literal">Run Last</code></pre>
1736
1994
  <p>
1995
+ The "text-selection-changed" signal is emitted when the
1996
+ selected text of an object which implements AtkText changes.
1737
1997
  </p>
1738
1998
  <div class="variablelist"><table border="0">
1739
1999
  <col align="left" valign="top">
@@ -1753,6 +2013,6 @@ an object which implements AtkText changes.
1753
2013
  </div>
1754
2014
  <div class="footer">
1755
2015
  <hr>
1756
- Generated by GTK-Doc V1.18.1</div>
2016
+ Generated by GTK-Doc V1.19.1</div>
1757
2017
  </body>
1758
2018
  </html>