atk 2.2.0-x86-mingw32 → 2.2.1-x86-mingw32
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/Rakefile +1 -1
- data/lib/2.0/atk.so +0 -0
- data/vendor/local/bin/libatk-1.0-0.dll +0 -0
- data/vendor/local/include/atk-1.0/atk/atk-enum-types.h +16 -0
- data/vendor/local/include/atk-1.0/atk/atk.h +3 -0
- data/vendor/local/include/atk-1.0/atk/atkaction.h +8 -1
- data/vendor/local/include/atk-1.0/atk/atkcomponent.h +20 -2
- data/vendor/local/include/atk-1.0/atk/atkdocument.h +29 -2
- data/vendor/local/include/atk-1.0/atk/atkeditabletext.h +8 -0
- data/vendor/local/include/atk-1.0/atk/atkgobjectaccessible.h +3 -0
- data/vendor/local/include/atk-1.0/atk/atkhyperlink.h +9 -1
- data/vendor/local/include/atk-1.0/atk/atkhyperlinkimpl.h +2 -0
- data/vendor/local/include/atk-1.0/atk/atkhypertext.h +4 -0
- data/vendor/local/include/atk-1.0/atk/atkimage.h +6 -0
- data/vendor/local/include/atk-1.0/atk/atkmisc.h +19 -19
- data/vendor/local/include/atk-1.0/atk/atknoopobject.h +4 -0
- data/vendor/local/include/atk-1.0/atk/atknoopobjectfactory.h +2 -0
- data/vendor/local/include/atk-1.0/atk/atkobject.h +133 -26
- data/vendor/local/include/atk-1.0/atk/atkobjectfactory.h +5 -0
- data/vendor/local/include/atk-1.0/atk/atkplug.h +5 -0
- data/vendor/local/include/atk-1.0/atk/atkrange.h +59 -0
- data/vendor/local/include/atk-1.0/atk/atkregistry.h +5 -15
- data/vendor/local/include/atk-1.0/atk/atkrelation.h +10 -0
- data/vendor/local/include/atk-1.0/atk/atkrelationset.h +10 -0
- data/vendor/local/include/atk-1.0/atk/atkselection.h +8 -0
- data/vendor/local/include/atk-1.0/atk/atksocket.h +6 -0
- data/vendor/local/include/atk-1.0/atk/atkstate.h +14 -2
- data/vendor/local/include/atk-1.0/atk/atkstateset.h +12 -0
- data/vendor/local/include/atk-1.0/atk/atkstreamablecontent.h +6 -1
- data/vendor/local/include/atk-1.0/atk/atktable.h +30 -6
- data/vendor/local/include/atk-1.0/atk/atktablecell.h +104 -0
- data/vendor/local/include/atk-1.0/atk/atktext.h +30 -5
- data/vendor/local/include/atk-1.0/atk/atkutil.h +35 -4
- data/vendor/local/include/atk-1.0/atk/atkvalue.h +88 -17
- data/vendor/local/include/atk-1.0/atk/atkversion.h +281 -2
- data/vendor/local/include/atk-1.0/atk/atkwindow.h +1 -0
- data/vendor/local/lib/girepository-1.0/Atk-1.0.typelib +0 -0
- data/vendor/local/lib/libatk-1.0.dll.a +0 -0
- data/vendor/local/lib/libatk-1.0.la +3 -3
- data/vendor/local/lib/pkgconfig/atk.pc +1 -1
- data/vendor/local/share/gir-1.0/Atk-1.0.gir +3410 -899
- data/vendor/local/share/gtk-doc/html/atk/AtkAction.html +343 -233
- data/vendor/local/share/gtk-doc/html/atk/AtkComponent.html +872 -578
- data/vendor/local/share/gtk-doc/html/atk/AtkDocument.html +558 -251
- data/vendor/local/share/gtk-doc/html/atk/AtkEditableText.html +298 -192
- data/vendor/local/share/gtk-doc/html/atk/AtkGObjectAccessible.html +117 -75
- data/vendor/local/share/gtk-doc/html/atk/AtkHyperlink.html +434 -273
- data/vendor/local/share/gtk-doc/html/atk/AtkHypertext.html +195 -119
- data/vendor/local/share/gtk-doc/html/atk/AtkImage.html +224 -143
- data/vendor/local/share/gtk-doc/html/atk/AtkMisc.html +191 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkNoOpObject.html +83 -59
- data/vendor/local/share/gtk-doc/html/atk/AtkNoOpObjectFactory.html +66 -49
- data/vendor/local/share/gtk-doc/html/atk/AtkObject.html +2398 -1337
- data/vendor/local/share/gtk-doc/html/atk/AtkObjectFactory.html +154 -96
- data/vendor/local/share/gtk-doc/html/atk/AtkRegistry.html +192 -118
- data/vendor/local/share/gtk-doc/html/atk/AtkRelation.html +496 -278
- data/vendor/local/share/gtk-doc/html/atk/AtkRelationSet.html +294 -193
- data/vendor/local/share/gtk-doc/html/atk/AtkSelection.html +333 -201
- data/vendor/local/share/gtk-doc/html/atk/AtkStateSet.html +403 -256
- data/vendor/local/share/gtk-doc/html/atk/AtkStreamableContent.html +192 -130
- data/vendor/local/share/gtk-doc/html/atk/AtkTable.html +1363 -776
- data/vendor/local/share/gtk-doc/html/atk/AtkTableCell.html +497 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkText.html +1975 -1446
- data/vendor/local/share/gtk-doc/html/atk/AtkUtil.html +862 -524
- data/vendor/local/share/gtk-doc/html/atk/AtkValue.html +638 -108
- data/vendor/local/share/gtk-doc/html/atk/AtkWindow.html +302 -175
- data/vendor/local/share/gtk-doc/html/atk/accessibles.html +49 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-12.html +18 -18
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-13.html +21 -11
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-20.html +11 -11
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-22.html +10 -10
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-3.html +11 -11
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-30.html +15 -15
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-4.html +9 -9
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-6.html +11 -11
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-9.html +39 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-2-10.html +35 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-2-12.html +78 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-2-2.html +53 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-2-8.html +47 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-deprecated.html +75 -25
- data/vendor/local/share/gtk-doc/html/atk/api-index-full.html +358 -288
- data/vendor/local/share/gtk-doc/html/atk/atk-AtkHyperlinkImpl.html +82 -60
- data/vendor/local/share/gtk-doc/html/atk/atk-AtkPlug.html +99 -52
- data/vendor/local/share/gtk-doc/html/atk/atk-AtkRange.html +328 -0
- data/vendor/local/share/gtk-doc/html/atk/atk-AtkSocket.html +139 -91
- data/vendor/local/share/gtk-doc/html/atk/atk-AtkState.html +355 -226
- data/vendor/local/share/gtk-doc/html/atk/atk-Versioning-Utilities.html +203 -142
- data/vendor/local/share/gtk-doc/html/atk/atk.devhelp2 +378 -547
- data/vendor/local/share/gtk-doc/html/atk/atkobject.html +33 -0
- data/vendor/local/share/gtk-doc/html/atk/data.html +49 -0
- data/vendor/local/share/gtk-doc/html/atk/deprecated.html +33 -0
- data/vendor/local/share/gtk-doc/html/atk/index.html +70 -46
- data/vendor/local/share/gtk-doc/html/atk/index.sgml +419 -519
- data/vendor/local/share/gtk-doc/html/atk/{atk.html → interfaces.html} +17 -60
- data/vendor/local/share/gtk-doc/html/atk/overview.html +47 -0
- data/vendor/local/share/gtk-doc/html/atk/style.css +260 -105
- data/vendor/local/share/gtk-doc/html/atk/toolkit.html +33 -0
- data/vendor/local/share/gtk-doc/html/atk/utilities.html +28 -14
- data/vendor/local/share/license/atk/AUTHORS +18 -5
- data/vendor/local/share/locale/an/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/as/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/ca/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/cs/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/da/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/de/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/el/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/es/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/eu/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/fi/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/fr/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/gl/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/he/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/hu/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/id/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/it/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/ko/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/lt/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/lv/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/nb/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/pa/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/pl/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/pt/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/pt_BR/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/ru/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/sk/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/sl/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/sr/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/sr@latin/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/zh_CN/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/zh_HK/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/zh_TW/LC_MESSAGES/atk10.mo +0 -0
- metadata +27 -19
- data/lib/1.9/atk.so +0 -0
- data/lib/2.1/atk.so +0 -0
- data/vendor/local/lib/atk-1.0.def +0 -248
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-18.html +0 -31
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-24.html +0 -31
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-26.html +0 -31
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-28.html +0 -31
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-32.html +0 -30
@@ -2,32 +2,28 @@
|
|
2
2
|
<html>
|
3
3
|
<head>
|
4
4
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
5
|
-
<title>AtkText</title>
|
6
|
-
<meta name="generator" content="DocBook XSL Stylesheets V1.
|
5
|
+
<title>ATK - Accessibility Toolkit: AtkText</title>
|
6
|
+
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
|
7
7
|
<link rel="home" href="index.html" title="ATK - Accessibility Toolkit">
|
8
|
-
<link rel="up" href="
|
9
|
-
<link rel="prev" href="
|
10
|
-
<link rel="next" href="
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
8
|
+
<link rel="up" href="interfaces.html" title="ATK Interfaces">
|
9
|
+
<link rel="prev" href="AtkTableCell.html" title="AtkTableCell">
|
10
|
+
<link rel="next" href="AtkValue.html" title="AtkValue">
|
11
|
+
<meta name="generator" content="GTK-Doc V1.21.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="
|
16
|
-
<td width="100%" align="left">
|
17
|
-
<a href="#" class="shortcut">Top</a>
|
18
|
-
|
19
|
-
<a href="#AtkText.
|
20
|
-
|
21
|
-
<a href="#AtkText.
|
22
|
-
|
|
23
|
-
<a href="#AtkText.implementations" class="shortcut">Known Implementations</a>
|
24
|
-
|
|
25
|
-
<a href="#AtkText.signals" class="shortcut">Signals</a>
|
15
|
+
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
|
16
|
+
<td width="100%" align="left" class="shortcuts">
|
17
|
+
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
|
18
|
+
<a href="#AtkText.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
|
19
|
+
<a href="#AtkText.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_implementations"> <span class="dim">|</span>
|
20
|
+
<a href="#AtkText.implementations" class="shortcut">Known Implementations</a></span><span id="nav_signals"> <span class="dim">|</span>
|
21
|
+
<a href="#AtkText.signals" class="shortcut">Signals</a></span>
|
26
22
|
</td>
|
27
23
|
<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="
|
29
|
-
<td><a accesskey="p" href="
|
30
|
-
<td><a accesskey="n" href="
|
24
|
+
<td><a accesskey="u" href="interfaces.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
|
25
|
+
<td><a accesskey="p" href="AtkTableCell.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
|
26
|
+
<td><a accesskey="n" href="AtkValue.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
|
31
27
|
</tr></table>
|
32
28
|
<div class="refentry">
|
33
29
|
<a name="AtkText"></a><div class="titlepage"></div>
|
@@ -37,1982 +33,2515 @@
|
|
37
33
|
<p>AtkText — The ATK interface implemented by components
|
38
34
|
with text content.</p>
|
39
35
|
</td>
|
40
|
-
<td valign="top" align="right"></td>
|
36
|
+
<td class="gallery_image" valign="top" align="right"></td>
|
41
37
|
</tr></table></div>
|
42
|
-
<div class="refsynopsisdiv">
|
43
|
-
<a name="AtkText.synopsis"></a><h2>Synopsis</h2>
|
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>;
|
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
|
-
enum <a class="link" href="AtkText.html#AtkTextClipType" title="enum AtkTextClipType">AtkTextClipType</a>;
|
49
|
-
struct <a class="link" href="AtkText.html#AtkTextRange" title="struct AtkTextRange">AtkTextRange</a>;
|
50
|
-
struct <a class="link" href="AtkText.html#AtkTextRectangle" title="struct AtkTextRectangle">AtkTextRectangle</a>;
|
51
|
-
struct <a class="link" href="AtkText.html#AtkAttribute" title="struct AtkAttribute">AtkAttribute</a>;
|
52
|
-
typedef <a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet">AtkAttributeSet</a>;
|
53
|
-
enum <a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute">AtkTextAttribute</a>;
|
54
|
-
<span class="returnvalue">gchar</span> * <a class="link" href="AtkText.html#atk-text-get-text" title="atk_text_get_text ()">atk_text_get_text</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
55
|
-
<em class="parameter"><code><span class="type">gint</span> start_offset</code></em>,
|
56
|
-
<em class="parameter"><code><span class="type">gint</span> end_offset</code></em>);
|
57
|
-
<span class="returnvalue">gunichar</span> <a class="link" href="AtkText.html#atk-text-get-character-at-offset" title="atk_text_get_character_at_offset ()">atk_text_get_character_at_offset</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
58
|
-
<em class="parameter"><code><span class="type">gint</span> offset</code></em>);
|
59
|
-
<span class="returnvalue">gchar</span> * <a class="link" href="AtkText.html#atk-text-get-text-after-offset" title="atk_text_get_text_after_offset ()">atk_text_get_text_after_offset</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
60
|
-
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
61
|
-
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a> boundary_type</code></em>,
|
62
|
-
<em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
|
63
|
-
<em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);
|
64
|
-
<span class="returnvalue">gchar</span> * <a class="link" href="AtkText.html#atk-text-get-text-at-offset" title="atk_text_get_text_at_offset ()">atk_text_get_text_at_offset</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
65
|
-
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
66
|
-
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a> boundary_type</code></em>,
|
67
|
-
<em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
|
68
|
-
<em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);
|
69
|
-
<span class="returnvalue">gchar</span> * <a class="link" href="AtkText.html#atk-text-get-text-before-offset" title="atk_text_get_text_before_offset ()">atk_text_get_text_before_offset</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
70
|
-
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
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
|
-
<em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
|
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>);
|
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>);
|
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>,
|
81
|
-
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
82
|
-
<em class="parameter"><code><span class="type">gint</span> *x</code></em>,
|
83
|
-
<em class="parameter"><code><span class="type">gint</span> *y</code></em>,
|
84
|
-
<em class="parameter"><code><span class="type">gint</span> *width</code></em>,
|
85
|
-
<em class="parameter"><code><span class="type">gint</span> *height</code></em>,
|
86
|
-
<em class="parameter"><code><a class="link" href="AtkUtil.html#AtkCoordType" title="enum AtkCoordType"><span class="type">AtkCoordType</span></a> coords</code></em>);
|
87
|
-
<a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="returnvalue">AtkAttributeSet</span></a> * <a class="link" href="AtkText.html#atk-text-get-run-attributes" title="atk_text_get_run_attributes ()">atk_text_get_run_attributes</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
88
|
-
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
89
|
-
<em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
|
90
|
-
<em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);
|
91
|
-
<a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="returnvalue">AtkAttributeSet</span></a> * <a class="link" href="AtkText.html#atk-text-get-default-attributes" title="atk_text_get_default_attributes ()">atk_text_get_default_attributes</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>);
|
92
|
-
<span class="returnvalue">gint</span> <a class="link" href="AtkText.html#atk-text-get-character-count" title="atk_text_get_character_count ()">atk_text_get_character_count</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>);
|
93
|
-
<span class="returnvalue">gint</span> <a class="link" href="AtkText.html#atk-text-get-offset-at-point" title="atk_text_get_offset_at_point ()">atk_text_get_offset_at_point</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
94
|
-
<em class="parameter"><code><span class="type">gint</span> x</code></em>,
|
95
|
-
<em class="parameter"><code><span class="type">gint</span> y</code></em>,
|
96
|
-
<em class="parameter"><code><a class="link" href="AtkUtil.html#AtkCoordType" title="enum AtkCoordType"><span class="type">AtkCoordType</span></a> coords</code></em>);
|
97
|
-
<a class="link" href="AtkText.html#AtkTextRange" title="struct AtkTextRange"><span class="returnvalue">AtkTextRange</span></a> ** <a class="link" href="AtkText.html#atk-text-get-bounded-ranges" title="atk_text_get_bounded_ranges ()">atk_text_get_bounded_ranges</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
98
|
-
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextRectangle" title="struct AtkTextRectangle"><span class="type">AtkTextRectangle</span></a> *rect</code></em>,
|
99
|
-
<em class="parameter"><code><a class="link" href="AtkUtil.html#AtkCoordType" title="enum AtkCoordType"><span class="type">AtkCoordType</span></a> coord_type</code></em>,
|
100
|
-
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextClipType" title="enum AtkTextClipType"><span class="type">AtkTextClipType</span></a> x_clip_type</code></em>,
|
101
|
-
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextClipType" title="enum AtkTextClipType"><span class="type">AtkTextClipType</span></a> y_clip_type</code></em>);
|
102
|
-
<span class="returnvalue">void</span> <a class="link" href="AtkText.html#atk-text-get-range-extents" title="atk_text_get_range_extents ()">atk_text_get_range_extents</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
103
|
-
<em class="parameter"><code><span class="type">gint</span> start_offset</code></em>,
|
104
|
-
<em class="parameter"><code><span class="type">gint</span> end_offset</code></em>,
|
105
|
-
<em class="parameter"><code><a class="link" href="AtkUtil.html#AtkCoordType" title="enum AtkCoordType"><span class="type">AtkCoordType</span></a> coord_type</code></em>,
|
106
|
-
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextRectangle" title="struct AtkTextRectangle"><span class="type">AtkTextRectangle</span></a> *rect</code></em>);
|
107
|
-
<span class="returnvalue">void</span> <a class="link" href="AtkText.html#atk-text-free-ranges" title="atk_text_free_ranges ()">atk_text_free_ranges</a> (<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextRange" title="struct AtkTextRange"><span class="type">AtkTextRange</span></a> **ranges</code></em>);
|
108
|
-
<span class="returnvalue">gint</span> <a class="link" href="AtkText.html#atk-text-get-n-selections" title="atk_text_get_n_selections ()">atk_text_get_n_selections</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>);
|
109
|
-
<span class="returnvalue">gchar</span> * <a class="link" href="AtkText.html#atk-text-get-selection" title="atk_text_get_selection ()">atk_text_get_selection</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
110
|
-
<em class="parameter"><code><span class="type">gint</span> selection_num</code></em>,
|
111
|
-
<em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
|
112
|
-
<em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);
|
113
|
-
<span class="returnvalue">gboolean</span> <a class="link" href="AtkText.html#atk-text-add-selection" title="atk_text_add_selection ()">atk_text_add_selection</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
114
|
-
<em class="parameter"><code><span class="type">gint</span> start_offset</code></em>,
|
115
|
-
<em class="parameter"><code><span class="type">gint</span> end_offset</code></em>);
|
116
|
-
<span class="returnvalue">gboolean</span> <a class="link" href="AtkText.html#atk-text-remove-selection" title="atk_text_remove_selection ()">atk_text_remove_selection</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
117
|
-
<em class="parameter"><code><span class="type">gint</span> selection_num</code></em>);
|
118
|
-
<span class="returnvalue">gboolean</span> <a class="link" href="AtkText.html#atk-text-set-selection" title="atk_text_set_selection ()">atk_text_set_selection</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
119
|
-
<em class="parameter"><code><span class="type">gint</span> selection_num</code></em>,
|
120
|
-
<em class="parameter"><code><span class="type">gint</span> start_offset</code></em>,
|
121
|
-
<em class="parameter"><code><span class="type">gint</span> end_offset</code></em>);
|
122
|
-
<span class="returnvalue">gboolean</span> <a class="link" href="AtkText.html#atk-text-set-caret-offset" title="atk_text_set_caret_offset ()">atk_text_set_caret_offset</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
123
|
-
<em class="parameter"><code><span class="type">gint</span> offset</code></em>);
|
124
|
-
<span class="returnvalue">void</span> <a class="link" href="AtkText.html#atk-attribute-set-free" title="atk_attribute_set_free ()">atk_attribute_set_free</a> (<em class="parameter"><code><a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> *attrib_set</code></em>);
|
125
|
-
<a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="returnvalue">AtkTextAttribute</span></a> <a class="link" href="AtkText.html#atk-text-attribute-register" title="atk_text_attribute_register ()">atk_text_attribute_register</a> (<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);
|
126
|
-
const <span class="returnvalue">gchar</span> * <a class="link" href="AtkText.html#atk-text-attribute-get-name" title="atk_text_attribute_get_name ()">atk_text_attribute_get_name</a> (<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a> attr</code></em>);
|
127
|
-
<a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="returnvalue">AtkTextAttribute</span></a> <a class="link" href="AtkText.html#atk-text-attribute-for-name" title="atk_text_attribute_for_name ()">atk_text_attribute_for_name</a> (<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);
|
128
|
-
const <span class="returnvalue">gchar</span> * <a class="link" href="AtkText.html#atk-text-attribute-get-value" title="atk_text_attribute_get_value ()">atk_text_attribute_get_value</a> (<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a> attr</code></em>,
|
129
|
-
<em class="parameter"><code><span class="type">gint</span> index_</code></em>);
|
130
|
-
</pre>
|
131
|
-
</div>
|
132
|
-
<div class="refsect1">
|
133
|
-
<a name="AtkText.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
134
|
-
<pre class="synopsis">
|
135
|
-
GInterface
|
136
|
-
+----AtkText
|
137
|
-
</pre>
|
138
|
-
</div>
|
139
|
-
<div class="refsect1">
|
140
|
-
<a name="AtkText.implementations"></a><h2>Known Implementations</h2>
|
141
|
-
<p>
|
142
|
-
AtkText is implemented by
|
143
|
-
<a class="link" href="AtkNoOpObject.html" title="AtkNoOpObject">AtkNoOpObject</a>.</p>
|
144
|
-
</div>
|
145
|
-
<div class="refsect1">
|
146
|
-
<a name="AtkText.signals"></a><h2>Signals</h2>
|
147
|
-
<pre class="synopsis">
|
148
|
-
"<a class="link" href="AtkText.html#AtkText-text-attributes-changed" title='The "text-attributes-changed" signal'>text-attributes-changed</a>" : <code class="literal">Run Last</code>
|
149
|
-
"<a class="link" href="AtkText.html#AtkText-text-caret-moved" title='The "text-caret-moved" signal'>text-caret-moved</a>" : <code class="literal">Run Last</code>
|
150
|
-
"<a class="link" href="AtkText.html#AtkText-text-changed" title='The "text-changed" signal'>text-changed</a>" : <code class="literal">Has Details</code>
|
151
|
-
"<a class="link" href="AtkText.html#AtkText-text-insert" title='The "text-insert" signal'>text-insert</a>" : <code class="literal">Has Details</code>
|
152
|
-
"<a class="link" href="AtkText.html#AtkText-text-remove" title='The "text-remove" signal'>text-remove</a>" : <code class="literal">Has Details</code>
|
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>
|
154
|
-
</pre>
|
155
|
-
</div>
|
156
|
-
<div class="refsect1">
|
157
|
-
<a name="AtkText.description"></a><h2>Description</h2>
|
158
|
-
<p>
|
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,
|
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
|
169
|
-
implemented instead.
|
170
|
-
</p>
|
171
|
-
<p>
|
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.
|
179
|
-
</p>
|
180
|
-
</div>
|
181
38
|
<div class="refsect1">
|
182
|
-
<a name="AtkText.
|
183
|
-
<div class="
|
184
|
-
<
|
185
|
-
<
|
186
|
-
<
|
187
|
-
</
|
188
|
-
</div>
|
189
|
-
<hr>
|
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">
|
39
|
+
<a name="AtkText.functions"></a><h2>Functions</h2>
|
40
|
+
<div class="informaltable"><table width="100%" border="0">
|
41
|
+
<colgroup>
|
42
|
+
<col width="150px" class="functions_return">
|
43
|
+
<col class="functions_name">
|
44
|
+
</colgroup>
|
284
45
|
<tbody>
|
285
46
|
<tr>
|
286
|
-
<td
|
287
|
-
<
|
288
|
-
</
|
289
|
-
<
|
290
|
-
<
|
291
|
-
|
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>
|
47
|
+
<td class="function_type">
|
48
|
+
<span class="returnvalue">gchar</span> *
|
49
|
+
</td>
|
50
|
+
<td class="function_name">
|
51
|
+
<a class="link" href="AtkText.html#atk-text-get-text" title="atk_text_get_text ()">atk_text_get_text</a> <span class="c_punctuation">()</span>
|
52
|
+
</td>
|
315
53
|
</tr>
|
316
54
|
<tr>
|
317
|
-
<td
|
318
|
-
<
|
55
|
+
<td class="function_type">
|
56
|
+
<span class="returnvalue">gunichar</span>
|
57
|
+
</td>
|
58
|
+
<td class="function_name">
|
59
|
+
<a class="link" href="AtkText.html#atk-text-get-character-at-offset" title="atk_text_get_character_at_offset ()">atk_text_get_character_at_offset</a> <span class="c_punctuation">()</span>
|
60
|
+
</td>
|
319
61
|
</tr>
|
320
62
|
<tr>
|
321
|
-
<td
|
322
|
-
<
|
63
|
+
<td class="function_type">
|
64
|
+
<span class="returnvalue">gchar</span> *
|
65
|
+
</td>
|
66
|
+
<td class="function_name">
|
67
|
+
<a class="link" href="AtkText.html#atk-text-get-text-after-offset" title="atk_text_get_text_after_offset ()">atk_text_get_text_after_offset</a> <span class="c_punctuation">()</span>
|
68
|
+
</td>
|
323
69
|
</tr>
|
324
70
|
<tr>
|
325
|
-
<td
|
326
|
-
<
|
71
|
+
<td class="function_type">
|
72
|
+
<span class="returnvalue">gchar</span> *
|
73
|
+
</td>
|
74
|
+
<td class="function_name">
|
75
|
+
<a class="link" href="AtkText.html#atk-text-get-text-at-offset" title="atk_text_get_text_at_offset ()">atk_text_get_text_at_offset</a> <span class="c_punctuation">()</span>
|
76
|
+
</td>
|
327
77
|
</tr>
|
328
78
|
<tr>
|
329
|
-
<td
|
330
|
-
<
|
79
|
+
<td class="function_type">
|
80
|
+
<span class="returnvalue">gchar</span> *
|
81
|
+
</td>
|
82
|
+
<td class="function_name">
|
83
|
+
<a class="link" href="AtkText.html#atk-text-get-text-before-offset" title="atk_text_get_text_before_offset ()">atk_text_get_text_before_offset</a> <span class="c_punctuation">()</span>
|
84
|
+
</td>
|
331
85
|
</tr>
|
332
86
|
<tr>
|
333
|
-
<td
|
334
|
-
<
|
87
|
+
<td class="function_type">
|
88
|
+
<span class="returnvalue">gchar</span> *
|
89
|
+
</td>
|
90
|
+
<td class="function_name">
|
91
|
+
<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> <span class="c_punctuation">()</span>
|
92
|
+
</td>
|
335
93
|
</tr>
|
336
94
|
<tr>
|
337
|
-
<td
|
338
|
-
<
|
95
|
+
<td class="function_type">
|
96
|
+
<span class="returnvalue">gint</span>
|
97
|
+
</td>
|
98
|
+
<td class="function_name">
|
99
|
+
<a class="link" href="AtkText.html#atk-text-get-caret-offset" title="atk_text_get_caret_offset ()">atk_text_get_caret_offset</a> <span class="c_punctuation">()</span>
|
100
|
+
</td>
|
339
101
|
</tr>
|
340
102
|
<tr>
|
341
|
-
<td
|
342
|
-
<
|
103
|
+
<td class="function_type">
|
104
|
+
<span class="returnvalue">void</span>
|
105
|
+
</td>
|
106
|
+
<td class="function_name">
|
107
|
+
<a class="link" href="AtkText.html#atk-text-get-character-extents" title="atk_text_get_character_extents ()">atk_text_get_character_extents</a> <span class="c_punctuation">()</span>
|
108
|
+
</td>
|
343
109
|
</tr>
|
344
110
|
<tr>
|
345
|
-
<td
|
346
|
-
<
|
111
|
+
<td class="function_type">
|
112
|
+
<a class="link" href="AtkObject.html#AtkAttributeSet" title="AtkAttributeSet"><span class="returnvalue">AtkAttributeSet</span></a> *
|
113
|
+
</td>
|
114
|
+
<td class="function_name">
|
115
|
+
<a class="link" href="AtkText.html#atk-text-get-run-attributes" title="atk_text_get_run_attributes ()">atk_text_get_run_attributes</a> <span class="c_punctuation">()</span>
|
116
|
+
</td>
|
347
117
|
</tr>
|
348
118
|
<tr>
|
349
|
-
<td
|
350
|
-
<
|
119
|
+
<td class="function_type">
|
120
|
+
<a class="link" href="AtkObject.html#AtkAttributeSet" title="AtkAttributeSet"><span class="returnvalue">AtkAttributeSet</span></a> *
|
121
|
+
</td>
|
122
|
+
<td class="function_name">
|
123
|
+
<a class="link" href="AtkText.html#atk-text-get-default-attributes" title="atk_text_get_default_attributes ()">atk_text_get_default_attributes</a> <span class="c_punctuation">()</span>
|
124
|
+
</td>
|
351
125
|
</tr>
|
352
126
|
<tr>
|
353
|
-
<td
|
354
|
-
<
|
127
|
+
<td class="function_type">
|
128
|
+
<span class="returnvalue">gint</span>
|
129
|
+
</td>
|
130
|
+
<td class="function_name">
|
131
|
+
<a class="link" href="AtkText.html#atk-text-get-character-count" title="atk_text_get_character_count ()">atk_text_get_character_count</a> <span class="c_punctuation">()</span>
|
132
|
+
</td>
|
355
133
|
</tr>
|
356
134
|
<tr>
|
357
|
-
<td
|
358
|
-
<
|
135
|
+
<td class="function_type">
|
136
|
+
<span class="returnvalue">gint</span>
|
137
|
+
</td>
|
138
|
+
<td class="function_name">
|
139
|
+
<a class="link" href="AtkText.html#atk-text-get-offset-at-point" title="atk_text_get_offset_at_point ()">atk_text_get_offset_at_point</a> <span class="c_punctuation">()</span>
|
140
|
+
</td>
|
359
141
|
</tr>
|
360
142
|
<tr>
|
361
|
-
<td
|
362
|
-
<
|
363
|
-
|
364
|
-
|
143
|
+
<td class="function_type">
|
144
|
+
<a class="link" href="AtkText.html#AtkTextRange" title="struct AtkTextRange"><span class="returnvalue">AtkTextRange</span></a> **
|
145
|
+
</td>
|
146
|
+
<td class="function_name">
|
147
|
+
<a class="link" href="AtkText.html#atk-text-get-bounded-ranges" title="atk_text_get_bounded_ranges ()">atk_text_get_bounded_ranges</a> <span class="c_punctuation">()</span>
|
148
|
+
</td>
|
365
149
|
</tr>
|
366
150
|
<tr>
|
367
|
-
<td
|
368
|
-
<
|
151
|
+
<td class="function_type">
|
152
|
+
<span class="returnvalue">void</span>
|
153
|
+
</td>
|
154
|
+
<td class="function_name">
|
155
|
+
<a class="link" href="AtkText.html#atk-text-get-range-extents" title="atk_text_get_range_extents ()">atk_text_get_range_extents</a> <span class="c_punctuation">()</span>
|
156
|
+
</td>
|
369
157
|
</tr>
|
370
158
|
<tr>
|
371
|
-
<td
|
372
|
-
<
|
159
|
+
<td class="function_type">
|
160
|
+
<span class="returnvalue">void</span>
|
161
|
+
</td>
|
162
|
+
<td class="function_name">
|
163
|
+
<a class="link" href="AtkText.html#atk-text-free-ranges" title="atk_text_free_ranges ()">atk_text_free_ranges</a> <span class="c_punctuation">()</span>
|
164
|
+
</td>
|
373
165
|
</tr>
|
374
166
|
<tr>
|
375
|
-
<td
|
376
|
-
<
|
167
|
+
<td class="function_type">
|
168
|
+
<span class="returnvalue">gint</span>
|
169
|
+
</td>
|
170
|
+
<td class="function_name">
|
171
|
+
<a class="link" href="AtkText.html#atk-text-get-n-selections" title="atk_text_get_n_selections ()">atk_text_get_n_selections</a> <span class="c_punctuation">()</span>
|
172
|
+
</td>
|
377
173
|
</tr>
|
378
174
|
<tr>
|
379
|
-
<td
|
380
|
-
<
|
175
|
+
<td class="function_type">
|
176
|
+
<span class="returnvalue">gchar</span> *
|
177
|
+
</td>
|
178
|
+
<td class="function_name">
|
179
|
+
<a class="link" href="AtkText.html#atk-text-get-selection" title="atk_text_get_selection ()">atk_text_get_selection</a> <span class="c_punctuation">()</span>
|
180
|
+
</td>
|
381
181
|
</tr>
|
382
182
|
<tr>
|
383
|
-
<td
|
384
|
-
<
|
183
|
+
<td class="function_type">
|
184
|
+
<span class="returnvalue">gboolean</span>
|
185
|
+
</td>
|
186
|
+
<td class="function_name">
|
187
|
+
<a class="link" href="AtkText.html#atk-text-add-selection" title="atk_text_add_selection ()">atk_text_add_selection</a> <span class="c_punctuation">()</span>
|
188
|
+
</td>
|
385
189
|
</tr>
|
386
190
|
<tr>
|
387
|
-
<td
|
388
|
-
<
|
389
|
-
|
390
|
-
|
391
|
-
|
191
|
+
<td class="function_type">
|
192
|
+
<span class="returnvalue">gboolean</span>
|
193
|
+
</td>
|
194
|
+
<td class="function_name">
|
195
|
+
<a class="link" href="AtkText.html#atk-text-remove-selection" title="atk_text_remove_selection ()">atk_text_remove_selection</a> <span class="c_punctuation">()</span>
|
196
|
+
</td>
|
392
197
|
</tr>
|
393
|
-
</tbody>
|
394
|
-
</table></div>
|
395
|
-
</div>
|
396
|
-
<hr>
|
397
|
-
<div class="refsect2">
|
398
|
-
<a name="AtkTextBoundary"></a><h3>enum AtkTextBoundary</h3>
|
399
|
-
<pre class="programlisting">typedef enum {
|
400
|
-
ATK_TEXT_BOUNDARY_CHAR,
|
401
|
-
ATK_TEXT_BOUNDARY_WORD_START,
|
402
|
-
ATK_TEXT_BOUNDARY_WORD_END,
|
403
|
-
ATK_TEXT_BOUNDARY_SENTENCE_START,
|
404
|
-
ATK_TEXT_BOUNDARY_SENTENCE_END,
|
405
|
-
ATK_TEXT_BOUNDARY_LINE_START,
|
406
|
-
ATK_TEXT_BOUNDARY_LINE_END
|
407
|
-
} AtkTextBoundary;
|
408
|
-
</pre>
|
409
|
-
<p>
|
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.
|
413
|
-
</p>
|
414
|
-
<div class="variablelist"><table border="0">
|
415
|
-
<col align="left" valign="top">
|
416
|
-
<tbody>
|
417
198
|
<tr>
|
418
|
-
<td
|
419
|
-
<
|
420
|
-
|
199
|
+
<td class="function_type">
|
200
|
+
<span class="returnvalue">gboolean</span>
|
201
|
+
</td>
|
202
|
+
<td class="function_name">
|
203
|
+
<a class="link" href="AtkText.html#atk-text-set-selection" title="atk_text_set_selection ()">atk_text_set_selection</a> <span class="c_punctuation">()</span>
|
421
204
|
</td>
|
422
205
|
</tr>
|
423
206
|
<tr>
|
424
|
-
<td
|
425
|
-
<
|
207
|
+
<td class="function_type">
|
208
|
+
<span class="returnvalue">gboolean</span>
|
209
|
+
</td>
|
210
|
+
<td class="function_name">
|
211
|
+
<a class="link" href="AtkText.html#atk-text-set-caret-offset" title="atk_text_set_caret_offset ()">atk_text_set_caret_offset</a> <span class="c_punctuation">()</span>
|
426
212
|
</td>
|
427
213
|
</tr>
|
428
214
|
<tr>
|
429
|
-
<td
|
430
|
-
<
|
431
|
-
|
215
|
+
<td class="function_type">
|
216
|
+
<span class="returnvalue">void</span>
|
217
|
+
</td>
|
218
|
+
<td class="function_name">
|
219
|
+
<a class="link" href="AtkText.html#atk-attribute-set-free" title="atk_attribute_set_free ()">atk_attribute_set_free</a> <span class="c_punctuation">()</span>
|
432
220
|
</td>
|
433
221
|
</tr>
|
434
222
|
<tr>
|
435
|
-
<td
|
436
|
-
<
|
223
|
+
<td class="function_type">
|
224
|
+
<a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="returnvalue">AtkTextAttribute</span></a>
|
225
|
+
</td>
|
226
|
+
<td class="function_name">
|
227
|
+
<a class="link" href="AtkText.html#atk-text-attribute-register" title="atk_text_attribute_register ()">atk_text_attribute_register</a> <span class="c_punctuation">()</span>
|
437
228
|
</td>
|
438
229
|
</tr>
|
439
230
|
<tr>
|
440
|
-
<td
|
441
|
-
|
442
|
-
|
443
|
-
|
444
|
-
similar terminal punctuation character.
|
231
|
+
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
232
|
+
</td>
|
233
|
+
<td class="function_name">
|
234
|
+
<a class="link" href="AtkText.html#atk-text-attribute-get-name" title="atk_text_attribute_get_name ()">atk_text_attribute_get_name</a> <span class="c_punctuation">()</span>
|
445
235
|
</td>
|
446
236
|
</tr>
|
447
237
|
<tr>
|
448
|
-
<td
|
449
|
-
<
|
450
|
-
|
238
|
+
<td class="function_type">
|
239
|
+
<a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="returnvalue">AtkTextAttribute</span></a>
|
240
|
+
</td>
|
241
|
+
<td class="function_name">
|
242
|
+
<a class="link" href="AtkText.html#atk-text-attribute-for-name" title="atk_text_attribute_for_name ()">atk_text_attribute_for_name</a> <span class="c_punctuation">()</span>
|
451
243
|
</td>
|
452
244
|
</tr>
|
453
245
|
<tr>
|
454
|
-
<td
|
455
|
-
|
456
|
-
|
246
|
+
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
247
|
+
</td>
|
248
|
+
<td class="function_name">
|
249
|
+
<a class="link" href="AtkText.html#atk-text-attribute-get-value" title="atk_text_attribute_get_value ()">atk_text_attribute_get_value</a> <span class="c_punctuation">()</span>
|
457
250
|
</td>
|
458
251
|
</tr>
|
459
252
|
</tbody>
|
460
253
|
</table></div>
|
461
254
|
</div>
|
462
|
-
<
|
463
|
-
<
|
464
|
-
<
|
465
|
-
<
|
466
|
-
|
467
|
-
|
468
|
-
|
469
|
-
|
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">
|
255
|
+
<div class="refsect1">
|
256
|
+
<a name="AtkText.signals"></a><h2>Signals</h2>
|
257
|
+
<div class="informaltable"><table border="0">
|
258
|
+
<colgroup>
|
259
|
+
<col width="150px" class="signals_return">
|
260
|
+
<col width="300px" class="signals_name">
|
261
|
+
<col width="200px" class="signals_flags">
|
262
|
+
</colgroup>
|
479
263
|
<tbody>
|
480
264
|
<tr>
|
481
|
-
<td
|
482
|
-
<td
|
483
|
-
|
484
|
-
</td>
|
265
|
+
<td class="signal_type"><span class="returnvalue">void</span></td>
|
266
|
+
<td class="signal_name"><a class="link" href="AtkText.html#AtkText-text-attributes-changed" title="The “text-attributes-changed” signal">text-attributes-changed</a></td>
|
267
|
+
<td class="signal_flags">Run Last</td>
|
485
268
|
</tr>
|
486
269
|
<tr>
|
487
|
-
<td
|
488
|
-
<td
|
489
|
-
|
490
|
-
the following one, if present.
|
491
|
-
</td>
|
270
|
+
<td class="signal_type"><span class="returnvalue">void</span></td>
|
271
|
+
<td class="signal_name"><a class="link" href="AtkText.html#AtkText-text-caret-moved" title="The “text-caret-moved” signal">text-caret-moved</a></td>
|
272
|
+
<td class="signal_flags">Run Last</td>
|
492
273
|
</tr>
|
493
274
|
<tr>
|
494
|
-
<td
|
495
|
-
<td
|
496
|
-
|
497
|
-
the following one, if present.
|
498
|
-
</td>
|
275
|
+
<td class="signal_type"><span class="returnvalue">void</span></td>
|
276
|
+
<td class="signal_name"><a class="link" href="AtkText.html#AtkText-text-changed" title="The “text-changed” signal">text-changed</a></td>
|
277
|
+
<td class="signal_flags">Has Details</td>
|
499
278
|
</tr>
|
500
279
|
<tr>
|
501
|
-
<td
|
502
|
-
<td
|
503
|
-
|
504
|
-
the following one, if present.
|
505
|
-
</td>
|
280
|
+
<td class="signal_type"><span class="returnvalue">void</span></td>
|
281
|
+
<td class="signal_name"><a class="link" href="AtkText.html#AtkText-text-insert" title="The “text-insert” signal">text-insert</a></td>
|
282
|
+
<td class="signal_flags">Has Details</td>
|
506
283
|
</tr>
|
507
284
|
<tr>
|
508
|
-
<td
|
509
|
-
<td
|
510
|
-
|
511
|
-
|
512
|
-
|
285
|
+
<td class="signal_type"><span class="returnvalue">void</span></td>
|
286
|
+
<td class="signal_name"><a class="link" href="AtkText.html#AtkText-text-remove" title="The “text-remove” signal">text-remove</a></td>
|
287
|
+
<td class="signal_flags">Has Details</td>
|
288
|
+
</tr>
|
289
|
+
<tr>
|
290
|
+
<td class="signal_type"><span class="returnvalue">void</span></td>
|
291
|
+
<td class="signal_name"><a class="link" href="AtkText.html#AtkText-text-selection-changed" title="The “text-selection-changed” signal">text-selection-changed</a></td>
|
292
|
+
<td class="signal_flags">Run Last</td>
|
513
293
|
</tr>
|
514
294
|
</tbody>
|
515
295
|
</table></div>
|
516
296
|
</div>
|
517
|
-
<
|
518
|
-
<
|
519
|
-
<
|
520
|
-
<
|
521
|
-
|
522
|
-
|
523
|
-
|
524
|
-
ATK_TEXT_CLIP_BOTH
|
525
|
-
} AtkTextClipType;
|
526
|
-
</pre>
|
527
|
-
<p>
|
528
|
-
Describes the type of clipping required.
|
529
|
-
</p>
|
530
|
-
<div class="variablelist"><table border="0">
|
531
|
-
<col align="left" valign="top">
|
297
|
+
<div class="refsect1">
|
298
|
+
<a name="AtkText.other"></a><h2>Types and Values</h2>
|
299
|
+
<div class="informaltable"><table width="100%" border="0">
|
300
|
+
<colgroup>
|
301
|
+
<col width="150px" class="name">
|
302
|
+
<col class="description">
|
303
|
+
</colgroup>
|
532
304
|
<tbody>
|
533
305
|
<tr>
|
534
|
-
<td
|
535
|
-
<td
|
536
|
-
</td>
|
306
|
+
<td class="datatype_keyword"> </td>
|
307
|
+
<td class="function_name"><a class="link" href="AtkText.html#AtkText-struct" title="AtkText">AtkText</a></td>
|
537
308
|
</tr>
|
538
309
|
<tr>
|
539
|
-
<td
|
540
|
-
<td
|
541
|
-
</td>
|
310
|
+
<td class="datatype_keyword">struct</td>
|
311
|
+
<td class="function_name"><a class="link" href="AtkText.html#AtkTextIface" title="struct AtkTextIface">AtkTextIface</a></td>
|
542
312
|
</tr>
|
543
313
|
<tr>
|
544
|
-
<td
|
545
|
-
<td
|
546
|
-
</td>
|
314
|
+
<td class="datatype_keyword">enum</td>
|
315
|
+
<td class="function_name"><a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary">AtkTextBoundary</a></td>
|
547
316
|
</tr>
|
548
317
|
<tr>
|
549
|
-
<td
|
550
|
-
<td
|
551
|
-
</td>
|
318
|
+
<td class="datatype_keyword">enum</td>
|
319
|
+
<td class="function_name"><a class="link" href="AtkText.html#AtkTextGranularity" title="enum AtkTextGranularity">AtkTextGranularity</a></td>
|
552
320
|
</tr>
|
553
|
-
</tbody>
|
554
|
-
</table></div>
|
555
|
-
</div>
|
556
|
-
<hr>
|
557
|
-
<div class="refsect2">
|
558
|
-
<a name="AtkTextRange"></a><h3>struct AtkTextRange</h3>
|
559
|
-
<pre class="programlisting">struct AtkTextRange {
|
560
|
-
AtkTextRectangle bounds;
|
561
|
-
gint start_offset;
|
562
|
-
gint end_offset;
|
563
|
-
gchar* content;
|
564
|
-
};
|
565
|
-
</pre>
|
566
|
-
<p>
|
567
|
-
A structure used to describe a text range.
|
568
|
-
</p>
|
569
|
-
<div class="variablelist"><table border="0">
|
570
|
-
<col align="left" valign="top">
|
571
|
-
<tbody>
|
572
321
|
<tr>
|
573
|
-
<td
|
574
|
-
<td
|
322
|
+
<td class="datatype_keyword">enum</td>
|
323
|
+
<td class="function_name"><a class="link" href="AtkText.html#AtkTextClipType" title="enum AtkTextClipType">AtkTextClipType</a></td>
|
575
324
|
</tr>
|
576
325
|
<tr>
|
577
|
-
<td
|
578
|
-
<td
|
326
|
+
<td class="datatype_keyword">struct</td>
|
327
|
+
<td class="function_name"><a class="link" href="AtkText.html#AtkTextRange" title="struct AtkTextRange">AtkTextRange</a></td>
|
579
328
|
</tr>
|
580
329
|
<tr>
|
581
|
-
<td
|
582
|
-
<td
|
330
|
+
<td class="datatype_keyword">struct</td>
|
331
|
+
<td class="function_name"><a class="link" href="AtkText.html#AtkTextRectangle" title="struct AtkTextRectangle">AtkTextRectangle</a></td>
|
583
332
|
</tr>
|
584
333
|
<tr>
|
585
|
-
<td
|
586
|
-
<td
|
334
|
+
<td class="datatype_keyword">enum</td>
|
335
|
+
<td class="function_name"><a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute">AtkTextAttribute</a></td>
|
587
336
|
</tr>
|
588
337
|
</tbody>
|
589
338
|
</table></div>
|
590
339
|
</div>
|
591
|
-
<
|
592
|
-
<
|
593
|
-
<
|
594
|
-
<
|
595
|
-
gint x;
|
596
|
-
gint y;
|
597
|
-
gint width;
|
598
|
-
gint height;
|
599
|
-
};
|
340
|
+
<div class="refsect1">
|
341
|
+
<a name="AtkText.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
342
|
+
<pre class="screen"> GInterface
|
343
|
+
<span class="lineart">╰──</span> AtkText
|
600
344
|
</pre>
|
345
|
+
</div>
|
346
|
+
<div class="refsect1">
|
347
|
+
<a name="AtkText.implementations"></a><h2>Known Implementations</h2>
|
601
348
|
<p>
|
602
|
-
|
603
|
-
</p>
|
604
|
-
|
605
|
-
<
|
349
|
+
AtkText is implemented by
|
350
|
+
<a class="link" href="AtkNoOpObject.html" title="AtkNoOpObject">AtkNoOpObject</a>.</p>
|
351
|
+
</div>
|
352
|
+
<div class="refsect1">
|
353
|
+
<a name="AtkText.description"></a><h2>Description</h2>
|
354
|
+
<p><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
|
355
|
+
that have text content which is either attributed or otherwise
|
356
|
+
non-trivial. <a href="AtkObject.html"><span class="type">AtkObjects</span></a> whose text content is simple,
|
357
|
+
unattributed, and very brief may expose that content via
|
358
|
+
<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,
|
359
|
+
multi-line, typically longer than three or four words, attributed,
|
360
|
+
selectable, or if the object already uses the 'name' ATK property
|
361
|
+
for other information, the <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> interface should be used to
|
362
|
+
expose the text content. In the case of editable text content,
|
363
|
+
<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
|
364
|
+
implemented instead.</p>
|
365
|
+
<p> <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> provides not only traversal facilities and change
|
366
|
+
notification for text content, but also caret tracking and glyph
|
367
|
+
bounding box calculations. Note that the text strings are exposed
|
368
|
+
as UTF-8, and are therefore potentially multi-byte, and
|
369
|
+
caret-to-byte offset mapping makes no assumptions about the
|
370
|
+
character length; also bounding box glyph-to-offset mapping may be
|
371
|
+
complex for languages which use ligatures.</p>
|
372
|
+
</div>
|
373
|
+
<div class="refsect1">
|
374
|
+
<a name="AtkText.functions_details"></a><h2>Functions</h2>
|
375
|
+
<div class="refsect2">
|
376
|
+
<a name="atk-text-get-text"></a><h3>atk_text_get_text ()</h3>
|
377
|
+
<pre class="programlisting"><span class="returnvalue">gchar</span> *
|
378
|
+
atk_text_get_text (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
379
|
+
<em class="parameter"><code><span class="type">gint</span> start_offset</code></em>,
|
380
|
+
<em class="parameter"><code><span class="type">gint</span> end_offset</code></em>);</pre>
|
381
|
+
<p>Gets the specified text.</p>
|
382
|
+
<div class="refsect3">
|
383
|
+
<a name="id-1.5.13.9.2.5"></a><h4>Parameters</h4>
|
384
|
+
<div class="informaltable"><table width="100%" border="0">
|
385
|
+
<colgroup>
|
386
|
+
<col width="150px" class="parameters_name">
|
387
|
+
<col class="parameters_description">
|
388
|
+
<col width="200px" class="parameters_annotations">
|
389
|
+
</colgroup>
|
606
390
|
<tbody>
|
607
391
|
<tr>
|
608
|
-
<td
|
609
|
-
<td>
|
392
|
+
<td class="parameter_name"><p>text</p></td>
|
393
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
394
|
+
<td class="parameter_annotations"> </td>
|
610
395
|
</tr>
|
611
396
|
<tr>
|
612
|
-
<td
|
613
|
-
<td>
|
397
|
+
<td class="parameter_name"><p>start_offset</p></td>
|
398
|
+
<td class="parameter_description"><p>start position</p></td>
|
399
|
+
<td class="parameter_annotations"> </td>
|
614
400
|
</tr>
|
615
401
|
<tr>
|
616
|
-
<td
|
617
|
-
<td>
|
618
|
-
</
|
619
|
-
<tr>
|
620
|
-
<td><p><span class="term"><span class="type">gint</span> <em class="structfield"><code><a name="AtkTextRectangle.height"></a>height</code></em>;</span></p></td>
|
621
|
-
<td>The height of a rectangle</td>
|
402
|
+
<td class="parameter_name"><p>end_offset</p></td>
|
403
|
+
<td class="parameter_description"><p>end position, or -1 for the end of the string.</p></td>
|
404
|
+
<td class="parameter_annotations"> </td>
|
622
405
|
</tr>
|
623
406
|
</tbody>
|
624
407
|
</table></div>
|
625
408
|
</div>
|
409
|
+
<div class="refsect3">
|
410
|
+
<a name="id-1.5.13.9.2.6"></a><h4>Returns</h4>
|
411
|
+
<p> a newly allocated string containing the text from <em class="parameter"><code>start_offset</code></em>
|
412
|
+
up
|
413
|
+
to, but not including <em class="parameter"><code>end_offset</code></em>
|
414
|
+
. Use <code class="function">g_free()</code> to free the returned string.</p>
|
415
|
+
<p></p>
|
416
|
+
</div>
|
417
|
+
</div>
|
626
418
|
<hr>
|
627
419
|
<div class="refsect2">
|
628
|
-
<a name="
|
629
|
-
<pre class="programlisting">
|
630
|
-
|
631
|
-
|
632
|
-
|
633
|
-
|
634
|
-
<
|
635
|
-
|
636
|
-
|
637
|
-
<
|
638
|
-
<col
|
420
|
+
<a name="atk-text-get-character-at-offset"></a><h3>atk_text_get_character_at_offset ()</h3>
|
421
|
+
<pre class="programlisting"><span class="returnvalue">gunichar</span>
|
422
|
+
atk_text_get_character_at_offset (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
423
|
+
<em class="parameter"><code><span class="type">gint</span> offset</code></em>);</pre>
|
424
|
+
<p>Gets the specified text.</p>
|
425
|
+
<div class="refsect3">
|
426
|
+
<a name="id-1.5.13.9.3.5"></a><h4>Parameters</h4>
|
427
|
+
<div class="informaltable"><table width="100%" border="0">
|
428
|
+
<colgroup>
|
429
|
+
<col width="150px" class="parameters_name">
|
430
|
+
<col class="parameters_description">
|
431
|
+
<col width="200px" class="parameters_annotations">
|
432
|
+
</colgroup>
|
639
433
|
<tbody>
|
640
434
|
<tr>
|
641
|
-
<td
|
642
|
-
<td>
|
643
|
-
</td>
|
435
|
+
<td class="parameter_name"><p>text</p></td>
|
436
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
437
|
+
<td class="parameter_annotations"> </td>
|
644
438
|
</tr>
|
645
439
|
<tr>
|
646
|
-
<td
|
647
|
-
<td>
|
648
|
-
|
649
|
-
For values which are numbers, the string representation of the number
|
650
|
-
is in value.</td>
|
440
|
+
<td class="parameter_name"><p>offset</p></td>
|
441
|
+
<td class="parameter_description"><p>position</p></td>
|
442
|
+
<td class="parameter_annotations"> </td>
|
651
443
|
</tr>
|
652
444
|
</tbody>
|
653
445
|
</table></div>
|
654
446
|
</div>
|
655
|
-
<
|
656
|
-
<
|
657
|
-
<
|
658
|
-
|
659
|
-
|
660
|
-
|
661
|
-
This is a singly-linked list (a <span class="type">GSList</span>) of <a class="link" href="AtkText.html#AtkAttribute" title="struct AtkAttribute"><span class="type">AtkAttribute</span></a>. It is
|
662
|
-
used by <a class="link" href="AtkText.html#atk-text-get-run-attributes" title="atk_text_get_run_attributes ()"><code class="function">atk_text_get_run_attributes()</code></a>, <a class="link" href="AtkText.html#atk-text-get-default-attributes" title="atk_text_get_default_attributes ()"><code class="function">atk_text_get_default_attributes()</code></a>
|
663
|
-
and <a class="link" href="AtkEditableText.html#atk-editable-text-set-run-attributes" title="atk_editable_text_set_run_attributes ()"><code class="function">atk_editable_text_set_run_attributes()</code></a>
|
664
|
-
</p>
|
447
|
+
<div class="refsect3">
|
448
|
+
<a name="id-1.5.13.9.3.6"></a><h4>Returns</h4>
|
449
|
+
<p> the character at <em class="parameter"><code>offset</code></em>
|
450
|
+
.</p>
|
451
|
+
<p></p>
|
452
|
+
</div>
|
665
453
|
</div>
|
666
454
|
<hr>
|
667
455
|
<div class="refsect2">
|
668
|
-
<a name="
|
669
|
-
<pre class="programlisting">
|
670
|
-
|
671
|
-
|
672
|
-
|
673
|
-
|
674
|
-
|
675
|
-
|
676
|
-
|
677
|
-
|
678
|
-
|
679
|
-
|
680
|
-
|
681
|
-
|
682
|
-
|
683
|
-
|
684
|
-
|
685
|
-
|
686
|
-
|
687
|
-
|
688
|
-
|
689
|
-
ATK_TEXT_ATTR_FG_COLOR,
|
690
|
-
ATK_TEXT_ATTR_BG_STIPPLE,
|
691
|
-
ATK_TEXT_ATTR_FG_STIPPLE,
|
692
|
-
ATK_TEXT_ATTR_WRAP_MODE,
|
693
|
-
ATK_TEXT_ATTR_DIRECTION,
|
694
|
-
ATK_TEXT_ATTR_JUSTIFICATION,
|
695
|
-
ATK_TEXT_ATTR_STRETCH,
|
696
|
-
ATK_TEXT_ATTR_VARIANT,
|
697
|
-
ATK_TEXT_ATTR_STYLE,
|
698
|
-
ATK_TEXT_ATTR_LAST_DEFINED
|
699
|
-
} AtkTextAttribute;
|
700
|
-
</pre>
|
701
|
-
<p>
|
702
|
-
Describes the text attributes supported
|
703
|
-
</p>
|
704
|
-
<div class="variablelist"><table border="0">
|
705
|
-
<col align="left" valign="top">
|
456
|
+
<a name="atk-text-get-text-after-offset"></a><h3>atk_text_get_text_after_offset ()</h3>
|
457
|
+
<pre class="programlisting"><span class="returnvalue">gchar</span> *
|
458
|
+
atk_text_get_text_after_offset (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
459
|
+
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
460
|
+
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a> boundary_type</code></em>,
|
461
|
+
<em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
|
462
|
+
<em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);</pre>
|
463
|
+
<div class="warning">
|
464
|
+
<p><code class="literal">atk_text_get_text_after_offset</code> is deprecated and should not be used in newly-written code.</p>
|
465
|
+
<p>This method is deprecated since ATK version
|
466
|
+
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>
|
467
|
+
</div>
|
468
|
+
<p>Gets the specified text.</p>
|
469
|
+
<div class="refsect3">
|
470
|
+
<a name="id-1.5.13.9.4.6"></a><h4>Parameters</h4>
|
471
|
+
<div class="informaltable"><table width="100%" border="0">
|
472
|
+
<colgroup>
|
473
|
+
<col width="150px" class="parameters_name">
|
474
|
+
<col class="parameters_description">
|
475
|
+
<col width="200px" class="parameters_annotations">
|
476
|
+
</colgroup>
|
706
477
|
<tbody>
|
707
478
|
<tr>
|
708
|
-
<td
|
709
|
-
<td>
|
710
|
-
</td>
|
479
|
+
<td class="parameter_name"><p>text</p></td>
|
480
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
481
|
+
<td class="parameter_annotations"> </td>
|
711
482
|
</tr>
|
712
483
|
<tr>
|
713
|
-
<td
|
714
|
-
<td>
|
715
|
-
</td>
|
484
|
+
<td class="parameter_name"><p>offset</p></td>
|
485
|
+
<td class="parameter_description"><p>position</p></td>
|
486
|
+
<td class="parameter_annotations"> </td>
|
716
487
|
</tr>
|
717
488
|
<tr>
|
718
|
-
<td
|
719
|
-
<td>
|
720
|
-
</td>
|
489
|
+
<td class="parameter_name"><p>boundary_type</p></td>
|
490
|
+
<td class="parameter_description"><p>An <a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a></p></td>
|
491
|
+
<td class="parameter_annotations"> </td>
|
721
492
|
</tr>
|
722
493
|
<tr>
|
723
|
-
<td
|
724
|
-
<td>
|
725
|
-
</td>
|
494
|
+
<td class="parameter_name"><p>start_offset</p></td>
|
495
|
+
<td class="parameter_description"><p> the start offset of the returned string. </p></td>
|
496
|
+
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span></td>
|
726
497
|
</tr>
|
727
498
|
<tr>
|
728
|
-
<td
|
729
|
-
<td
|
730
|
-
</td>
|
499
|
+
<td class="parameter_name"><p>end_offset</p></td>
|
500
|
+
<td class="parameter_description"><p> the offset of the first character after the
|
501
|
+
returned substring. </p></td>
|
502
|
+
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span></td>
|
731
503
|
</tr>
|
504
|
+
</tbody>
|
505
|
+
</table></div>
|
506
|
+
</div>
|
507
|
+
<div class="refsect3">
|
508
|
+
<a name="id-1.5.13.9.4.7"></a><h4>Returns</h4>
|
509
|
+
<p> a newly allocated string containing the text after <em class="parameter"><code>offset</code></em>
|
510
|
+
bounded
|
511
|
+
by the specified <em class="parameter"><code>boundary_type</code></em>
|
512
|
+
. Use <code class="function">g_free()</code> to free the returned string.</p>
|
513
|
+
<p></p>
|
514
|
+
</div>
|
515
|
+
</div>
|
516
|
+
<hr>
|
517
|
+
<div class="refsect2">
|
518
|
+
<a name="atk-text-get-text-at-offset"></a><h3>atk_text_get_text_at_offset ()</h3>
|
519
|
+
<pre class="programlisting"><span class="returnvalue">gchar</span> *
|
520
|
+
atk_text_get_text_at_offset (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
521
|
+
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
522
|
+
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a> boundary_type</code></em>,
|
523
|
+
<em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
|
524
|
+
<em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);</pre>
|
525
|
+
<div class="warning">
|
526
|
+
<p><code class="literal">atk_text_get_text_at_offset</code> is deprecated and should not be used in newly-written code.</p>
|
527
|
+
<p>This method is deprecated since ATK version
|
528
|
+
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>
|
529
|
+
</div>
|
530
|
+
<p>Gets the specified text.</p>
|
531
|
+
<p>If the boundary_type if ATK_TEXT_BOUNDARY_CHAR the character at the
|
532
|
+
offset is returned.</p>
|
533
|
+
<p>If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string
|
534
|
+
is from the word start at or before the offset to the word start after
|
535
|
+
the offset.</p>
|
536
|
+
<p>The returned string will contain the word at the offset if the offset
|
537
|
+
is inside a word and will contain the word before the offset if the
|
538
|
+
offset is not inside a word.</p>
|
539
|
+
<p>If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the returned
|
540
|
+
string is from the sentence start at or before the offset to the sentence
|
541
|
+
start after the offset.</p>
|
542
|
+
<p>The returned string will contain the sentence at the offset if the offset
|
543
|
+
is inside a sentence and will contain the sentence before the offset
|
544
|
+
if the offset is not inside a sentence.</p>
|
545
|
+
<p>If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned
|
546
|
+
string is from the line start at or before the offset to the line
|
547
|
+
start after the offset.</p>
|
548
|
+
<div class="refsect3">
|
549
|
+
<a name="id-1.5.13.9.5.12"></a><h4>Parameters</h4>
|
550
|
+
<div class="informaltable"><table width="100%" border="0">
|
551
|
+
<colgroup>
|
552
|
+
<col width="150px" class="parameters_name">
|
553
|
+
<col class="parameters_description">
|
554
|
+
<col width="200px" class="parameters_annotations">
|
555
|
+
</colgroup>
|
556
|
+
<tbody>
|
732
557
|
<tr>
|
733
|
-
<td
|
734
|
-
<td
|
735
|
-
</td>
|
558
|
+
<td class="parameter_name"><p>text</p></td>
|
559
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
560
|
+
<td class="parameter_annotations"> </td>
|
736
561
|
</tr>
|
737
562
|
<tr>
|
738
|
-
<td
|
739
|
-
<td>
|
740
|
-
</td>
|
563
|
+
<td class="parameter_name"><p>offset</p></td>
|
564
|
+
<td class="parameter_description"><p>position</p></td>
|
565
|
+
<td class="parameter_annotations"> </td>
|
741
566
|
</tr>
|
742
567
|
<tr>
|
743
|
-
<td
|
744
|
-
<td>
|
745
|
-
</td>
|
568
|
+
<td class="parameter_name"><p>boundary_type</p></td>
|
569
|
+
<td class="parameter_description"><p>An <a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a></p></td>
|
570
|
+
<td class="parameter_annotations"> </td>
|
746
571
|
</tr>
|
747
572
|
<tr>
|
748
|
-
<td
|
749
|
-
<td>
|
750
|
-
</td>
|
573
|
+
<td class="parameter_name"><p>start_offset</p></td>
|
574
|
+
<td class="parameter_description"><p> the start offset of the returned string. </p></td>
|
575
|
+
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span></td>
|
751
576
|
</tr>
|
752
577
|
<tr>
|
753
|
-
<td
|
754
|
-
<td
|
755
|
-
</td>
|
578
|
+
<td class="parameter_name"><p>end_offset</p></td>
|
579
|
+
<td class="parameter_description"><p> the offset of the first character after the
|
580
|
+
returned substring. </p></td>
|
581
|
+
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span></td>
|
756
582
|
</tr>
|
583
|
+
</tbody>
|
584
|
+
</table></div>
|
585
|
+
</div>
|
586
|
+
<div class="refsect3">
|
587
|
+
<a name="id-1.5.13.9.5.13"></a><h4>Returns</h4>
|
588
|
+
<p> a newly allocated string containing the text at <em class="parameter"><code>offset</code></em>
|
589
|
+
bounded by
|
590
|
+
the specified <em class="parameter"><code>boundary_type</code></em>
|
591
|
+
. Use <code class="function">g_free()</code> to free the returned string.</p>
|
592
|
+
<p></p>
|
593
|
+
</div>
|
594
|
+
</div>
|
595
|
+
<hr>
|
596
|
+
<div class="refsect2">
|
597
|
+
<a name="atk-text-get-text-before-offset"></a><h3>atk_text_get_text_before_offset ()</h3>
|
598
|
+
<pre class="programlisting"><span class="returnvalue">gchar</span> *
|
599
|
+
atk_text_get_text_before_offset (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
600
|
+
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
601
|
+
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a> boundary_type</code></em>,
|
602
|
+
<em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
|
603
|
+
<em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);</pre>
|
604
|
+
<div class="warning">
|
605
|
+
<p><code class="literal">atk_text_get_text_before_offset</code> is deprecated and should not be used in newly-written code.</p>
|
606
|
+
<p>This method is deprecated since ATK version
|
607
|
+
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>
|
608
|
+
</div>
|
609
|
+
<p>Gets the specified text.</p>
|
610
|
+
<div class="refsect3">
|
611
|
+
<a name="id-1.5.13.9.6.6"></a><h4>Parameters</h4>
|
612
|
+
<div class="informaltable"><table width="100%" border="0">
|
613
|
+
<colgroup>
|
614
|
+
<col width="150px" class="parameters_name">
|
615
|
+
<col class="parameters_description">
|
616
|
+
<col width="200px" class="parameters_annotations">
|
617
|
+
</colgroup>
|
618
|
+
<tbody>
|
757
619
|
<tr>
|
758
|
-
<td
|
759
|
-
<td>
|
760
|
-
</td>
|
620
|
+
<td class="parameter_name"><p>text</p></td>
|
621
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
622
|
+
<td class="parameter_annotations"> </td>
|
761
623
|
</tr>
|
762
624
|
<tr>
|
763
|
-
<td
|
764
|
-
<td
|
765
|
-
</td>
|
625
|
+
<td class="parameter_name"><p>offset</p></td>
|
626
|
+
<td class="parameter_description"><p>position</p></td>
|
627
|
+
<td class="parameter_annotations"> </td>
|
766
628
|
</tr>
|
767
629
|
<tr>
|
768
|
-
<td
|
769
|
-
<td
|
770
|
-
</td>
|
630
|
+
<td class="parameter_name"><p>boundary_type</p></td>
|
631
|
+
<td class="parameter_description"><p>An <a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a></p></td>
|
632
|
+
<td class="parameter_annotations"> </td>
|
771
633
|
</tr>
|
772
634
|
<tr>
|
773
|
-
<td
|
774
|
-
<td>
|
775
|
-
</td>
|
635
|
+
<td class="parameter_name"><p>start_offset</p></td>
|
636
|
+
<td class="parameter_description"><p> the start offset of the returned string. </p></td>
|
637
|
+
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span></td>
|
776
638
|
</tr>
|
777
639
|
<tr>
|
778
|
-
<td
|
779
|
-
<td>
|
780
|
-
</td>
|
640
|
+
<td class="parameter_name"><p>end_offset</p></td>
|
641
|
+
<td class="parameter_description"><p> the offset of the first character after the
|
642
|
+
returned substring. </p></td>
|
643
|
+
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span></td>
|
781
644
|
</tr>
|
645
|
+
</tbody>
|
646
|
+
</table></div>
|
647
|
+
</div>
|
648
|
+
<div class="refsect3">
|
649
|
+
<a name="id-1.5.13.9.6.7"></a><h4>Returns</h4>
|
650
|
+
<p> a newly allocated string containing the text before <em class="parameter"><code>offset</code></em>
|
651
|
+
bounded
|
652
|
+
by the specified <em class="parameter"><code>boundary_type</code></em>
|
653
|
+
. Use <code class="function">g_free()</code> to free the returned string.</p>
|
654
|
+
<p></p>
|
655
|
+
</div>
|
656
|
+
</div>
|
657
|
+
<hr>
|
658
|
+
<div class="refsect2">
|
659
|
+
<a name="atk-text-get-string-at-offset"></a><h3>atk_text_get_string_at_offset ()</h3>
|
660
|
+
<pre class="programlisting"><span class="returnvalue">gchar</span> *
|
661
|
+
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>,
|
662
|
+
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
663
|
+
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextGranularity" title="enum AtkTextGranularity"><span class="type">AtkTextGranularity</span></a> granularity</code></em>,
|
664
|
+
<em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
|
665
|
+
<em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);</pre>
|
666
|
+
<p>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>
|
667
|
+
|
668
|
+
and a specific <em class="parameter"><code>granularity</code></em>
|
669
|
+
, along with the start and end offsets defining the
|
670
|
+
boundaries of such a portion of text.</p>
|
671
|
+
<p>If <em class="parameter"><code>granularity</code></em>
|
672
|
+
is ATK_TEXT_GRANULARITY_CHAR the character at the
|
673
|
+
offset is returned.</p>
|
674
|
+
<p>If <em class="parameter"><code>granularity</code></em>
|
675
|
+
is ATK_TEXT_GRANULARITY_WORD the returned string
|
676
|
+
is from the word start at or before the offset to the word start after
|
677
|
+
the offset.</p>
|
678
|
+
<p>The returned string will contain the word at the offset if the offset
|
679
|
+
is inside a word and will contain the word before the offset if the
|
680
|
+
offset is not inside a word.</p>
|
681
|
+
<p>If <em class="parameter"><code>granularity</code></em>
|
682
|
+
is ATK_TEXT_GRANULARITY_SENTENCE the returned string
|
683
|
+
is from the sentence start at or before the offset to the sentence
|
684
|
+
start after the offset.</p>
|
685
|
+
<p>The returned string will contain the sentence at the offset if the offset
|
686
|
+
is inside a sentence and will contain the sentence before the offset
|
687
|
+
if the offset is not inside a sentence.</p>
|
688
|
+
<p>If <em class="parameter"><code>granularity</code></em>
|
689
|
+
is ATK_TEXT_GRANULARITY_LINE the returned string
|
690
|
+
is from the line start at or before the offset to the line
|
691
|
+
start after the offset.</p>
|
692
|
+
<p>If <em class="parameter"><code>granularity</code></em>
|
693
|
+
is ATK_TEXT_GRANULARITY_PARAGRAPH the returned string
|
694
|
+
is from the start of the paragraph at or before the offset to the start
|
695
|
+
of the following paragraph after the offset.</p>
|
696
|
+
<div class="refsect3">
|
697
|
+
<a name="id-1.5.13.9.7.12"></a><h4>Parameters</h4>
|
698
|
+
<div class="informaltable"><table width="100%" border="0">
|
699
|
+
<colgroup>
|
700
|
+
<col width="150px" class="parameters_name">
|
701
|
+
<col class="parameters_description">
|
702
|
+
<col width="200px" class="parameters_annotations">
|
703
|
+
</colgroup>
|
704
|
+
<tbody>
|
782
705
|
<tr>
|
783
|
-
<td
|
784
|
-
<td>
|
785
|
-
</td>
|
706
|
+
<td class="parameter_name"><p>text</p></td>
|
707
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
708
|
+
<td class="parameter_annotations"> </td>
|
786
709
|
</tr>
|
787
710
|
<tr>
|
788
|
-
<td
|
789
|
-
<td>
|
790
|
-
</td>
|
711
|
+
<td class="parameter_name"><p>offset</p></td>
|
712
|
+
<td class="parameter_description"><p>position</p></td>
|
713
|
+
<td class="parameter_annotations"> </td>
|
791
714
|
</tr>
|
792
715
|
<tr>
|
793
|
-
<td
|
794
|
-
<td>
|
795
|
-
</td>
|
716
|
+
<td class="parameter_name"><p>granularity</p></td>
|
717
|
+
<td class="parameter_description"><p>An <a class="link" href="AtkText.html#AtkTextGranularity" title="enum AtkTextGranularity"><span class="type">AtkTextGranularity</span></a></p></td>
|
718
|
+
<td class="parameter_annotations"> </td>
|
796
719
|
</tr>
|
797
720
|
<tr>
|
798
|
-
<td
|
799
|
-
<td>
|
800
|
-
</td>
|
721
|
+
<td class="parameter_name"><p>start_offset</p></td>
|
722
|
+
<td class="parameter_description"><p> the start offset of the returned string, or -1
|
723
|
+
if an error has occurred (e.g. invalid offset, not implemented). </p></td>
|
724
|
+
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span></td>
|
801
725
|
</tr>
|
802
726
|
<tr>
|
803
|
-
<td
|
804
|
-
<td>
|
805
|
-
</td>
|
727
|
+
<td class="parameter_name"><p>end_offset</p></td>
|
728
|
+
<td class="parameter_description"><p> the offset of the first character after the returned string,
|
729
|
+
or -1 if an error has occurred (e.g. invalid offset, not implemented). </p></td>
|
730
|
+
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span></td>
|
806
731
|
</tr>
|
732
|
+
</tbody>
|
733
|
+
</table></div>
|
734
|
+
</div>
|
735
|
+
<div class="refsect3">
|
736
|
+
<a name="id-1.5.13.9.7.13"></a><h4>Returns</h4>
|
737
|
+
<p> a newly allocated string containing the text
|
738
|
+
at the <em class="parameter"><code>offset</code></em>
|
739
|
+
bounded by the specified <em class="parameter"><code>granularity</code></em>
|
740
|
+
. Use
|
741
|
+
<code class="function">g_free()</code> to free the returned string. Returns <code class="literal">NULL</code> if the
|
742
|
+
offset is invalid or no implementation is available. </p>
|
743
|
+
<p><span class="annotation">[<a href="http://foldoc.org/nullable"><span class="acronym">nullable</span></a>]</span></p>
|
744
|
+
</div>
|
745
|
+
<p class="since">Since 2.10</p>
|
746
|
+
</div>
|
747
|
+
<hr>
|
748
|
+
<div class="refsect2">
|
749
|
+
<a name="atk-text-get-caret-offset"></a><h3>atk_text_get_caret_offset ()</h3>
|
750
|
+
<pre class="programlisting"><span class="returnvalue">gint</span>
|
751
|
+
atk_text_get_caret_offset (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>);</pre>
|
752
|
+
<p>Gets the offset position of the caret (cursor).</p>
|
753
|
+
<div class="refsect3">
|
754
|
+
<a name="id-1.5.13.9.8.5"></a><h4>Parameters</h4>
|
755
|
+
<div class="informaltable"><table width="100%" border="0">
|
756
|
+
<colgroup>
|
757
|
+
<col width="150px" class="parameters_name">
|
758
|
+
<col class="parameters_description">
|
759
|
+
<col width="200px" class="parameters_annotations">
|
760
|
+
</colgroup>
|
761
|
+
<tbody><tr>
|
762
|
+
<td class="parameter_name"><p>text</p></td>
|
763
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
764
|
+
<td class="parameter_annotations"> </td>
|
765
|
+
</tr></tbody>
|
766
|
+
</table></div>
|
767
|
+
</div>
|
768
|
+
<div class="refsect3">
|
769
|
+
<a name="id-1.5.13.9.8.6"></a><h4>Returns</h4>
|
770
|
+
<p> the offset position of the caret (cursor).</p>
|
771
|
+
<p></p>
|
772
|
+
</div>
|
773
|
+
</div>
|
774
|
+
<hr>
|
775
|
+
<div class="refsect2">
|
776
|
+
<a name="atk-text-get-character-extents"></a><h3>atk_text_get_character_extents ()</h3>
|
777
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
778
|
+
atk_text_get_character_extents (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
779
|
+
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
780
|
+
<em class="parameter"><code><span class="type">gint</span> *x</code></em>,
|
781
|
+
<em class="parameter"><code><span class="type">gint</span> *y</code></em>,
|
782
|
+
<em class="parameter"><code><span class="type">gint</span> *width</code></em>,
|
783
|
+
<em class="parameter"><code><span class="type">gint</span> *height</code></em>,
|
784
|
+
<em class="parameter"><code><a class="link" href="AtkUtil.html#AtkCoordType" title="enum AtkCoordType"><span class="type">AtkCoordType</span></a> coords</code></em>);</pre>
|
785
|
+
<p>Get the bounding box containing the glyph representing the character at
|
786
|
+
a particular text offset.</p>
|
787
|
+
<div class="refsect3">
|
788
|
+
<a name="id-1.5.13.9.9.5"></a><h4>Parameters</h4>
|
789
|
+
<div class="informaltable"><table width="100%" border="0">
|
790
|
+
<colgroup>
|
791
|
+
<col width="150px" class="parameters_name">
|
792
|
+
<col class="parameters_description">
|
793
|
+
<col width="200px" class="parameters_annotations">
|
794
|
+
</colgroup>
|
795
|
+
<tbody>
|
807
796
|
<tr>
|
808
|
-
<td
|
809
|
-
<td>"
|
810
|
-
</td>
|
797
|
+
<td class="parameter_name"><p>text</p></td>
|
798
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
799
|
+
<td class="parameter_annotations"> </td>
|
811
800
|
</tr>
|
812
801
|
<tr>
|
813
|
-
<td
|
814
|
-
<td
|
815
|
-
</td>
|
802
|
+
<td class="parameter_name"><p>offset</p></td>
|
803
|
+
<td class="parameter_description"><p>The offset of the text character for which bounding information is required.</p></td>
|
804
|
+
<td class="parameter_annotations"> </td>
|
816
805
|
</tr>
|
817
806
|
<tr>
|
818
|
-
<td
|
819
|
-
<td>
|
820
|
-
</td>
|
807
|
+
<td class="parameter_name"><p>x</p></td>
|
808
|
+
<td class="parameter_description"><p>Pointer for the x cordinate of the bounding box</p></td>
|
809
|
+
<td class="parameter_annotations"> </td>
|
821
810
|
</tr>
|
822
811
|
<tr>
|
823
|
-
<td
|
824
|
-
<td>
|
825
|
-
</td>
|
812
|
+
<td class="parameter_name"><p>y</p></td>
|
813
|
+
<td class="parameter_description"><p>Pointer for the y cordinate of the bounding box</p></td>
|
814
|
+
<td class="parameter_annotations"> </td>
|
826
815
|
</tr>
|
827
816
|
<tr>
|
828
|
-
<td
|
829
|
-
<td>
|
830
|
-
</td>
|
817
|
+
<td class="parameter_name"><p>width</p></td>
|
818
|
+
<td class="parameter_description"><p>Pointer for the width of the bounding box</p></td>
|
819
|
+
<td class="parameter_annotations"> </td>
|
831
820
|
</tr>
|
832
821
|
<tr>
|
833
|
-
<td
|
834
|
-
<td
|
835
|
-
</td>
|
822
|
+
<td class="parameter_name"><p>height</p></td>
|
823
|
+
<td class="parameter_description"><p>Pointer for the height of the bounding box</p></td>
|
824
|
+
<td class="parameter_annotations"> </td>
|
836
825
|
</tr>
|
837
826
|
<tr>
|
838
|
-
<td
|
839
|
-
<td>
|
840
|
-
</td>
|
827
|
+
<td class="parameter_name"><p>coords</p></td>
|
828
|
+
<td class="parameter_description"><p>specify whether coordinates are relative to the screen or widget window </p></td>
|
829
|
+
<td class="parameter_annotations"> </td>
|
830
|
+
</tr>
|
831
|
+
</tbody>
|
832
|
+
</table></div>
|
833
|
+
</div>
|
834
|
+
</div>
|
835
|
+
<hr>
|
836
|
+
<div class="refsect2">
|
837
|
+
<a name="atk-text-get-run-attributes"></a><h3>atk_text_get_run_attributes ()</h3>
|
838
|
+
<pre class="programlisting"><a class="link" href="AtkObject.html#AtkAttributeSet" title="AtkAttributeSet"><span class="returnvalue">AtkAttributeSet</span></a> *
|
839
|
+
atk_text_get_run_attributes (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
840
|
+
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
841
|
+
<em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
|
842
|
+
<em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);</pre>
|
843
|
+
<p>Creates an <a class="link" href="AtkObject.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> which consists of the attributes explicitly
|
844
|
+
set at the position <em class="parameter"><code>offset</code></em>
|
845
|
+
in the text. <em class="parameter"><code>start_offset</code></em>
|
846
|
+
and <em class="parameter"><code>end_offset</code></em>
|
847
|
+
are
|
848
|
+
set to the start and end of the range around <em class="parameter"><code>offset</code></em>
|
849
|
+
where the attributes are
|
850
|
+
invariant. Note that <em class="parameter"><code>end_offset</code></em>
|
851
|
+
is the offset of the first character
|
852
|
+
after the range. See the enum AtkTextAttribute for types of text
|
853
|
+
attributes that can be returned. Note that other attributes may also be
|
854
|
+
returned.</p>
|
855
|
+
<div class="refsect3">
|
856
|
+
<a name="id-1.5.13.9.10.5"></a><h4>Parameters</h4>
|
857
|
+
<div class="informaltable"><table width="100%" border="0">
|
858
|
+
<colgroup>
|
859
|
+
<col width="150px" class="parameters_name">
|
860
|
+
<col class="parameters_description">
|
861
|
+
<col width="200px" class="parameters_annotations">
|
862
|
+
</colgroup>
|
863
|
+
<tbody>
|
864
|
+
<tr>
|
865
|
+
<td class="parameter_name"><p>text</p></td>
|
866
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
867
|
+
<td class="parameter_annotations"> </td>
|
841
868
|
</tr>
|
842
869
|
<tr>
|
843
|
-
<td
|
844
|
-
<td>
|
845
|
-
|
870
|
+
<td class="parameter_name"><p>offset</p></td>
|
871
|
+
<td class="parameter_description"><p>the offset at which to get the attributes, -1 means the offset of
|
872
|
+
the character to be inserted at the caret location.</p></td>
|
873
|
+
<td class="parameter_annotations"> </td>
|
846
874
|
</tr>
|
847
875
|
<tr>
|
848
|
-
<td
|
849
|
-
<td>
|
850
|
-
</td>
|
876
|
+
<td class="parameter_name"><p>start_offset</p></td>
|
877
|
+
<td class="parameter_description"><p> the address to put the start offset of the range. </p></td>
|
878
|
+
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span></td>
|
879
|
+
</tr>
|
880
|
+
<tr>
|
881
|
+
<td class="parameter_name"><p>end_offset</p></td>
|
882
|
+
<td class="parameter_description"><p> the address to put the end offset of the range. </p></td>
|
883
|
+
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span></td>
|
851
884
|
</tr>
|
852
885
|
</tbody>
|
853
886
|
</table></div>
|
854
887
|
</div>
|
888
|
+
<div class="refsect3">
|
889
|
+
<a name="id-1.5.13.9.10.6"></a><h4>Returns</h4>
|
890
|
+
<p> an <a class="link" href="AtkObject.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> which contains the attributes
|
891
|
+
explicitly set at <em class="parameter"><code>offset</code></em>
|
892
|
+
. This <a class="link" href="AtkObject.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> should be freed by a call
|
893
|
+
to <a class="link" href="AtkText.html#atk-attribute-set-free" title="atk_attribute_set_free ()"><code class="function">atk_attribute_set_free()</code></a>. </p>
|
894
|
+
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span></p>
|
895
|
+
</div>
|
896
|
+
</div>
|
855
897
|
<hr>
|
856
898
|
<div class="refsect2">
|
857
|
-
<a name="atk-text-get-
|
858
|
-
<pre class="programlisting"><
|
859
|
-
|
860
|
-
|
861
|
-
|
862
|
-
|
863
|
-
|
864
|
-
<div class="
|
865
|
-
<
|
899
|
+
<a name="atk-text-get-default-attributes"></a><h3>atk_text_get_default_attributes ()</h3>
|
900
|
+
<pre class="programlisting"><a class="link" href="AtkObject.html#AtkAttributeSet" title="AtkAttributeSet"><span class="returnvalue">AtkAttributeSet</span></a> *
|
901
|
+
atk_text_get_default_attributes (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>);</pre>
|
902
|
+
<p>Creates an <a class="link" href="AtkObject.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> which consists of the default values of
|
903
|
+
attributes for the text. See the enum AtkTextAttribute for types of text
|
904
|
+
attributes that can be returned. Note that other attributes may also be
|
905
|
+
returned.</p>
|
906
|
+
<div class="refsect3">
|
907
|
+
<a name="id-1.5.13.9.11.5"></a><h4>Parameters</h4>
|
908
|
+
<div class="informaltable"><table width="100%" border="0">
|
909
|
+
<colgroup>
|
910
|
+
<col width="150px" class="parameters_name">
|
911
|
+
<col class="parameters_description">
|
912
|
+
<col width="200px" class="parameters_annotations">
|
913
|
+
</colgroup>
|
914
|
+
<tbody><tr>
|
915
|
+
<td class="parameter_name"><p>text</p></td>
|
916
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
917
|
+
<td class="parameter_annotations"> </td>
|
918
|
+
</tr></tbody>
|
919
|
+
</table></div>
|
920
|
+
</div>
|
921
|
+
<div class="refsect3">
|
922
|
+
<a name="id-1.5.13.9.11.6"></a><h4>Returns</h4>
|
923
|
+
<p> an <a class="link" href="AtkObject.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> which contains the default
|
924
|
+
values of attributes. at <em class="parameter"><code>offset</code></em>
|
925
|
+
. this <span class="type">atkattributeset</span> should be freed by
|
926
|
+
a call to <a class="link" href="AtkText.html#atk-attribute-set-free" title="atk_attribute_set_free ()"><code class="function">atk_attribute_set_free()</code></a>. </p>
|
927
|
+
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span></p>
|
928
|
+
</div>
|
929
|
+
</div>
|
930
|
+
<hr>
|
931
|
+
<div class="refsect2">
|
932
|
+
<a name="atk-text-get-character-count"></a><h3>atk_text_get_character_count ()</h3>
|
933
|
+
<pre class="programlisting"><span class="returnvalue">gint</span>
|
934
|
+
atk_text_get_character_count (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>);</pre>
|
935
|
+
<p>Gets the character count.</p>
|
936
|
+
<div class="refsect3">
|
937
|
+
<a name="id-1.5.13.9.12.5"></a><h4>Parameters</h4>
|
938
|
+
<div class="informaltable"><table width="100%" border="0">
|
939
|
+
<colgroup>
|
940
|
+
<col width="150px" class="parameters_name">
|
941
|
+
<col class="parameters_description">
|
942
|
+
<col width="200px" class="parameters_annotations">
|
943
|
+
</colgroup>
|
944
|
+
<tbody><tr>
|
945
|
+
<td class="parameter_name"><p>text</p></td>
|
946
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
947
|
+
<td class="parameter_annotations"> </td>
|
948
|
+
</tr></tbody>
|
949
|
+
</table></div>
|
950
|
+
</div>
|
951
|
+
<div class="refsect3">
|
952
|
+
<a name="id-1.5.13.9.12.6"></a><h4>Returns</h4>
|
953
|
+
<p> the number of characters.</p>
|
954
|
+
<p></p>
|
955
|
+
</div>
|
956
|
+
</div>
|
957
|
+
<hr>
|
958
|
+
<div class="refsect2">
|
959
|
+
<a name="atk-text-get-offset-at-point"></a><h3>atk_text_get_offset_at_point ()</h3>
|
960
|
+
<pre class="programlisting"><span class="returnvalue">gint</span>
|
961
|
+
atk_text_get_offset_at_point (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
962
|
+
<em class="parameter"><code><span class="type">gint</span> x</code></em>,
|
963
|
+
<em class="parameter"><code><span class="type">gint</span> y</code></em>,
|
964
|
+
<em class="parameter"><code><a class="link" href="AtkUtil.html#AtkCoordType" title="enum AtkCoordType"><span class="type">AtkCoordType</span></a> coords</code></em>);</pre>
|
965
|
+
<p>Gets the offset of the character located at coordinates <em class="parameter"><code>x</code></em>
|
966
|
+
and <em class="parameter"><code>y</code></em>
|
967
|
+
. <em class="parameter"><code>x</code></em>
|
968
|
+
and <em class="parameter"><code>y</code></em>
|
969
|
+
|
970
|
+
are interpreted as being relative to the screen or this widget's window
|
971
|
+
depending on <em class="parameter"><code>coords</code></em>
|
972
|
+
.</p>
|
973
|
+
<div class="refsect3">
|
974
|
+
<a name="id-1.5.13.9.13.5"></a><h4>Parameters</h4>
|
975
|
+
<div class="informaltable"><table width="100%" border="0">
|
976
|
+
<colgroup>
|
977
|
+
<col width="150px" class="parameters_name">
|
978
|
+
<col class="parameters_description">
|
979
|
+
<col width="200px" class="parameters_annotations">
|
980
|
+
</colgroup>
|
866
981
|
<tbody>
|
867
982
|
<tr>
|
868
|
-
<td
|
869
|
-
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
870
|
-
</td>
|
983
|
+
<td class="parameter_name"><p>text</p></td>
|
984
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
985
|
+
<td class="parameter_annotations"> </td>
|
871
986
|
</tr>
|
872
987
|
<tr>
|
873
|
-
<td
|
874
|
-
<td>
|
988
|
+
<td class="parameter_name"><p>x</p></td>
|
989
|
+
<td class="parameter_description"><p>screen x-position of character</p></td>
|
990
|
+
<td class="parameter_annotations"> </td>
|
875
991
|
</tr>
|
876
992
|
<tr>
|
877
|
-
<td
|
878
|
-
<td>
|
993
|
+
<td class="parameter_name"><p>y</p></td>
|
994
|
+
<td class="parameter_description"><p>screen y-position of character</p></td>
|
995
|
+
<td class="parameter_annotations"> </td>
|
879
996
|
</tr>
|
880
997
|
<tr>
|
881
|
-
<td
|
882
|
-
<td>
|
883
|
-
|
998
|
+
<td class="parameter_name"><p>coords</p></td>
|
999
|
+
<td class="parameter_description"><p>specify whether coordinates are relative to the screen or
|
1000
|
+
widget window </p></td>
|
1001
|
+
<td class="parameter_annotations"> </td>
|
884
1002
|
</tr>
|
885
1003
|
</tbody>
|
886
1004
|
</table></div>
|
887
1005
|
</div>
|
1006
|
+
<div class="refsect3">
|
1007
|
+
<a name="id-1.5.13.9.13.6"></a><h4>Returns</h4>
|
1008
|
+
<p> the offset to the character which is located at
|
1009
|
+
the specified <em class="parameter"><code>x</code></em>
|
1010
|
+
and <em class="parameter"><code>y</code></em>
|
1011
|
+
coordinates.</p>
|
1012
|
+
<p></p>
|
1013
|
+
</div>
|
1014
|
+
</div>
|
888
1015
|
<hr>
|
889
1016
|
<div class="refsect2">
|
890
|
-
<a name="atk-text-get-
|
891
|
-
<pre class="programlisting"><
|
892
|
-
|
893
|
-
<
|
894
|
-
|
895
|
-
</
|
896
|
-
<
|
897
|
-
<
|
1017
|
+
<a name="atk-text-get-bounded-ranges"></a><h3>atk_text_get_bounded_ranges ()</h3>
|
1018
|
+
<pre class="programlisting"><a class="link" href="AtkText.html#AtkTextRange" title="struct AtkTextRange"><span class="returnvalue">AtkTextRange</span></a> **
|
1019
|
+
atk_text_get_bounded_ranges (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
1020
|
+
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextRectangle" title="struct AtkTextRectangle"><span class="type">AtkTextRectangle</span></a> *rect</code></em>,
|
1021
|
+
<em class="parameter"><code><a class="link" href="AtkUtil.html#AtkCoordType" title="enum AtkCoordType"><span class="type">AtkCoordType</span></a> coord_type</code></em>,
|
1022
|
+
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextClipType" title="enum AtkTextClipType"><span class="type">AtkTextClipType</span></a> x_clip_type</code></em>,
|
1023
|
+
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextClipType" title="enum AtkTextClipType"><span class="type">AtkTextClipType</span></a> y_clip_type</code></em>);</pre>
|
1024
|
+
<p>Get the ranges of text in the specified bounding box.</p>
|
1025
|
+
<div class="refsect3">
|
1026
|
+
<a name="id-1.5.13.9.14.5"></a><h4>Parameters</h4>
|
1027
|
+
<div class="informaltable"><table width="100%" border="0">
|
1028
|
+
<colgroup>
|
1029
|
+
<col width="150px" class="parameters_name">
|
1030
|
+
<col class="parameters_description">
|
1031
|
+
<col width="200px" class="parameters_annotations">
|
1032
|
+
</colgroup>
|
898
1033
|
<tbody>
|
899
1034
|
<tr>
|
900
|
-
<td
|
901
|
-
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
902
|
-
</td>
|
1035
|
+
<td class="parameter_name"><p>text</p></td>
|
1036
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
1037
|
+
<td class="parameter_annotations"> </td>
|
903
1038
|
</tr>
|
904
1039
|
<tr>
|
905
|
-
<td
|
906
|
-
<td>
|
1040
|
+
<td class="parameter_name"><p>rect</p></td>
|
1041
|
+
<td class="parameter_description"><p>An AtkTextRectangle giving the dimensions of the bounding box.</p></td>
|
1042
|
+
<td class="parameter_annotations"> </td>
|
907
1043
|
</tr>
|
908
1044
|
<tr>
|
909
|
-
<td
|
910
|
-
<td
|
1045
|
+
<td class="parameter_name"><p>coord_type</p></td>
|
1046
|
+
<td class="parameter_description"><p>Specify whether coordinates are relative to the screen or widget window.</p></td>
|
1047
|
+
<td class="parameter_annotations"> </td>
|
1048
|
+
</tr>
|
1049
|
+
<tr>
|
1050
|
+
<td class="parameter_name"><p>x_clip_type</p></td>
|
1051
|
+
<td class="parameter_description"><p>Specify the horizontal clip type.</p></td>
|
1052
|
+
<td class="parameter_annotations"> </td>
|
1053
|
+
</tr>
|
1054
|
+
<tr>
|
1055
|
+
<td class="parameter_name"><p>y_clip_type</p></td>
|
1056
|
+
<td class="parameter_description"><p>Specify the vertical clip type.</p></td>
|
1057
|
+
<td class="parameter_annotations"> </td>
|
911
1058
|
</tr>
|
912
1059
|
</tbody>
|
913
1060
|
</table></div>
|
914
1061
|
</div>
|
1062
|
+
<div class="refsect3">
|
1063
|
+
<a name="id-1.5.13.9.14.6"></a><h4>Returns</h4>
|
1064
|
+
<p> Array of AtkTextRange. The last
|
1065
|
+
element of the array returned by this function will be NULL. </p>
|
1066
|
+
<p><span class="annotation">[<a href="http://foldoc.org/array"><span class="acronym">array</span></a> zero-terminated=1]</span></p>
|
1067
|
+
</div>
|
1068
|
+
<p class="since">Since 1.3</p>
|
1069
|
+
</div>
|
915
1070
|
<hr>
|
916
1071
|
<div class="refsect2">
|
917
|
-
<a name="atk-text-get-
|
918
|
-
<pre class="programlisting"><span class="returnvalue">
|
919
|
-
|
920
|
-
|
921
|
-
|
922
|
-
|
923
|
-
<
|
924
|
-
<
|
925
|
-
<
|
926
|
-
|
927
|
-
|
928
|
-
<
|
929
|
-
|
930
|
-
|
931
|
-
<
|
932
|
-
|
1072
|
+
<a name="atk-text-get-range-extents"></a><h3>atk_text_get_range_extents ()</h3>
|
1073
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
1074
|
+
atk_text_get_range_extents (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
1075
|
+
<em class="parameter"><code><span class="type">gint</span> start_offset</code></em>,
|
1076
|
+
<em class="parameter"><code><span class="type">gint</span> end_offset</code></em>,
|
1077
|
+
<em class="parameter"><code><a class="link" href="AtkUtil.html#AtkCoordType" title="enum AtkCoordType"><span class="type">AtkCoordType</span></a> coord_type</code></em>,
|
1078
|
+
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextRectangle" title="struct AtkTextRectangle"><span class="type">AtkTextRectangle</span></a> *rect</code></em>);</pre>
|
1079
|
+
<p>Get the bounding box for text within the specified range.</p>
|
1080
|
+
<div class="refsect3">
|
1081
|
+
<a name="id-1.5.13.9.15.5"></a><h4>Parameters</h4>
|
1082
|
+
<div class="informaltable"><table width="100%" border="0">
|
1083
|
+
<colgroup>
|
1084
|
+
<col width="150px" class="parameters_name">
|
1085
|
+
<col class="parameters_description">
|
1086
|
+
<col width="200px" class="parameters_annotations">
|
1087
|
+
</colgroup>
|
933
1088
|
<tbody>
|
934
1089
|
<tr>
|
935
|
-
<td
|
936
|
-
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
937
|
-
</td>
|
938
|
-
</tr>
|
939
|
-
<tr>
|
940
|
-
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
|
941
|
-
<td>position</td>
|
1090
|
+
<td class="parameter_name"><p>text</p></td>
|
1091
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
1092
|
+
<td class="parameter_annotations"> </td>
|
942
1093
|
</tr>
|
943
1094
|
<tr>
|
944
|
-
<td
|
945
|
-
<td
|
946
|
-
|
1095
|
+
<td class="parameter_name"><p>start_offset</p></td>
|
1096
|
+
<td class="parameter_description"><p>The offset of the first text character for which boundary
|
1097
|
+
information is required.</p></td>
|
1098
|
+
<td class="parameter_annotations"> </td>
|
947
1099
|
</tr>
|
948
1100
|
<tr>
|
949
|
-
<td
|
950
|
-
<td>
|
951
|
-
|
1101
|
+
<td class="parameter_name"><p>end_offset</p></td>
|
1102
|
+
<td class="parameter_description"><p>The offset of the text character after the last character
|
1103
|
+
for which boundary information is required.</p></td>
|
1104
|
+
<td class="parameter_annotations"> </td>
|
952
1105
|
</tr>
|
953
1106
|
<tr>
|
954
|
-
<td
|
955
|
-
<td>
|
956
|
-
|
957
|
-
</td>
|
1107
|
+
<td class="parameter_name"><p>coord_type</p></td>
|
1108
|
+
<td class="parameter_description"><p>Specify whether coordinates are relative to the screen or widget window.</p></td>
|
1109
|
+
<td class="parameter_annotations"> </td>
|
958
1110
|
</tr>
|
959
1111
|
<tr>
|
960
|
-
<td
|
961
|
-
<td>a
|
962
|
-
|
1112
|
+
<td class="parameter_name"><p>rect</p></td>
|
1113
|
+
<td class="parameter_description"><p>A pointer to a AtkTextRectangle which is filled in by this function.</p></td>
|
1114
|
+
<td class="parameter_annotations"> </td>
|
963
1115
|
</tr>
|
964
1116
|
</tbody>
|
965
1117
|
</table></div>
|
966
1118
|
</div>
|
1119
|
+
<p class="since">Since 1.3</p>
|
1120
|
+
</div>
|
967
1121
|
<hr>
|
968
1122
|
<div class="refsect2">
|
969
|
-
<a name="atk-text-
|
970
|
-
<pre class="programlisting"><span class="returnvalue">
|
971
|
-
|
972
|
-
|
973
|
-
|
974
|
-
|
975
|
-
<div class="
|
976
|
-
<
|
977
|
-
<
|
978
|
-
|
1123
|
+
<a name="atk-text-free-ranges"></a><h3>atk_text_free_ranges ()</h3>
|
1124
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
1125
|
+
atk_text_free_ranges (<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextRange" title="struct AtkTextRange"><span class="type">AtkTextRange</span></a> **ranges</code></em>);</pre>
|
1126
|
+
<p>Frees the memory associated with an array of AtkTextRange. It is assumed
|
1127
|
+
that the array was returned by the function atk_text_get_bounded_ranges
|
1128
|
+
and is NULL terminated.</p>
|
1129
|
+
<div class="refsect3">
|
1130
|
+
<a name="id-1.5.13.9.16.5"></a><h4>Parameters</h4>
|
1131
|
+
<div class="informaltable"><table width="100%" border="0">
|
1132
|
+
<colgroup>
|
1133
|
+
<col width="150px" class="parameters_name">
|
1134
|
+
<col class="parameters_description">
|
1135
|
+
<col width="200px" class="parameters_annotations">
|
1136
|
+
</colgroup>
|
1137
|
+
<tbody><tr>
|
1138
|
+
<td class="parameter_name"><p>ranges</p></td>
|
1139
|
+
<td class="parameter_description"><p> A pointer to an array of <a class="link" href="AtkText.html#AtkTextRange" title="struct AtkTextRange"><span class="type">AtkTextRange</span></a> which is
|
1140
|
+
to be freed. </p></td>
|
1141
|
+
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/array"><span class="acronym">array</span></a>]</span></td>
|
1142
|
+
</tr></tbody>
|
1143
|
+
</table></div>
|
979
1144
|
</div>
|
980
|
-
<p>
|
981
|
-
|
982
|
-
|
983
|
-
<
|
984
|
-
|
985
|
-
|
986
|
-
</
|
987
|
-
<p>
|
988
|
-
|
989
|
-
|
990
|
-
|
991
|
-
|
992
|
-
<
|
993
|
-
|
994
|
-
|
995
|
-
|
996
|
-
|
997
|
-
<p>
|
998
|
-
|
999
|
-
|
1000
|
-
|
1001
|
-
</
|
1002
|
-
|
1003
|
-
|
1004
|
-
|
1005
|
-
|
1006
|
-
|
1007
|
-
<p>
|
1008
|
-
|
1009
|
-
|
1010
|
-
|
1011
|
-
|
1012
|
-
<
|
1013
|
-
<
|
1145
|
+
<p class="since">Since 1.3</p>
|
1146
|
+
</div>
|
1147
|
+
<hr>
|
1148
|
+
<div class="refsect2">
|
1149
|
+
<a name="atk-text-get-n-selections"></a><h3>atk_text_get_n_selections ()</h3>
|
1150
|
+
<pre class="programlisting"><span class="returnvalue">gint</span>
|
1151
|
+
atk_text_get_n_selections (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>);</pre>
|
1152
|
+
<p>Gets the number of selected regions.</p>
|
1153
|
+
<div class="refsect3">
|
1154
|
+
<a name="id-1.5.13.9.17.5"></a><h4>Parameters</h4>
|
1155
|
+
<div class="informaltable"><table width="100%" border="0">
|
1156
|
+
<colgroup>
|
1157
|
+
<col width="150px" class="parameters_name">
|
1158
|
+
<col class="parameters_description">
|
1159
|
+
<col width="200px" class="parameters_annotations">
|
1160
|
+
</colgroup>
|
1161
|
+
<tbody><tr>
|
1162
|
+
<td class="parameter_name"><p>text</p></td>
|
1163
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
1164
|
+
<td class="parameter_annotations"> </td>
|
1165
|
+
</tr></tbody>
|
1166
|
+
</table></div>
|
1167
|
+
</div>
|
1168
|
+
<div class="refsect3">
|
1169
|
+
<a name="id-1.5.13.9.17.6"></a><h4>Returns</h4>
|
1170
|
+
<p> The number of selected regions, or -1 if a failure
|
1171
|
+
occurred.</p>
|
1172
|
+
<p></p>
|
1173
|
+
</div>
|
1174
|
+
</div>
|
1175
|
+
<hr>
|
1176
|
+
<div class="refsect2">
|
1177
|
+
<a name="atk-text-get-selection"></a><h3>atk_text_get_selection ()</h3>
|
1178
|
+
<pre class="programlisting"><span class="returnvalue">gchar</span> *
|
1179
|
+
atk_text_get_selection (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
1180
|
+
<em class="parameter"><code><span class="type">gint</span> selection_num</code></em>,
|
1181
|
+
<em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
|
1182
|
+
<em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);</pre>
|
1183
|
+
<p>Gets the text from the specified selection.</p>
|
1184
|
+
<div class="refsect3">
|
1185
|
+
<a name="id-1.5.13.9.18.5"></a><h4>Parameters</h4>
|
1186
|
+
<div class="informaltable"><table width="100%" border="0">
|
1187
|
+
<colgroup>
|
1188
|
+
<col width="150px" class="parameters_name">
|
1189
|
+
<col class="parameters_description">
|
1190
|
+
<col width="200px" class="parameters_annotations">
|
1191
|
+
</colgroup>
|
1014
1192
|
<tbody>
|
1015
1193
|
<tr>
|
1016
|
-
<td
|
1017
|
-
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
1018
|
-
</td>
|
1194
|
+
<td class="parameter_name"><p>text</p></td>
|
1195
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
1196
|
+
<td class="parameter_annotations"> </td>
|
1019
1197
|
</tr>
|
1020
1198
|
<tr>
|
1021
|
-
<td
|
1022
|
-
<td>
|
1199
|
+
<td class="parameter_name"><p>selection_num</p></td>
|
1200
|
+
<td class="parameter_description"><p>The selection number. The selected regions are
|
1201
|
+
assigned numbers that correspond to how far the region is from the
|
1202
|
+
start of the text. The selected region closest to the beginning
|
1203
|
+
of the text region is assigned the number 0, etc. Note that adding,
|
1204
|
+
moving or deleting a selected region can change the numbering.</p></td>
|
1205
|
+
<td class="parameter_annotations"> </td>
|
1023
1206
|
</tr>
|
1024
1207
|
<tr>
|
1025
|
-
<td
|
1026
|
-
<td
|
1027
|
-
</td>
|
1208
|
+
<td class="parameter_name"><p>start_offset</p></td>
|
1209
|
+
<td class="parameter_description"><p> passes back the start position of the selected region. </p></td>
|
1210
|
+
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span></td>
|
1028
1211
|
</tr>
|
1029
1212
|
<tr>
|
1030
|
-
<td
|
1031
|
-
<td>the
|
1032
|
-
</td>
|
1213
|
+
<td class="parameter_name"><p>end_offset</p></td>
|
1214
|
+
<td class="parameter_description"><p> passes back the end position of (e.g. offset immediately past)
|
1215
|
+
the selected region. </p></td>
|
1216
|
+
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span></td>
|
1033
1217
|
</tr>
|
1218
|
+
</tbody>
|
1219
|
+
</table></div>
|
1220
|
+
</div>
|
1221
|
+
<div class="refsect3">
|
1222
|
+
<a name="id-1.5.13.9.18.6"></a><h4>Returns</h4>
|
1223
|
+
<p> a newly allocated string containing the selected text. Use <code class="function">g_free()</code>
|
1224
|
+
to free the returned string.</p>
|
1225
|
+
<p></p>
|
1226
|
+
</div>
|
1227
|
+
</div>
|
1228
|
+
<hr>
|
1229
|
+
<div class="refsect2">
|
1230
|
+
<a name="atk-text-add-selection"></a><h3>atk_text_add_selection ()</h3>
|
1231
|
+
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
1232
|
+
atk_text_add_selection (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
1233
|
+
<em class="parameter"><code><span class="type">gint</span> start_offset</code></em>,
|
1234
|
+
<em class="parameter"><code><span class="type">gint</span> end_offset</code></em>);</pre>
|
1235
|
+
<p>Adds a selection bounded by the specified offsets.</p>
|
1236
|
+
<div class="refsect3">
|
1237
|
+
<a name="id-1.5.13.9.19.5"></a><h4>Parameters</h4>
|
1238
|
+
<div class="informaltable"><table width="100%" border="0">
|
1239
|
+
<colgroup>
|
1240
|
+
<col width="150px" class="parameters_name">
|
1241
|
+
<col class="parameters_description">
|
1242
|
+
<col width="200px" class="parameters_annotations">
|
1243
|
+
</colgroup>
|
1244
|
+
<tbody>
|
1034
1245
|
<tr>
|
1035
|
-
<td
|
1036
|
-
<td>
|
1037
|
-
|
1038
|
-
</
|
1246
|
+
<td class="parameter_name"><p>text</p></td>
|
1247
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
1248
|
+
<td class="parameter_annotations"> </td>
|
1249
|
+
</tr>
|
1250
|
+
<tr>
|
1251
|
+
<td class="parameter_name"><p>start_offset</p></td>
|
1252
|
+
<td class="parameter_description"><p>the start position of the selected region</p></td>
|
1253
|
+
<td class="parameter_annotations"> </td>
|
1039
1254
|
</tr>
|
1040
1255
|
<tr>
|
1041
|
-
<td
|
1042
|
-
<td>
|
1043
|
-
|
1256
|
+
<td class="parameter_name"><p>end_offset</p></td>
|
1257
|
+
<td class="parameter_description"><p>the offset of the first character after the selected region.</p></td>
|
1258
|
+
<td class="parameter_annotations"> </td>
|
1044
1259
|
</tr>
|
1045
1260
|
</tbody>
|
1046
1261
|
</table></div>
|
1047
1262
|
</div>
|
1263
|
+
<div class="refsect3">
|
1264
|
+
<a name="id-1.5.13.9.19.6"></a><h4>Returns</h4>
|
1265
|
+
<p> <code class="literal">TRUE</code> if success, <code class="literal">FALSE</code> otherwise</p>
|
1266
|
+
<p></p>
|
1267
|
+
</div>
|
1268
|
+
</div>
|
1048
1269
|
<hr>
|
1049
1270
|
<div class="refsect2">
|
1050
|
-
<a name="atk-text-
|
1051
|
-
<pre class="programlisting"><span class="returnvalue">
|
1052
|
-
|
1053
|
-
|
1054
|
-
|
1055
|
-
|
1056
|
-
<
|
1057
|
-
<
|
1058
|
-
<
|
1059
|
-
|
1271
|
+
<a name="atk-text-remove-selection"></a><h3>atk_text_remove_selection ()</h3>
|
1272
|
+
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
1273
|
+
atk_text_remove_selection (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
1274
|
+
<em class="parameter"><code><span class="type">gint</span> selection_num</code></em>);</pre>
|
1275
|
+
<p>Removes the specified selection.</p>
|
1276
|
+
<div class="refsect3">
|
1277
|
+
<a name="id-1.5.13.9.20.5"></a><h4>Parameters</h4>
|
1278
|
+
<div class="informaltable"><table width="100%" border="0">
|
1279
|
+
<colgroup>
|
1280
|
+
<col width="150px" class="parameters_name">
|
1281
|
+
<col class="parameters_description">
|
1282
|
+
<col width="200px" class="parameters_annotations">
|
1283
|
+
</colgroup>
|
1284
|
+
<tbody>
|
1285
|
+
<tr>
|
1286
|
+
<td class="parameter_name"><p>text</p></td>
|
1287
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
1288
|
+
<td class="parameter_annotations"> </td>
|
1289
|
+
</tr>
|
1290
|
+
<tr>
|
1291
|
+
<td class="parameter_name"><p>selection_num</p></td>
|
1292
|
+
<td class="parameter_description"><p>The selection number. The selected regions are
|
1293
|
+
assigned numbers that correspond to how far the region is from the
|
1294
|
+
start of the text. The selected region closest to the beginning
|
1295
|
+
of the text region is assigned the number 0, etc. Note that adding,
|
1296
|
+
moving or deleting a selected region can change the numbering.</p></td>
|
1297
|
+
<td class="parameter_annotations"> </td>
|
1298
|
+
</tr>
|
1299
|
+
</tbody>
|
1300
|
+
</table></div>
|
1060
1301
|
</div>
|
1061
|
-
<
|
1062
|
-
|
1063
|
-
</p>
|
1064
|
-
<
|
1065
|
-
|
1302
|
+
<div class="refsect3">
|
1303
|
+
<a name="id-1.5.13.9.20.6"></a><h4>Returns</h4>
|
1304
|
+
<p> <code class="literal">TRUE</code> if success, <code class="literal">FALSE</code> otherwise</p>
|
1305
|
+
<p></p>
|
1306
|
+
</div>
|
1307
|
+
</div>
|
1308
|
+
<hr>
|
1309
|
+
<div class="refsect2">
|
1310
|
+
<a name="atk-text-set-selection"></a><h3>atk_text_set_selection ()</h3>
|
1311
|
+
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
1312
|
+
atk_text_set_selection (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
1313
|
+
<em class="parameter"><code><span class="type">gint</span> selection_num</code></em>,
|
1314
|
+
<em class="parameter"><code><span class="type">gint</span> start_offset</code></em>,
|
1315
|
+
<em class="parameter"><code><span class="type">gint</span> end_offset</code></em>);</pre>
|
1316
|
+
<p>Changes the start and end offset of the specified selection.</p>
|
1317
|
+
<div class="refsect3">
|
1318
|
+
<a name="id-1.5.13.9.21.5"></a><h4>Parameters</h4>
|
1319
|
+
<div class="informaltable"><table width="100%" border="0">
|
1320
|
+
<colgroup>
|
1321
|
+
<col width="150px" class="parameters_name">
|
1322
|
+
<col class="parameters_description">
|
1323
|
+
<col width="200px" class="parameters_annotations">
|
1324
|
+
</colgroup>
|
1066
1325
|
<tbody>
|
1067
1326
|
<tr>
|
1068
|
-
<td
|
1069
|
-
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
1070
|
-
</td>
|
1327
|
+
<td class="parameter_name"><p>text</p></td>
|
1328
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
1329
|
+
<td class="parameter_annotations"> </td>
|
1071
1330
|
</tr>
|
1072
1331
|
<tr>
|
1073
|
-
<td
|
1074
|
-
<td>
|
1332
|
+
<td class="parameter_name"><p>selection_num</p></td>
|
1333
|
+
<td class="parameter_description"><p>The selection number. The selected regions are
|
1334
|
+
assigned numbers that correspond to how far the region is from the
|
1335
|
+
start of the text. The selected region closest to the beginning
|
1336
|
+
of the text region is assigned the number 0, etc. Note that adding,
|
1337
|
+
moving or deleting a selected region can change the numbering.</p></td>
|
1338
|
+
<td class="parameter_annotations"> </td>
|
1075
1339
|
</tr>
|
1076
1340
|
<tr>
|
1077
|
-
<td
|
1078
|
-
<td
|
1079
|
-
</td>
|
1341
|
+
<td class="parameter_name"><p>start_offset</p></td>
|
1342
|
+
<td class="parameter_description"><p>the new start position of the selection</p></td>
|
1343
|
+
<td class="parameter_annotations"> </td>
|
1080
1344
|
</tr>
|
1081
1345
|
<tr>
|
1082
|
-
<td
|
1083
|
-
<td>the
|
1084
|
-
</td>
|
1346
|
+
<td class="parameter_name"><p>end_offset</p></td>
|
1347
|
+
<td class="parameter_description"><p>the new end position of (e.g. offset immediately past)
|
1348
|
+
the selection</p></td>
|
1349
|
+
<td class="parameter_annotations"> </td>
|
1085
1350
|
</tr>
|
1351
|
+
</tbody>
|
1352
|
+
</table></div>
|
1353
|
+
</div>
|
1354
|
+
<div class="refsect3">
|
1355
|
+
<a name="id-1.5.13.9.21.6"></a><h4>Returns</h4>
|
1356
|
+
<p> <code class="literal">TRUE</code> if success, <code class="literal">FALSE</code> otherwise</p>
|
1357
|
+
<p></p>
|
1358
|
+
</div>
|
1359
|
+
</div>
|
1360
|
+
<hr>
|
1361
|
+
<div class="refsect2">
|
1362
|
+
<a name="atk-text-set-caret-offset"></a><h3>atk_text_set_caret_offset ()</h3>
|
1363
|
+
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
1364
|
+
atk_text_set_caret_offset (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
1365
|
+
<em class="parameter"><code><span class="type">gint</span> offset</code></em>);</pre>
|
1366
|
+
<p>Sets the caret (cursor) position to the specified <em class="parameter"><code>offset</code></em>
|
1367
|
+
.</p>
|
1368
|
+
<div class="refsect3">
|
1369
|
+
<a name="id-1.5.13.9.22.5"></a><h4>Parameters</h4>
|
1370
|
+
<div class="informaltable"><table width="100%" border="0">
|
1371
|
+
<colgroup>
|
1372
|
+
<col width="150px" class="parameters_name">
|
1373
|
+
<col class="parameters_description">
|
1374
|
+
<col width="200px" class="parameters_annotations">
|
1375
|
+
</colgroup>
|
1376
|
+
<tbody>
|
1086
1377
|
<tr>
|
1087
|
-
<td
|
1088
|
-
<td>
|
1089
|
-
|
1090
|
-
</td>
|
1378
|
+
<td class="parameter_name"><p>text</p></td>
|
1379
|
+
<td class="parameter_description"><p>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a></p></td>
|
1380
|
+
<td class="parameter_annotations"> </td>
|
1091
1381
|
</tr>
|
1092
1382
|
<tr>
|
1093
|
-
<td
|
1094
|
-
<td
|
1095
|
-
|
1383
|
+
<td class="parameter_name"><p>offset</p></td>
|
1384
|
+
<td class="parameter_description"><p>position</p></td>
|
1385
|
+
<td class="parameter_annotations"> </td>
|
1096
1386
|
</tr>
|
1097
1387
|
</tbody>
|
1098
1388
|
</table></div>
|
1099
1389
|
</div>
|
1390
|
+
<div class="refsect3">
|
1391
|
+
<a name="id-1.5.13.9.22.6"></a><h4>Returns</h4>
|
1392
|
+
<p> <code class="literal">TRUE</code> if success, <code class="literal">FALSE</code> otherwise.</p>
|
1393
|
+
<p></p>
|
1394
|
+
</div>
|
1395
|
+
</div>
|
1396
|
+
<hr>
|
1397
|
+
<div class="refsect2">
|
1398
|
+
<a name="atk-attribute-set-free"></a><h3>atk_attribute_set_free ()</h3>
|
1399
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
1400
|
+
atk_attribute_set_free (<em class="parameter"><code><a class="link" href="AtkObject.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> *attrib_set</code></em>);</pre>
|
1401
|
+
<p>Frees the memory used by an <a class="link" href="AtkObject.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a>, including all its
|
1402
|
+
<a href="AtkObject.html#AtkAttribute"><span class="type">AtkAttributes</span></a>.</p>
|
1403
|
+
<div class="refsect3">
|
1404
|
+
<a name="id-1.5.13.9.23.5"></a><h4>Parameters</h4>
|
1405
|
+
<div class="informaltable"><table width="100%" border="0">
|
1406
|
+
<colgroup>
|
1407
|
+
<col width="150px" class="parameters_name">
|
1408
|
+
<col class="parameters_description">
|
1409
|
+
<col width="200px" class="parameters_annotations">
|
1410
|
+
</colgroup>
|
1411
|
+
<tbody><tr>
|
1412
|
+
<td class="parameter_name"><p>attrib_set</p></td>
|
1413
|
+
<td class="parameter_description"><p>The <a class="link" href="AtkObject.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> to free</p></td>
|
1414
|
+
<td class="parameter_annotations"> </td>
|
1415
|
+
</tr></tbody>
|
1416
|
+
</table></div>
|
1417
|
+
</div>
|
1418
|
+
</div>
|
1100
1419
|
<hr>
|
1101
1420
|
<div class="refsect2">
|
1102
|
-
<a name="atk-text-
|
1103
|
-
<pre class="programlisting"><
|
1104
|
-
|
1105
|
-
|
1106
|
-
|
1107
|
-
|
1108
|
-
<
|
1109
|
-
|
1110
|
-
|
1111
|
-
|
1112
|
-
|
1113
|
-
<
|
1114
|
-
|
1115
|
-
|
1116
|
-
</p>
|
1117
|
-
<p>
|
1118
|
-
|
1119
|
-
|
1120
|
-
|
1121
|
-
</
|
1122
|
-
<
|
1123
|
-
|
1124
|
-
|
1125
|
-
offset is not inside a word.
|
1126
|
-
</p>
|
1127
|
-
<p>
|
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.
|
1131
|
-
</p>
|
1132
|
-
<p>
|
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.
|
1136
|
-
</p>
|
1137
|
-
<p>
|
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.
|
1421
|
+
<a name="atk-text-attribute-register"></a><h3>atk_text_attribute_register ()</h3>
|
1422
|
+
<pre class="programlisting"><a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="returnvalue">AtkTextAttribute</span></a>
|
1423
|
+
atk_text_attribute_register (<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
|
1424
|
+
<p>Associate <em class="parameter"><code>name</code></em>
|
1425
|
+
with a new <a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a></p>
|
1426
|
+
<div class="refsect3">
|
1427
|
+
<a name="id-1.5.13.9.24.5"></a><h4>Parameters</h4>
|
1428
|
+
<div class="informaltable"><table width="100%" border="0">
|
1429
|
+
<colgroup>
|
1430
|
+
<col width="150px" class="parameters_name">
|
1431
|
+
<col class="parameters_description">
|
1432
|
+
<col width="200px" class="parameters_annotations">
|
1433
|
+
</colgroup>
|
1434
|
+
<tbody><tr>
|
1435
|
+
<td class="parameter_name"><p>name</p></td>
|
1436
|
+
<td class="parameter_description"><p>a name string</p></td>
|
1437
|
+
<td class="parameter_annotations"> </td>
|
1438
|
+
</tr></tbody>
|
1439
|
+
</table></div>
|
1440
|
+
</div>
|
1441
|
+
<div class="refsect3">
|
1442
|
+
<a name="id-1.5.13.9.24.6"></a><h4>Returns</h4>
|
1443
|
+
<p> an <a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a> associated with <em class="parameter"><code>name</code></em>
|
1141
1444
|
</p>
|
1445
|
+
<p></p>
|
1446
|
+
</div>
|
1447
|
+
</div>
|
1448
|
+
<hr>
|
1449
|
+
<div class="refsect2">
|
1450
|
+
<a name="atk-text-attribute-get-name"></a><h3>atk_text_attribute_get_name ()</h3>
|
1451
|
+
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
1452
|
+
atk_text_attribute_get_name (<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a> attr</code></em>);</pre>
|
1453
|
+
<p>Gets the name corresponding to the <a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a></p>
|
1454
|
+
<div class="refsect3">
|
1455
|
+
<a name="id-1.5.13.9.25.5"></a><h4>Parameters</h4>
|
1456
|
+
<div class="informaltable"><table width="100%" border="0">
|
1457
|
+
<colgroup>
|
1458
|
+
<col width="150px" class="parameters_name">
|
1459
|
+
<col class="parameters_description">
|
1460
|
+
<col width="200px" class="parameters_annotations">
|
1461
|
+
</colgroup>
|
1462
|
+
<tbody><tr>
|
1463
|
+
<td class="parameter_name"><p>attr</p></td>
|
1464
|
+
<td class="parameter_description"><p>The <a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a> whose name is required</p></td>
|
1465
|
+
<td class="parameter_annotations"> </td>
|
1466
|
+
</tr></tbody>
|
1467
|
+
</table></div>
|
1468
|
+
</div>
|
1469
|
+
<div class="refsect3">
|
1470
|
+
<a name="id-1.5.13.9.25.6"></a><h4>Returns</h4>
|
1471
|
+
<p> a string containing the name; this string should not be freed</p>
|
1472
|
+
<p></p>
|
1473
|
+
</div>
|
1474
|
+
</div>
|
1475
|
+
<hr>
|
1476
|
+
<div class="refsect2">
|
1477
|
+
<a name="atk-text-attribute-for-name"></a><h3>atk_text_attribute_for_name ()</h3>
|
1478
|
+
<pre class="programlisting"><a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="returnvalue">AtkTextAttribute</span></a>
|
1479
|
+
atk_text_attribute_for_name (<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
|
1480
|
+
<p>Get the <a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a> type corresponding to a text attribute name.</p>
|
1481
|
+
<div class="refsect3">
|
1482
|
+
<a name="id-1.5.13.9.26.5"></a><h4>Parameters</h4>
|
1483
|
+
<div class="informaltable"><table width="100%" border="0">
|
1484
|
+
<colgroup>
|
1485
|
+
<col width="150px" class="parameters_name">
|
1486
|
+
<col class="parameters_description">
|
1487
|
+
<col width="200px" class="parameters_annotations">
|
1488
|
+
</colgroup>
|
1489
|
+
<tbody><tr>
|
1490
|
+
<td class="parameter_name"><p>name</p></td>
|
1491
|
+
<td class="parameter_description"><p>a string which is the (non-localized) name of an ATK text attribute.</p></td>
|
1492
|
+
<td class="parameter_annotations"> </td>
|
1493
|
+
</tr></tbody>
|
1494
|
+
</table></div>
|
1495
|
+
</div>
|
1496
|
+
<div class="refsect3">
|
1497
|
+
<a name="id-1.5.13.9.26.6"></a><h4>Returns</h4>
|
1498
|
+
<p> the <a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a> enumerated type corresponding to the specified
|
1499
|
+
name,
|
1500
|
+
or <span class="type">ATK_TEXT_ATTRIBUTE_INVALID</span> if no matching text attribute is found.</p>
|
1501
|
+
<p></p>
|
1502
|
+
</div>
|
1503
|
+
</div>
|
1504
|
+
<hr>
|
1505
|
+
<div class="refsect2">
|
1506
|
+
<a name="atk-text-attribute-get-value"></a><h3>atk_text_attribute_get_value ()</h3>
|
1507
|
+
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
1508
|
+
atk_text_attribute_get_value (<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a> attr</code></em>,
|
1509
|
+
<em class="parameter"><code><span class="type">gint</span> index_</code></em>);</pre>
|
1510
|
+
<p>Gets the value for the index of the <a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a></p>
|
1511
|
+
<div class="refsect3">
|
1512
|
+
<a name="id-1.5.13.9.27.5"></a><h4>Parameters</h4>
|
1513
|
+
<div class="informaltable"><table width="100%" border="0">
|
1514
|
+
<colgroup>
|
1515
|
+
<col width="150px" class="parameters_name">
|
1516
|
+
<col class="parameters_description">
|
1517
|
+
<col width="200px" class="parameters_annotations">
|
1518
|
+
</colgroup>
|
1519
|
+
<tbody>
|
1520
|
+
<tr>
|
1521
|
+
<td class="parameter_name"><p>attr</p></td>
|
1522
|
+
<td class="parameter_description"><p>The <a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a> for which a value is required</p></td>
|
1523
|
+
<td class="parameter_annotations"> </td>
|
1524
|
+
</tr>
|
1525
|
+
<tr>
|
1526
|
+
<td class="parameter_name"><p>index_</p></td>
|
1527
|
+
<td class="parameter_description"><p>The index of the required value</p></td>
|
1528
|
+
<td class="parameter_annotations"> </td>
|
1529
|
+
</tr>
|
1530
|
+
</tbody>
|
1531
|
+
</table></div>
|
1532
|
+
</div>
|
1533
|
+
<div class="refsect3">
|
1534
|
+
<a name="id-1.5.13.9.27.6"></a><h4>Returns</h4>
|
1535
|
+
<p> a string containing the value; this string
|
1536
|
+
should not be freed; <code class="literal">NULL</code> is returned if there are no values
|
1537
|
+
maintained for the attr value. </p>
|
1538
|
+
<p><span class="annotation">[<a href="http://foldoc.org/nullable"><span class="acronym">nullable</span></a>]</span></p>
|
1539
|
+
</div>
|
1540
|
+
</div>
|
1541
|
+
</div>
|
1542
|
+
<div class="refsect1">
|
1543
|
+
<a name="AtkText.other_details"></a><h2>Types and Values</h2>
|
1544
|
+
<div class="refsect2">
|
1545
|
+
<a name="AtkText-struct"></a><h3>AtkText</h3>
|
1546
|
+
<pre class="programlisting">typedef struct _AtkText AtkText;</pre>
|
1142
1547
|
<p>
|
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.
|
1146
1548
|
</p>
|
1147
|
-
|
1148
|
-
<
|
1549
|
+
</div>
|
1550
|
+
<hr>
|
1551
|
+
<div class="refsect2">
|
1552
|
+
<a name="AtkTextIface"></a><h3>struct AtkTextIface</h3>
|
1553
|
+
<pre class="programlisting">struct AtkTextIface {
|
1554
|
+
GTypeInterface parent;
|
1555
|
+
|
1556
|
+
gchar* (* get_text) (AtkText *text,
|
1557
|
+
gint start_offset,
|
1558
|
+
gint end_offset);
|
1559
|
+
gchar* (* get_text_after_offset) (AtkText *text,
|
1560
|
+
gint offset,
|
1561
|
+
AtkTextBoundary boundary_type,
|
1562
|
+
gint *start_offset,
|
1563
|
+
gint *end_offset);
|
1564
|
+
gchar* (* get_text_at_offset) (AtkText *text,
|
1565
|
+
gint offset,
|
1566
|
+
AtkTextBoundary boundary_type,
|
1567
|
+
gint *start_offset,
|
1568
|
+
gint *end_offset);
|
1569
|
+
gunichar (* get_character_at_offset) (AtkText *text,
|
1570
|
+
gint offset);
|
1571
|
+
gchar* (* get_text_before_offset) (AtkText *text,
|
1572
|
+
gint offset,
|
1573
|
+
AtkTextBoundary boundary_type,
|
1574
|
+
gint *start_offset,
|
1575
|
+
gint *end_offset);
|
1576
|
+
gint (* get_caret_offset) (AtkText *text);
|
1577
|
+
AtkAttributeSet* (* get_run_attributes) (AtkText *text,
|
1578
|
+
gint offset,
|
1579
|
+
gint *start_offset,
|
1580
|
+
gint *end_offset);
|
1581
|
+
AtkAttributeSet* (* get_default_attributes) (AtkText *text);
|
1582
|
+
void (* get_character_extents) (AtkText *text,
|
1583
|
+
gint offset,
|
1584
|
+
gint *x,
|
1585
|
+
gint *y,
|
1586
|
+
gint *width,
|
1587
|
+
gint *height,
|
1588
|
+
AtkCoordType coords);
|
1589
|
+
gint (* get_character_count) (AtkText *text);
|
1590
|
+
gint (* get_offset_at_point) (AtkText *text,
|
1591
|
+
gint x,
|
1592
|
+
gint y,
|
1593
|
+
AtkCoordType coords);
|
1594
|
+
gint (* get_n_selections) (AtkText *text);
|
1595
|
+
gchar* (* get_selection) (AtkText *text,
|
1596
|
+
gint selection_num,
|
1597
|
+
gint *start_offset,
|
1598
|
+
gint *end_offset);
|
1599
|
+
gboolean (* add_selection) (AtkText *text,
|
1600
|
+
gint start_offset,
|
1601
|
+
gint end_offset);
|
1602
|
+
gboolean (* remove_selection) (AtkText *text,
|
1603
|
+
gint selection_num);
|
1604
|
+
gboolean (* set_selection) (AtkText *text,
|
1605
|
+
gint selection_num,
|
1606
|
+
gint start_offset,
|
1607
|
+
gint end_offset);
|
1608
|
+
gboolean (* set_caret_offset) (AtkText *text,
|
1609
|
+
gint offset);
|
1610
|
+
|
1611
|
+
/*
|
1612
|
+
* signal handlers
|
1613
|
+
*/
|
1614
|
+
void (* text_changed) (AtkText *text,
|
1615
|
+
gint position,
|
1616
|
+
gint length);
|
1617
|
+
void (* text_caret_moved) (AtkText *text,
|
1618
|
+
gint location);
|
1619
|
+
void (* text_selection_changed) (AtkText *text);
|
1620
|
+
|
1621
|
+
void (* text_attributes_changed) (AtkText *text);
|
1622
|
+
|
1623
|
+
|
1624
|
+
void (* get_range_extents) (AtkText *text,
|
1625
|
+
gint start_offset,
|
1626
|
+
gint end_offset,
|
1627
|
+
AtkCoordType coord_type,
|
1628
|
+
AtkTextRectangle *rect);
|
1629
|
+
|
1630
|
+
AtkTextRange** (* get_bounded_ranges) (AtkText *text,
|
1631
|
+
AtkTextRectangle *rect,
|
1632
|
+
AtkCoordType coord_type,
|
1633
|
+
AtkTextClipType x_clip_type,
|
1634
|
+
AtkTextClipType y_clip_type);
|
1635
|
+
|
1636
|
+
gchar* (* get_string_at_offset) (AtkText *text,
|
1637
|
+
gint offset,
|
1638
|
+
AtkTextGranularity granularity,
|
1639
|
+
gint *start_offset,
|
1640
|
+
gint *end_offset);
|
1641
|
+
};
|
1642
|
+
</pre>
|
1643
|
+
<div class="refsect3">
|
1644
|
+
<a name="id-1.5.13.10.3.4"></a><h4>Members</h4>
|
1645
|
+
<div class="informaltable"><table width="100%" border="0">
|
1646
|
+
<colgroup>
|
1647
|
+
<col width="300px" class="struct_members_name">
|
1648
|
+
<col class="struct_members_description">
|
1649
|
+
<col width="200px" class="struct_members_annotations">
|
1650
|
+
</colgroup>
|
1149
1651
|
<tbody>
|
1150
1652
|
<tr>
|
1151
|
-
<td><p><span class="
|
1152
|
-
<td
|
1153
|
-
</td>
|
1653
|
+
<td class="struct_member_name"><p><span class="type">GTypeInterface</span> <em class="structfield"><code><a name="AtkTextIface.parent"></a>parent</code></em>;</p></td>
|
1654
|
+
<td class="struct_member_description"> </td>
|
1655
|
+
<td class="struct_member_annotations"> </td>
|
1656
|
+
</tr>
|
1657
|
+
<tr>
|
1658
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.get-text"></a>get_text</code></em> ()</p></td>
|
1659
|
+
<td class="struct_member_description"> </td>
|
1660
|
+
<td class="struct_member_annotations"> </td>
|
1661
|
+
</tr>
|
1662
|
+
<tr>
|
1663
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.get-text-after-offset"></a>get_text_after_offset</code></em> ()</p></td>
|
1664
|
+
<td class="struct_member_description"><p>Gets specified text. This virtual function
|
1665
|
+
is deprecated and it should not be overridden.</p></td>
|
1666
|
+
<td class="struct_member_annotations"> </td>
|
1667
|
+
</tr>
|
1668
|
+
<tr>
|
1669
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.get-text-at-offset"></a>get_text_at_offset</code></em> ()</p></td>
|
1670
|
+
<td class="struct_member_description"><p>Gets specified text. This virtual function
|
1671
|
+
is deprecated and it should not be overridden.</p></td>
|
1672
|
+
<td class="struct_member_annotations"> </td>
|
1673
|
+
</tr>
|
1674
|
+
<tr>
|
1675
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.get-character-at-offset"></a>get_character_at_offset</code></em> ()</p></td>
|
1676
|
+
<td class="struct_member_description"> </td>
|
1677
|
+
<td class="struct_member_annotations"> </td>
|
1678
|
+
</tr>
|
1679
|
+
<tr>
|
1680
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.get-text-before-offset"></a>get_text_before_offset</code></em> ()</p></td>
|
1681
|
+
<td class="struct_member_description"><p>Gets specified text. This virtual function
|
1682
|
+
is deprecated and it should not be overridden.</p></td>
|
1683
|
+
<td class="struct_member_annotations"> </td>
|
1684
|
+
</tr>
|
1685
|
+
<tr>
|
1686
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.get-caret-offset"></a>get_caret_offset</code></em> ()</p></td>
|
1687
|
+
<td class="struct_member_description"> </td>
|
1688
|
+
<td class="struct_member_annotations"> </td>
|
1689
|
+
</tr>
|
1690
|
+
<tr>
|
1691
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.get-run-attributes"></a>get_run_attributes</code></em> ()</p></td>
|
1692
|
+
<td class="struct_member_description"> </td>
|
1693
|
+
<td class="struct_member_annotations"> </td>
|
1154
1694
|
</tr>
|
1155
1695
|
<tr>
|
1156
|
-
<td
|
1157
|
-
<td>
|
1696
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.get-default-attributes"></a>get_default_attributes</code></em> ()</p></td>
|
1697
|
+
<td class="struct_member_description"> </td>
|
1698
|
+
<td class="struct_member_annotations"> </td>
|
1158
1699
|
</tr>
|
1159
1700
|
<tr>
|
1160
|
-
<td
|
1161
|
-
<td
|
1162
|
-
</td>
|
1701
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.get-character-extents"></a>get_character_extents</code></em> ()</p></td>
|
1702
|
+
<td class="struct_member_description"> </td>
|
1703
|
+
<td class="struct_member_annotations"> </td>
|
1163
1704
|
</tr>
|
1164
1705
|
<tr>
|
1165
|
-
<td
|
1166
|
-
<td>
|
1167
|
-
|
1168
|
-
</td>
|
1706
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.get-character-count"></a>get_character_count</code></em> ()</p></td>
|
1707
|
+
<td class="struct_member_description"> </td>
|
1708
|
+
<td class="struct_member_annotations"> </td>
|
1169
1709
|
</tr>
|
1170
1710
|
<tr>
|
1171
|
-
<td
|
1172
|
-
<td>
|
1173
|
-
|
1174
|
-
</td>
|
1711
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.get-offset-at-point"></a>get_offset_at_point</code></em> ()</p></td>
|
1712
|
+
<td class="struct_member_description"> </td>
|
1713
|
+
<td class="struct_member_annotations"> </td>
|
1175
1714
|
</tr>
|
1176
1715
|
<tr>
|
1177
|
-
<td><p><
|
1178
|
-
<td
|
1179
|
-
|
1180
|
-
Returns <code class="literal">NULL</code> if the offset is invalid or no implementation is available.</td>
|
1716
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.get-n-selections"></a>get_n_selections</code></em> ()</p></td>
|
1717
|
+
<td class="struct_member_description"> </td>
|
1718
|
+
<td class="struct_member_annotations"> </td>
|
1181
1719
|
</tr>
|
1182
|
-
</tbody>
|
1183
|
-
</table></div>
|
1184
|
-
<p class="since">Since 2.9.4</p>
|
1185
|
-
</div>
|
1186
|
-
<hr>
|
1187
|
-
<div class="refsect2">
|
1188
|
-
<a name="atk-text-get-caret-offset"></a><h3>atk_text_get_caret_offset ()</h3>
|
1189
|
-
<pre class="programlisting"><span class="returnvalue">gint</span> atk_text_get_caret_offset (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>);</pre>
|
1190
|
-
<p>
|
1191
|
-
Gets the offset position of the caret (cursor).
|
1192
|
-
</p>
|
1193
|
-
<div class="variablelist"><table border="0">
|
1194
|
-
<col align="left" valign="top">
|
1195
|
-
<tbody>
|
1196
1720
|
<tr>
|
1197
|
-
<td
|
1198
|
-
<td
|
1199
|
-
</td>
|
1721
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.get-selection"></a>get_selection</code></em> ()</p></td>
|
1722
|
+
<td class="struct_member_description"> </td>
|
1723
|
+
<td class="struct_member_annotations"> </td>
|
1200
1724
|
</tr>
|
1201
1725
|
<tr>
|
1202
|
-
<td><p><
|
1203
|
-
<td>
|
1726
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.add-selection"></a>add_selection</code></em> ()</p></td>
|
1727
|
+
<td class="struct_member_description"> </td>
|
1728
|
+
<td class="struct_member_annotations"> </td>
|
1204
1729
|
</tr>
|
1205
|
-
</tbody>
|
1206
|
-
</table></div>
|
1207
|
-
</div>
|
1208
|
-
<hr>
|
1209
|
-
<div class="refsect2">
|
1210
|
-
<a name="atk-text-get-character-extents"></a><h3>atk_text_get_character_extents ()</h3>
|
1211
|
-
<pre class="programlisting"><span class="returnvalue">void</span> atk_text_get_character_extents (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
1212
|
-
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
1213
|
-
<em class="parameter"><code><span class="type">gint</span> *x</code></em>,
|
1214
|
-
<em class="parameter"><code><span class="type">gint</span> *y</code></em>,
|
1215
|
-
<em class="parameter"><code><span class="type">gint</span> *width</code></em>,
|
1216
|
-
<em class="parameter"><code><span class="type">gint</span> *height</code></em>,
|
1217
|
-
<em class="parameter"><code><a class="link" href="AtkUtil.html#AtkCoordType" title="enum AtkCoordType"><span class="type">AtkCoordType</span></a> coords</code></em>);</pre>
|
1218
|
-
<p>
|
1219
|
-
Get the bounding box containing the glyph representing the character at
|
1220
|
-
a particular text offset.
|
1221
|
-
</p>
|
1222
|
-
<div class="variablelist"><table border="0">
|
1223
|
-
<col align="left" valign="top">
|
1224
|
-
<tbody>
|
1225
1730
|
<tr>
|
1226
|
-
<td
|
1227
|
-
<td
|
1228
|
-
</td>
|
1731
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.remove-selection"></a>remove_selection</code></em> ()</p></td>
|
1732
|
+
<td class="struct_member_description"> </td>
|
1733
|
+
<td class="struct_member_annotations"> </td>
|
1734
|
+
</tr>
|
1735
|
+
<tr>
|
1736
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.set-selection"></a>set_selection</code></em> ()</p></td>
|
1737
|
+
<td class="struct_member_description"> </td>
|
1738
|
+
<td class="struct_member_annotations"> </td>
|
1229
1739
|
</tr>
|
1230
1740
|
<tr>
|
1231
|
-
<td
|
1232
|
-
<td>
|
1741
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.set-caret-offset"></a>set_caret_offset</code></em> ()</p></td>
|
1742
|
+
<td class="struct_member_description"> </td>
|
1743
|
+
<td class="struct_member_annotations"> </td>
|
1233
1744
|
</tr>
|
1234
1745
|
<tr>
|
1235
|
-
<td
|
1236
|
-
<td>
|
1746
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.text-changed"></a>text_changed</code></em> ()</p></td>
|
1747
|
+
<td class="struct_member_description"><p>the signal handler which is executed when there is a
|
1748
|
+
text change. This virtual function is deprecated sice 2.9.4 and
|
1749
|
+
it should not be overriden.</p></td>
|
1750
|
+
<td class="struct_member_annotations"> </td>
|
1751
|
+
</tr>
|
1752
|
+
<tr>
|
1753
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.text-caret-moved"></a>text_caret_moved</code></em> ()</p></td>
|
1754
|
+
<td class="struct_member_description"> </td>
|
1755
|
+
<td class="struct_member_annotations"> </td>
|
1756
|
+
</tr>
|
1757
|
+
<tr>
|
1758
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.text-selection-changed"></a>text_selection_changed</code></em> ()</p></td>
|
1759
|
+
<td class="struct_member_description"> </td>
|
1760
|
+
<td class="struct_member_annotations"> </td>
|
1237
1761
|
</tr>
|
1238
1762
|
<tr>
|
1239
|
-
<td
|
1240
|
-
<td>
|
1763
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.text-attributes-changed"></a>text_attributes_changed</code></em> ()</p></td>
|
1764
|
+
<td class="struct_member_description"> </td>
|
1765
|
+
<td class="struct_member_annotations"> </td>
|
1241
1766
|
</tr>
|
1242
1767
|
<tr>
|
1243
|
-
<td
|
1244
|
-
<td>
|
1768
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.get-range-extents"></a>get_range_extents</code></em> ()</p></td>
|
1769
|
+
<td class="struct_member_description"> </td>
|
1770
|
+
<td class="struct_member_annotations"> </td>
|
1245
1771
|
</tr>
|
1246
1772
|
<tr>
|
1247
|
-
<td
|
1248
|
-
<td>
|
1773
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.get-bounded-ranges"></a>get_bounded_ranges</code></em> ()</p></td>
|
1774
|
+
<td class="struct_member_description"> </td>
|
1775
|
+
<td class="struct_member_annotations"> </td>
|
1249
1776
|
</tr>
|
1250
1777
|
<tr>
|
1251
|
-
<td
|
1252
|
-
<td>
|
1778
|
+
<td class="struct_member_name"><p><em class="structfield"><code><a name="AtkTextIface.get-string-at-offset"></a>get_string_at_offset</code></em> ()</p></td>
|
1779
|
+
<td class="struct_member_description"><p>Gets a portion of the text exposed through
|
1780
|
+
an AtkText according to a given offset and a specific
|
1781
|
+
granularity, along with the start and end offsets defining the
|
1782
|
+
boundaries of such a portion of text.</p></td>
|
1783
|
+
<td class="struct_member_annotations"> </td>
|
1253
1784
|
</tr>
|
1254
1785
|
</tbody>
|
1255
1786
|
</table></div>
|
1256
1787
|
</div>
|
1788
|
+
</div>
|
1257
1789
|
<hr>
|
1258
1790
|
<div class="refsect2">
|
1259
|
-
<a name="
|
1260
|
-
<
|
1261
|
-
|
1262
|
-
|
1263
|
-
|
1264
|
-
<
|
1265
|
-
|
1266
|
-
|
1267
|
-
|
1268
|
-
|
1269
|
-
|
1270
|
-
|
1271
|
-
returned.
|
1272
|
-
</p>
|
1273
|
-
<div class="variablelist"><table border="0">
|
1274
|
-
<col align="left" valign="top">
|
1791
|
+
<a name="AtkTextBoundary"></a><h3>enum AtkTextBoundary</h3>
|
1792
|
+
<p>Text boundary types used for specifying boundaries for regions of text.
|
1793
|
+
This enumerationis deprecated since 2.9.4 and should not be used. Use
|
1794
|
+
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.</p>
|
1795
|
+
<div class="refsect3">
|
1796
|
+
<a name="id-1.5.13.10.4.4"></a><h4>Members</h4>
|
1797
|
+
<div class="informaltable"><table width="100%" border="0">
|
1798
|
+
<colgroup>
|
1799
|
+
<col width="300px" class="enum_members_name">
|
1800
|
+
<col class="enum_members_description">
|
1801
|
+
<col width="200px" class="enum_members_annotations">
|
1802
|
+
</colgroup>
|
1275
1803
|
<tbody>
|
1276
1804
|
<tr>
|
1277
|
-
<td
|
1278
|
-
<td
|
1805
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-BOUNDARY-CHAR:CAPS"></a>ATK_TEXT_BOUNDARY_CHAR</p></td>
|
1806
|
+
<td class="enum_member_description">
|
1807
|
+
<p>Boundary is the boundary between characters
|
1808
|
+
(including non-printing characters)</p>
|
1279
1809
|
</td>
|
1810
|
+
<td class="enum_member_annotations"> </td>
|
1280
1811
|
</tr>
|
1281
1812
|
<tr>
|
1282
|
-
<td
|
1283
|
-
<td>
|
1284
|
-
the
|
1285
|
-
</tr>
|
1286
|
-
<tr>
|
1287
|
-
<td><p><span class="term"><em class="parameter"><code>start_offset</code></em> :</span></p></td>
|
1288
|
-
<td>the address to put the start offset of the range. <span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span>
|
1813
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-BOUNDARY-WORD-START:CAPS"></a>ATK_TEXT_BOUNDARY_WORD_START</p></td>
|
1814
|
+
<td class="enum_member_description">
|
1815
|
+
<p>Boundary is the start (i.e. first character) of a word.</p>
|
1289
1816
|
</td>
|
1817
|
+
<td class="enum_member_annotations"> </td>
|
1290
1818
|
</tr>
|
1291
1819
|
<tr>
|
1292
|
-
<td
|
1293
|
-
<td
|
1820
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-BOUNDARY-WORD-END:CAPS"></a>ATK_TEXT_BOUNDARY_WORD_END</p></td>
|
1821
|
+
<td class="enum_member_description">
|
1822
|
+
<p>Boundary is the end (i.e. last
|
1823
|
+
character) of a word.</p>
|
1294
1824
|
</td>
|
1825
|
+
<td class="enum_member_annotations"> </td>
|
1295
1826
|
</tr>
|
1296
1827
|
<tr>
|
1297
|
-
<td
|
1298
|
-
<td
|
1299
|
-
|
1300
|
-
to <a class="link" href="AtkText.html#atk-attribute-set-free" title="atk_attribute_set_free ()"><code class="function">atk_attribute_set_free()</code></a>. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
|
1828
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-BOUNDARY-SENTENCE-START:CAPS"></a>ATK_TEXT_BOUNDARY_SENTENCE_START</p></td>
|
1829
|
+
<td class="enum_member_description">
|
1830
|
+
<p>Boundary is the first character in a sentence.</p>
|
1301
1831
|
</td>
|
1832
|
+
<td class="enum_member_annotations"> </td>
|
1302
1833
|
</tr>
|
1303
|
-
</tbody>
|
1304
|
-
</table></div>
|
1305
|
-
</div>
|
1306
|
-
<hr>
|
1307
|
-
<div class="refsect2">
|
1308
|
-
<a name="atk-text-get-default-attributes"></a><h3>atk_text_get_default_attributes ()</h3>
|
1309
|
-
<pre class="programlisting"><a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="returnvalue">AtkAttributeSet</span></a> * atk_text_get_default_attributes (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>);</pre>
|
1310
|
-
<p>
|
1311
|
-
Creates an <a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> which consists of the default values of
|
1312
|
-
attributes for the text. See the enum AtkTextAttribute for types of text
|
1313
|
-
attributes that can be returned. Note that other attributes may also be
|
1314
|
-
returned.
|
1315
|
-
</p>
|
1316
|
-
<div class="variablelist"><table border="0">
|
1317
|
-
<col align="left" valign="top">
|
1318
|
-
<tbody>
|
1319
1834
|
<tr>
|
1320
|
-
<td
|
1321
|
-
<td
|
1835
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-BOUNDARY-SENTENCE-END:CAPS"></a>ATK_TEXT_BOUNDARY_SENTENCE_END</p></td>
|
1836
|
+
<td class="enum_member_description">
|
1837
|
+
<p>Boundary is the last (terminal)
|
1838
|
+
character in a sentence; in languages which use "sentence stop"
|
1839
|
+
punctuation such as English, the boundary is thus the '.', '?', or
|
1840
|
+
similar terminal punctuation character.</p>
|
1322
1841
|
</td>
|
1842
|
+
<td class="enum_member_annotations"> </td>
|
1323
1843
|
</tr>
|
1324
1844
|
<tr>
|
1325
|
-
<td
|
1326
|
-
<td
|
1327
|
-
|
1328
|
-
|
1845
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-BOUNDARY-LINE-START:CAPS"></a>ATK_TEXT_BOUNDARY_LINE_START</p></td>
|
1846
|
+
<td class="enum_member_description">
|
1847
|
+
<p>Boundary is the initial character of the content or a
|
1848
|
+
character immediately following a newline, linefeed, or return character.</p>
|
1329
1849
|
</td>
|
1850
|
+
<td class="enum_member_annotations"> </td>
|
1330
1851
|
</tr>
|
1331
|
-
</tbody>
|
1332
|
-
</table></div>
|
1333
|
-
</div>
|
1334
|
-
<hr>
|
1335
|
-
<div class="refsect2">
|
1336
|
-
<a name="atk-text-get-character-count"></a><h3>atk_text_get_character_count ()</h3>
|
1337
|
-
<pre class="programlisting"><span class="returnvalue">gint</span> atk_text_get_character_count (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>);</pre>
|
1338
|
-
<p>
|
1339
|
-
Gets the character count.
|
1340
|
-
</p>
|
1341
|
-
<div class="variablelist"><table border="0">
|
1342
|
-
<col align="left" valign="top">
|
1343
|
-
<tbody>
|
1344
1852
|
<tr>
|
1345
|
-
<td
|
1346
|
-
<td
|
1853
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-BOUNDARY-LINE-END:CAPS"></a>ATK_TEXT_BOUNDARY_LINE_END</p></td>
|
1854
|
+
<td class="enum_member_description">
|
1855
|
+
<p>Boundary is the linefeed, or return
|
1856
|
+
character.</p>
|
1347
1857
|
</td>
|
1348
|
-
</
|
1349
|
-
<tr>
|
1350
|
-
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1351
|
-
<td>the number of characters.</td>
|
1858
|
+
<td class="enum_member_annotations"> </td>
|
1352
1859
|
</tr>
|
1353
1860
|
</tbody>
|
1354
1861
|
</table></div>
|
1355
1862
|
</div>
|
1863
|
+
</div>
|
1356
1864
|
<hr>
|
1357
1865
|
<div class="refsect2">
|
1358
|
-
<a name="
|
1359
|
-
<
|
1360
|
-
|
1361
|
-
|
1362
|
-
|
1363
|
-
<
|
1364
|
-
|
1365
|
-
|
1366
|
-
|
1367
|
-
|
1368
|
-
|
1369
|
-
<col align="left" valign="top">
|
1866
|
+
<a name="AtkTextGranularity"></a><h3>enum AtkTextGranularity</h3>
|
1867
|
+
<p>Text granularity types used for specifying the granularity of the region of
|
1868
|
+
text we are interested in.</p>
|
1869
|
+
<div class="refsect3">
|
1870
|
+
<a name="id-1.5.13.10.5.4"></a><h4>Members</h4>
|
1871
|
+
<div class="informaltable"><table width="100%" border="0">
|
1872
|
+
<colgroup>
|
1873
|
+
<col width="300px" class="enum_members_name">
|
1874
|
+
<col class="enum_members_description">
|
1875
|
+
<col width="200px" class="enum_members_annotations">
|
1876
|
+
</colgroup>
|
1370
1877
|
<tbody>
|
1371
1878
|
<tr>
|
1372
|
-
<td
|
1373
|
-
<td
|
1879
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-GRANULARITY-CHAR:CAPS"></a>ATK_TEXT_GRANULARITY_CHAR</p></td>
|
1880
|
+
<td class="enum_member_description">
|
1881
|
+
<p>Granularity is defined by the boundaries between characters
|
1882
|
+
(including non-printing characters)</p>
|
1374
1883
|
</td>
|
1884
|
+
<td class="enum_member_annotations"> </td>
|
1375
1885
|
</tr>
|
1376
1886
|
<tr>
|
1377
|
-
<td
|
1378
|
-
<td
|
1887
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-GRANULARITY-WORD:CAPS"></a>ATK_TEXT_GRANULARITY_WORD</p></td>
|
1888
|
+
<td class="enum_member_description">
|
1889
|
+
<p>Granularity is defined by the boundaries of a word,
|
1890
|
+
starting at the beginning of the current word and finishing at the beginning of
|
1891
|
+
the following one, if present.</p>
|
1892
|
+
</td>
|
1893
|
+
<td class="enum_member_annotations"> </td>
|
1379
1894
|
</tr>
|
1380
1895
|
<tr>
|
1381
|
-
<td
|
1382
|
-
<td
|
1896
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-GRANULARITY-SENTENCE:CAPS"></a>ATK_TEXT_GRANULARITY_SENTENCE</p></td>
|
1897
|
+
<td class="enum_member_description">
|
1898
|
+
<p>Granularity is defined by the boundaries of a sentence,
|
1899
|
+
starting at the beginning of the current sentence and finishing at the beginning of
|
1900
|
+
the following one, if present.</p>
|
1901
|
+
</td>
|
1902
|
+
<td class="enum_member_annotations"> </td>
|
1383
1903
|
</tr>
|
1384
1904
|
<tr>
|
1385
|
-
<td
|
1386
|
-
<td>
|
1387
|
-
|
1905
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-GRANULARITY-LINE:CAPS"></a>ATK_TEXT_GRANULARITY_LINE</p></td>
|
1906
|
+
<td class="enum_member_description">
|
1907
|
+
<p>Granularity is defined by the boundaries of a line,
|
1908
|
+
starting at the beginning of the current line and finishing at the beginning of
|
1909
|
+
the following one, if present.</p>
|
1910
|
+
</td>
|
1911
|
+
<td class="enum_member_annotations"> </td>
|
1388
1912
|
</tr>
|
1389
1913
|
<tr>
|
1390
|
-
<td
|
1391
|
-
<td>
|
1392
|
-
|
1914
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-GRANULARITY-PARAGRAPH:CAPS"></a>ATK_TEXT_GRANULARITY_PARAGRAPH</p></td>
|
1915
|
+
<td class="enum_member_description">
|
1916
|
+
<p>Granularity is defined by the boundaries of a paragraph,
|
1917
|
+
starting at the beginning of the current paragraph and finishing at the beginning of
|
1918
|
+
the following one, if present.</p>
|
1919
|
+
</td>
|
1920
|
+
<td class="enum_member_annotations"> </td>
|
1393
1921
|
</tr>
|
1394
1922
|
</tbody>
|
1395
1923
|
</table></div>
|
1396
1924
|
</div>
|
1925
|
+
</div>
|
1397
1926
|
<hr>
|
1398
1927
|
<div class="refsect2">
|
1399
|
-
<a name="
|
1400
|
-
<
|
1401
|
-
|
1402
|
-
|
1403
|
-
|
1404
|
-
|
1405
|
-
<
|
1406
|
-
|
1407
|
-
|
1408
|
-
|
1409
|
-
<col align="left" valign="top">
|
1928
|
+
<a name="AtkTextClipType"></a><h3>enum AtkTextClipType</h3>
|
1929
|
+
<p>Describes the type of clipping required.</p>
|
1930
|
+
<div class="refsect3">
|
1931
|
+
<a name="id-1.5.13.10.6.4"></a><h4>Members</h4>
|
1932
|
+
<div class="informaltable"><table width="100%" border="0">
|
1933
|
+
<colgroup>
|
1934
|
+
<col width="300px" class="enum_members_name">
|
1935
|
+
<col class="enum_members_description">
|
1936
|
+
<col width="200px" class="enum_members_annotations">
|
1937
|
+
</colgroup>
|
1410
1938
|
<tbody>
|
1411
1939
|
<tr>
|
1412
|
-
<td
|
1413
|
-
<td
|
1940
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-CLIP-NONE:CAPS"></a>ATK_TEXT_CLIP_NONE</p></td>
|
1941
|
+
<td class="enum_member_description">
|
1942
|
+
<p>No clipping to be done</p>
|
1414
1943
|
</td>
|
1944
|
+
<td class="enum_member_annotations"> </td>
|
1415
1945
|
</tr>
|
1416
1946
|
<tr>
|
1417
|
-
<td
|
1418
|
-
<td
|
1419
|
-
</
|
1420
|
-
|
1421
|
-
<td
|
1422
|
-
<td>Specify whether coordinates are relative to the screen or widget window.</td>
|
1423
|
-
</tr>
|
1424
|
-
<tr>
|
1425
|
-
<td><p><span class="term"><em class="parameter"><code>x_clip_type</code></em> :</span></p></td>
|
1426
|
-
<td>Specify the horizontal clip type.</td>
|
1947
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-CLIP-MIN:CAPS"></a>ATK_TEXT_CLIP_MIN</p></td>
|
1948
|
+
<td class="enum_member_description">
|
1949
|
+
<p>Text clipped by min coordinate is omitted</p>
|
1950
|
+
</td>
|
1951
|
+
<td class="enum_member_annotations"> </td>
|
1427
1952
|
</tr>
|
1428
1953
|
<tr>
|
1429
|
-
<td
|
1430
|
-
<td
|
1954
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-CLIP-MAX:CAPS"></a>ATK_TEXT_CLIP_MAX</p></td>
|
1955
|
+
<td class="enum_member_description">
|
1956
|
+
<p>Text clipped by max coordinate is omitted</p>
|
1957
|
+
</td>
|
1958
|
+
<td class="enum_member_annotations"> </td>
|
1431
1959
|
</tr>
|
1432
1960
|
<tr>
|
1433
|
-
<td
|
1434
|
-
<td>
|
1435
|
-
|
1436
|
-
Virtual: get_bounded_ranges. <span class="annotation">[<a href="http://foldoc.org/array"><span class="acronym">array</span></a> zero-terminated=1]</span>
|
1961
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-CLIP-BOTH:CAPS"></a>ATK_TEXT_CLIP_BOTH</p></td>
|
1962
|
+
<td class="enum_member_description">
|
1963
|
+
<p>Only text fully within mix/max bound is retained</p>
|
1437
1964
|
</td>
|
1965
|
+
<td class="enum_member_annotations"> </td>
|
1438
1966
|
</tr>
|
1439
1967
|
</tbody>
|
1440
1968
|
</table></div>
|
1441
|
-
|
1969
|
+
</div>
|
1442
1970
|
</div>
|
1443
1971
|
<hr>
|
1444
1972
|
<div class="refsect2">
|
1445
|
-
<a name="
|
1446
|
-
<pre class="programlisting"
|
1447
|
-
|
1448
|
-
|
1449
|
-
|
1450
|
-
|
1451
|
-
|
1452
|
-
|
1453
|
-
|
1454
|
-
<div class="
|
1455
|
-
<
|
1973
|
+
<a name="AtkTextRange"></a><h3>struct AtkTextRange</h3>
|
1974
|
+
<pre class="programlisting">struct AtkTextRange {
|
1975
|
+
AtkTextRectangle bounds;
|
1976
|
+
gint start_offset;
|
1977
|
+
gint end_offset;
|
1978
|
+
gchar* content;
|
1979
|
+
};
|
1980
|
+
</pre>
|
1981
|
+
<p>A structure used to describe a text range.</p>
|
1982
|
+
<div class="refsect3">
|
1983
|
+
<a name="id-1.5.13.10.7.5"></a><h4>Members</h4>
|
1984
|
+
<div class="informaltable"><table width="100%" border="0">
|
1985
|
+
<colgroup>
|
1986
|
+
<col width="300px" class="struct_members_name">
|
1987
|
+
<col class="struct_members_description">
|
1988
|
+
<col width="200px" class="struct_members_annotations">
|
1989
|
+
</colgroup>
|
1456
1990
|
<tbody>
|
1457
1991
|
<tr>
|
1458
|
-
<td><p><span class="
|
1459
|
-
<td
|
1460
|
-
</td>
|
1461
|
-
</tr>
|
1462
|
-
<tr>
|
1463
|
-
<td><p><span class="term"><em class="parameter"><code>start_offset</code></em> :</span></p></td>
|
1464
|
-
<td>The offset of the first text character for which boundary
|
1465
|
-
information is required.</td>
|
1992
|
+
<td class="struct_member_name"><p><a class="link" href="AtkText.html#AtkTextRectangle" title="struct AtkTextRectangle"><span class="type">AtkTextRectangle</span></a> <em class="structfield"><code><a name="AtkTextRange.bounds"></a>bounds</code></em>;</p></td>
|
1993
|
+
<td class="struct_member_description"><p>A rectangle giving the bounds of the text range</p></td>
|
1994
|
+
<td class="struct_member_annotations"> </td>
|
1466
1995
|
</tr>
|
1467
1996
|
<tr>
|
1468
|
-
<td><p><span class="
|
1469
|
-
<td>The offset of
|
1470
|
-
|
1997
|
+
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="AtkTextRange.start-offset"></a>start_offset</code></em>;</p></td>
|
1998
|
+
<td class="struct_member_description"><p>The start offset of a AtkTextRange</p></td>
|
1999
|
+
<td class="struct_member_annotations"> </td>
|
1471
2000
|
</tr>
|
1472
2001
|
<tr>
|
1473
|
-
<td><p><span class="
|
1474
|
-
<td>
|
2002
|
+
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="AtkTextRange.end-offset"></a>end_offset</code></em>;</p></td>
|
2003
|
+
<td class="struct_member_description"><p>The end offset of a AtkTextRange</p></td>
|
2004
|
+
<td class="struct_member_annotations"> </td>
|
1475
2005
|
</tr>
|
1476
2006
|
<tr>
|
1477
|
-
<td><p><span class="
|
1478
|
-
<td>
|
2007
|
+
<td class="struct_member_name"><p><span class="type">gchar</span> *<em class="structfield"><code><a name="AtkTextRange.content"></a>content</code></em>;</p></td>
|
2008
|
+
<td class="struct_member_description"><p>The text in the text range</p></td>
|
2009
|
+
<td class="struct_member_annotations"> </td>
|
1479
2010
|
</tr>
|
1480
2011
|
</tbody>
|
1481
2012
|
</table></div>
|
1482
|
-
<p class="since">Since 1.3</p>
|
1483
2013
|
</div>
|
1484
|
-
<hr>
|
1485
|
-
<div class="refsect2">
|
1486
|
-
<a name="atk-text-free-ranges"></a><h3>atk_text_free_ranges ()</h3>
|
1487
|
-
<pre class="programlisting"><span class="returnvalue">void</span> atk_text_free_ranges (<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextRange" title="struct AtkTextRange"><span class="type">AtkTextRange</span></a> **ranges</code></em>);</pre>
|
1488
|
-
<p>
|
1489
|
-
Frees the memory associated with an array of AtkTextRange. It is assumed
|
1490
|
-
that the array was returned by the function atk_text_get_bounded_ranges
|
1491
|
-
and is NULL terminated.
|
1492
|
-
</p>
|
1493
|
-
<div class="variablelist"><table border="0">
|
1494
|
-
<col align="left" valign="top">
|
1495
|
-
<tbody><tr>
|
1496
|
-
<td><p><span class="term"><em class="parameter"><code>ranges</code></em> :</span></p></td>
|
1497
|
-
<td>A pointer to an array of <a class="link" href="AtkText.html#AtkTextRange" title="struct AtkTextRange"><span class="type">AtkTextRange</span></a> which is
|
1498
|
-
to be freed. <span class="annotation">[<a href="http://foldoc.org/array"><span class="acronym">array</span></a>]</span>
|
1499
|
-
</td>
|
1500
|
-
</tr></tbody>
|
1501
|
-
</table></div>
|
1502
|
-
<p class="since">Since 1.3</p>
|
1503
2014
|
</div>
|
1504
2015
|
<hr>
|
1505
2016
|
<div class="refsect2">
|
1506
|
-
<a name="
|
1507
|
-
<pre class="programlisting"
|
1508
|
-
|
1509
|
-
|
1510
|
-
|
1511
|
-
|
1512
|
-
|
2017
|
+
<a name="AtkTextRectangle"></a><h3>struct AtkTextRectangle</h3>
|
2018
|
+
<pre class="programlisting">struct AtkTextRectangle {
|
2019
|
+
gint x;
|
2020
|
+
gint y;
|
2021
|
+
gint width;
|
2022
|
+
gint height;
|
2023
|
+
};
|
2024
|
+
</pre>
|
2025
|
+
<p>A structure used to store a rectangle used by AtkText.</p>
|
2026
|
+
<div class="refsect3">
|
2027
|
+
<a name="id-1.5.13.10.8.5"></a><h4>Members</h4>
|
2028
|
+
<div class="informaltable"><table width="100%" border="0">
|
2029
|
+
<colgroup>
|
2030
|
+
<col width="300px" class="struct_members_name">
|
2031
|
+
<col class="struct_members_description">
|
2032
|
+
<col width="200px" class="struct_members_annotations">
|
2033
|
+
</colgroup>
|
1513
2034
|
<tbody>
|
1514
2035
|
<tr>
|
1515
|
-
<td><p><span class="
|
1516
|
-
<td
|
1517
|
-
</td>
|
2036
|
+
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="AtkTextRectangle.x"></a>x</code></em>;</p></td>
|
2037
|
+
<td class="struct_member_description"><p>The horizontal coordinate of a rectangle</p></td>
|
2038
|
+
<td class="struct_member_annotations"> </td>
|
2039
|
+
</tr>
|
2040
|
+
<tr>
|
2041
|
+
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="AtkTextRectangle.y"></a>y</code></em>;</p></td>
|
2042
|
+
<td class="struct_member_description"><p>The vertical coordinate of a rectangle</p></td>
|
2043
|
+
<td class="struct_member_annotations"> </td>
|
1518
2044
|
</tr>
|
1519
2045
|
<tr>
|
1520
|
-
<td><p><span class="
|
1521
|
-
<td>The
|
1522
|
-
|
2046
|
+
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="AtkTextRectangle.width"></a>width</code></em>;</p></td>
|
2047
|
+
<td class="struct_member_description"><p>The width of a rectangle</p></td>
|
2048
|
+
<td class="struct_member_annotations"> </td>
|
2049
|
+
</tr>
|
2050
|
+
<tr>
|
2051
|
+
<td class="struct_member_name"><p><span class="type">gint</span> <em class="structfield"><code><a name="AtkTextRectangle.height"></a>height</code></em>;</p></td>
|
2052
|
+
<td class="struct_member_description"><p>The height of a rectangle</p></td>
|
2053
|
+
<td class="struct_member_annotations"> </td>
|
1523
2054
|
</tr>
|
1524
2055
|
</tbody>
|
1525
2056
|
</table></div>
|
1526
2057
|
</div>
|
2058
|
+
</div>
|
1527
2059
|
<hr>
|
1528
2060
|
<div class="refsect2">
|
1529
|
-
<a name="
|
1530
|
-
<
|
1531
|
-
|
1532
|
-
|
1533
|
-
|
1534
|
-
<
|
1535
|
-
|
1536
|
-
|
1537
|
-
<
|
1538
|
-
|
2061
|
+
<a name="AtkTextAttribute"></a><h3>enum AtkTextAttribute</h3>
|
2062
|
+
<p>Describes the text attributes supported</p>
|
2063
|
+
<div class="refsect3">
|
2064
|
+
<a name="id-1.5.13.10.9.4"></a><h4>Members</h4>
|
2065
|
+
<div class="informaltable"><table width="100%" border="0">
|
2066
|
+
<colgroup>
|
2067
|
+
<col width="300px" class="enum_members_name">
|
2068
|
+
<col class="enum_members_description">
|
2069
|
+
<col width="200px" class="enum_members_annotations">
|
2070
|
+
</colgroup>
|
1539
2071
|
<tbody>
|
1540
2072
|
<tr>
|
1541
|
-
<td
|
1542
|
-
<td
|
2073
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-INVALID:CAPS"></a>ATK_TEXT_ATTR_INVALID</p></td>
|
2074
|
+
<td class="enum_member_description">
|
2075
|
+
<p>Invalid attribute, like bad spelling or grammar.</p>
|
1543
2076
|
</td>
|
2077
|
+
<td class="enum_member_annotations"> </td>
|
1544
2078
|
</tr>
|
1545
2079
|
<tr>
|
1546
|
-
<td
|
1547
|
-
<td>
|
1548
|
-
|
1549
|
-
|
1550
|
-
|
1551
|
-
moving or deleting a selected region can change the numbering.</td>
|
2080
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-LEFT-MARGIN:CAPS"></a>ATK_TEXT_ATTR_LEFT_MARGIN</p></td>
|
2081
|
+
<td class="enum_member_description">
|
2082
|
+
<p>The pixel width of the left margin</p>
|
2083
|
+
</td>
|
2084
|
+
<td class="enum_member_annotations"> </td>
|
1552
2085
|
</tr>
|
1553
2086
|
<tr>
|
1554
|
-
<td
|
1555
|
-
<td
|
2087
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-RIGHT-MARGIN:CAPS"></a>ATK_TEXT_ATTR_RIGHT_MARGIN</p></td>
|
2088
|
+
<td class="enum_member_description">
|
2089
|
+
<p>The pixel width of the right margin</p>
|
1556
2090
|
</td>
|
2091
|
+
<td class="enum_member_annotations"> </td>
|
1557
2092
|
</tr>
|
1558
2093
|
<tr>
|
1559
|
-
<td
|
1560
|
-
<td>
|
1561
|
-
|
2094
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-INDENT:CAPS"></a>ATK_TEXT_ATTR_INDENT</p></td>
|
2095
|
+
<td class="enum_member_description">
|
2096
|
+
<p>The number of pixels that the text is indented</p>
|
1562
2097
|
</td>
|
2098
|
+
<td class="enum_member_annotations"> </td>
|
1563
2099
|
</tr>
|
1564
2100
|
<tr>
|
1565
|
-
<td
|
1566
|
-
<td
|
1567
|
-
|
2101
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-INVISIBLE:CAPS"></a>ATK_TEXT_ATTR_INVISIBLE</p></td>
|
2102
|
+
<td class="enum_member_description">
|
2103
|
+
<p>Either "true" or "false" indicating whether text is visible or not</p>
|
2104
|
+
</td>
|
2105
|
+
<td class="enum_member_annotations"> </td>
|
1568
2106
|
</tr>
|
1569
|
-
</tbody>
|
1570
|
-
</table></div>
|
1571
|
-
</div>
|
1572
|
-
<hr>
|
1573
|
-
<div class="refsect2">
|
1574
|
-
<a name="atk-text-add-selection"></a><h3>atk_text_add_selection ()</h3>
|
1575
|
-
<pre class="programlisting"><span class="returnvalue">gboolean</span> atk_text_add_selection (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
1576
|
-
<em class="parameter"><code><span class="type">gint</span> start_offset</code></em>,
|
1577
|
-
<em class="parameter"><code><span class="type">gint</span> end_offset</code></em>);</pre>
|
1578
|
-
<p>
|
1579
|
-
Adds a selection bounded by the specified offsets.
|
1580
|
-
</p>
|
1581
|
-
<div class="variablelist"><table border="0">
|
1582
|
-
<col align="left" valign="top">
|
1583
|
-
<tbody>
|
1584
2107
|
<tr>
|
1585
|
-
<td
|
1586
|
-
<td
|
2108
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-EDITABLE:CAPS"></a>ATK_TEXT_ATTR_EDITABLE</p></td>
|
2109
|
+
<td class="enum_member_description">
|
2110
|
+
<p>Either "true" or "false" indicating whether text is editable or not</p>
|
1587
2111
|
</td>
|
2112
|
+
<td class="enum_member_annotations"> </td>
|
1588
2113
|
</tr>
|
1589
2114
|
<tr>
|
1590
|
-
<td
|
1591
|
-
<td
|
2115
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-PIXELS-ABOVE-LINES:CAPS"></a>ATK_TEXT_ATTR_PIXELS_ABOVE_LINES</p></td>
|
2116
|
+
<td class="enum_member_description">
|
2117
|
+
<p>Pixels of blank space to leave above each newline-terminated line. </p>
|
2118
|
+
</td>
|
2119
|
+
<td class="enum_member_annotations"> </td>
|
1592
2120
|
</tr>
|
1593
2121
|
<tr>
|
1594
|
-
<td
|
1595
|
-
<td
|
2122
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-PIXELS-BELOW-LINES:CAPS"></a>ATK_TEXT_ATTR_PIXELS_BELOW_LINES</p></td>
|
2123
|
+
<td class="enum_member_description">
|
2124
|
+
<p>Pixels of blank space to leave below each newline-terminated line.</p>
|
2125
|
+
</td>
|
2126
|
+
<td class="enum_member_annotations"> </td>
|
1596
2127
|
</tr>
|
1597
2128
|
<tr>
|
1598
|
-
<td
|
1599
|
-
<td>
|
1600
|
-
<
|
2129
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-PIXELS-INSIDE-WRAP:CAPS"></a>ATK_TEXT_ATTR_PIXELS_INSIDE_WRAP</p></td>
|
2130
|
+
<td class="enum_member_description">
|
2131
|
+
<p>Pixels of blank space to leave between wrapped lines inside the same newline-terminated line (paragraph).</p>
|
2132
|
+
</td>
|
2133
|
+
<td class="enum_member_annotations"> </td>
|
1601
2134
|
</tr>
|
1602
|
-
</tbody>
|
1603
|
-
</table></div>
|
1604
|
-
</div>
|
1605
|
-
<hr>
|
1606
|
-
<div class="refsect2">
|
1607
|
-
<a name="atk-text-remove-selection"></a><h3>atk_text_remove_selection ()</h3>
|
1608
|
-
<pre class="programlisting"><span class="returnvalue">gboolean</span> atk_text_remove_selection (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
1609
|
-
<em class="parameter"><code><span class="type">gint</span> selection_num</code></em>);</pre>
|
1610
|
-
<p>
|
1611
|
-
Removes the specified selection.
|
1612
|
-
</p>
|
1613
|
-
<div class="variablelist"><table border="0">
|
1614
|
-
<col align="left" valign="top">
|
1615
|
-
<tbody>
|
1616
2135
|
<tr>
|
1617
|
-
<td
|
1618
|
-
<td
|
2136
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-BG-FULL-HEIGHT:CAPS"></a>ATK_TEXT_ATTR_BG_FULL_HEIGHT</p></td>
|
2137
|
+
<td class="enum_member_description">
|
2138
|
+
<p>"true" or "false" whether to make the background color for each character the height of the highest font used on the current line, or the height of the font used for the current character.</p>
|
1619
2139
|
</td>
|
2140
|
+
<td class="enum_member_annotations"> </td>
|
1620
2141
|
</tr>
|
1621
2142
|
<tr>
|
1622
|
-
<td
|
1623
|
-
<td>
|
1624
|
-
|
1625
|
-
|
1626
|
-
|
1627
|
-
moving or deleting a selected region can change the numbering.</td>
|
2143
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-RISE:CAPS"></a>ATK_TEXT_ATTR_RISE</p></td>
|
2144
|
+
<td class="enum_member_description">
|
2145
|
+
<p>Number of pixels that the characters are risen above the baseline</p>
|
2146
|
+
</td>
|
2147
|
+
<td class="enum_member_annotations"> </td>
|
1628
2148
|
</tr>
|
1629
2149
|
<tr>
|
1630
|
-
<td
|
1631
|
-
<td>
|
1632
|
-
<
|
2150
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-UNDERLINE:CAPS"></a>ATK_TEXT_ATTR_UNDERLINE</p></td>
|
2151
|
+
<td class="enum_member_description">
|
2152
|
+
<p>"none", "single", "double", "low", or "error"</p>
|
2153
|
+
</td>
|
2154
|
+
<td class="enum_member_annotations"> </td>
|
1633
2155
|
</tr>
|
1634
|
-
</tbody>
|
1635
|
-
</table></div>
|
1636
|
-
</div>
|
1637
|
-
<hr>
|
1638
|
-
<div class="refsect2">
|
1639
|
-
<a name="atk-text-set-selection"></a><h3>atk_text_set_selection ()</h3>
|
1640
|
-
<pre class="programlisting"><span class="returnvalue">gboolean</span> atk_text_set_selection (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
1641
|
-
<em class="parameter"><code><span class="type">gint</span> selection_num</code></em>,
|
1642
|
-
<em class="parameter"><code><span class="type">gint</span> start_offset</code></em>,
|
1643
|
-
<em class="parameter"><code><span class="type">gint</span> end_offset</code></em>);</pre>
|
1644
|
-
<p>
|
1645
|
-
Changes the start and end offset of the specified selection.
|
1646
|
-
</p>
|
1647
|
-
<div class="variablelist"><table border="0">
|
1648
|
-
<col align="left" valign="top">
|
1649
|
-
<tbody>
|
1650
2156
|
<tr>
|
1651
|
-
<td
|
1652
|
-
<td
|
2157
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-STRIKETHROUGH:CAPS"></a>ATK_TEXT_ATTR_STRIKETHROUGH</p></td>
|
2158
|
+
<td class="enum_member_description">
|
2159
|
+
<p>"true" or "false" whether the text is strikethrough </p>
|
1653
2160
|
</td>
|
2161
|
+
<td class="enum_member_annotations"> </td>
|
1654
2162
|
</tr>
|
1655
2163
|
<tr>
|
1656
|
-
<td
|
1657
|
-
<td>
|
1658
|
-
|
1659
|
-
|
1660
|
-
|
1661
|
-
moving or deleting a selected region can change the numbering.</td>
|
2164
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-SIZE:CAPS"></a>ATK_TEXT_ATTR_SIZE</p></td>
|
2165
|
+
<td class="enum_member_description">
|
2166
|
+
<p>The size of the characters in points. eg: 10</p>
|
2167
|
+
</td>
|
2168
|
+
<td class="enum_member_annotations"> </td>
|
1662
2169
|
</tr>
|
1663
2170
|
<tr>
|
1664
|
-
<td
|
1665
|
-
<td
|
2171
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-SCALE:CAPS"></a>ATK_TEXT_ATTR_SCALE</p></td>
|
2172
|
+
<td class="enum_member_description">
|
2173
|
+
<p>The scale of the characters. The value is a string representation of a double </p>
|
2174
|
+
</td>
|
2175
|
+
<td class="enum_member_annotations"> </td>
|
1666
2176
|
</tr>
|
1667
2177
|
<tr>
|
1668
|
-
<td
|
1669
|
-
<td>
|
1670
|
-
the
|
2178
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-WEIGHT:CAPS"></a>ATK_TEXT_ATTR_WEIGHT</p></td>
|
2179
|
+
<td class="enum_member_description">
|
2180
|
+
<p>The weight of the characters.</p>
|
2181
|
+
</td>
|
2182
|
+
<td class="enum_member_annotations"> </td>
|
1671
2183
|
</tr>
|
1672
2184
|
<tr>
|
1673
|
-
<td
|
1674
|
-
<td>
|
1675
|
-
<
|
2185
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-LANGUAGE:CAPS"></a>ATK_TEXT_ATTR_LANGUAGE</p></td>
|
2186
|
+
<td class="enum_member_description">
|
2187
|
+
<p>The language used</p>
|
2188
|
+
</td>
|
2189
|
+
<td class="enum_member_annotations"> </td>
|
1676
2190
|
</tr>
|
1677
|
-
</tbody>
|
1678
|
-
</table></div>
|
1679
|
-
</div>
|
1680
|
-
<hr>
|
1681
|
-
<div class="refsect2">
|
1682
|
-
<a name="atk-text-set-caret-offset"></a><h3>atk_text_set_caret_offset ()</h3>
|
1683
|
-
<pre class="programlisting"><span class="returnvalue">gboolean</span> atk_text_set_caret_offset (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
1684
|
-
<em class="parameter"><code><span class="type">gint</span> offset</code></em>);</pre>
|
1685
|
-
<p>
|
1686
|
-
Sets the caret (cursor) position to the specified <em class="parameter"><code>offset</code></em>.
|
1687
|
-
</p>
|
1688
|
-
<div class="variablelist"><table border="0">
|
1689
|
-
<col align="left" valign="top">
|
1690
|
-
<tbody>
|
1691
2191
|
<tr>
|
1692
|
-
<td
|
1693
|
-
<td
|
2192
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-FAMILY-NAME:CAPS"></a>ATK_TEXT_ATTR_FAMILY_NAME</p></td>
|
2193
|
+
<td class="enum_member_description">
|
2194
|
+
<p>The font family name</p>
|
1694
2195
|
</td>
|
2196
|
+
<td class="enum_member_annotations"> </td>
|
1695
2197
|
</tr>
|
1696
2198
|
<tr>
|
1697
|
-
<td
|
1698
|
-
<td>
|
2199
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-BG-COLOR:CAPS"></a>ATK_TEXT_ATTR_BG_COLOR</p></td>
|
2200
|
+
<td class="enum_member_description">
|
2201
|
+
<p>The background color. The value is an RGB value of the format "<code class="literal">u</code>,<code class="literal">u</code>,<code class="literal">u</code>"</p>
|
2202
|
+
</td>
|
2203
|
+
<td class="enum_member_annotations"> </td>
|
1699
2204
|
</tr>
|
1700
2205
|
<tr>
|
1701
|
-
<td
|
1702
|
-
<td>
|
1703
|
-
<code class="literal">
|
2206
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-FG-COLOR:CAPS"></a>ATK_TEXT_ATTR_FG_COLOR</p></td>
|
2207
|
+
<td class="enum_member_description">
|
2208
|
+
<p>The foreground color. The value is an RGB value of the format "<code class="literal">u</code>,<code class="literal">u</code>,<code class="literal">u</code>"</p>
|
2209
|
+
</td>
|
2210
|
+
<td class="enum_member_annotations"> </td>
|
1704
2211
|
</tr>
|
1705
|
-
</tbody>
|
1706
|
-
</table></div>
|
1707
|
-
</div>
|
1708
|
-
<hr>
|
1709
|
-
<div class="refsect2">
|
1710
|
-
<a name="atk-attribute-set-free"></a><h3>atk_attribute_set_free ()</h3>
|
1711
|
-
<pre class="programlisting"><span class="returnvalue">void</span> atk_attribute_set_free (<em class="parameter"><code><a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> *attrib_set</code></em>);</pre>
|
1712
|
-
<p>
|
1713
|
-
Frees the memory used by an <a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a>, including all its
|
1714
|
-
<a href="AtkText.html#AtkAttribute"><span class="type">AtkAttributes</span></a>.
|
1715
|
-
</p>
|
1716
|
-
<div class="variablelist"><table border="0">
|
1717
|
-
<col align="left" valign="top">
|
1718
|
-
<tbody><tr>
|
1719
|
-
<td><p><span class="term"><em class="parameter"><code>attrib_set</code></em> :</span></p></td>
|
1720
|
-
<td>The <a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> to free</td>
|
1721
|
-
</tr></tbody>
|
1722
|
-
</table></div>
|
1723
|
-
</div>
|
1724
|
-
<hr>
|
1725
|
-
<div class="refsect2">
|
1726
|
-
<a name="atk-text-attribute-register"></a><h3>atk_text_attribute_register ()</h3>
|
1727
|
-
<pre class="programlisting"><a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="returnvalue">AtkTextAttribute</span></a> atk_text_attribute_register (<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
|
1728
|
-
<p>
|
1729
|
-
Associate <em class="parameter"><code>name</code></em> with a new <a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a>
|
1730
|
-
</p>
|
1731
|
-
<div class="variablelist"><table border="0">
|
1732
|
-
<col align="left" valign="top">
|
1733
|
-
<tbody>
|
1734
2212
|
<tr>
|
1735
|
-
<td
|
1736
|
-
<td
|
2213
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-BG-STIPPLE:CAPS"></a>ATK_TEXT_ATTR_BG_STIPPLE</p></td>
|
2214
|
+
<td class="enum_member_description">
|
2215
|
+
<p>"true" if a <span class="type">GdkBitmap</span> is set for stippling the background color.</p>
|
2216
|
+
</td>
|
2217
|
+
<td class="enum_member_annotations"> </td>
|
1737
2218
|
</tr>
|
1738
2219
|
<tr>
|
1739
|
-
<td
|
1740
|
-
<td
|
2220
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-FG-STIPPLE:CAPS"></a>ATK_TEXT_ATTR_FG_STIPPLE</p></td>
|
2221
|
+
<td class="enum_member_description">
|
2222
|
+
<p>"true" if a <span class="type">GdkBitmap</span> is set for stippling the foreground color.</p>
|
1741
2223
|
</td>
|
2224
|
+
<td class="enum_member_annotations"> </td>
|
1742
2225
|
</tr>
|
1743
|
-
</tbody>
|
1744
|
-
</table></div>
|
1745
|
-
</div>
|
1746
|
-
<hr>
|
1747
|
-
<div class="refsect2">
|
1748
|
-
<a name="atk-text-attribute-get-name"></a><h3>atk_text_attribute_get_name ()</h3>
|
1749
|
-
<pre class="programlisting">const <span class="returnvalue">gchar</span> * atk_text_attribute_get_name (<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a> attr</code></em>);</pre>
|
1750
|
-
<p>
|
1751
|
-
Gets the name corresponding to the <a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a>
|
1752
|
-
</p>
|
1753
|
-
<div class="variablelist"><table border="0">
|
1754
|
-
<col align="left" valign="top">
|
1755
|
-
<tbody>
|
1756
2226
|
<tr>
|
1757
|
-
<td
|
1758
|
-
<td
|
2227
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-WRAP-MODE:CAPS"></a>ATK_TEXT_ATTR_WRAP_MODE</p></td>
|
2228
|
+
<td class="enum_member_description">
|
2229
|
+
<p>The wrap mode of the text, if any. Values are "none", "char", "word", or "word_char".</p>
|
2230
|
+
</td>
|
2231
|
+
<td class="enum_member_annotations"> </td>
|
1759
2232
|
</tr>
|
1760
2233
|
<tr>
|
1761
|
-
<td
|
1762
|
-
<td
|
2234
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-DIRECTION:CAPS"></a>ATK_TEXT_ATTR_DIRECTION</p></td>
|
2235
|
+
<td class="enum_member_description">
|
2236
|
+
<p>The direction of the text, if set. Values are "none", "ltr" or "rtl" </p>
|
2237
|
+
</td>
|
2238
|
+
<td class="enum_member_annotations"> </td>
|
1763
2239
|
</tr>
|
1764
|
-
</tbody>
|
1765
|
-
</table></div>
|
1766
|
-
</div>
|
1767
|
-
<hr>
|
1768
|
-
<div class="refsect2">
|
1769
|
-
<a name="atk-text-attribute-for-name"></a><h3>atk_text_attribute_for_name ()</h3>
|
1770
|
-
<pre class="programlisting"><a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="returnvalue">AtkTextAttribute</span></a> atk_text_attribute_for_name (<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
|
1771
|
-
<p>
|
1772
|
-
Get the <a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a> type corresponding to a text attribute name.
|
1773
|
-
</p>
|
1774
|
-
<div class="variablelist"><table border="0">
|
1775
|
-
<col align="left" valign="top">
|
1776
|
-
<tbody>
|
1777
2240
|
<tr>
|
1778
|
-
<td
|
1779
|
-
<td
|
2241
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-JUSTIFICATION:CAPS"></a>ATK_TEXT_ATTR_JUSTIFICATION</p></td>
|
2242
|
+
<td class="enum_member_description">
|
2243
|
+
<p>The justification of the text, if set. Values are "left", "right", "center" or "fill" </p>
|
2244
|
+
</td>
|
2245
|
+
<td class="enum_member_annotations"> </td>
|
1780
2246
|
</tr>
|
1781
2247
|
<tr>
|
1782
|
-
<td
|
1783
|
-
<td
|
1784
|
-
|
1785
|
-
|
2248
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-STRETCH:CAPS"></a>ATK_TEXT_ATTR_STRETCH</p></td>
|
2249
|
+
<td class="enum_member_description">
|
2250
|
+
<p>The stretch of the text, if set. Values are "ultra_condensed", "extra_condensed", "condensed", "semi_condensed", "normal", "semi_expanded", "expanded", "extra_expanded" or "ultra_expanded"</p>
|
2251
|
+
</td>
|
2252
|
+
<td class="enum_member_annotations"> </td>
|
1786
2253
|
</tr>
|
1787
|
-
</tbody>
|
1788
|
-
</table></div>
|
1789
|
-
</div>
|
1790
|
-
<hr>
|
1791
|
-
<div class="refsect2">
|
1792
|
-
<a name="atk-text-attribute-get-value"></a><h3>atk_text_attribute_get_value ()</h3>
|
1793
|
-
<pre class="programlisting">const <span class="returnvalue">gchar</span> * atk_text_attribute_get_value (<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a> attr</code></em>,
|
1794
|
-
<em class="parameter"><code><span class="type">gint</span> index_</code></em>);</pre>
|
1795
|
-
<p>
|
1796
|
-
Gets the value for the index of the <a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a>
|
1797
|
-
</p>
|
1798
|
-
<div class="variablelist"><table border="0">
|
1799
|
-
<col align="left" valign="top">
|
1800
|
-
<tbody>
|
1801
2254
|
<tr>
|
1802
|
-
<td
|
1803
|
-
<td
|
2255
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-VARIANT:CAPS"></a>ATK_TEXT_ATTR_VARIANT</p></td>
|
2256
|
+
<td class="enum_member_description">
|
2257
|
+
<p>The capitalization variant of the text, if set. Values are "normal" or "small_caps"</p>
|
2258
|
+
</td>
|
2259
|
+
<td class="enum_member_annotations"> </td>
|
1804
2260
|
</tr>
|
1805
2261
|
<tr>
|
1806
|
-
<td
|
1807
|
-
<td
|
2262
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-STYLE:CAPS"></a>ATK_TEXT_ATTR_STYLE</p></td>
|
2263
|
+
<td class="enum_member_description">
|
2264
|
+
<p>The slant style of the text, if set. Values are "normal", "oblique" or "italic"</p>
|
2265
|
+
</td>
|
2266
|
+
<td class="enum_member_annotations"> </td>
|
1808
2267
|
</tr>
|
1809
2268
|
<tr>
|
1810
|
-
<td
|
1811
|
-
<td>
|
1812
|
-
|
2269
|
+
<td class="enum_member_name"><p><a name="ATK-TEXT-ATTR-LAST-DEFINED:CAPS"></a>ATK_TEXT_ATTR_LAST_DEFINED</p></td>
|
2270
|
+
<td class="enum_member_description">
|
2271
|
+
<p>not a valid text attribute, used for finding end of enumeration</p>
|
2272
|
+
</td>
|
2273
|
+
<td class="enum_member_annotations"> </td>
|
1813
2274
|
</tr>
|
1814
2275
|
</tbody>
|
1815
2276
|
</table></div>
|
1816
2277
|
</div>
|
1817
2278
|
</div>
|
2279
|
+
</div>
|
1818
2280
|
<div class="refsect1">
|
1819
2281
|
<a name="AtkText.signal-details"></a><h2>Signal Details</h2>
|
1820
2282
|
<div class="refsect2">
|
1821
|
-
<a name="AtkText-text-attributes-changed"></a><h3>The <code class="literal"
|
1822
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
1823
|
-
|
1824
|
-
<
|
1825
|
-
The "text-attributes-changed" signal is emitted when the text
|
2283
|
+
<a name="AtkText-text-attributes-changed"></a><h3>The <code class="literal">“text-attributes-changed”</code> signal</h3>
|
2284
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
2285
|
+
user_function (<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *atktext,
|
2286
|
+
<span class="type">gpointer</span> user_data)</pre>
|
2287
|
+
<p>The "text-attributes-changed" signal is emitted when the text
|
1826
2288
|
attributes of the text of an object which implements AtkText
|
1827
|
-
changes
|
1828
|
-
|
1829
|
-
<
|
1830
|
-
<
|
2289
|
+
changes.</p>
|
2290
|
+
<div class="refsect3">
|
2291
|
+
<a name="id-1.5.13.11.2.5"></a><h4>Parameters</h4>
|
2292
|
+
<div class="informaltable"><table width="100%" border="0">
|
2293
|
+
<colgroup>
|
2294
|
+
<col width="150px" class="parameters_name">
|
2295
|
+
<col class="parameters_description">
|
2296
|
+
<col width="200px" class="parameters_annotations">
|
2297
|
+
</colgroup>
|
1831
2298
|
<tbody>
|
1832
2299
|
<tr>
|
1833
|
-
<td
|
1834
|
-
<td>the object which received the signal.</td>
|
2300
|
+
<td class="parameter_name"><p>atktext</p></td>
|
2301
|
+
<td class="parameter_description"><p>the object which received the signal.</p></td>
|
2302
|
+
<td class="parameter_annotations"> </td>
|
1835
2303
|
</tr>
|
1836
2304
|
<tr>
|
1837
|
-
<td
|
1838
|
-
<td>user data set when the signal handler was connected.</td>
|
2305
|
+
<td class="parameter_name"><p>user_data</p></td>
|
2306
|
+
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
2307
|
+
<td class="parameter_annotations"> </td>
|
1839
2308
|
</tr>
|
1840
2309
|
</tbody>
|
1841
2310
|
</table></div>
|
1842
2311
|
</div>
|
2312
|
+
<p>Flags: Run Last</p>
|
2313
|
+
</div>
|
1843
2314
|
<hr>
|
1844
2315
|
<div class="refsect2">
|
1845
|
-
<a name="AtkText-text-caret-moved"></a><h3>The <code class="literal"
|
1846
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
1847
|
-
|
1848
|
-
|
1849
|
-
<
|
1850
|
-
The "text-caret-moved" signal is emitted when the caret
|
2316
|
+
<a name="AtkText-text-caret-moved"></a><h3>The <code class="literal">“text-caret-moved”</code> signal</h3>
|
2317
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
2318
|
+
user_function (<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *atktext,
|
2319
|
+
<span class="type">gint</span> arg1,
|
2320
|
+
<span class="type">gpointer</span> user_data)</pre>
|
2321
|
+
<p>The "text-caret-moved" signal is emitted when the caret
|
1851
2322
|
position of the text of an object which implements AtkText
|
1852
|
-
changes
|
1853
|
-
|
1854
|
-
<
|
1855
|
-
<
|
2323
|
+
changes.</p>
|
2324
|
+
<div class="refsect3">
|
2325
|
+
<a name="id-1.5.13.11.3.5"></a><h4>Parameters</h4>
|
2326
|
+
<div class="informaltable"><table width="100%" border="0">
|
2327
|
+
<colgroup>
|
2328
|
+
<col width="150px" class="parameters_name">
|
2329
|
+
<col class="parameters_description">
|
2330
|
+
<col width="200px" class="parameters_annotations">
|
2331
|
+
</colgroup>
|
1856
2332
|
<tbody>
|
1857
2333
|
<tr>
|
1858
|
-
<td
|
1859
|
-
<td>the object which received the signal.</td>
|
2334
|
+
<td class="parameter_name"><p>atktext</p></td>
|
2335
|
+
<td class="parameter_description"><p>the object which received the signal.</p></td>
|
2336
|
+
<td class="parameter_annotations"> </td>
|
1860
2337
|
</tr>
|
1861
2338
|
<tr>
|
1862
|
-
<td
|
1863
|
-
<td>The new position of the text caret.</td>
|
2339
|
+
<td class="parameter_name"><p>arg1</p></td>
|
2340
|
+
<td class="parameter_description"><p>The new position of the text caret.</p></td>
|
2341
|
+
<td class="parameter_annotations"> </td>
|
1864
2342
|
</tr>
|
1865
2343
|
<tr>
|
1866
|
-
<td
|
1867
|
-
<td>user data set when the signal handler was connected.</td>
|
2344
|
+
<td class="parameter_name"><p>user_data</p></td>
|
2345
|
+
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
2346
|
+
<td class="parameter_annotations"> </td>
|
1868
2347
|
</tr>
|
1869
2348
|
</tbody>
|
1870
2349
|
</table></div>
|
1871
2350
|
</div>
|
2351
|
+
<p>Flags: Run Last</p>
|
2352
|
+
</div>
|
1872
2353
|
<hr>
|
1873
2354
|
<div class="refsect2">
|
1874
|
-
<a name="AtkText-text-changed"></a><h3>The <code class="literal"
|
1875
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
1876
|
-
|
1877
|
-
|
1878
|
-
|
1879
|
-
<
|
1880
|
-
<
|
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>
|
1884
|
-
<p>
|
1885
|
-
The "text-changed" signal is emitted when the text of the
|
2355
|
+
<a name="AtkText-text-changed"></a><h3>The <code class="literal">“text-changed”</code> signal</h3>
|
2356
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
2357
|
+
user_function (<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *atktext,
|
2358
|
+
<span class="type">gint</span> arg1,
|
2359
|
+
<span class="type">gint</span> arg2,
|
2360
|
+
<span class="type">gpointer</span> user_data)</pre>
|
2361
|
+
<p>The "text-changed" signal is emitted when the text of the
|
1886
2362
|
object which implements the AtkText interface changes, This
|
1887
2363
|
signal will have a detail which is either "insert" or
|
1888
2364
|
"delete" which identifies whether the text change was an
|
1889
|
-
insertion or a deletion
|
1890
|
-
|
1891
|
-
<
|
1892
|
-
<
|
2365
|
+
insertion or a deletion.</p>
|
2366
|
+
<div class="warning">
|
2367
|
+
<p><code class="literal">AtkText::text-changed</code> is deprecated and should not be used in newly-written code.</p>
|
2368
|
+
<p>Since 2.9.4. Use <span class="type">“text-insert”</span> or
|
2369
|
+
<span class="type">“text-remove”</span> instead.</p>
|
2370
|
+
</div>
|
2371
|
+
<div class="refsect3">
|
2372
|
+
<a name="id-1.5.13.11.4.6"></a><h4>Parameters</h4>
|
2373
|
+
<div class="informaltable"><table width="100%" border="0">
|
2374
|
+
<colgroup>
|
2375
|
+
<col width="150px" class="parameters_name">
|
2376
|
+
<col class="parameters_description">
|
2377
|
+
<col width="200px" class="parameters_annotations">
|
2378
|
+
</colgroup>
|
1893
2379
|
<tbody>
|
1894
2380
|
<tr>
|
1895
|
-
<td
|
1896
|
-
<td>the object which received the signal.</td>
|
2381
|
+
<td class="parameter_name"><p>atktext</p></td>
|
2382
|
+
<td class="parameter_description"><p>the object which received the signal.</p></td>
|
2383
|
+
<td class="parameter_annotations"> </td>
|
1897
2384
|
</tr>
|
1898
2385
|
<tr>
|
1899
|
-
<td
|
1900
|
-
<td>The position (character offset) of the insertion or deletion.</td>
|
2386
|
+
<td class="parameter_name"><p>arg1</p></td>
|
2387
|
+
<td class="parameter_description"><p>The position (character offset) of the insertion or deletion.</p></td>
|
2388
|
+
<td class="parameter_annotations"> </td>
|
1901
2389
|
</tr>
|
1902
2390
|
<tr>
|
1903
|
-
<td
|
1904
|
-
<td>The length (in characters) of text inserted or deleted.</td>
|
2391
|
+
<td class="parameter_name"><p>arg2</p></td>
|
2392
|
+
<td class="parameter_description"><p>The length (in characters) of text inserted or deleted.</p></td>
|
2393
|
+
<td class="parameter_annotations"> </td>
|
1905
2394
|
</tr>
|
1906
2395
|
<tr>
|
1907
|
-
<td
|
1908
|
-
<td>user data set when the signal handler was connected.</td>
|
2396
|
+
<td class="parameter_name"><p>user_data</p></td>
|
2397
|
+
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
2398
|
+
<td class="parameter_annotations"> </td>
|
1909
2399
|
</tr>
|
1910
2400
|
</tbody>
|
1911
2401
|
</table></div>
|
1912
2402
|
</div>
|
2403
|
+
<p>Flags: Has Details</p>
|
2404
|
+
</div>
|
1913
2405
|
<hr>
|
1914
2406
|
<div class="refsect2">
|
1915
|
-
<a name="AtkText-text-insert"></a><h3>The <code class="literal"
|
1916
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
1917
|
-
|
1918
|
-
|
1919
|
-
|
1920
|
-
|
1921
|
-
<
|
1922
|
-
The "text-insert" signal is emitted when a new text is
|
1923
|
-
inserted.
|
1924
|
-
|
1925
|
-
|
1926
|
-
<
|
2407
|
+
<a name="AtkText-text-insert"></a><h3>The <code class="literal">“text-insert”</code> signal</h3>
|
2408
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
2409
|
+
user_function (<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *atktext,
|
2410
|
+
<span class="type">gint</span> arg1,
|
2411
|
+
<span class="type">gint</span> arg2,
|
2412
|
+
<span class="type">gchar</span> *arg3,
|
2413
|
+
<span class="type">gpointer</span> user_data)</pre>
|
2414
|
+
<p>The "text-insert" signal is emitted when a new text is
|
2415
|
+
inserted. If the signal was not triggered by the user
|
2416
|
+
(e.g. typing or pasting text), the "system" detail should be
|
2417
|
+
included.</p>
|
2418
|
+
<div class="refsect3">
|
2419
|
+
<a name="id-1.5.13.11.5.5"></a><h4>Parameters</h4>
|
2420
|
+
<div class="informaltable"><table width="100%" border="0">
|
2421
|
+
<colgroup>
|
2422
|
+
<col width="150px" class="parameters_name">
|
2423
|
+
<col class="parameters_description">
|
2424
|
+
<col width="200px" class="parameters_annotations">
|
2425
|
+
</colgroup>
|
1927
2426
|
<tbody>
|
1928
2427
|
<tr>
|
1929
|
-
<td
|
1930
|
-
<td>the object which received the signal.</td>
|
2428
|
+
<td class="parameter_name"><p>atktext</p></td>
|
2429
|
+
<td class="parameter_description"><p>the object which received the signal.</p></td>
|
2430
|
+
<td class="parameter_annotations"> </td>
|
1931
2431
|
</tr>
|
1932
2432
|
<tr>
|
1933
|
-
<td
|
1934
|
-
<td>The position (character offset) of the insertion.</td>
|
2433
|
+
<td class="parameter_name"><p>arg1</p></td>
|
2434
|
+
<td class="parameter_description"><p>The position (character offset) of the insertion.</p></td>
|
2435
|
+
<td class="parameter_annotations"> </td>
|
1935
2436
|
</tr>
|
1936
2437
|
<tr>
|
1937
|
-
<td
|
1938
|
-
<td>The length (in characters) of text inserted.</td>
|
2438
|
+
<td class="parameter_name"><p>arg2</p></td>
|
2439
|
+
<td class="parameter_description"><p>The length (in characters) of text inserted.</p></td>
|
2440
|
+
<td class="parameter_annotations"> </td>
|
1939
2441
|
</tr>
|
1940
2442
|
<tr>
|
1941
|
-
<td
|
1942
|
-
<td>The new text inserted</td>
|
2443
|
+
<td class="parameter_name"><p>arg3</p></td>
|
2444
|
+
<td class="parameter_description"><p>The new text inserted</p></td>
|
2445
|
+
<td class="parameter_annotations"> </td>
|
1943
2446
|
</tr>
|
1944
2447
|
<tr>
|
1945
|
-
<td
|
1946
|
-
<td>user data set when the signal handler was connected.</td>
|
2448
|
+
<td class="parameter_name"><p>user_data</p></td>
|
2449
|
+
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
2450
|
+
<td class="parameter_annotations"> </td>
|
1947
2451
|
</tr>
|
1948
2452
|
</tbody>
|
1949
2453
|
</table></div>
|
1950
2454
|
</div>
|
2455
|
+
<p>Flags: Has Details</p>
|
2456
|
+
</div>
|
1951
2457
|
<hr>
|
1952
2458
|
<div class="refsect2">
|
1953
|
-
<a name="AtkText-text-remove"></a><h3>The <code class="literal"
|
1954
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
1955
|
-
|
1956
|
-
|
1957
|
-
|
1958
|
-
|
1959
|
-
<
|
1960
|
-
The "text-remove" signal is emitted when a new text is
|
1961
|
-
removed.
|
1962
|
-
|
1963
|
-
|
1964
|
-
<
|
2459
|
+
<a name="AtkText-text-remove"></a><h3>The <code class="literal">“text-remove”</code> signal</h3>
|
2460
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
2461
|
+
user_function (<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *atktext,
|
2462
|
+
<span class="type">gint</span> arg1,
|
2463
|
+
<span class="type">gint</span> arg2,
|
2464
|
+
<span class="type">gchar</span> *arg3,
|
2465
|
+
<span class="type">gpointer</span> user_data)</pre>
|
2466
|
+
<p>The "text-remove" signal is emitted when a new text is
|
2467
|
+
removed. If the signal was not triggered by the user
|
2468
|
+
(e.g. typing or pasting text), the "system" detail should be
|
2469
|
+
included.</p>
|
2470
|
+
<div class="refsect3">
|
2471
|
+
<a name="id-1.5.13.11.6.5"></a><h4>Parameters</h4>
|
2472
|
+
<div class="informaltable"><table width="100%" border="0">
|
2473
|
+
<colgroup>
|
2474
|
+
<col width="150px" class="parameters_name">
|
2475
|
+
<col class="parameters_description">
|
2476
|
+
<col width="200px" class="parameters_annotations">
|
2477
|
+
</colgroup>
|
1965
2478
|
<tbody>
|
1966
2479
|
<tr>
|
1967
|
-
<td
|
1968
|
-
<td>the object which received the signal.</td>
|
2480
|
+
<td class="parameter_name"><p>atktext</p></td>
|
2481
|
+
<td class="parameter_description"><p>the object which received the signal.</p></td>
|
2482
|
+
<td class="parameter_annotations"> </td>
|
1969
2483
|
</tr>
|
1970
2484
|
<tr>
|
1971
|
-
<td
|
1972
|
-
<td>The position (character offset) of the removal.</td>
|
2485
|
+
<td class="parameter_name"><p>arg1</p></td>
|
2486
|
+
<td class="parameter_description"><p>The position (character offset) of the removal.</p></td>
|
2487
|
+
<td class="parameter_annotations"> </td>
|
1973
2488
|
</tr>
|
1974
2489
|
<tr>
|
1975
|
-
<td
|
1976
|
-
<td>The length (in characters) of text removed.</td>
|
2490
|
+
<td class="parameter_name"><p>arg2</p></td>
|
2491
|
+
<td class="parameter_description"><p>The length (in characters) of text removed.</p></td>
|
2492
|
+
<td class="parameter_annotations"> </td>
|
1977
2493
|
</tr>
|
1978
2494
|
<tr>
|
1979
|
-
<td
|
1980
|
-
<td>The old text removed</td>
|
2495
|
+
<td class="parameter_name"><p>arg3</p></td>
|
2496
|
+
<td class="parameter_description"><p>The old text removed</p></td>
|
2497
|
+
<td class="parameter_annotations"> </td>
|
1981
2498
|
</tr>
|
1982
2499
|
<tr>
|
1983
|
-
<td
|
1984
|
-
<td>user data set when the signal handler was connected.</td>
|
2500
|
+
<td class="parameter_name"><p>user_data</p></td>
|
2501
|
+
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
2502
|
+
<td class="parameter_annotations"> </td>
|
1985
2503
|
</tr>
|
1986
2504
|
</tbody>
|
1987
2505
|
</table></div>
|
1988
2506
|
</div>
|
2507
|
+
<p>Flags: Has Details</p>
|
2508
|
+
</div>
|
1989
2509
|
<hr>
|
1990
2510
|
<div class="refsect2">
|
1991
|
-
<a name="AtkText-text-selection-changed"></a><h3>The <code class="literal"
|
1992
|
-
<pre class="programlisting"><span class="returnvalue">void</span>
|
1993
|
-
|
1994
|
-
<
|
1995
|
-
The "text-selection-changed" signal is emitted when the
|
1996
|
-
selected text of an object which implements AtkText changes
|
1997
|
-
|
1998
|
-
<
|
1999
|
-
<
|
2511
|
+
<a name="AtkText-text-selection-changed"></a><h3>The <code class="literal">“text-selection-changed”</code> signal</h3>
|
2512
|
+
<pre class="programlisting"><span class="returnvalue">void</span>
|
2513
|
+
user_function (<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *atktext,
|
2514
|
+
<span class="type">gpointer</span> user_data)</pre>
|
2515
|
+
<p>The "text-selection-changed" signal is emitted when the
|
2516
|
+
selected text of an object which implements AtkText changes.</p>
|
2517
|
+
<div class="refsect3">
|
2518
|
+
<a name="id-1.5.13.11.7.5"></a><h4>Parameters</h4>
|
2519
|
+
<div class="informaltable"><table width="100%" border="0">
|
2520
|
+
<colgroup>
|
2521
|
+
<col width="150px" class="parameters_name">
|
2522
|
+
<col class="parameters_description">
|
2523
|
+
<col width="200px" class="parameters_annotations">
|
2524
|
+
</colgroup>
|
2000
2525
|
<tbody>
|
2001
2526
|
<tr>
|
2002
|
-
<td
|
2003
|
-
<td>the object which received the signal.</td>
|
2527
|
+
<td class="parameter_name"><p>atktext</p></td>
|
2528
|
+
<td class="parameter_description"><p>the object which received the signal.</p></td>
|
2529
|
+
<td class="parameter_annotations"> </td>
|
2004
2530
|
</tr>
|
2005
2531
|
<tr>
|
2006
|
-
<td
|
2007
|
-
<td>user data set when the signal handler was connected.</td>
|
2532
|
+
<td class="parameter_name"><p>user_data</p></td>
|
2533
|
+
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
2534
|
+
<td class="parameter_annotations"> </td>
|
2008
2535
|
</tr>
|
2009
2536
|
</tbody>
|
2010
2537
|
</table></div>
|
2011
2538
|
</div>
|
2539
|
+
<p>Flags: Run Last</p>
|
2540
|
+
</div>
|
2012
2541
|
</div>
|
2013
2542
|
</div>
|
2014
2543
|
<div class="footer">
|
2015
2544
|
<hr>
|
2016
|
-
Generated by GTK-Doc V1.
|
2545
|
+
Generated by GTK-Doc V1.21.1</div>
|
2017
2546
|
</body>
|
2018
2547
|
</html>
|