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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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>