atk 1.1.9-x86-mingw32 → 1.2.0-x86-mingw32
Sign up to get free protection for your applications and to get access to all the features.
- data/Rakefile +12 -1
- data/lib/1.8/atk.so +0 -0
- data/lib/1.9/atk.so +0 -0
- data/vendor/local/bin/libatk-1.0-0.dll +0 -0
- data/vendor/local/include/atk-1.0/atk/atk.h +1 -0
- data/vendor/local/include/atk-1.0/atk/atkaction.h +8 -8
- data/vendor/local/include/atk-1.0/atk/atkdocument.h +6 -6
- data/vendor/local/include/atk-1.0/atk/atkhyperlink.h +1 -0
- data/vendor/local/include/atk-1.0/atk/atkimage.h +4 -4
- data/vendor/local/include/atk-1.0/atk/atkmisc.h +24 -1
- data/vendor/local/include/atk-1.0/atk/atkobject.h +35 -7
- data/vendor/local/include/atk-1.0/atk/atkrelation.h +1 -1
- data/vendor/local/include/atk-1.0/atk/atkrelationset.h +3 -0
- data/vendor/local/include/atk-1.0/atk/atkstate.h +1 -1
- data/vendor/local/include/atk-1.0/atk/atkstreamablecontent.h +6 -6
- data/vendor/local/include/atk-1.0/atk/atktable.h +5 -8
- data/vendor/local/include/atk-1.0/atk/atktext.h +4 -2
- data/vendor/local/include/atk-1.0/atk/atkutil.h +75 -66
- data/vendor/local/include/atk-1.0/atk/atkwindow.h +54 -0
- data/vendor/local/lib/atk-1.0.def +2 -0
- data/vendor/local/lib/libatk-1.0.dll.a +0 -0
- data/vendor/local/lib/libatk-1.0.la +41 -0
- data/vendor/local/lib/pkgconfig/atk.pc +1 -1
- data/vendor/local/share/gtk-doc/html/atk/AtkAction.html +330 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkComponent.html +639 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkDocument.html +343 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkEditableText.html +328 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkGObjectAccessible.html +128 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkHyperlink.html +400 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkHypertext.html +215 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkImage.html +238 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkNoOpObject.html +109 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkNoOpObjectFactory.html +94 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkObject.html +1960 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkObjectFactory.html +166 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkRegistry.html +201 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkRelation.html +443 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkRelationSet.html +313 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkSelection.html +330 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkStateSet.html +395 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkStreamableContent.html +213 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkTable.html +1210 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkText.html +1745 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkUtil.html +743 -0
- data/vendor/local/share/gtk-doc/html/atk/AtkValue.html +216 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-12.html +51 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-13.html +31 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-18.html +31 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-20.html +35 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-22.html +45 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-24.html +31 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-26.html +31 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-28.html +31 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-3.html +41 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-30.html +39 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-32.html +30 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-4.html +35 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-1-6.html +35 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-deprecated.html +41 -0
- data/vendor/local/share/gtk-doc/html/atk/api-index-full.html +651 -0
- data/vendor/local/share/gtk-doc/html/atk/atk-AtkHyperlinkImpl.html +107 -0
- data/vendor/local/share/gtk-doc/html/atk/atk-AtkPlug.html +81 -0
- data/vendor/local/share/gtk-doc/html/atk/atk-AtkSocket.html +130 -0
- data/vendor/local/share/gtk-doc/html/atk/atk-AtkState.html +430 -0
- data/vendor/local/share/gtk-doc/html/atk/atk.devhelp2 +573 -0
- data/vendor/local/share/gtk-doc/html/atk/atk.html +121 -0
- data/vendor/local/share/gtk-doc/html/atk/home.png +0 -0
- data/vendor/local/share/gtk-doc/html/atk/index.html +136 -0
- data/vendor/local/share/gtk-doc/html/atk/index.sgml +688 -0
- data/vendor/local/share/gtk-doc/html/atk/left.png +0 -0
- data/vendor/local/share/gtk-doc/html/atk/right.png +0 -0
- data/vendor/local/share/gtk-doc/html/atk/style.css +266 -0
- data/vendor/local/share/gtk-doc/html/atk/up.png +0 -0
- data/vendor/local/share/license/atk/AUTHORS +5 -0
- data/vendor/local/share/license/atk/COPYING +482 -0
- data/vendor/local/share/locale/as/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/ast/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/be/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/bg/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/bn_IN/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/en_GB/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/eo/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/es/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/et/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/eu/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/fa/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/gu/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/he/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/hi/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/ja/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/km/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/kn/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/ml/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/nb/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/nn/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/or/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/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/sv/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/ta/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/te/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/tr/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/ug/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/uk/LC_MESSAGES/atk10.mo +0 -0
- data/vendor/local/share/locale/vi/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
- data/vendor/local/share/locale/zu/LC_MESSAGES/atk10.mo +0 -0
- metadata +65 -14
- data/vendor/local/lib/atk-1.0.lib +0 -0
- data/vendor/local/manifest/atk-dev_1.32.0-2_win32.mft +0 -37
- data/vendor/local/manifest/atk_1.32.0-2_win32.mft +0 -95
- data/vendor/local/src/dieterv/packaging/atk_1.32.0-2_win32.log +0 -740
- data/vendor/local/src/dieterv/packaging/atk_1.32.0-2_win32.sh +0 -76
@@ -0,0 +1,1745 @@
|
|
1
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
2
|
+
<html>
|
3
|
+
<head>
|
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.76.1">
|
7
|
+
<link rel="home" href="index.html" title="ATK - Accessibility Toolkit">
|
8
|
+
<link rel="up" href="atk.html" title="ATK Library">
|
9
|
+
<link rel="prev" href="AtkTable.html" title="AtkTable">
|
10
|
+
<link rel="next" href="AtkUtil.html" title="AtkUtil">
|
11
|
+
<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
|
12
|
+
<link rel="stylesheet" href="style.css" type="text/css">
|
13
|
+
</head>
|
14
|
+
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
15
|
+
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
|
16
|
+
<tr valign="middle">
|
17
|
+
<td><a accesskey="p" href="AtkTable.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
|
18
|
+
<td><a accesskey="u" href="atk.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
|
19
|
+
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
|
20
|
+
<th width="100%" align="center">ATK - Accessibility Toolkit</th>
|
21
|
+
<td><a accesskey="n" href="AtkUtil.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
|
22
|
+
</tr>
|
23
|
+
<tr><td colspan="5" class="shortcuts">
|
24
|
+
<a href="#AtkText.synopsis" class="shortcut">Top</a>
|
25
|
+
|
|
26
|
+
<a href="#AtkText.description" class="shortcut">Description</a>
|
27
|
+
|
|
28
|
+
<a href="#AtkText.object-hierarchy" class="shortcut">Object Hierarchy</a>
|
29
|
+
|
|
30
|
+
<a href="#AtkText.implementations" class="shortcut">Known Implementations</a>
|
31
|
+
|
|
32
|
+
<a href="#AtkText.signals" class="shortcut">Signals</a>
|
33
|
+
</td></tr>
|
34
|
+
</table>
|
35
|
+
<div class="refentry">
|
36
|
+
<a name="AtkText"></a><div class="titlepage"></div>
|
37
|
+
<div class="refnamediv"><table width="100%"><tr>
|
38
|
+
<td valign="top">
|
39
|
+
<h2><span class="refentrytitle"><a name="AtkText.top_of_page"></a>AtkText</span></h2>
|
40
|
+
<p>AtkText — The ATK interface implemented by components with text content.</p>
|
41
|
+
</td>
|
42
|
+
<td valign="top" align="right"></td>
|
43
|
+
</tr></table></div>
|
44
|
+
<div class="refsynopsisdiv">
|
45
|
+
<a name="AtkText.synopsis"></a><h2>Synopsis</h2>
|
46
|
+
<pre class="synopsis"> <a class="link" href="AtkText.html#AtkText-struct" title="AtkText">AtkText</a>;
|
47
|
+
enum <a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary">AtkTextBoundary</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">gint</span> <a class="link" href="AtkText.html#atk-text-get-caret-offset" title="atk_text_get_caret_offset ()">atk_text_get_caret_offset</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>);
|
75
|
+
<span class="returnvalue">void</span> <a class="link" href="AtkText.html#atk-text-get-character-extents" title="atk_text_get_character_extents ()">atk_text_get_character_extents</a> (<em class="parameter"><code><a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *text</code></em>,
|
76
|
+
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
77
|
+
<em class="parameter"><code><span class="type">gint</span> *x</code></em>,
|
78
|
+
<em class="parameter"><code><span class="type">gint</span> *y</code></em>,
|
79
|
+
<em class="parameter"><code><span class="type">gint</span> *width</code></em>,
|
80
|
+
<em class="parameter"><code><span class="type">gint</span> *height</code></em>,
|
81
|
+
<em class="parameter"><code><a class="link" href="AtkUtil.html#AtkCoordType" title="enum AtkCoordType"><span class="type">AtkCoordType</span></a> coords</code></em>);
|
82
|
+
<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>,
|
83
|
+
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
84
|
+
<em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
|
85
|
+
<em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);
|
86
|
+
<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>);
|
87
|
+
<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>);
|
88
|
+
<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>,
|
89
|
+
<em class="parameter"><code><span class="type">gint</span> x</code></em>,
|
90
|
+
<em class="parameter"><code><span class="type">gint</span> y</code></em>,
|
91
|
+
<em class="parameter"><code><a class="link" href="AtkUtil.html#AtkCoordType" title="enum AtkCoordType"><span class="type">AtkCoordType</span></a> coords</code></em>);
|
92
|
+
<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>,
|
93
|
+
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextRectangle" title="struct AtkTextRectangle"><span class="type">AtkTextRectangle</span></a> *rect</code></em>,
|
94
|
+
<em class="parameter"><code><a class="link" href="AtkUtil.html#AtkCoordType" title="enum AtkCoordType"><span class="type">AtkCoordType</span></a> coord_type</code></em>,
|
95
|
+
<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>,
|
96
|
+
<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>);
|
97
|
+
<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>,
|
98
|
+
<em class="parameter"><code><span class="type">gint</span> start_offset</code></em>,
|
99
|
+
<em class="parameter"><code><span class="type">gint</span> end_offset</code></em>,
|
100
|
+
<em class="parameter"><code><a class="link" href="AtkUtil.html#AtkCoordType" title="enum AtkCoordType"><span class="type">AtkCoordType</span></a> coord_type</code></em>,
|
101
|
+
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextRectangle" title="struct AtkTextRectangle"><span class="type">AtkTextRectangle</span></a> *rect</code></em>);
|
102
|
+
<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>);
|
103
|
+
<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>);
|
104
|
+
<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>,
|
105
|
+
<em class="parameter"><code><span class="type">gint</span> selection_num</code></em>,
|
106
|
+
<em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
|
107
|
+
<em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);
|
108
|
+
<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>,
|
109
|
+
<em class="parameter"><code><span class="type">gint</span> start_offset</code></em>,
|
110
|
+
<em class="parameter"><code><span class="type">gint</span> end_offset</code></em>);
|
111
|
+
<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>,
|
112
|
+
<em class="parameter"><code><span class="type">gint</span> selection_num</code></em>);
|
113
|
+
<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>,
|
114
|
+
<em class="parameter"><code><span class="type">gint</span> selection_num</code></em>,
|
115
|
+
<em class="parameter"><code><span class="type">gint</span> start_offset</code></em>,
|
116
|
+
<em class="parameter"><code><span class="type">gint</span> end_offset</code></em>);
|
117
|
+
<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>,
|
118
|
+
<em class="parameter"><code><span class="type">gint</span> offset</code></em>);
|
119
|
+
<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>);
|
120
|
+
<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>);
|
121
|
+
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>);
|
122
|
+
<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>);
|
123
|
+
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>,
|
124
|
+
<em class="parameter"><code><span class="type">gint</span> index_</code></em>);
|
125
|
+
</pre>
|
126
|
+
</div>
|
127
|
+
<div class="refsect1">
|
128
|
+
<a name="AtkText.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
129
|
+
<pre class="synopsis">
|
130
|
+
GInterface
|
131
|
+
+----AtkText
|
132
|
+
</pre>
|
133
|
+
</div>
|
134
|
+
<div class="refsect1">
|
135
|
+
<a name="AtkText.implementations"></a><h2>Known Implementations</h2>
|
136
|
+
<p>
|
137
|
+
AtkText is implemented by
|
138
|
+
<a class="link" href="AtkNoOpObject.html" title="AtkNoOpObject">AtkNoOpObject</a>.</p>
|
139
|
+
</div>
|
140
|
+
<div class="refsect1">
|
141
|
+
<a name="AtkText.signals"></a><h2>Signals</h2>
|
142
|
+
<pre class="synopsis">
|
143
|
+
"<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>
|
144
|
+
"<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>
|
145
|
+
"<a class="link" href="AtkText.html#AtkText-text-changed" title='The "text-changed" signal'>text-changed</a>" : <code class="literal">Has Details</code>
|
146
|
+
"<a class="link" href="AtkText.html#AtkText-text-insert" title='The "text-insert" signal'>text-insert</a>" : <code class="literal">Has Details</code>
|
147
|
+
"<a class="link" href="AtkText.html#AtkText-text-remove" title='The "text-remove" signal'>text-remove</a>" : <code class="literal">Has Details</code>
|
148
|
+
"<a class="link" href="AtkText.html#AtkText-text-selection-changed" title='The "text-selection-changed" signal'>text-selection-changed</a>" : <code class="literal">Run Last</code>
|
149
|
+
"<a class="link" href="AtkText.html#AtkText-text-update" title='The "text-update" signal'>text-update</a>" : <code class="literal">Has Details</code>
|
150
|
+
</pre>
|
151
|
+
</div>
|
152
|
+
<div class="refsect1">
|
153
|
+
<a name="AtkText.description"></a><h2>Description</h2>
|
154
|
+
<p>
|
155
|
+
<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> should be implemented by <a href="AtkObject.html"><span class="type">AtkObjects</span></a> on behalf of widgets that
|
156
|
+
have text content which is either attributed or otherwise non-trivial.
|
157
|
+
<a href="AtkObject.html"><span class="type">AtkObjects</span></a> whose text content is simple, unattributed, and very brief
|
158
|
+
may expose that content via <a class="link" href="AtkObject.html#atk-object-get-name" title="atk_object_get_name ()"><span class="type">atk_object_get_name</span></a> instead; however if the
|
159
|
+
text is editable, multi-line, typically longer than three or four words,
|
160
|
+
attributed, selectable, or if the object already uses the 'name' ATK
|
161
|
+
property for other information, the <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> interface should be used
|
162
|
+
to expose the text content. In the case of editable text content,
|
163
|
+
<a class="link" href="AtkEditableText.html" title="AtkEditableText"><span class="type">AtkEditableText</span></a> (a subtype of the <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> interface) should be
|
164
|
+
implemented instead.
|
165
|
+
</p>
|
166
|
+
<p>
|
167
|
+
<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> provides not only traversal facilities and change notification
|
168
|
+
for text content, but also caret tracking and glyph bounding box
|
169
|
+
calculations. Note that the text strings are exposed as UTF-8, and are
|
170
|
+
therefore potentially multi-byte, and caret-to-byte offset mapping makes
|
171
|
+
no assumptions about the character length; also bounding box
|
172
|
+
glyph-to-offset mapping may be complex for languages which use ligatures.
|
173
|
+
</p>
|
174
|
+
</div>
|
175
|
+
<div class="refsect1">
|
176
|
+
<a name="AtkText.details"></a><h2>Details</h2>
|
177
|
+
<div class="refsect2">
|
178
|
+
<a name="AtkText-struct"></a><h3>AtkText</h3>
|
179
|
+
<pre class="programlisting">typedef struct _AtkText AtkText;</pre>
|
180
|
+
<p>
|
181
|
+
The AtkText structure does not contain any fields.
|
182
|
+
</p>
|
183
|
+
</div>
|
184
|
+
<hr>
|
185
|
+
<div class="refsect2">
|
186
|
+
<a name="AtkTextBoundary"></a><h3>enum AtkTextBoundary</h3>
|
187
|
+
<pre class="programlisting">typedef enum {
|
188
|
+
ATK_TEXT_BOUNDARY_CHAR,
|
189
|
+
ATK_TEXT_BOUNDARY_WORD_START,
|
190
|
+
ATK_TEXT_BOUNDARY_WORD_END,
|
191
|
+
ATK_TEXT_BOUNDARY_SENTENCE_START,
|
192
|
+
ATK_TEXT_BOUNDARY_SENTENCE_END,
|
193
|
+
ATK_TEXT_BOUNDARY_LINE_START,
|
194
|
+
ATK_TEXT_BOUNDARY_LINE_END
|
195
|
+
} AtkTextBoundary;
|
196
|
+
</pre>
|
197
|
+
<p>
|
198
|
+
Text boundary types used for specifying boundaries for regions of text
|
199
|
+
</p>
|
200
|
+
<div class="variablelist"><table border="0">
|
201
|
+
<col align="left" valign="top">
|
202
|
+
<tbody>
|
203
|
+
<tr>
|
204
|
+
<td><p><a name="ATK-TEXT-BOUNDARY-CHAR:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_BOUNDARY_CHAR</code></span></p></td>
|
205
|
+
<td>Boundary is the boundary between characters
|
206
|
+
(including non-printing characters)
|
207
|
+
</td>
|
208
|
+
</tr>
|
209
|
+
<tr>
|
210
|
+
<td><p><a name="ATK-TEXT-BOUNDARY-WORD-START:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_BOUNDARY_WORD_START</code></span></p></td>
|
211
|
+
<td>Boundary is the start (i.e. first character) of a word.
|
212
|
+
</td>
|
213
|
+
</tr>
|
214
|
+
<tr>
|
215
|
+
<td><p><a name="ATK-TEXT-BOUNDARY-WORD-END:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_BOUNDARY_WORD_END</code></span></p></td>
|
216
|
+
<td>Boundary is the end (i.e. last character) of a word.
|
217
|
+
</td>
|
218
|
+
</tr>
|
219
|
+
<tr>
|
220
|
+
<td><p><a name="ATK-TEXT-BOUNDARY-SENTENCE-START:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_BOUNDARY_SENTENCE_START</code></span></p></td>
|
221
|
+
<td>Boundary is the first character in a sentence.
|
222
|
+
</td>
|
223
|
+
</tr>
|
224
|
+
<tr>
|
225
|
+
<td><p><a name="ATK-TEXT-BOUNDARY-SENTENCE-END:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_BOUNDARY_SENTENCE_END</code></span></p></td>
|
226
|
+
<td>Boundary is the last (terminal) character in a sentence;
|
227
|
+
in languages which use "sentence stop" punctuation such as English, the boundary is thus the
|
228
|
+
'.', '?', or similar terminal punctuation character.
|
229
|
+
</td>
|
230
|
+
</tr>
|
231
|
+
<tr>
|
232
|
+
<td><p><a name="ATK-TEXT-BOUNDARY-LINE-START:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_BOUNDARY_LINE_START</code></span></p></td>
|
233
|
+
<td>Boundary is the initial character of the content or a
|
234
|
+
character immediately following a newline, linefeed, or return character.
|
235
|
+
</td>
|
236
|
+
</tr>
|
237
|
+
<tr>
|
238
|
+
<td><p><a name="ATK-TEXT-BOUNDARY-LINE-END:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_BOUNDARY_LINE_END</code></span></p></td>
|
239
|
+
<td>Boundary is the linefeed, or return character.
|
240
|
+
</td>
|
241
|
+
</tr>
|
242
|
+
</tbody>
|
243
|
+
</table></div>
|
244
|
+
</div>
|
245
|
+
<hr>
|
246
|
+
<div class="refsect2">
|
247
|
+
<a name="AtkTextClipType"></a><h3>enum AtkTextClipType</h3>
|
248
|
+
<pre class="programlisting">typedef enum {
|
249
|
+
ATK_TEXT_CLIP_NONE,
|
250
|
+
ATK_TEXT_CLIP_MIN,
|
251
|
+
ATK_TEXT_CLIP_MAX,
|
252
|
+
ATK_TEXT_CLIP_BOTH
|
253
|
+
} AtkTextClipType;
|
254
|
+
</pre>
|
255
|
+
<p>
|
256
|
+
Describes the type of clipping required.
|
257
|
+
</p>
|
258
|
+
<div class="variablelist"><table border="0">
|
259
|
+
<col align="left" valign="top">
|
260
|
+
<tbody>
|
261
|
+
<tr>
|
262
|
+
<td><p><a name="ATK-TEXT-CLIP-NONE:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_CLIP_NONE</code></span></p></td>
|
263
|
+
<td>No clipping to be done
|
264
|
+
</td>
|
265
|
+
</tr>
|
266
|
+
<tr>
|
267
|
+
<td><p><a name="ATK-TEXT-CLIP-MIN:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_CLIP_MIN</code></span></p></td>
|
268
|
+
<td>Text clipped by min coordinate is omitted
|
269
|
+
</td>
|
270
|
+
</tr>
|
271
|
+
<tr>
|
272
|
+
<td><p><a name="ATK-TEXT-CLIP-MAX:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_CLIP_MAX</code></span></p></td>
|
273
|
+
<td>Text clipped by max coordinate is omitted
|
274
|
+
</td>
|
275
|
+
</tr>
|
276
|
+
<tr>
|
277
|
+
<td><p><a name="ATK-TEXT-CLIP-BOTH:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_CLIP_BOTH</code></span></p></td>
|
278
|
+
<td>Only text fully within mix/max bound is retained
|
279
|
+
</td>
|
280
|
+
</tr>
|
281
|
+
</tbody>
|
282
|
+
</table></div>
|
283
|
+
</div>
|
284
|
+
<hr>
|
285
|
+
<div class="refsect2">
|
286
|
+
<a name="AtkTextRange"></a><h3>struct AtkTextRange</h3>
|
287
|
+
<pre class="programlisting">struct AtkTextRange {
|
288
|
+
AtkTextRectangle bounds;
|
289
|
+
gint start_offset;
|
290
|
+
gint end_offset;
|
291
|
+
gchar* content;
|
292
|
+
};
|
293
|
+
</pre>
|
294
|
+
<p>
|
295
|
+
A structure used to describe a text range.
|
296
|
+
</p>
|
297
|
+
<div class="variablelist"><table border="0">
|
298
|
+
<col align="left" valign="top">
|
299
|
+
<tbody>
|
300
|
+
<tr>
|
301
|
+
<td><p><span class="term"><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>;</span></p></td>
|
302
|
+
<td>A rectangle giving the bounds of the text range</td>
|
303
|
+
</tr>
|
304
|
+
<tr>
|
305
|
+
<td><p><span class="term"><span class="type">gint</span> <em class="structfield"><code><a name="AtkTextRange.start-offset"></a>start_offset</code></em>;</span></p></td>
|
306
|
+
<td>The start offset of a AtkTextRange</td>
|
307
|
+
</tr>
|
308
|
+
<tr>
|
309
|
+
<td><p><span class="term"><span class="type">gint</span> <em class="structfield"><code><a name="AtkTextRange.end-offset"></a>end_offset</code></em>;</span></p></td>
|
310
|
+
<td>The end offset of a AtkTextRange</td>
|
311
|
+
</tr>
|
312
|
+
<tr>
|
313
|
+
<td><p><span class="term"><span class="type">gchar</span> *<em class="structfield"><code><a name="AtkTextRange.content"></a>content</code></em>;</span></p></td>
|
314
|
+
<td>The text in the text range</td>
|
315
|
+
</tr>
|
316
|
+
</tbody>
|
317
|
+
</table></div>
|
318
|
+
</div>
|
319
|
+
<hr>
|
320
|
+
<div class="refsect2">
|
321
|
+
<a name="AtkTextRectangle"></a><h3>struct AtkTextRectangle</h3>
|
322
|
+
<pre class="programlisting">struct AtkTextRectangle {
|
323
|
+
gint x;
|
324
|
+
gint y;
|
325
|
+
gint width;
|
326
|
+
gint height;
|
327
|
+
};
|
328
|
+
</pre>
|
329
|
+
<p>
|
330
|
+
A structure used to store a rectangle used by AtkText.
|
331
|
+
</p>
|
332
|
+
<div class="variablelist"><table border="0">
|
333
|
+
<col align="left" valign="top">
|
334
|
+
<tbody>
|
335
|
+
<tr>
|
336
|
+
<td><p><span class="term"><span class="type">gint</span> <em class="structfield"><code><a name="AtkTextRectangle.x"></a>x</code></em>;</span></p></td>
|
337
|
+
<td>The horizontal coordinate of a rectangle</td>
|
338
|
+
</tr>
|
339
|
+
<tr>
|
340
|
+
<td><p><span class="term"><span class="type">gint</span> <em class="structfield"><code><a name="AtkTextRectangle.y"></a>y</code></em>;</span></p></td>
|
341
|
+
<td>The vertical coordinate of a rectangle</td>
|
342
|
+
</tr>
|
343
|
+
<tr>
|
344
|
+
<td><p><span class="term"><span class="type">gint</span> <em class="structfield"><code><a name="AtkTextRectangle.width"></a>width</code></em>;</span></p></td>
|
345
|
+
<td>The width of a rectangle</td>
|
346
|
+
</tr>
|
347
|
+
<tr>
|
348
|
+
<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>
|
349
|
+
<td>The height of a rectangle</td>
|
350
|
+
</tr>
|
351
|
+
</tbody>
|
352
|
+
</table></div>
|
353
|
+
</div>
|
354
|
+
<hr>
|
355
|
+
<div class="refsect2">
|
356
|
+
<a name="AtkAttribute"></a><h3>struct AtkAttribute</h3>
|
357
|
+
<pre class="programlisting">struct AtkAttribute {
|
358
|
+
gchar* name;
|
359
|
+
gchar* value;
|
360
|
+
};
|
361
|
+
</pre>
|
362
|
+
<p>
|
363
|
+
A string name/value pair representing a text attribute.
|
364
|
+
</p>
|
365
|
+
<div class="variablelist"><table border="0">
|
366
|
+
<col align="left" valign="top">
|
367
|
+
<tbody>
|
368
|
+
<tr>
|
369
|
+
<td><p><span class="term"><span class="type">gchar</span> *<em class="structfield"><code><a name="AtkAttribute.name"></a>name</code></em>;</span></p></td>
|
370
|
+
<td>The attribute name. Call <code class="function">atk_text_attr_get_name()</code>
|
371
|
+
</td>
|
372
|
+
</tr>
|
373
|
+
<tr>
|
374
|
+
<td><p><span class="term"><span class="type">gchar</span> *<em class="structfield"><code><a name="AtkAttribute.value"></a>value</code></em>;</span></p></td>
|
375
|
+
<td>the value of the attribute, represented as a string.
|
376
|
+
Call <code class="function">atk_text_attr_get_value()</code> for those which are strings.
|
377
|
+
For values which are numbers, the string representation of the number
|
378
|
+
is in value.</td>
|
379
|
+
</tr>
|
380
|
+
</tbody>
|
381
|
+
</table></div>
|
382
|
+
</div>
|
383
|
+
<hr>
|
384
|
+
<div class="refsect2">
|
385
|
+
<a name="AtkAttributeSet"></a><h3>AtkAttributeSet</h3>
|
386
|
+
<pre class="programlisting">typedef GSList AtkAttributeSet;
|
387
|
+
</pre>
|
388
|
+
<p>
|
389
|
+
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
|
390
|
+
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>
|
391
|
+
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>
|
392
|
+
</p>
|
393
|
+
</div>
|
394
|
+
<hr>
|
395
|
+
<div class="refsect2">
|
396
|
+
<a name="AtkTextAttribute"></a><h3>enum AtkTextAttribute</h3>
|
397
|
+
<pre class="programlisting">typedef enum {
|
398
|
+
ATK_TEXT_ATTR_INVALID = 0,
|
399
|
+
ATK_TEXT_ATTR_LEFT_MARGIN,
|
400
|
+
ATK_TEXT_ATTR_RIGHT_MARGIN,
|
401
|
+
ATK_TEXT_ATTR_INDENT,
|
402
|
+
ATK_TEXT_ATTR_INVISIBLE,
|
403
|
+
ATK_TEXT_ATTR_EDITABLE,
|
404
|
+
ATK_TEXT_ATTR_PIXELS_ABOVE_LINES,
|
405
|
+
ATK_TEXT_ATTR_PIXELS_BELOW_LINES,
|
406
|
+
ATK_TEXT_ATTR_PIXELS_INSIDE_WRAP,
|
407
|
+
ATK_TEXT_ATTR_BG_FULL_HEIGHT,
|
408
|
+
ATK_TEXT_ATTR_RISE,
|
409
|
+
ATK_TEXT_ATTR_UNDERLINE,
|
410
|
+
ATK_TEXT_ATTR_STRIKETHROUGH,
|
411
|
+
ATK_TEXT_ATTR_SIZE,
|
412
|
+
ATK_TEXT_ATTR_SCALE,
|
413
|
+
ATK_TEXT_ATTR_WEIGHT,
|
414
|
+
ATK_TEXT_ATTR_LANGUAGE,
|
415
|
+
ATK_TEXT_ATTR_FAMILY_NAME,
|
416
|
+
ATK_TEXT_ATTR_BG_COLOR,
|
417
|
+
ATK_TEXT_ATTR_FG_COLOR,
|
418
|
+
ATK_TEXT_ATTR_BG_STIPPLE,
|
419
|
+
ATK_TEXT_ATTR_FG_STIPPLE,
|
420
|
+
ATK_TEXT_ATTR_WRAP_MODE,
|
421
|
+
ATK_TEXT_ATTR_DIRECTION,
|
422
|
+
ATK_TEXT_ATTR_JUSTIFICATION,
|
423
|
+
ATK_TEXT_ATTR_STRETCH,
|
424
|
+
ATK_TEXT_ATTR_VARIANT,
|
425
|
+
ATK_TEXT_ATTR_STYLE,
|
426
|
+
ATK_TEXT_ATTR_LAST_DEFINED
|
427
|
+
} AtkTextAttribute;
|
428
|
+
</pre>
|
429
|
+
<p>
|
430
|
+
Describes the text attributes supported
|
431
|
+
</p>
|
432
|
+
<div class="variablelist"><table border="0">
|
433
|
+
<col align="left" valign="top">
|
434
|
+
<tbody>
|
435
|
+
<tr>
|
436
|
+
<td><p><a name="ATK-TEXT-ATTR-INVALID:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_INVALID</code></span></p></td>
|
437
|
+
<td>Invalid attribute
|
438
|
+
</td>
|
439
|
+
</tr>
|
440
|
+
<tr>
|
441
|
+
<td><p><a name="ATK-TEXT-ATTR-LEFT-MARGIN:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_LEFT_MARGIN</code></span></p></td>
|
442
|
+
<td>The pixel width of the left margin
|
443
|
+
</td>
|
444
|
+
</tr>
|
445
|
+
<tr>
|
446
|
+
<td><p><a name="ATK-TEXT-ATTR-RIGHT-MARGIN:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_RIGHT_MARGIN</code></span></p></td>
|
447
|
+
<td>The pixel width of the right margin
|
448
|
+
</td>
|
449
|
+
</tr>
|
450
|
+
<tr>
|
451
|
+
<td><p><a name="ATK-TEXT-ATTR-INDENT:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_INDENT</code></span></p></td>
|
452
|
+
<td>The number of pixels that the text is indented
|
453
|
+
</td>
|
454
|
+
</tr>
|
455
|
+
<tr>
|
456
|
+
<td><p><a name="ATK-TEXT-ATTR-INVISIBLE:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_INVISIBLE</code></span></p></td>
|
457
|
+
<td>Either "true" or "false" indicating whether text is visible or not
|
458
|
+
</td>
|
459
|
+
</tr>
|
460
|
+
<tr>
|
461
|
+
<td><p><a name="ATK-TEXT-ATTR-EDITABLE:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_EDITABLE</code></span></p></td>
|
462
|
+
<td>Either "true" or "false" indicating whether text is editable or not
|
463
|
+
</td>
|
464
|
+
</tr>
|
465
|
+
<tr>
|
466
|
+
<td><p><a name="ATK-TEXT-ATTR-PIXELS-ABOVE-LINES:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_PIXELS_ABOVE_LINES</code></span></p></td>
|
467
|
+
<td>Pixels of blank space to leave above each newline-terminated line.
|
468
|
+
</td>
|
469
|
+
</tr>
|
470
|
+
<tr>
|
471
|
+
<td><p><a name="ATK-TEXT-ATTR-PIXELS-BELOW-LINES:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_PIXELS_BELOW_LINES</code></span></p></td>
|
472
|
+
<td>Pixels of blank space to leave below each newline-terminated line.
|
473
|
+
</td>
|
474
|
+
</tr>
|
475
|
+
<tr>
|
476
|
+
<td><p><a name="ATK-TEXT-ATTR-PIXELS-INSIDE-WRAP:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_PIXELS_INSIDE_WRAP</code></span></p></td>
|
477
|
+
<td>Pixels of blank space to leave between wrapped lines inside the same newline-terminated line (paragraph).
|
478
|
+
</td>
|
479
|
+
</tr>
|
480
|
+
<tr>
|
481
|
+
<td><p><a name="ATK-TEXT-ATTR-BG-FULL-HEIGHT:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_BG_FULL_HEIGHT</code></span></p></td>
|
482
|
+
<td>"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.
|
483
|
+
</td>
|
484
|
+
</tr>
|
485
|
+
<tr>
|
486
|
+
<td><p><a name="ATK-TEXT-ATTR-RISE:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_RISE</code></span></p></td>
|
487
|
+
<td>Number of pixels that the characters are risen above the baseline
|
488
|
+
</td>
|
489
|
+
</tr>
|
490
|
+
<tr>
|
491
|
+
<td><p><a name="ATK-TEXT-ATTR-UNDERLINE:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_UNDERLINE</code></span></p></td>
|
492
|
+
<td>"none", "single", "double", "low", or "error"
|
493
|
+
</td>
|
494
|
+
</tr>
|
495
|
+
<tr>
|
496
|
+
<td><p><a name="ATK-TEXT-ATTR-STRIKETHROUGH:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_STRIKETHROUGH</code></span></p></td>
|
497
|
+
<td>"true" or "false" whether the text is strikethrough
|
498
|
+
</td>
|
499
|
+
</tr>
|
500
|
+
<tr>
|
501
|
+
<td><p><a name="ATK-TEXT-ATTR-SIZE:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_SIZE</code></span></p></td>
|
502
|
+
<td>The size of the characters.
|
503
|
+
</td>
|
504
|
+
</tr>
|
505
|
+
<tr>
|
506
|
+
<td><p><a name="ATK-TEXT-ATTR-SCALE:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_SCALE</code></span></p></td>
|
507
|
+
<td>The scale of the characters. The value is a string representation of a double
|
508
|
+
</td>
|
509
|
+
</tr>
|
510
|
+
<tr>
|
511
|
+
<td><p><a name="ATK-TEXT-ATTR-WEIGHT:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_WEIGHT</code></span></p></td>
|
512
|
+
<td>The weight of the characters.
|
513
|
+
</td>
|
514
|
+
</tr>
|
515
|
+
<tr>
|
516
|
+
<td><p><a name="ATK-TEXT-ATTR-LANGUAGE:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_LANGUAGE</code></span></p></td>
|
517
|
+
<td>The language used
|
518
|
+
</td>
|
519
|
+
</tr>
|
520
|
+
<tr>
|
521
|
+
<td><p><a name="ATK-TEXT-ATTR-FAMILY-NAME:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_FAMILY_NAME</code></span></p></td>
|
522
|
+
<td>The font family name
|
523
|
+
</td>
|
524
|
+
</tr>
|
525
|
+
<tr>
|
526
|
+
<td><p><a name="ATK-TEXT-ATTR-BG-COLOR:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_BG_COLOR</code></span></p></td>
|
527
|
+
<td>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>"
|
528
|
+
</td>
|
529
|
+
</tr>
|
530
|
+
<tr>
|
531
|
+
<td><p><a name="ATK-TEXT-ATTR-FG-COLOR:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_FG_COLOR</code></span></p></td>
|
532
|
+
<td>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>"
|
533
|
+
</td>
|
534
|
+
</tr>
|
535
|
+
<tr>
|
536
|
+
<td><p><a name="ATK-TEXT-ATTR-BG-STIPPLE:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_BG_STIPPLE</code></span></p></td>
|
537
|
+
<td>"true" if a <span class="type">GdkBitmap</span> is set for stippling the background color.
|
538
|
+
</td>
|
539
|
+
</tr>
|
540
|
+
<tr>
|
541
|
+
<td><p><a name="ATK-TEXT-ATTR-FG-STIPPLE:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_FG_STIPPLE</code></span></p></td>
|
542
|
+
<td>"true" if a <span class="type">GdkBitmap</span> is set for stippling the foreground color.
|
543
|
+
</td>
|
544
|
+
</tr>
|
545
|
+
<tr>
|
546
|
+
<td><p><a name="ATK-TEXT-ATTR-WRAP-MODE:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_WRAP_MODE</code></span></p></td>
|
547
|
+
<td>The wrap mode of the text, if any. Values are "none", "char", "word", or "word_char".
|
548
|
+
</td>
|
549
|
+
</tr>
|
550
|
+
<tr>
|
551
|
+
<td><p><a name="ATK-TEXT-ATTR-DIRECTION:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_DIRECTION</code></span></p></td>
|
552
|
+
<td>The direction of the text, if set. Values are "none", "ltr" or "rtl"
|
553
|
+
</td>
|
554
|
+
</tr>
|
555
|
+
<tr>
|
556
|
+
<td><p><a name="ATK-TEXT-ATTR-JUSTIFICATION:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_JUSTIFICATION</code></span></p></td>
|
557
|
+
<td>The justification of the text, if set. Values are "left", "right", "center" or "fill"
|
558
|
+
</td>
|
559
|
+
</tr>
|
560
|
+
<tr>
|
561
|
+
<td><p><a name="ATK-TEXT-ATTR-STRETCH:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_STRETCH</code></span></p></td>
|
562
|
+
<td>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"
|
563
|
+
</td>
|
564
|
+
</tr>
|
565
|
+
<tr>
|
566
|
+
<td><p><a name="ATK-TEXT-ATTR-VARIANT:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_VARIANT</code></span></p></td>
|
567
|
+
<td>The capitalization variant of the text, if set. Values are "normal" or "small_caps"
|
568
|
+
</td>
|
569
|
+
</tr>
|
570
|
+
<tr>
|
571
|
+
<td><p><a name="ATK-TEXT-ATTR-STYLE:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_STYLE</code></span></p></td>
|
572
|
+
<td>The slant style of the text, if set. Values are "normal", "oblique" or "italic"
|
573
|
+
</td>
|
574
|
+
</tr>
|
575
|
+
<tr>
|
576
|
+
<td><p><a name="ATK-TEXT-ATTR-LAST-DEFINED:CAPS"></a><span class="term"><code class="literal">ATK_TEXT_ATTR_LAST_DEFINED</code></span></p></td>
|
577
|
+
<td>not a valid text attribute, used for finding end of enumeration
|
578
|
+
</td>
|
579
|
+
</tr>
|
580
|
+
</tbody>
|
581
|
+
</table></div>
|
582
|
+
</div>
|
583
|
+
<hr>
|
584
|
+
<div class="refsect2">
|
585
|
+
<a name="atk-text-get-text"></a><h3>atk_text_get_text ()</h3>
|
586
|
+
<pre class="programlisting"><span class="returnvalue">gchar</span> * 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>,
|
587
|
+
<em class="parameter"><code><span class="type">gint</span> start_offset</code></em>,
|
588
|
+
<em class="parameter"><code><span class="type">gint</span> end_offset</code></em>);</pre>
|
589
|
+
<p>
|
590
|
+
Gets the specified text.
|
591
|
+
</p>
|
592
|
+
<div class="variablelist"><table border="0">
|
593
|
+
<col align="left" valign="top">
|
594
|
+
<tbody>
|
595
|
+
<tr>
|
596
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
597
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
598
|
+
</td>
|
599
|
+
</tr>
|
600
|
+
<tr>
|
601
|
+
<td><p><span class="term"><em class="parameter"><code>start_offset</code></em> :</span></p></td>
|
602
|
+
<td>start position</td>
|
603
|
+
</tr>
|
604
|
+
<tr>
|
605
|
+
<td><p><span class="term"><em class="parameter"><code>end_offset</code></em> :</span></p></td>
|
606
|
+
<td>end position, or -1 for the end of the string.</td>
|
607
|
+
</tr>
|
608
|
+
<tr>
|
609
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
610
|
+
<td>a newly allocated string containing the text from <em class="parameter"><code>start_offset</code></em> up
|
611
|
+
to, but not including <em class="parameter"><code>end_offset</code></em>. Use <code class="function">g_free()</code> to free the returned string.</td>
|
612
|
+
</tr>
|
613
|
+
</tbody>
|
614
|
+
</table></div>
|
615
|
+
</div>
|
616
|
+
<hr>
|
617
|
+
<div class="refsect2">
|
618
|
+
<a name="atk-text-get-character-at-offset"></a><h3>atk_text_get_character_at_offset ()</h3>
|
619
|
+
<pre class="programlisting"><span class="returnvalue">gunichar</span> 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>,
|
620
|
+
<em class="parameter"><code><span class="type">gint</span> offset</code></em>);</pre>
|
621
|
+
<p>
|
622
|
+
Gets the specified text.
|
623
|
+
</p>
|
624
|
+
<div class="variablelist"><table border="0">
|
625
|
+
<col align="left" valign="top">
|
626
|
+
<tbody>
|
627
|
+
<tr>
|
628
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
629
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
630
|
+
</td>
|
631
|
+
</tr>
|
632
|
+
<tr>
|
633
|
+
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
|
634
|
+
<td>position</td>
|
635
|
+
</tr>
|
636
|
+
<tr>
|
637
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
638
|
+
<td>the character at <em class="parameter"><code>offset</code></em>.</td>
|
639
|
+
</tr>
|
640
|
+
</tbody>
|
641
|
+
</table></div>
|
642
|
+
</div>
|
643
|
+
<hr>
|
644
|
+
<div class="refsect2">
|
645
|
+
<a name="atk-text-get-text-after-offset"></a><h3>atk_text_get_text_after_offset ()</h3>
|
646
|
+
<pre class="programlisting"><span class="returnvalue">gchar</span> * 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>,
|
647
|
+
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
648
|
+
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a> boundary_type</code></em>,
|
649
|
+
<em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
|
650
|
+
<em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);</pre>
|
651
|
+
<p>
|
652
|
+
Gets the specified text.
|
653
|
+
</p>
|
654
|
+
<p>
|
655
|
+
If the boundary_type if ATK_TEXT_BOUNDARY_CHAR the character after the
|
656
|
+
offset is returned.
|
657
|
+
</p>
|
658
|
+
<p>
|
659
|
+
If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string
|
660
|
+
is from the word start after the offset to the next word start.
|
661
|
+
</p>
|
662
|
+
<p>
|
663
|
+
The returned string will contain the word after the offset if the offset
|
664
|
+
is inside a word or if the offset is not inside a word.
|
665
|
+
</p>
|
666
|
+
<p>
|
667
|
+
If the boundary_type is ATK_TEXT_BOUNDARY_WORD_END the returned string
|
668
|
+
is from the word end at or after the offset to the next work end.
|
669
|
+
</p>
|
670
|
+
<p>
|
671
|
+
The returned string will contain the word after the offset if the offset
|
672
|
+
is inside a word and will contain the word after the word after the offset
|
673
|
+
if the offset is not inside a word.
|
674
|
+
</p>
|
675
|
+
<p>
|
676
|
+
If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the returned
|
677
|
+
string is from the sentence start after the offset to the next sentence
|
678
|
+
start.
|
679
|
+
</p>
|
680
|
+
<p>
|
681
|
+
The returned string will contain the sentence after the offset if the offset
|
682
|
+
is inside a sentence or if the offset is not inside a sentence.
|
683
|
+
</p>
|
684
|
+
<p>
|
685
|
+
If the boundary_type is ATK_TEXT_BOUNDARY_SENTENCE_END the returned string
|
686
|
+
is from the sentence end at or after the offset to the next sentence end.
|
687
|
+
</p>
|
688
|
+
<p>
|
689
|
+
The returned string will contain the sentence after the offset if the offset
|
690
|
+
is inside a sentence and will contain the sentence after the sentence
|
691
|
+
after the offset if the offset is not inside a sentence.
|
692
|
+
</p>
|
693
|
+
<p>
|
694
|
+
If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned
|
695
|
+
string is from the line start after the offset to the next line start.
|
696
|
+
</p>
|
697
|
+
<p>
|
698
|
+
If the boundary_type is ATK_TEXT_BOUNDARY_LINE_END the returned string
|
699
|
+
is from the line end at or after the offset to the next line end.
|
700
|
+
</p>
|
701
|
+
<div class="variablelist"><table border="0">
|
702
|
+
<col align="left" valign="top">
|
703
|
+
<tbody>
|
704
|
+
<tr>
|
705
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
706
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
707
|
+
</td>
|
708
|
+
</tr>
|
709
|
+
<tr>
|
710
|
+
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
|
711
|
+
<td>position</td>
|
712
|
+
</tr>
|
713
|
+
<tr>
|
714
|
+
<td><p><span class="term"><em class="parameter"><code>boundary_type</code></em> :</span></p></td>
|
715
|
+
<td>An <a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a>
|
716
|
+
</td>
|
717
|
+
</tr>
|
718
|
+
<tr>
|
719
|
+
<td><p><span class="term"><em class="parameter"><code>start_offset</code></em> :</span></p></td>
|
720
|
+
<td>the start offset of the returned string</td>
|
721
|
+
</tr>
|
722
|
+
<tr>
|
723
|
+
<td><p><span class="term"><em class="parameter"><code>end_offset</code></em> :</span></p></td>
|
724
|
+
<td>the offset of the first character after the
|
725
|
+
returned substring</td>
|
726
|
+
</tr>
|
727
|
+
<tr>
|
728
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
729
|
+
<td>a newly allocated string containing the text after <em class="parameter"><code>offset</code></em> bounded
|
730
|
+
by the specified <em class="parameter"><code>boundary_type</code></em>. Use <code class="function">g_free()</code> to free the returned string.</td>
|
731
|
+
</tr>
|
732
|
+
</tbody>
|
733
|
+
</table></div>
|
734
|
+
</div>
|
735
|
+
<hr>
|
736
|
+
<div class="refsect2">
|
737
|
+
<a name="atk-text-get-text-at-offset"></a><h3>atk_text_get_text_at_offset ()</h3>
|
738
|
+
<pre class="programlisting"><span class="returnvalue">gchar</span> * 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>,
|
739
|
+
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
740
|
+
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a> boundary_type</code></em>,
|
741
|
+
<em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
|
742
|
+
<em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);</pre>
|
743
|
+
<p>
|
744
|
+
Gets the specified text.
|
745
|
+
</p>
|
746
|
+
<p>
|
747
|
+
If the boundary_type if ATK_TEXT_BOUNDARY_CHAR the character at the
|
748
|
+
offset is returned.
|
749
|
+
</p>
|
750
|
+
<p>
|
751
|
+
If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string
|
752
|
+
is from the word start at or before the offset to the word start after
|
753
|
+
the offset.
|
754
|
+
</p>
|
755
|
+
<p>
|
756
|
+
The returned string will contain the word at the offset if the offset
|
757
|
+
is inside a word and will contain the word before the offset if the
|
758
|
+
offset is not inside a word.
|
759
|
+
</p>
|
760
|
+
<p>
|
761
|
+
If the boundary_type is ATK_TEXT_BOUNDARY_WORD_END the returned string
|
762
|
+
is from the word end before the offset to the word end at or after the
|
763
|
+
offset.
|
764
|
+
</p>
|
765
|
+
<p>
|
766
|
+
The returned string will contain the word at the offset if the offset
|
767
|
+
is inside a word and will contain the word after to the offset if the
|
768
|
+
offset is not inside a word.
|
769
|
+
</p>
|
770
|
+
<p>
|
771
|
+
If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the returned
|
772
|
+
string is from the sentence start at or before the offset to the sentence
|
773
|
+
start after the offset.
|
774
|
+
</p>
|
775
|
+
<p>
|
776
|
+
The returned string will contain the sentence at the offset if the offset
|
777
|
+
is inside a sentence and will contain the sentence before the offset
|
778
|
+
if the offset is not inside a sentence.
|
779
|
+
</p>
|
780
|
+
<p>
|
781
|
+
If the boundary_type is ATK_TEXT_BOUNDARY_SENTENCE_END the returned string
|
782
|
+
is from the sentence end before the offset to the sentence end at or
|
783
|
+
after the offset.
|
784
|
+
</p>
|
785
|
+
<p>
|
786
|
+
The returned string will contain the sentence at the offset if the offset
|
787
|
+
is inside a sentence and will contain the sentence after the offset
|
788
|
+
if the offset is not inside a sentence.
|
789
|
+
</p>
|
790
|
+
<p>
|
791
|
+
If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned
|
792
|
+
string is from the line start at or before the offset to the line
|
793
|
+
start after the offset.
|
794
|
+
</p>
|
795
|
+
<p>
|
796
|
+
If the boundary_type is ATK_TEXT_BOUNDARY_LINE_END the returned string
|
797
|
+
is from the line end before the offset to the line end at or after
|
798
|
+
the offset.
|
799
|
+
</p>
|
800
|
+
<div class="variablelist"><table border="0">
|
801
|
+
<col align="left" valign="top">
|
802
|
+
<tbody>
|
803
|
+
<tr>
|
804
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
805
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
806
|
+
</td>
|
807
|
+
</tr>
|
808
|
+
<tr>
|
809
|
+
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
|
810
|
+
<td>position</td>
|
811
|
+
</tr>
|
812
|
+
<tr>
|
813
|
+
<td><p><span class="term"><em class="parameter"><code>boundary_type</code></em> :</span></p></td>
|
814
|
+
<td>An <a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a>
|
815
|
+
</td>
|
816
|
+
</tr>
|
817
|
+
<tr>
|
818
|
+
<td><p><span class="term"><em class="parameter"><code>start_offset</code></em> :</span></p></td>
|
819
|
+
<td>the start offset of the returned string</td>
|
820
|
+
</tr>
|
821
|
+
<tr>
|
822
|
+
<td><p><span class="term"><em class="parameter"><code>end_offset</code></em> :</span></p></td>
|
823
|
+
<td>the offset of the first character after the
|
824
|
+
returned substring</td>
|
825
|
+
</tr>
|
826
|
+
<tr>
|
827
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
828
|
+
<td>a newly allocated string containing the text at <em class="parameter"><code>offset</code></em> bounded by
|
829
|
+
the specified <em class="parameter"><code>boundary_type</code></em>. Use <code class="function">g_free()</code> to free the returned string.</td>
|
830
|
+
</tr>
|
831
|
+
</tbody>
|
832
|
+
</table></div>
|
833
|
+
</div>
|
834
|
+
<hr>
|
835
|
+
<div class="refsect2">
|
836
|
+
<a name="atk-text-get-text-before-offset"></a><h3>atk_text_get_text_before_offset ()</h3>
|
837
|
+
<pre class="programlisting"><span class="returnvalue">gchar</span> * 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>,
|
838
|
+
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
839
|
+
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a> boundary_type</code></em>,
|
840
|
+
<em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
|
841
|
+
<em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);</pre>
|
842
|
+
<p>
|
843
|
+
Gets the specified text.
|
844
|
+
</p>
|
845
|
+
<p>
|
846
|
+
If the boundary_type if ATK_TEXT_BOUNDARY_CHAR the character before the
|
847
|
+
offset is returned.
|
848
|
+
</p>
|
849
|
+
<p>
|
850
|
+
If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string
|
851
|
+
is from the word start before the word start before or at the offset to
|
852
|
+
the word start before or at the offset.
|
853
|
+
</p>
|
854
|
+
<p>
|
855
|
+
The returned string will contain the word before the offset if the offset
|
856
|
+
is inside a word and will contain the word before the word before the
|
857
|
+
offset if the offset is not inside a word.
|
858
|
+
</p>
|
859
|
+
<p>
|
860
|
+
If the boundary_type is ATK_TEXT_BOUNDARY_WORD_END the returned string
|
861
|
+
is from the word end before the word end before the offset to the word
|
862
|
+
end before the offset.
|
863
|
+
</p>
|
864
|
+
<p>
|
865
|
+
The returned string will contain the word before the offset if the offset
|
866
|
+
is inside a word or if the offset is not inside a word.
|
867
|
+
</p>
|
868
|
+
<p>
|
869
|
+
If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the returned
|
870
|
+
string is from the sentence start before the sentence start before
|
871
|
+
the offset to the sentence start before the offset.
|
872
|
+
</p>
|
873
|
+
<p>
|
874
|
+
The returned string will contain the sentence before the offset if the
|
875
|
+
offset is inside a sentence and will contain the sentence before the
|
876
|
+
sentence before the offset if the offset is not inside a sentence.
|
877
|
+
</p>
|
878
|
+
<p>
|
879
|
+
If the boundary_type is ATK_TEXT_BOUNDARY_SENTENCE_END the returned string
|
880
|
+
is from the sentence end before the sentence end at or before the offset to
|
881
|
+
the sentence end at or before the offset.
|
882
|
+
</p>
|
883
|
+
<p>
|
884
|
+
The returned string will contain the sentence before the offset if the
|
885
|
+
offset is inside a sentence or if the offset is not inside a sentence.
|
886
|
+
</p>
|
887
|
+
<p>
|
888
|
+
If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned
|
889
|
+
string is from the line start before the line start ar or before the offset
|
890
|
+
to the line start ar or before the offset.
|
891
|
+
</p>
|
892
|
+
<p>
|
893
|
+
If the boundary_type is ATK_TEXT_BOUNDARY_LINE_END the returned string
|
894
|
+
is from the line end before the line end before the offset to the
|
895
|
+
line end before the offset.
|
896
|
+
</p>
|
897
|
+
<div class="variablelist"><table border="0">
|
898
|
+
<col align="left" valign="top">
|
899
|
+
<tbody>
|
900
|
+
<tr>
|
901
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
902
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
903
|
+
</td>
|
904
|
+
</tr>
|
905
|
+
<tr>
|
906
|
+
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
|
907
|
+
<td>position</td>
|
908
|
+
</tr>
|
909
|
+
<tr>
|
910
|
+
<td><p><span class="term"><em class="parameter"><code>boundary_type</code></em> :</span></p></td>
|
911
|
+
<td>An <a class="link" href="AtkText.html#AtkTextBoundary" title="enum AtkTextBoundary"><span class="type">AtkTextBoundary</span></a>
|
912
|
+
</td>
|
913
|
+
</tr>
|
914
|
+
<tr>
|
915
|
+
<td><p><span class="term"><em class="parameter"><code>start_offset</code></em> :</span></p></td>
|
916
|
+
<td>the start offset of the returned string</td>
|
917
|
+
</tr>
|
918
|
+
<tr>
|
919
|
+
<td><p><span class="term"><em class="parameter"><code>end_offset</code></em> :</span></p></td>
|
920
|
+
<td>the offset of the first character after the
|
921
|
+
returned substring</td>
|
922
|
+
</tr>
|
923
|
+
<tr>
|
924
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
925
|
+
<td>a newly allocated string containing the text before <em class="parameter"><code>offset</code></em> bounded
|
926
|
+
by the specified <em class="parameter"><code>boundary_type</code></em>. Use <code class="function">g_free()</code> to free the returned string.</td>
|
927
|
+
</tr>
|
928
|
+
</tbody>
|
929
|
+
</table></div>
|
930
|
+
</div>
|
931
|
+
<hr>
|
932
|
+
<div class="refsect2">
|
933
|
+
<a name="atk-text-get-caret-offset"></a><h3>atk_text_get_caret_offset ()</h3>
|
934
|
+
<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>
|
935
|
+
<p>
|
936
|
+
Gets the offset position of the caret (cursor).
|
937
|
+
</p>
|
938
|
+
<div class="variablelist"><table border="0">
|
939
|
+
<col align="left" valign="top">
|
940
|
+
<tbody>
|
941
|
+
<tr>
|
942
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
943
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
944
|
+
</td>
|
945
|
+
</tr>
|
946
|
+
<tr>
|
947
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
948
|
+
<td>the offset position of the caret (cursor).</td>
|
949
|
+
</tr>
|
950
|
+
</tbody>
|
951
|
+
</table></div>
|
952
|
+
</div>
|
953
|
+
<hr>
|
954
|
+
<div class="refsect2">
|
955
|
+
<a name="atk-text-get-character-extents"></a><h3>atk_text_get_character_extents ()</h3>
|
956
|
+
<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>,
|
957
|
+
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
958
|
+
<em class="parameter"><code><span class="type">gint</span> *x</code></em>,
|
959
|
+
<em class="parameter"><code><span class="type">gint</span> *y</code></em>,
|
960
|
+
<em class="parameter"><code><span class="type">gint</span> *width</code></em>,
|
961
|
+
<em class="parameter"><code><span class="type">gint</span> *height</code></em>,
|
962
|
+
<em class="parameter"><code><a class="link" href="AtkUtil.html#AtkCoordType" title="enum AtkCoordType"><span class="type">AtkCoordType</span></a> coords</code></em>);</pre>
|
963
|
+
<p>
|
964
|
+
Get the bounding box containing the glyph representing the character at
|
965
|
+
a particular text offset.
|
966
|
+
</p>
|
967
|
+
<div class="variablelist"><table border="0">
|
968
|
+
<col align="left" valign="top">
|
969
|
+
<tbody>
|
970
|
+
<tr>
|
971
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
972
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
973
|
+
</td>
|
974
|
+
</tr>
|
975
|
+
<tr>
|
976
|
+
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
|
977
|
+
<td>The offset of the text character for which bounding information is required.</td>
|
978
|
+
</tr>
|
979
|
+
<tr>
|
980
|
+
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
|
981
|
+
<td>Pointer for the x cordinate of the bounding box</td>
|
982
|
+
</tr>
|
983
|
+
<tr>
|
984
|
+
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
|
985
|
+
<td>Pointer for the y cordinate of the bounding box</td>
|
986
|
+
</tr>
|
987
|
+
<tr>
|
988
|
+
<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
|
989
|
+
<td>Pointer for the width of the bounding box</td>
|
990
|
+
</tr>
|
991
|
+
<tr>
|
992
|
+
<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
|
993
|
+
<td>Pointer for the height of the bounding box</td>
|
994
|
+
</tr>
|
995
|
+
<tr>
|
996
|
+
<td><p><span class="term"><em class="parameter"><code>coords</code></em> :</span></p></td>
|
997
|
+
<td>specify whether coordinates are relative to the screen or widget window</td>
|
998
|
+
</tr>
|
999
|
+
</tbody>
|
1000
|
+
</table></div>
|
1001
|
+
</div>
|
1002
|
+
<hr>
|
1003
|
+
<div class="refsect2">
|
1004
|
+
<a name="atk-text-get-run-attributes"></a><h3>atk_text_get_run_attributes ()</h3>
|
1005
|
+
<pre class="programlisting"><a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="returnvalue">AtkAttributeSet</span></a> * 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>,
|
1006
|
+
<em class="parameter"><code><span class="type">gint</span> offset</code></em>,
|
1007
|
+
<em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
|
1008
|
+
<em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);</pre>
|
1009
|
+
<p>
|
1010
|
+
Creates an <a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> which consists of the attributes explicitly
|
1011
|
+
set at the position <em class="parameter"><code>offset</code></em> in the text. <em class="parameter"><code>start_offset</code></em> and <em class="parameter"><code>end_offset</code></em> are
|
1012
|
+
set to the start and end of the range around <em class="parameter"><code>offset</code></em> where the attributes are
|
1013
|
+
invariant. Note that <em class="parameter"><code>end_offset</code></em> is the offset of the first character
|
1014
|
+
after the range. See the enum AtkTextAttribute for types of text
|
1015
|
+
attributes that can be returned. Note that other attributes may also be
|
1016
|
+
returned.
|
1017
|
+
</p>
|
1018
|
+
<div class="variablelist"><table border="0">
|
1019
|
+
<col align="left" valign="top">
|
1020
|
+
<tbody>
|
1021
|
+
<tr>
|
1022
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
1023
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
1024
|
+
</td>
|
1025
|
+
</tr>
|
1026
|
+
<tr>
|
1027
|
+
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
|
1028
|
+
<td>the offset at which to get the attributes, -1 means the offset of
|
1029
|
+
the character to be inserted at the caret location.</td>
|
1030
|
+
</tr>
|
1031
|
+
<tr>
|
1032
|
+
<td><p><span class="term"><em class="parameter"><code>start_offset</code></em> :</span></p></td>
|
1033
|
+
<td>the address to put the start offset of the range</td>
|
1034
|
+
</tr>
|
1035
|
+
<tr>
|
1036
|
+
<td><p><span class="term"><em class="parameter"><code>end_offset</code></em> :</span></p></td>
|
1037
|
+
<td>the address to put the end offset of the range</td>
|
1038
|
+
</tr>
|
1039
|
+
<tr>
|
1040
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1041
|
+
<td>an <a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> which contains the attributes
|
1042
|
+
explicitly set at <em class="parameter"><code>offset</code></em>. This <a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> should be freed by a call
|
1043
|
+
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>
|
1044
|
+
</td>
|
1045
|
+
</tr>
|
1046
|
+
</tbody>
|
1047
|
+
</table></div>
|
1048
|
+
</div>
|
1049
|
+
<hr>
|
1050
|
+
<div class="refsect2">
|
1051
|
+
<a name="atk-text-get-default-attributes"></a><h3>atk_text_get_default_attributes ()</h3>
|
1052
|
+
<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>
|
1053
|
+
<p>
|
1054
|
+
Creates an <a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> which consists of the default values of
|
1055
|
+
attributes for the text. See the enum AtkTextAttribute for types of text
|
1056
|
+
attributes that can be returned. Note that other attributes may also be
|
1057
|
+
returned.
|
1058
|
+
</p>
|
1059
|
+
<div class="variablelist"><table border="0">
|
1060
|
+
<col align="left" valign="top">
|
1061
|
+
<tbody>
|
1062
|
+
<tr>
|
1063
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
1064
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
1065
|
+
</td>
|
1066
|
+
</tr>
|
1067
|
+
<tr>
|
1068
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1069
|
+
<td>an <a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> which contains the default
|
1070
|
+
values of attributes. at <em class="parameter"><code>offset</code></em>. this <span class="type">atkattributeset</span> should be freed by
|
1071
|
+
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>. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
|
1072
|
+
</td>
|
1073
|
+
</tr>
|
1074
|
+
</tbody>
|
1075
|
+
</table></div>
|
1076
|
+
</div>
|
1077
|
+
<hr>
|
1078
|
+
<div class="refsect2">
|
1079
|
+
<a name="atk-text-get-character-count"></a><h3>atk_text_get_character_count ()</h3>
|
1080
|
+
<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>
|
1081
|
+
<p>
|
1082
|
+
Gets the character count.
|
1083
|
+
</p>
|
1084
|
+
<div class="variablelist"><table border="0">
|
1085
|
+
<col align="left" valign="top">
|
1086
|
+
<tbody>
|
1087
|
+
<tr>
|
1088
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
1089
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
1090
|
+
</td>
|
1091
|
+
</tr>
|
1092
|
+
<tr>
|
1093
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1094
|
+
<td>the number of characters.</td>
|
1095
|
+
</tr>
|
1096
|
+
</tbody>
|
1097
|
+
</table></div>
|
1098
|
+
</div>
|
1099
|
+
<hr>
|
1100
|
+
<div class="refsect2">
|
1101
|
+
<a name="atk-text-get-offset-at-point"></a><h3>atk_text_get_offset_at_point ()</h3>
|
1102
|
+
<pre class="programlisting"><span class="returnvalue">gint</span> 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>,
|
1103
|
+
<em class="parameter"><code><span class="type">gint</span> x</code></em>,
|
1104
|
+
<em class="parameter"><code><span class="type">gint</span> y</code></em>,
|
1105
|
+
<em class="parameter"><code><a class="link" href="AtkUtil.html#AtkCoordType" title="enum AtkCoordType"><span class="type">AtkCoordType</span></a> coords</code></em>);</pre>
|
1106
|
+
<p>
|
1107
|
+
Gets the offset of the character located at coordinates <em class="parameter"><code>x</code></em> and <em class="parameter"><code>y</code></em>. <em class="parameter"><code>x</code></em> and <em class="parameter"><code>y</code></em>
|
1108
|
+
are interpreted as being relative to the screen or this widget's window
|
1109
|
+
depending on <em class="parameter"><code>coords</code></em>.
|
1110
|
+
</p>
|
1111
|
+
<div class="variablelist"><table border="0">
|
1112
|
+
<col align="left" valign="top">
|
1113
|
+
<tbody>
|
1114
|
+
<tr>
|
1115
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
1116
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
1117
|
+
</td>
|
1118
|
+
</tr>
|
1119
|
+
<tr>
|
1120
|
+
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
|
1121
|
+
<td>screen x-position of character</td>
|
1122
|
+
</tr>
|
1123
|
+
<tr>
|
1124
|
+
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
|
1125
|
+
<td>screen y-position of character</td>
|
1126
|
+
</tr>
|
1127
|
+
<tr>
|
1128
|
+
<td><p><span class="term"><em class="parameter"><code>coords</code></em> :</span></p></td>
|
1129
|
+
<td>specify whether coordinates are relative to the screen or
|
1130
|
+
widget window</td>
|
1131
|
+
</tr>
|
1132
|
+
<tr>
|
1133
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1134
|
+
<td>the offset to the character which is located at
|
1135
|
+
the specified <em class="parameter"><code>x</code></em> and <em class="parameter"><code>y</code></em> coordinates.</td>
|
1136
|
+
</tr>
|
1137
|
+
</tbody>
|
1138
|
+
</table></div>
|
1139
|
+
</div>
|
1140
|
+
<hr>
|
1141
|
+
<div class="refsect2">
|
1142
|
+
<a name="atk-text-get-bounded-ranges"></a><h3>atk_text_get_bounded_ranges ()</h3>
|
1143
|
+
<pre class="programlisting"><a class="link" href="AtkText.html#AtkTextRange" title="struct AtkTextRange"><span class="returnvalue">AtkTextRange</span></a> ** 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>,
|
1144
|
+
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextRectangle" title="struct AtkTextRectangle"><span class="type">AtkTextRectangle</span></a> *rect</code></em>,
|
1145
|
+
<em class="parameter"><code><a class="link" href="AtkUtil.html#AtkCoordType" title="enum AtkCoordType"><span class="type">AtkCoordType</span></a> coord_type</code></em>,
|
1146
|
+
<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>,
|
1147
|
+
<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>
|
1148
|
+
<p>
|
1149
|
+
Get the ranges of text in the specified bounding box.
|
1150
|
+
</p>
|
1151
|
+
<div class="variablelist"><table border="0">
|
1152
|
+
<col align="left" valign="top">
|
1153
|
+
<tbody>
|
1154
|
+
<tr>
|
1155
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
1156
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
1157
|
+
</td>
|
1158
|
+
</tr>
|
1159
|
+
<tr>
|
1160
|
+
<td><p><span class="term"><em class="parameter"><code>rect</code></em> :</span></p></td>
|
1161
|
+
<td>An AtkTextRectangle giving the dimensions of the bounding box.</td>
|
1162
|
+
</tr>
|
1163
|
+
<tr>
|
1164
|
+
<td><p><span class="term"><em class="parameter"><code>coord_type</code></em> :</span></p></td>
|
1165
|
+
<td>Specify whether coordinates are relative to the screen or widget window.</td>
|
1166
|
+
</tr>
|
1167
|
+
<tr>
|
1168
|
+
<td><p><span class="term"><em class="parameter"><code>x_clip_type</code></em> :</span></p></td>
|
1169
|
+
<td>Specify the horizontal clip type.</td>
|
1170
|
+
</tr>
|
1171
|
+
<tr>
|
1172
|
+
<td><p><span class="term"><em class="parameter"><code>y_clip_type</code></em> :</span></p></td>
|
1173
|
+
<td>Specify the vertical clip type.</td>
|
1174
|
+
</tr>
|
1175
|
+
<tr>
|
1176
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1177
|
+
<td>Array of AtkTextRange. The last
|
1178
|
+
element of the array returned by this function will be NULL. <span class="annotation">[<a href="http://foldoc.org/array"><span class="acronym">array</span></a> zero-terminated=1]</span>
|
1179
|
+
</td>
|
1180
|
+
</tr>
|
1181
|
+
</tbody>
|
1182
|
+
</table></div>
|
1183
|
+
<p class="since">Since 1.3</p>
|
1184
|
+
</div>
|
1185
|
+
<hr>
|
1186
|
+
<div class="refsect2">
|
1187
|
+
<a name="atk-text-get-range-extents"></a><h3>atk_text_get_range_extents ()</h3>
|
1188
|
+
<pre class="programlisting"><span class="returnvalue">void</span> 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>,
|
1189
|
+
<em class="parameter"><code><span class="type">gint</span> start_offset</code></em>,
|
1190
|
+
<em class="parameter"><code><span class="type">gint</span> end_offset</code></em>,
|
1191
|
+
<em class="parameter"><code><a class="link" href="AtkUtil.html#AtkCoordType" title="enum AtkCoordType"><span class="type">AtkCoordType</span></a> coord_type</code></em>,
|
1192
|
+
<em class="parameter"><code><a class="link" href="AtkText.html#AtkTextRectangle" title="struct AtkTextRectangle"><span class="type">AtkTextRectangle</span></a> *rect</code></em>);</pre>
|
1193
|
+
<p>
|
1194
|
+
Get the bounding box for text within the specified range.
|
1195
|
+
</p>
|
1196
|
+
<div class="variablelist"><table border="0">
|
1197
|
+
<col align="left" valign="top">
|
1198
|
+
<tbody>
|
1199
|
+
<tr>
|
1200
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
1201
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
1202
|
+
</td>
|
1203
|
+
</tr>
|
1204
|
+
<tr>
|
1205
|
+
<td><p><span class="term"><em class="parameter"><code>start_offset</code></em> :</span></p></td>
|
1206
|
+
<td>The offset of the first text character for which boundary
|
1207
|
+
information is required.</td>
|
1208
|
+
</tr>
|
1209
|
+
<tr>
|
1210
|
+
<td><p><span class="term"><em class="parameter"><code>end_offset</code></em> :</span></p></td>
|
1211
|
+
<td>The offset of the text character after the last character
|
1212
|
+
for which boundary information is required.</td>
|
1213
|
+
</tr>
|
1214
|
+
<tr>
|
1215
|
+
<td><p><span class="term"><em class="parameter"><code>coord_type</code></em> :</span></p></td>
|
1216
|
+
<td>Specify whether coordinates are relative to the screen or widget window.</td>
|
1217
|
+
</tr>
|
1218
|
+
<tr>
|
1219
|
+
<td><p><span class="term"><em class="parameter"><code>rect</code></em> :</span></p></td>
|
1220
|
+
<td>A pointer to a AtkTextRectangle which is filled in by this function.</td>
|
1221
|
+
</tr>
|
1222
|
+
</tbody>
|
1223
|
+
</table></div>
|
1224
|
+
<p class="since">Since 1.3</p>
|
1225
|
+
</div>
|
1226
|
+
<hr>
|
1227
|
+
<div class="refsect2">
|
1228
|
+
<a name="atk-text-free-ranges"></a><h3>atk_text_free_ranges ()</h3>
|
1229
|
+
<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>
|
1230
|
+
<p>
|
1231
|
+
Frees the memory associated with an array of AtkTextRange. It is assumed
|
1232
|
+
that the array was returned by the function atk_text_get_bounded_ranges
|
1233
|
+
and is NULL terminated.
|
1234
|
+
</p>
|
1235
|
+
<div class="variablelist"><table border="0">
|
1236
|
+
<col align="left" valign="top">
|
1237
|
+
<tbody><tr>
|
1238
|
+
<td><p><span class="term"><em class="parameter"><code>ranges</code></em> :</span></p></td>
|
1239
|
+
<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 to be freed.</td>
|
1240
|
+
</tr></tbody>
|
1241
|
+
</table></div>
|
1242
|
+
<p class="since">Since 1.3</p>
|
1243
|
+
</div>
|
1244
|
+
<hr>
|
1245
|
+
<div class="refsect2">
|
1246
|
+
<a name="atk-text-get-n-selections"></a><h3>atk_text_get_n_selections ()</h3>
|
1247
|
+
<pre class="programlisting"><span class="returnvalue">gint</span> 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>
|
1248
|
+
<p>
|
1249
|
+
Gets the number of selected regions.
|
1250
|
+
</p>
|
1251
|
+
<div class="variablelist"><table border="0">
|
1252
|
+
<col align="left" valign="top">
|
1253
|
+
<tbody>
|
1254
|
+
<tr>
|
1255
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
1256
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
1257
|
+
</td>
|
1258
|
+
</tr>
|
1259
|
+
<tr>
|
1260
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1261
|
+
<td>The number of selected regions, or -1 if a failure
|
1262
|
+
occurred.</td>
|
1263
|
+
</tr>
|
1264
|
+
</tbody>
|
1265
|
+
</table></div>
|
1266
|
+
</div>
|
1267
|
+
<hr>
|
1268
|
+
<div class="refsect2">
|
1269
|
+
<a name="atk-text-get-selection"></a><h3>atk_text_get_selection ()</h3>
|
1270
|
+
<pre class="programlisting"><span class="returnvalue">gchar</span> * 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>,
|
1271
|
+
<em class="parameter"><code><span class="type">gint</span> selection_num</code></em>,
|
1272
|
+
<em class="parameter"><code><span class="type">gint</span> *start_offset</code></em>,
|
1273
|
+
<em class="parameter"><code><span class="type">gint</span> *end_offset</code></em>);</pre>
|
1274
|
+
<p>
|
1275
|
+
Gets the text from the specified selection.
|
1276
|
+
</p>
|
1277
|
+
<div class="variablelist"><table border="0">
|
1278
|
+
<col align="left" valign="top">
|
1279
|
+
<tbody>
|
1280
|
+
<tr>
|
1281
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
1282
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
1283
|
+
</td>
|
1284
|
+
</tr>
|
1285
|
+
<tr>
|
1286
|
+
<td><p><span class="term"><em class="parameter"><code>selection_num</code></em> :</span></p></td>
|
1287
|
+
<td>The selection number. The selected regions are
|
1288
|
+
assigned numbers that correspond to how far the region is from the
|
1289
|
+
start of the text. The selected region closest to the beginning
|
1290
|
+
of the text region is assigned the number 0, etc. Note that adding,
|
1291
|
+
moving or deleting a selected region can change the numbering.</td>
|
1292
|
+
</tr>
|
1293
|
+
<tr>
|
1294
|
+
<td><p><span class="term"><em class="parameter"><code>start_offset</code></em> :</span></p></td>
|
1295
|
+
<td>passes back the start position of the selected region</td>
|
1296
|
+
</tr>
|
1297
|
+
<tr>
|
1298
|
+
<td><p><span class="term"><em class="parameter"><code>end_offset</code></em> :</span></p></td>
|
1299
|
+
<td>passes back the end position of (e.g. offset immediately past)
|
1300
|
+
the selected region</td>
|
1301
|
+
</tr>
|
1302
|
+
<tr>
|
1303
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1304
|
+
<td>a newly allocated string containing the selected text. Use <code class="function">g_free()</code>
|
1305
|
+
to free the returned string.</td>
|
1306
|
+
</tr>
|
1307
|
+
</tbody>
|
1308
|
+
</table></div>
|
1309
|
+
</div>
|
1310
|
+
<hr>
|
1311
|
+
<div class="refsect2">
|
1312
|
+
<a name="atk-text-add-selection"></a><h3>atk_text_add_selection ()</h3>
|
1313
|
+
<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>,
|
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>
|
1317
|
+
Adds a selection bounded by the specified offsets.
|
1318
|
+
</p>
|
1319
|
+
<div class="variablelist"><table border="0">
|
1320
|
+
<col align="left" valign="top">
|
1321
|
+
<tbody>
|
1322
|
+
<tr>
|
1323
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
1324
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
1325
|
+
</td>
|
1326
|
+
</tr>
|
1327
|
+
<tr>
|
1328
|
+
<td><p><span class="term"><em class="parameter"><code>start_offset</code></em> :</span></p></td>
|
1329
|
+
<td>the start position of the selected region</td>
|
1330
|
+
</tr>
|
1331
|
+
<tr>
|
1332
|
+
<td><p><span class="term"><em class="parameter"><code>end_offset</code></em> :</span></p></td>
|
1333
|
+
<td>the offset of the first character after the selected region.</td>
|
1334
|
+
</tr>
|
1335
|
+
<tr>
|
1336
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1337
|
+
<td>
|
1338
|
+
<code class="literal">TRUE</code> if success, <code class="literal">FALSE</code> otherwise</td>
|
1339
|
+
</tr>
|
1340
|
+
</tbody>
|
1341
|
+
</table></div>
|
1342
|
+
</div>
|
1343
|
+
<hr>
|
1344
|
+
<div class="refsect2">
|
1345
|
+
<a name="atk-text-remove-selection"></a><h3>atk_text_remove_selection ()</h3>
|
1346
|
+
<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>,
|
1347
|
+
<em class="parameter"><code><span class="type">gint</span> selection_num</code></em>);</pre>
|
1348
|
+
<p>
|
1349
|
+
Removes the specified selection.
|
1350
|
+
</p>
|
1351
|
+
<div class="variablelist"><table border="0">
|
1352
|
+
<col align="left" valign="top">
|
1353
|
+
<tbody>
|
1354
|
+
<tr>
|
1355
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
1356
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
1357
|
+
</td>
|
1358
|
+
</tr>
|
1359
|
+
<tr>
|
1360
|
+
<td><p><span class="term"><em class="parameter"><code>selection_num</code></em> :</span></p></td>
|
1361
|
+
<td>The selection number. The selected regions are
|
1362
|
+
assigned numbers that correspond to how far the region is from the
|
1363
|
+
start of the text. The selected region closest to the beginning
|
1364
|
+
of the text region is assigned the number 0, etc. Note that adding,
|
1365
|
+
moving or deleting a selected region can change the numbering.</td>
|
1366
|
+
</tr>
|
1367
|
+
<tr>
|
1368
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1369
|
+
<td>
|
1370
|
+
<code class="literal">TRUE</code> if success, <code class="literal">FALSE</code> otherwise</td>
|
1371
|
+
</tr>
|
1372
|
+
</tbody>
|
1373
|
+
</table></div>
|
1374
|
+
</div>
|
1375
|
+
<hr>
|
1376
|
+
<div class="refsect2">
|
1377
|
+
<a name="atk-text-set-selection"></a><h3>atk_text_set_selection ()</h3>
|
1378
|
+
<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>,
|
1379
|
+
<em class="parameter"><code><span class="type">gint</span> selection_num</code></em>,
|
1380
|
+
<em class="parameter"><code><span class="type">gint</span> start_offset</code></em>,
|
1381
|
+
<em class="parameter"><code><span class="type">gint</span> end_offset</code></em>);</pre>
|
1382
|
+
<p>
|
1383
|
+
Changes the start and end offset of the specified selection.
|
1384
|
+
</p>
|
1385
|
+
<div class="variablelist"><table border="0">
|
1386
|
+
<col align="left" valign="top">
|
1387
|
+
<tbody>
|
1388
|
+
<tr>
|
1389
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
1390
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
1391
|
+
</td>
|
1392
|
+
</tr>
|
1393
|
+
<tr>
|
1394
|
+
<td><p><span class="term"><em class="parameter"><code>selection_num</code></em> :</span></p></td>
|
1395
|
+
<td>The selection number. The selected regions are
|
1396
|
+
assigned numbers that correspond to how far the region is from the
|
1397
|
+
start of the text. The selected region closest to the beginning
|
1398
|
+
of the text region is assigned the number 0, etc. Note that adding,
|
1399
|
+
moving or deleting a selected region can change the numbering.</td>
|
1400
|
+
</tr>
|
1401
|
+
<tr>
|
1402
|
+
<td><p><span class="term"><em class="parameter"><code>start_offset</code></em> :</span></p></td>
|
1403
|
+
<td>the new start position of the selection</td>
|
1404
|
+
</tr>
|
1405
|
+
<tr>
|
1406
|
+
<td><p><span class="term"><em class="parameter"><code>end_offset</code></em> :</span></p></td>
|
1407
|
+
<td>the new end position of (e.g. offset immediately past)
|
1408
|
+
the selection</td>
|
1409
|
+
</tr>
|
1410
|
+
<tr>
|
1411
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1412
|
+
<td>
|
1413
|
+
<code class="literal">TRUE</code> if success, <code class="literal">FALSE</code> otherwise</td>
|
1414
|
+
</tr>
|
1415
|
+
</tbody>
|
1416
|
+
</table></div>
|
1417
|
+
</div>
|
1418
|
+
<hr>
|
1419
|
+
<div class="refsect2">
|
1420
|
+
<a name="atk-text-set-caret-offset"></a><h3>atk_text_set_caret_offset ()</h3>
|
1421
|
+
<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>,
|
1422
|
+
<em class="parameter"><code><span class="type">gint</span> offset</code></em>);</pre>
|
1423
|
+
<p>
|
1424
|
+
Sets the caret (cursor) position to the specified <em class="parameter"><code>offset</code></em>.
|
1425
|
+
</p>
|
1426
|
+
<div class="variablelist"><table border="0">
|
1427
|
+
<col align="left" valign="top">
|
1428
|
+
<tbody>
|
1429
|
+
<tr>
|
1430
|
+
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
|
1431
|
+
<td>an <a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a>
|
1432
|
+
</td>
|
1433
|
+
</tr>
|
1434
|
+
<tr>
|
1435
|
+
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
|
1436
|
+
<td>position</td>
|
1437
|
+
</tr>
|
1438
|
+
<tr>
|
1439
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1440
|
+
<td>
|
1441
|
+
<code class="literal">TRUE</code> if success, <code class="literal">FALSE</code> otherwise.</td>
|
1442
|
+
</tr>
|
1443
|
+
</tbody>
|
1444
|
+
</table></div>
|
1445
|
+
</div>
|
1446
|
+
<hr>
|
1447
|
+
<div class="refsect2">
|
1448
|
+
<a name="atk-attribute-set-free"></a><h3>atk_attribute_set_free ()</h3>
|
1449
|
+
<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>
|
1450
|
+
<p>
|
1451
|
+
Frees the memory used by an <a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a>, including all its
|
1452
|
+
<a href="AtkText.html#AtkAttribute"><span class="type">AtkAttributes</span></a>.
|
1453
|
+
</p>
|
1454
|
+
<div class="variablelist"><table border="0">
|
1455
|
+
<col align="left" valign="top">
|
1456
|
+
<tbody><tr>
|
1457
|
+
<td><p><span class="term"><em class="parameter"><code>attrib_set</code></em> :</span></p></td>
|
1458
|
+
<td>The <a class="link" href="AtkText.html#AtkAttributeSet" title="AtkAttributeSet"><span class="type">AtkAttributeSet</span></a> to free</td>
|
1459
|
+
</tr></tbody>
|
1460
|
+
</table></div>
|
1461
|
+
</div>
|
1462
|
+
<hr>
|
1463
|
+
<div class="refsect2">
|
1464
|
+
<a name="atk-text-attribute-register"></a><h3>atk_text_attribute_register ()</h3>
|
1465
|
+
<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>
|
1466
|
+
<p>
|
1467
|
+
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>
|
1468
|
+
</p>
|
1469
|
+
<div class="variablelist"><table border="0">
|
1470
|
+
<col align="left" valign="top">
|
1471
|
+
<tbody>
|
1472
|
+
<tr>
|
1473
|
+
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
|
1474
|
+
<td>a name string</td>
|
1475
|
+
</tr>
|
1476
|
+
<tr>
|
1477
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1478
|
+
<td>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>
|
1479
|
+
</td>
|
1480
|
+
</tr>
|
1481
|
+
</tbody>
|
1482
|
+
</table></div>
|
1483
|
+
</div>
|
1484
|
+
<hr>
|
1485
|
+
<div class="refsect2">
|
1486
|
+
<a name="atk-text-attribute-get-name"></a><h3>atk_text_attribute_get_name ()</h3>
|
1487
|
+
<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>
|
1488
|
+
<p>
|
1489
|
+
Gets the name corresponding to the <a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a>
|
1490
|
+
</p>
|
1491
|
+
<div class="variablelist"><table border="0">
|
1492
|
+
<col align="left" valign="top">
|
1493
|
+
<tbody>
|
1494
|
+
<tr>
|
1495
|
+
<td><p><span class="term"><em class="parameter"><code>attr</code></em> :</span></p></td>
|
1496
|
+
<td>The <a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a> whose name is required</td>
|
1497
|
+
</tr>
|
1498
|
+
<tr>
|
1499
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1500
|
+
<td>a string containing the name; this string should not be freed</td>
|
1501
|
+
</tr>
|
1502
|
+
</tbody>
|
1503
|
+
</table></div>
|
1504
|
+
</div>
|
1505
|
+
<hr>
|
1506
|
+
<div class="refsect2">
|
1507
|
+
<a name="atk-text-attribute-for-name"></a><h3>atk_text_attribute_for_name ()</h3>
|
1508
|
+
<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>
|
1509
|
+
<p>
|
1510
|
+
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.
|
1511
|
+
</p>
|
1512
|
+
<div class="variablelist"><table border="0">
|
1513
|
+
<col align="left" valign="top">
|
1514
|
+
<tbody>
|
1515
|
+
<tr>
|
1516
|
+
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
|
1517
|
+
<td>a string which is the (non-localized) name of an ATK text attribute.</td>
|
1518
|
+
</tr>
|
1519
|
+
<tr>
|
1520
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1521
|
+
<td>the <a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a> enumerated type corresponding to the specified
|
1522
|
+
name,
|
1523
|
+
or <span class="type">ATK_TEXT_ATTRIBUTE_INVALID</span> if no matching text attribute is found.</td>
|
1524
|
+
</tr>
|
1525
|
+
</tbody>
|
1526
|
+
</table></div>
|
1527
|
+
</div>
|
1528
|
+
<hr>
|
1529
|
+
<div class="refsect2">
|
1530
|
+
<a name="atk-text-attribute-get-value"></a><h3>atk_text_attribute_get_value ()</h3>
|
1531
|
+
<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>,
|
1532
|
+
<em class="parameter"><code><span class="type">gint</span> index_</code></em>);</pre>
|
1533
|
+
<p>
|
1534
|
+
Gets the value for the index of the <a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a>
|
1535
|
+
</p>
|
1536
|
+
<div class="variablelist"><table border="0">
|
1537
|
+
<col align="left" valign="top">
|
1538
|
+
<tbody>
|
1539
|
+
<tr>
|
1540
|
+
<td><p><span class="term"><em class="parameter"><code>attr</code></em> :</span></p></td>
|
1541
|
+
<td>The <a class="link" href="AtkText.html#AtkTextAttribute" title="enum AtkTextAttribute"><span class="type">AtkTextAttribute</span></a> for which a value is required</td>
|
1542
|
+
</tr>
|
1543
|
+
<tr>
|
1544
|
+
<td><p><span class="term"><em class="parameter"><code>index_</code></em> :</span></p></td>
|
1545
|
+
<td>The index of the required value</td>
|
1546
|
+
</tr>
|
1547
|
+
<tr>
|
1548
|
+
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
1549
|
+
<td>a string containing the value; this string should not be freed;
|
1550
|
+
NULL is returned if there are no values maintained for the attr value.</td>
|
1551
|
+
</tr>
|
1552
|
+
</tbody>
|
1553
|
+
</table></div>
|
1554
|
+
</div>
|
1555
|
+
</div>
|
1556
|
+
<div class="refsect1">
|
1557
|
+
<a name="AtkText.signal-details"></a><h2>Signal Details</h2>
|
1558
|
+
<div class="refsect2">
|
1559
|
+
<a name="AtkText-text-attributes-changed"></a><h3>The <code class="literal">"text-attributes-changed"</code> signal</h3>
|
1560
|
+
<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *atktext,
|
1561
|
+
<span class="type">gpointer</span> user_data) : <code class="literal">Run Last</code></pre>
|
1562
|
+
<p>
|
1563
|
+
The "text-attributes-changed" signal is emitted when the text attributes of
|
1564
|
+
the text of an object which implements AtkText changes.
|
1565
|
+
</p>
|
1566
|
+
<div class="variablelist"><table border="0">
|
1567
|
+
<col align="left" valign="top">
|
1568
|
+
<tbody>
|
1569
|
+
<tr>
|
1570
|
+
<td><p><span class="term"><em class="parameter"><code>atktext</code></em> :</span></p></td>
|
1571
|
+
<td>the object which received the signal.</td>
|
1572
|
+
</tr>
|
1573
|
+
<tr>
|
1574
|
+
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
1575
|
+
<td>user data set when the signal handler was connected.</td>
|
1576
|
+
</tr>
|
1577
|
+
</tbody>
|
1578
|
+
</table></div>
|
1579
|
+
</div>
|
1580
|
+
<hr>
|
1581
|
+
<div class="refsect2">
|
1582
|
+
<a name="AtkText-text-caret-moved"></a><h3>The <code class="literal">"text-caret-moved"</code> signal</h3>
|
1583
|
+
<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *atktext,
|
1584
|
+
<span class="type">gint</span> arg1,
|
1585
|
+
<span class="type">gpointer</span> user_data) : <code class="literal">Run Last</code></pre>
|
1586
|
+
<p>
|
1587
|
+
The "text-caret-moved" signal is emitted when the caret position of
|
1588
|
+
the text of an object which implements AtkText changes.
|
1589
|
+
</p>
|
1590
|
+
<div class="variablelist"><table border="0">
|
1591
|
+
<col align="left" valign="top">
|
1592
|
+
<tbody>
|
1593
|
+
<tr>
|
1594
|
+
<td><p><span class="term"><em class="parameter"><code>atktext</code></em> :</span></p></td>
|
1595
|
+
<td>the object which received the signal.</td>
|
1596
|
+
</tr>
|
1597
|
+
<tr>
|
1598
|
+
<td><p><span class="term"><em class="parameter"><code>arg1</code></em> :</span></p></td>
|
1599
|
+
<td>The new position of the text caret.</td>
|
1600
|
+
</tr>
|
1601
|
+
<tr>
|
1602
|
+
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
1603
|
+
<td>user data set when the signal handler was connected.</td>
|
1604
|
+
</tr>
|
1605
|
+
</tbody>
|
1606
|
+
</table></div>
|
1607
|
+
</div>
|
1608
|
+
<hr>
|
1609
|
+
<div class="refsect2">
|
1610
|
+
<a name="AtkText-text-changed"></a><h3>The <code class="literal">"text-changed"</code> signal</h3>
|
1611
|
+
<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *atktext,
|
1612
|
+
<span class="type">gint</span> arg1,
|
1613
|
+
<span class="type">gint</span> arg2,
|
1614
|
+
<span class="type">gpointer</span> user_data) : <code class="literal">Has Details</code></pre>
|
1615
|
+
<p>
|
1616
|
+
The "text-changed" signal is emitted when the text of the object which
|
1617
|
+
implements the AtkText interface changes, This signal will have a detail
|
1618
|
+
which is either "insert" or "delete" which identifies whether the text
|
1619
|
+
change was an insertion or a deletion
|
1620
|
+
</p>
|
1621
|
+
<div class="variablelist"><table border="0">
|
1622
|
+
<col align="left" valign="top">
|
1623
|
+
<tbody>
|
1624
|
+
<tr>
|
1625
|
+
<td><p><span class="term"><em class="parameter"><code>atktext</code></em> :</span></p></td>
|
1626
|
+
<td>the object which received the signal.</td>
|
1627
|
+
</tr>
|
1628
|
+
<tr>
|
1629
|
+
<td><p><span class="term"><em class="parameter"><code>arg1</code></em> :</span></p></td>
|
1630
|
+
<td>The position (character offset) of the insertion or deletion.</td>
|
1631
|
+
</tr>
|
1632
|
+
<tr>
|
1633
|
+
<td><p><span class="term"><em class="parameter"><code>arg2</code></em> :</span></p></td>
|
1634
|
+
<td>The length (in characters) of text inserted or deleted.</td>
|
1635
|
+
</tr>
|
1636
|
+
<tr>
|
1637
|
+
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
1638
|
+
<td>user data set when the signal handler was connected.</td>
|
1639
|
+
</tr>
|
1640
|
+
</tbody>
|
1641
|
+
</table></div>
|
1642
|
+
</div>
|
1643
|
+
<hr>
|
1644
|
+
<div class="refsect2">
|
1645
|
+
<a name="AtkText-text-insert"></a><h3>The <code class="literal">"text-insert"</code> signal</h3>
|
1646
|
+
<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *atktext,
|
1647
|
+
<span class="type">gint</span> arg1,
|
1648
|
+
<span class="type">gint</span> arg2,
|
1649
|
+
<span class="type">gchar</span> *arg3,
|
1650
|
+
<span class="type">gpointer</span> user_data) : <code class="literal">Has Details</code></pre>
|
1651
|
+
<p>
|
1652
|
+
</p>
|
1653
|
+
<div class="variablelist"><table border="0">
|
1654
|
+
<col align="left" valign="top">
|
1655
|
+
<tbody>
|
1656
|
+
<tr>
|
1657
|
+
<td><p><span class="term"><em class="parameter"><code>atktext</code></em> :</span></p></td>
|
1658
|
+
<td>the object which received the signal.</td>
|
1659
|
+
</tr>
|
1660
|
+
<tr>
|
1661
|
+
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
1662
|
+
<td>user data set when the signal handler was connected.</td>
|
1663
|
+
</tr>
|
1664
|
+
</tbody>
|
1665
|
+
</table></div>
|
1666
|
+
</div>
|
1667
|
+
<hr>
|
1668
|
+
<div class="refsect2">
|
1669
|
+
<a name="AtkText-text-remove"></a><h3>The <code class="literal">"text-remove"</code> signal</h3>
|
1670
|
+
<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *atktext,
|
1671
|
+
<span class="type">gint</span> arg1,
|
1672
|
+
<span class="type">gint</span> arg2,
|
1673
|
+
<span class="type">gchar</span> *arg3,
|
1674
|
+
<span class="type">gpointer</span> user_data) : <code class="literal">Has Details</code></pre>
|
1675
|
+
<p>
|
1676
|
+
</p>
|
1677
|
+
<div class="variablelist"><table border="0">
|
1678
|
+
<col align="left" valign="top">
|
1679
|
+
<tbody>
|
1680
|
+
<tr>
|
1681
|
+
<td><p><span class="term"><em class="parameter"><code>atktext</code></em> :</span></p></td>
|
1682
|
+
<td>the object which received the signal.</td>
|
1683
|
+
</tr>
|
1684
|
+
<tr>
|
1685
|
+
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
1686
|
+
<td>user data set when the signal handler was connected.</td>
|
1687
|
+
</tr>
|
1688
|
+
</tbody>
|
1689
|
+
</table></div>
|
1690
|
+
</div>
|
1691
|
+
<hr>
|
1692
|
+
<div class="refsect2">
|
1693
|
+
<a name="AtkText-text-selection-changed"></a><h3>The <code class="literal">"text-selection-changed"</code> signal</h3>
|
1694
|
+
<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *atktext,
|
1695
|
+
<span class="type">gpointer</span> user_data) : <code class="literal">Run Last</code></pre>
|
1696
|
+
<p>
|
1697
|
+
The "text-selection-changed" signal is emitted when the selected text of
|
1698
|
+
an object which implements AtkText changes.
|
1699
|
+
</p>
|
1700
|
+
<div class="variablelist"><table border="0">
|
1701
|
+
<col align="left" valign="top">
|
1702
|
+
<tbody>
|
1703
|
+
<tr>
|
1704
|
+
<td><p><span class="term"><em class="parameter"><code>atktext</code></em> :</span></p></td>
|
1705
|
+
<td>the object which received the signal.</td>
|
1706
|
+
</tr>
|
1707
|
+
<tr>
|
1708
|
+
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
1709
|
+
<td>user data set when the signal handler was connected.</td>
|
1710
|
+
</tr>
|
1711
|
+
</tbody>
|
1712
|
+
</table></div>
|
1713
|
+
</div>
|
1714
|
+
<hr>
|
1715
|
+
<div class="refsect2">
|
1716
|
+
<a name="AtkText-text-update"></a><h3>The <code class="literal">"text-update"</code> signal</h3>
|
1717
|
+
<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="AtkText.html" title="AtkText"><span class="type">AtkText</span></a> *atktext,
|
1718
|
+
<span class="type">gint</span> arg1,
|
1719
|
+
<span class="type">gint</span> arg2,
|
1720
|
+
<span class="type">gint</span> arg3,
|
1721
|
+
<span class="type">gchar</span> *arg4,
|
1722
|
+
<span class="type">gpointer</span> user_data) : <code class="literal">Has Details</code></pre>
|
1723
|
+
<p>
|
1724
|
+
</p>
|
1725
|
+
<div class="variablelist"><table border="0">
|
1726
|
+
<col align="left" valign="top">
|
1727
|
+
<tbody>
|
1728
|
+
<tr>
|
1729
|
+
<td><p><span class="term"><em class="parameter"><code>atktext</code></em> :</span></p></td>
|
1730
|
+
<td>the object which received the signal.</td>
|
1731
|
+
</tr>
|
1732
|
+
<tr>
|
1733
|
+
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
1734
|
+
<td>user data set when the signal handler was connected.</td>
|
1735
|
+
</tr>
|
1736
|
+
</tbody>
|
1737
|
+
</table></div>
|
1738
|
+
</div>
|
1739
|
+
</div>
|
1740
|
+
</div>
|
1741
|
+
<div class="footer">
|
1742
|
+
<hr>
|
1743
|
+
Generated by GTK-Doc V1.18.1</div>
|
1744
|
+
</body>
|
1745
|
+
</html>
|