<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>at-spi-idl: Accessibility::Text Interface Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
<div class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li><a href="dirs.html"><span>Directories</span></a></li>
</ul>
</div>
<div class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Data Fields</span></a></li>
</ul>
</div>
<div class="navpath">
<ul>
<li><a class="el" href="namespaceAccessibility.html">Accessibility</a> </li>
<li><a class="el" href="interfaceAccessibility_1_1Text.html">Accessibility::Text</a> </li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#nested-classes">Data Structures</a> |
<a href="#pub-types">Public Types</a> |
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pub-attribs">Data Fields</a> </div>
<div class="headertitle">
<h1>Accessibility::Text Interface Reference</h1> </div>
</div>
<div class="contents">
<!-- doxytag: class="Accessibility::Text" -->
<p><code>import "<a class="el" href="Accessibility__Text_8idl_source.html">Accessibility_Text.idl</a>";</code></p>
<div class="dynheader">
Inheritance diagram for Accessibility::Text:</div>
<div class="dyncontent">
<div class="center">
<img src="interfaceAccessibility_1_1Text.png" usemap="#Accessibility::Text_map" alt=""/>
<map id="Accessibility::Text_map" name="Accessibility::Text_map">
<area href="interfaceAccessibility_1_1EditableText.html" alt="Accessibility::EditableText" shape="rect" coords="0,56,157,80"/>
</map>
</div>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="nested-classes"></a>
Data Structures</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structAccessibility_1_1Text_1_1Range.html">Range</a></td></tr>
<tr><td colspan="2"><h2><a name="pub-types"></a>
Public Types</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef sequence< <a class="el" href="structAccessibility_1_1Text_1_1Range.html">Range</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#a27aeba1ecd50aba1aa9fb8fe39f6e1f8">RangeList</a></td></tr>
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">string </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#ade7424139a67c4c178e16cad345823ab">getText</a> (in long startOffset, in long endOffset)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">boolean </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#a2cba9a784d5aed8ce3ecfcaa5bdffd9d">setCaretOffset</a> (in long offset)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">string </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#a846596d3a76efdfeb8e3ce294fc35d98">getTextBeforeOffset</a> (in long offset, in <a class="el" href="namespaceAccessibility.html#a3e168f50d58ee7d64d1b27927ddc9130">TEXT_BOUNDARY_TYPE</a> type, out long startOffset, out long endOffset)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">string </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#a554eb204bd9d6ab2a75b7e053e70d2ca">getTextAtOffset</a> (in long offset, in <a class="el" href="namespaceAccessibility.html#a3e168f50d58ee7d64d1b27927ddc9130">TEXT_BOUNDARY_TYPE</a> type, out long startOffset, out long endOffset)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">string </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#a7b63df8f9e540141ea4b420f17ecfdd9">getTextAfterOffset</a> (in long offset, in <a class="el" href="namespaceAccessibility.html#a3e168f50d58ee7d64d1b27927ddc9130">TEXT_BOUNDARY_TYPE</a> type, out long startOffset, out long endOffset)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">unsigned long </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#a07c9e8d4d5f7e7102d46be50cfeb2baf">getCharacterAtOffset</a> (in long offset)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">string </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#a6f553c0e924e52f618ec0b7e050d4223">getAttributeValue</a> (in long offset, in string attributeName, out long startOffset, out long endOffset, out boolean defined)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">string </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#a6fc2c01b914fb791fb190275f6ad188d">getAttributes</a> (in long offset, out long startOffset, out long endOffset)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">string </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#aab6c7995cc6d22b910239f8e329eb2c5">getDefaultAttributes</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#a04e3f1f5e1c3f10b96fa730bcc661005">getCharacterExtents</a> (in long offset, out long x, out long y, out long width, out long height, in short coordType)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">long </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#add07d139594223c4e7c245fdf169ce8f">getOffsetAtPoint</a> (in long x, in long y, in short coordType)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">long </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#aea43f631cffdaa5fbe4324cccc51d5e1">getNSelections</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#af97a056dca35c2eff12224d5254952a5">getSelection</a> (in long selectionNum, out long startOffset, out long endOffset)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">boolean </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#aa3a686107b240fe8b8791071a43638a3">addSelection</a> (in long startOffset, in long endOffset)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">boolean </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#a049bf51f2a07a7d27ed4115b74e688ae">removeSelection</a> (in long selectionNum)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">boolean </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#ace8652359a664c0efbad6715684e4e5d">setSelection</a> (in long selectionNum, in long startOffset, in long endOffset)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#ab8a32f0a5cc17038a1bd611939bd2d9b">getRangeExtents</a> (in long startOffset, in long endOffset, out long x, out long y, out long width, out long height, in short coordType)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="interfaceAccessibility_1_1Text.html#a27aeba1ecd50aba1aa9fb8fe39f6e1f8">RangeList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#a92af69cb3f5ae7a650fadc73621d227f">getBoundedRanges</a> (in long x, in long y, in long width, in long height, in short coordType, in <a class="el" href="namespaceAccessibility.html#a303d7dd2931c6ecd521f5dca847d5c7d">TEXT_CLIP_TYPE</a> xClipType, in <a class="el" href="namespaceAccessibility.html#a303d7dd2931c6ecd521f5dca847d5c7d">TEXT_CLIP_TYPE</a> yClipType)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="namespaceAccessibility.html#a917a6a01da45802ba562d131cae3c4e9">AttributeSet</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#ab32e3ccad6c10c73098c6a725f0e757e">getAttributeRun</a> (in long offset, out long startOffset, out long endOffset, in boolean includeDefaults)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="namespaceAccessibility.html#a917a6a01da45802ba562d131cae3c4e9">AttributeSet</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#a54127de49e5d05d4d48f715c3ff7116a">getDefaultAttributeSet</a> ()</td></tr>
<tr><td colspan="2"><h2><a name="pub-attribs"></a>
Data Fields</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">readonly attribute long </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#a525e8e06584efc964f32f1d7f2c7ade9">characterCount</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">readonly attribute long </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Text.html#aa95e0467813a17e6af426fbac6fd4323">caretOffset</a></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>The text interface should be implemented by objects which place textual information onscreen as character strings or glyphs. The text interface allows access to textual content, including display attributes and semantic hints associated with runs of text, and access to bounding box information for glyphs and substrings. It also allows portions of textual content to be selected, if the object's <a class="el" href="interfaceAccessibility_1_1StateSet.html">StateSet</a> includes STATE_SELECTABLE_TEXT.</p>
<p>In some cases a <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a> object may have, as its content, an empty string. In particular this can occur in the case of <a class="el" href="interfaceAccessibility_1_1Hypertext.html">Hypertext</a> objects which do not display explicitly textual information onscreen, as <a class="el" href="interfaceAccessibility_1_1Hypertext.html">Hypertext</a> is derived from the <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a> interface. </p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="interfaceAccessibility_1_1Hypertext.html">Hypertext</a>.</dd></dl>
<p>Typographic and semantic attributes of onscreen textual content, for instance typeface, weight, language, and such qualities as 'emphasis' or 'blockquote', are represented as text attributes. Contiguous sequences of characters over which these attributes are unchanged are referred to as "attribute runs", and are available via <a class="el" href="interfaceAccessibility_1_1Text.html#ab32e3ccad6c10c73098c6a725f0e757e">Text::getAttributeRun</a>. Where possible, implementing clients will report textual attributes which are the same over the entire text object, for instance those inherited from a default or document-scope style, via getDefaultAttributes instead of reporting them explicitly for each character. Therefore, for any span of text, the attributes in effect are the union of the set returned by <a class="el" href="interfaceAccessibility_1_1Text.html#aab6c7995cc6d22b910239f8e329eb2c5">Text::getDefaultAttributes</a>, and the set returned at a particular character offset via <a class="el" href="interfaceAccessibility_1_1Text.html#ab32e3ccad6c10c73098c6a725f0e757e">Text::getAttributeRun</a>.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>Events that may be emitted by instances of <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a> include: <ul>
<li><code>"object:text-attributes-changed"</code> The attributes of a range of text, or the range over which attributes apply, has changed. </li>
<li><code>"object:text-changed"</code> The text content of this object has changed. </li>
<li><code>"object:text-bounds-changed"</code> The character bounds of a text object have changed, for instance in response to a reformatting or reflow operation. </li>
<li><code>"object:text-caret-moved"</code> The character offset of the text caret (visible or notional) within this object has changed. Events of this type may also be generated when an onscreen text caret appears or disappears. </li>
<li><code>"object:text-selection-changed"</code> The range or number of text selections within this text object has changed.</li>
</ul>
</dd>
<dd>
In some cases, objects which are not onscreen may implement <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a>, but if such objects implement <a class="el" href="interfaceAccessibility_1_1Component.html">Component</a>, their potential visibility should be examined (via comparison with STATE_VISIBLE and STATE_SHOWING) before exposing them to the user. Objects which implement <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a> but not <a class="el" href="interfaceAccessibility_1_1Component.html">Component</a> may be encountered in special-purpose interfaces or as special ¨accessibility¨ extensions to visual interfaces to allow non-graphical access to application features. These instances should be considered the exception, rather than the rule. </dd></dl>
<hr/><h2>Member Typedef Documentation</h2>
<a class="anchor" id="a27aeba1ecd50aba1aa9fb8fe39f6e1f8"></a><!-- doxytag: member="Accessibility::Text::RangeList" ref="a27aeba1ecd50aba1aa9fb8fe39f6e1f8" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef sequence<<a class="el" href="structAccessibility_1_1Text_1_1Range.html">Range</a>> <a class="el" href="interfaceAccessibility_1_1Text.html#a27aeba1ecd50aba1aa9fb8fe39f6e1f8">Accessibility::Text::RangeList</a></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="aa3a686107b240fe8b8791071a43638a3"></a><!-- doxytag: member="Accessibility::Text::addSelection" ref="aa3a686107b240fe8b8791071a43638a3" args="(in long startOffset, in long endOffset)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">boolean Accessibility::Text::addSelection </td>
<td>(</td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>startOffset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>endOffset</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The result of calling addSelection on objects which already have one selection present, and which do not include STATE_MULTISELECTABLE, is undefined, other than the return value. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>True</code> of the selection was successfully added, <code>False</code> otherwise. <a class="el" href="interfaceAccessibility_1_1Selection.html">Selection</a> may fail if the object does not support selection of text (see STATE_SELECTABLE_TEXT), if the object does not support multiple selections and a selection is already defined, or for other reasons (for instance if the user does not have permission to copy the text into the relevant selection buffer). </dd></dl>
</div>
</div>
<a class="anchor" id="ab32e3ccad6c10c73098c6a725f0e757e"></a><!-- doxytag: member="Accessibility::Text::getAttributeRun" ref="ab32e3ccad6c10c73098c6a725f0e757e" args="(in long offset, out long startOffset, out long endOffset, in boolean includeDefaults)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="namespaceAccessibility.html#a917a6a01da45802ba562d131cae3c4e9">AttributeSet</a> Accessibility::Text::getAttributeRun </td>
<td>(</td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>startOffset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>endOffset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in boolean </td>
<td class="paramname"> <em>includeDefaults</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Query a particular text object for the text attributes defined at a given offset, obtaining the start and end of the "attribute run" over which these attributes are currently invariant. <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a> attributes are those presentational, typographic, or semantic attributes or qualitites which apply to a range of text specifyable by starting and ending offsets. Attributes relevant to localization should be provided in accordance with the w3c "Internationalization and Localization Markup Requirements", <a href="http://www.w3.org/TR/2005/WD-itsreq-20051122/">http://www.w3.org/TR/2005/WD-itsreq-20051122/</a> Other text attributes should choose their names and value semantics in accordance with relevant standards such as CSS level 2 (<a href="http://www.w3.org/TR/1998/REC-CSS2-19980512">http://www.w3.org/TR/1998/REC-CSS2-19980512</a>), XHTML 1.0 (<a href="http://www.w3.org/TR/2002/REC-xhtml1-20020801">http://www.w3.org/TR/2002/REC-xhtml1-20020801</a>), and WICD (<a href="http://www.w3.org/TR/2005/WD-WICD-20051121/">http://www.w3.org/TR/2005/WD-WICD-20051121/</a>). Those attributes from the aforementioned specifications and recommendations which do not concern typographic, presentational, or semantic aspects of text should be exposed via the more general <a class="el" href="interfaceAccessibility_1_1Accessible.html#a576e030f726cf576a67746750e967442">Accessible::getAttributes()</a> API (if at all).</p>
<p>For example, CSS attributes which should be exposed on text (either as default attributes, or as explicitly-set attributes when non-default values are specified in the content view) include the Font attributes (i.e. "css2:font-weight", "css2:font-style"), the "css2:color" and "css2:background-color" attributes, and "css2:text-decoration" attribute.</p>
<p>If includeDefaults is TRUE, then this AttributeSet should include the default attributes as well as those which are explicitly assigned to the attribute run in question. startOffset and endOffset will be back-filled to indicate the start and end of the attribute run which contains 'offset' - an attribute run is a contiguous section of text whose attributes are homogeneous. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>offset</em> </td><td>the offset of the character whose attributes will be reported. -1 means the offset of the character to be inserted at the caret location. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>startOffset</em> </td><td>backfilled with the starting offset of the character range over which all text attributes match those of <code>offset</code>, i.e. the start of the homogeneous attribute run including <code>offset</code>. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>endOffset</em> </td><td>backfilled with the offset of the first character past the character range over which all text attributes match those of <code>offset</code>, i.e. the character immediately after the homogeneous attribute run including <code>offset</code>. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>includeDefaults</em> </td><td>if False, the call should only return those attributes which are explicitly set on the current attribute run, omitting any attributes which are inherited from the default values. See also <a class="el" href="interfaceAccessibility_1_1Text.html#aab6c7995cc6d22b910239f8e329eb2c5">Text::getDefaultAttributes</a>.</td></tr>
</table>
</dd>
</dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Clients seeking annotations or properties of a more general nature, which are not specific to the onscreen textual content of objects and cannot logically be applied to specific character offset ranges, should use <a class="el" href="interfaceAccessibility_1_1Accessible.html#a576e030f726cf576a67746750e967442">Accessible::getAttributes</a> instead. The attributes returned by <a class="el" href="interfaceAccessibility_1_1Text.html#ab32e3ccad6c10c73098c6a725f0e757e">Text::getAttributeRun</a> (with or without 'default attributes'), are distinct from the properties/attributes returned by <a class="el" href="interfaceAccessibility_1_1Accessible.html#a576e030f726cf576a67746750e967442">Accessible::getAttributes</a>.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="interfaceAccessibility_1_1Accessible.html#a576e030f726cf576a67746750e967442">Accessible::getAttributes</a></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the AttributeSet defined at offset, optionally including the 'default' attributes.</dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>AT-SPI 1.7.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a6fc2c01b914fb791fb190275f6ad188d"></a><!-- doxytag: member="Accessibility::Text::getAttributes" ref="a6fc2c01b914fb791fb190275f6ad188d" args="(in long offset, out long startOffset, out long endOffset)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">string Accessibility::Text::getAttributes </td>
<td>(</td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>startOffset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>endOffset</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>getAttributes is deprecated in favor of getAttributeRun. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the attributes at offset, as a semicolon-delimited set of colon-delimited name-value pairs. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="interfaceAccessibility_1_1Text.html#ab32e3ccad6c10c73098c6a725f0e757e">getAttributeRun</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a6f553c0e924e52f618ec0b7e050d4223"></a><!-- doxytag: member="Accessibility::Text::getAttributeValue" ref="a6f553c0e924e52f618ec0b7e050d4223" args="(in long offset, in string attributeName, out long startOffset, out long endOffset, out boolean defined)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">string Accessibility::Text::getAttributeValue </td>
<td>(</td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in string </td>
<td class="paramname"> <em>attributeName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>startOffset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>endOffset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out boolean </td>
<td class="paramname"> <em>defined</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the string value of a named attribute at a given offset, if defined. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>offset</em> </td><td>the offset of the character for which the attribute run is to be obtained. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>attributeName</em> </td><td>the name of the attribute for which the value is to be returned, if defined. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>startOffset</em> </td><td>back-filled with the offset of the first character in the attribute run containing the character at <code>offset</code>. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>endOffset</em> </td><td>back-filled with the offset of the first character past the end of the attribute run containing the character at <code>offset</code>. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>defined</em> </td><td>back-filled with <code>True</code> if the attributeName has a defined value at <code>offset</code>, <code>False</code> otherwise. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the value of attribute (name-value pair) corresponding to "name", if defined. </dd></dl>
</div>
</div>
<a class="anchor" id="a92af69cb3f5ae7a650fadc73621d227f"></a><!-- doxytag: member="Accessibility::Text::getBoundedRanges" ref="a92af69cb3f5ae7a650fadc73621d227f" args="(in long x, in long y, in long width, in long height, in short coordType, in TEXT_CLIP_TYPE xClipType, in TEXT_CLIP_TYPE yClipType)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="interfaceAccessibility_1_1Text.html#a27aeba1ecd50aba1aa9fb8fe39f6e1f8">RangeList</a> Accessibility::Text::getBoundedRanges </td>
<td>(</td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>x</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>y</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>width</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>height</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in short </td>
<td class="paramname"> <em>coordType</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in <a class="el" href="namespaceAccessibility.html#a303d7dd2931c6ecd521f5dca847d5c7d">TEXT_CLIP_TYPE</a> </td>
<td class="paramname"> <em>xClipType</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in <a class="el" href="namespaceAccessibility.html#a303d7dd2931c6ecd521f5dca847d5c7d">TEXT_CLIP_TYPE</a> </td>
<td class="paramname"> <em>yClipType</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return the text content within a bounding box, as a list of <a class="el" href="structAccessibility_1_1Text_1_1Range.html">Range</a> structures. Depending on the TEXT_CLIP_TYPE parameters, glyphs which are clipped by the bounding box (i.e. which lie partially inside and partially outside it) may or may not be included in the ranges returned. </p>
<dl class="note"><dt><b>Note:</b></dt><dd>This method may be of particular interest to screen review algorithms. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="namespaceAccessibility.html#a303d7dd2931c6ecd521f5dca847d5c7d">TEXT_CLIP_TYPE</a>. </dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>x</em> </td><td>the minimum x ( i.e. leftmost) coordinate of the bounding box. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>y</em> </td><td>the minimum y coordinate of the bounding box. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>width</em> </td><td>the horizontal size of the bounding box. The rightmost bound of the bounding box is (x + width); </td></tr>
<tr><td valign="top"></td><td valign="top"><em>height</em> </td><td>the vertical size of the bounding box. The maximum y value of the bounding box is (y + height); </td></tr>
<tr><td valign="top"></td><td valign="top"><em>coordType</em> </td><td>If 0, the above coordinates are interpreted as pixels relative to corner of the screen; if 1, the coordinates are interpreted as pixels relative to the corner of the containing toplevel window. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>xClipType</em> </td><td>determines whether text which intersects the bounding box in the x direction is included. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>yClipType</em> </td><td>determines whether text which intersects the bounding box in the y direction is included. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a07c9e8d4d5f7e7102d46be50cfeb2baf"></a><!-- doxytag: member="Accessibility::Text::getCharacterAtOffset" ref="a07c9e8d4d5f7e7102d46be50cfeb2baf" args="(in long offset)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">unsigned long Accessibility::Text::getCharacterAtOffset </td>
<td>(</td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>offset</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="return"><dt><b>Returns:</b></dt><dd>an unsigned long integer whose value corresponds to the UCS-4 representation of the character at the specified text offset, or 0 if offset is out of range. </dd></dl>
</div>
</div>
<a class="anchor" id="a04e3f1f5e1c3f10b96fa730bcc661005"></a><!-- doxytag: member="Accessibility::Text::getCharacterExtents" ref="a04e3f1f5e1c3f10b96fa730bcc661005" args="(in long offset, out long x, out long y, out long width, out long height, in short coordType)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Accessibility::Text::getCharacterExtents </td>
<td>(</td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>x</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>y</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>width</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>height</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in short </td>
<td class="paramname"> <em>coordType</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain a the bounding box, as x, y, width, and height, of the character or glyph at a particular character offset in this object's text content. The coordinate system in which the results are reported is specified by coordType. If an onscreen glyph corresponds to multiple character offsets, for instance if the glyph is a ligature, the bounding box reported will include the entire glyph and therefore may apply to more than one character offset. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>offset</em> </td><td>the character offset of the character or glyph being queried. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>x</em> </td><td>the minimum horizontal coordinate of the bounding box of the glyph representing the character at <code>offset</code>. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>y</em> </td><td>the minimum vertical coordinate of the bounding box of the glyph representing the character at <code>offset</code>. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>width</em> </td><td>the horizontal extent of the bounding box of the glyph representing the character at <code>offset</code>. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>height</em> </td><td>the vertical extent of the bounding box of the glyph representing the character at <code>offset</code>. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>coordType</em> </td><td>If 0, the results will be reported in screen coordinates, i.e. in pixels relative to the upper-left corner of the screen, with the x axis pointing right and the y axis pointing down. If 1, the results will be reported relative to the containing toplevel window, with the x axis pointing right and the y axis pointing down. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="aab6c7995cc6d22b910239f8e329eb2c5"></a><!-- doxytag: member="Accessibility::Text::getDefaultAttributes" ref="aab6c7995cc6d22b910239f8e329eb2c5" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">string Accessibility::Text::getDefaultAttributes </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Deprecated in favor of getDefaultAttributeSet. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the attributes which apply to the entire text content, but which were not explicitly specified by the content creator. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="interfaceAccessibility_1_1Text.html#a54127de49e5d05d4d48f715c3ff7116a">getDefaultAttributeSet</a> </dd></dl>
</div>
</div>
<a class="anchor" id="a54127de49e5d05d4d48f715c3ff7116a"></a><!-- doxytag: member="Accessibility::Text::getDefaultAttributeSet" ref="a54127de49e5d05d4d48f715c3ff7116a" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="namespaceAccessibility.html#a917a6a01da45802ba562d131cae3c4e9">AttributeSet</a> Accessibility::Text::getDefaultAttributeSet </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return an <a class="el" href="namespaceAccessibility.html#a917a6a01da45802ba562d131cae3c4e9">AttributeSet</a> containing the text attributes which apply to all text in the object by virtue of the default settings of the document, view, or user agent; e.g. those attributes which are implied rather than explicitly applied to the text object. For instance, an object whose entire text content has been explicitly marked as 'bold' will report the 'bold' attribute via <a class="el" href="interfaceAccessibility_1_1Text.html#ab32e3ccad6c10c73098c6a725f0e757e">getAttributeRun()</a>, whereas an object whose text weight is inspecified may report the default or implied text weight in the default AttributeSet.</p>
<dl class="since"><dt><b>Since:</b></dt><dd>AT-SPI 1.7.0 </dd></dl>
</div>
</div>
<a class="anchor" id="aea43f631cffdaa5fbe4324cccc51d5e1"></a><!-- doxytag: member="Accessibility::Text::getNSelections" ref="aea43f631cffdaa5fbe4324cccc51d5e1" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">long Accessibility::Text::getNSelections </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain the number of separate, contiguous selections in the current <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a> object. <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a> objects which do not implement selection of discontiguous text regions will always return '0' or '1'. Note that "contiguous" is defined by continuity of the offsets, i.e. a text 'selection' is defined by a start/end offset pair. In the case of bidirectional text, this means that a continguous selection may appear visually discontiguous, and vice-versa.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the number of contiguous selections in the current <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a> object. </dd></dl>
</div>
</div>
<a class="anchor" id="add07d139594223c4e7c245fdf169ce8f"></a><!-- doxytag: member="Accessibility::Text::getOffsetAtPoint" ref="add07d139594223c4e7c245fdf169ce8f" args="(in long x, in long y, in short coordType)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">long Accessibility::Text::getOffsetAtPoint </td>
<td>(</td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>x</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>y</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in short </td>
<td class="paramname"> <em>coordType</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the offset of the character at a given onscreen coordinate. The coordinate system used to interpret x and y is determined by parameter coordType. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>x</em> </td><td></td></tr>
<tr><td valign="top"></td><td valign="top"><em>y</em> </td><td></td></tr>
<tr><td valign="top"></td><td valign="top"><em>coordType</em> </td><td>if 0, the input coordinates are interpreted relative to the entire screen, if 1, they are relative to the toplevel window containing this <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a> object. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the text offset (as an offset into the character array) of the glyph whose onscreen bounds contain the point x,y, or -1 if the point is outside the bounds of any glyph. </dd></dl>
</div>
</div>
<a class="anchor" id="ab8a32f0a5cc17038a1bd611939bd2d9b"></a><!-- doxytag: member="Accessibility::Text::getRangeExtents" ref="ab8a32f0a5cc17038a1bd611939bd2d9b" args="(in long startOffset, in long endOffset, out long x, out long y, out long width, out long height, in short coordType)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Accessibility::Text::getRangeExtents </td>
<td>(</td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>startOffset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>endOffset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>x</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>y</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>width</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>height</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in short </td>
<td class="paramname"> <em>coordType</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain the bounding box which entirely contains a given text range. Negative values may be returned for the bounding box parameters in the event that all or part of the text range is offscreen or not mapped to the screen. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>startOffset</em> </td><td>the offset of the first character in the specified range. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>endOffset</em> </td><td>the offset of the character immediately after the last character in the specified range. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>x</em> </td><td>an integer parameter which is back-filled with the minimum horizontal coordinate of the resulting bounding box. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>y</em> </td><td>an integer parameter which is back-filled with the minimum vertical coordinate of the resulting bounding box. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>width</em> </td><td>an integer parameter which is back-filled with the horizontal extent of the bounding box. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>height</em> </td><td>an integer parameter which is back-filled with the vertical extent of the bounding box. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>coordType</em> </td><td>If 0, the above coordinates are reported in pixels relative to corner of the screen; if 1, the coordinates are reported relative to the corner of the containing toplevel window. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="af97a056dca35c2eff12224d5254952a5"></a><!-- doxytag: member="Accessibility::Text::getSelection" ref="af97a056dca35c2eff12224d5254952a5" args="(in long selectionNum, out long startOffset, out long endOffset)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Accessibility::Text::getSelection </td>
<td>(</td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>selectionNum</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>startOffset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>endOffset</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The result of calling getSelection with an out-of-range selectionNum (i.e. for a selection which does not exist) is not strictly defined, but should set endOffset equal to startOffset. </p>
</div>
</div>
<a class="anchor" id="ade7424139a67c4c178e16cad345823ab"></a><!-- doxytag: member="Accessibility::Text::getText" ref="ade7424139a67c4c178e16cad345823ab" args="(in long startOffset, in long endOffset)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">string Accessibility::Text::getText </td>
<td>(</td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>startOffset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>endOffset</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain all or part of the onscreen textual content of a <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a> object. If endOffset is specified as "-1", then this method will return the entire onscreen textual contents of the <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a> object. </p>
<dl class="note"><dt><b>Note:</b></dt><dd>'onscreen' in this context means "potentially onscreen", this method does not perform any sort of coordinate visibility clipping or window-stack-ordering clipping. The text thus reported corresponds to the text which would be presented onscreen if the object implementing the <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a> interface were entirely unobscured. </dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the textual content of the current <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a> object beginning startOffset (inclusive) up to but not including the character at endOffset. </dd></dl>
</div>
</div>
<a class="anchor" id="a7b63df8f9e540141ea4b420f17ecfdd9"></a><!-- doxytag: member="Accessibility::Text::getTextAfterOffset" ref="a7b63df8f9e540141ea4b420f17ecfdd9" args="(in long offset, in TEXT_BOUNDARY_TYPE type, out long startOffset, out long endOffset)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">string Accessibility::Text::getTextAfterOffset </td>
<td>(</td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in <a class="el" href="namespaceAccessibility.html#a3e168f50d58ee7d64d1b27927ddc9130">TEXT_BOUNDARY_TYPE</a> </td>
<td class="paramname"> <em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>startOffset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>endOffset</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain a subset of the text content of an object which entirely follows <code>offset</code>, delimited by character, word, line, or sentence boundaries as specified by <code>type</code>. The starting and ending offsets of the resulting substring are returned in <code>startOffset</code> and <code>endOffset</code>. By definition, if such a substring exists, <code>startOffset</code> must be greater than <code>offset</code>. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>offset</em> </td><td>the offset from which the substring search begins, and which must lie before the returned substring. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>type</em> </td><td>the text-boundary delimiter which determines whether the returned text constitures a character, word, line, or sentence (and possibly attendant whitespace), and whether the start or ending of such a substring forms the boundary condition. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>startOffset</em> </td><td>back-filled with the starting offset of the resulting substring, if one exists. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>endOffset</em> </td><td>back-filled with the offset of the character immediately following the resulting substring, if one exists. </td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="namespaceAccessibility.html#a3e168f50d58ee7d64d1b27927ddc9130">TEXT_BOUNDARY_TYPE</a> </dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a string which is a substring of the text content of the object, delimited by the specified boundary condition. </dd></dl>
</div>
</div>
<a class="anchor" id="a554eb204bd9d6ab2a75b7e053e70d2ca"></a><!-- doxytag: member="Accessibility::Text::getTextAtOffset" ref="a554eb204bd9d6ab2a75b7e053e70d2ca" args="(in long offset, in TEXT_BOUNDARY_TYPE type, out long startOffset, out long endOffset)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">string Accessibility::Text::getTextAtOffset </td>
<td>(</td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in <a class="el" href="namespaceAccessibility.html#a3e168f50d58ee7d64d1b27927ddc9130">TEXT_BOUNDARY_TYPE</a> </td>
<td class="paramname"> <em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>startOffset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>endOffset</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain a subset of the text content of an object which includes the specified <code>offset</code>, delimited by character, word, line, or sentence boundaries as specified by <code>type</code>. The starting and ending offsets of the resulting substring are returned in <code>startOffset</code> and <code>endOffset</code>. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>offset</em> </td><td>the offset from which the substring search begins, and which must lie within the returned substring. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>type</em> </td><td>the text-boundary delimiter which determines whether the returned text constitures a character, word, line, or sentence (and possibly attendant whitespace), and whether the start or ending of such a substring forms the boundary condition. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>startOffset</em> </td><td>back-filled with the starting offset of the resulting substring, if one exists. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>endOffset</em> </td><td>back-filled with the offset of the character immediately following the resulting substring, if one exists. </td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="namespaceAccessibility.html#a3e168f50d58ee7d64d1b27927ddc9130">TEXT_BOUNDARY_TYPE</a> </dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a string which is a substring of the text content of the object, delimited by the specified boundary condition. </dd></dl>
</div>
</div>
<a class="anchor" id="a846596d3a76efdfeb8e3ce294fc35d98"></a><!-- doxytag: member="Accessibility::Text::getTextBeforeOffset" ref="a846596d3a76efdfeb8e3ce294fc35d98" args="(in long offset, in TEXT_BOUNDARY_TYPE type, out long startOffset, out long endOffset)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">string Accessibility::Text::getTextBeforeOffset </td>
<td>(</td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>offset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in <a class="el" href="namespaceAccessibility.html#a3e168f50d58ee7d64d1b27927ddc9130">TEXT_BOUNDARY_TYPE</a> </td>
<td class="paramname"> <em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>startOffset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>endOffset</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain a subset of the text content of an object which entirely precedes <code>offset</code>, delimited by character, word, line, or sentence boundaries as specified by <code>type</code>. The starting and ending offsets of the resulting substring are returned in <code>startOffset</code> and <code>endOffset</code>. By definition, if such a substring exists, <code>endOffset</code> is less than or equal to <code>offset</code>. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>offset</em> </td><td>the offset from which the substring search begins. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>type</em> </td><td>the text-boundary delimiter which determines whether the returned text constitures a character, word, line, or sentence (and possibly attendant whitespace), and whether the start or ending of such a substring forms the boundary condition. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>startOffset</em> </td><td>back-filled with the starting offset of the resulting substring, if one exists. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>endOffset</em> </td><td>back-filled with the offset of the character immediately following the resulting substring, if one exists. </td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="namespaceAccessibility.html#a3e168f50d58ee7d64d1b27927ddc9130">TEXT_BOUNDARY_TYPE</a> </dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a string which is a substring of the text content of the object, delimited by the specified boundary condition. </dd></dl>
</div>
</div>
<a class="anchor" id="a049bf51f2a07a7d27ed4115b74e688ae"></a><!-- doxytag: member="Accessibility::Text::removeSelection" ref="a049bf51f2a07a7d27ed4115b74e688ae" args="(in long selectionNum)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">boolean Accessibility::Text::removeSelection </td>
<td>(</td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>selectionNum</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Deselect the text contained in the specified selectionNum, if such a selection exists, otherwise do nothing. Removal of a non-existant selectionNum has no effect. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>True</code> if the selection was successfully removed, <code>False</code> otherwise. </dd></dl>
</div>
</div>
<a class="anchor" id="a2cba9a784d5aed8ce3ecfcaa5bdffd9d"></a><!-- doxytag: member="Accessibility::Text::setCaretOffset" ref="a2cba9a784d5aed8ce3ecfcaa5bdffd9d" args="(in long offset)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">boolean Accessibility::Text::setCaretOffset </td>
<td>(</td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>offset</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Programmatically move the text caret (visible or virtual, as above) to a given position. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>offset</em> </td><td>a long int indicating the desired character offset. Not all implementations of <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a> will honor setCaretOffset requests, so the return value below should be checked by the client. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>TRUE</code> if the request was carried out, or <code>FALSE</code> if the caret could not be moved to the requested position. </dd></dl>
</div>
</div>
<a class="anchor" id="ace8652359a664c0efbad6715684e4e5d"></a><!-- doxytag: member="Accessibility::Text::setSelection" ref="ace8652359a664c0efbad6715684e4e5d" args="(in long selectionNum, in long startOffset, in long endOffset)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">boolean Accessibility::Text::setSelection </td>
<td>(</td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>selectionNum</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>startOffset</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in long </td>
<td class="paramname"> <em>endOffset</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Modify an existing selection's start or ending offset.</p>
<p>Calling setSelection for a selectionNum that is not already defined has no effect. The result of calling setSelection with a selectionNum greater than 0 for objects that do not include STATE_MULTISELECTABLE is undefined. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>selectionNum</em> </td><td>indicates which of a set of non-contiguous selections to modify. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>startOffset</em> </td><td>the new starting offset for the selection </td></tr>
<tr><td valign="top"></td><td valign="top"><em>endOffset</em> </td><td>the new ending offset for the selection </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>True</code> if the selection corresponding to selectionNum is successfully modified, <code>False</code> otherwise. </dd></dl>
</div>
</div>
<hr/><h2>Field Documentation</h2>
<a class="anchor" id="aa95e0467813a17e6af426fbac6fd4323"></a><!-- doxytag: member="Accessibility::Text::caretOffset" ref="aa95e0467813a17e6af426fbac6fd4323" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">readonly attribute long <a class="el" href="interfaceAccessibility_1_1Text.html#aa95e0467813a17e6af426fbac6fd4323">Accessibility::Text::caretOffset</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The current offset of the text caret in the <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a> object. This caret may be virtual, e.g. non-visual and notional-only, but if an onscreen representation of the caret position is visible, it will correspond to this offset. The caret offset is given as a character offset, as opposed to a byte offset into a text buffer or a column offset. </p>
</div>
</div>
<a class="anchor" id="a525e8e06584efc964f32f1d7f2c7ade9"></a><!-- doxytag: member="Accessibility::Text::characterCount" ref="a525e8e06584efc964f32f1d7f2c7ade9" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">readonly attribute long <a class="el" href="interfaceAccessibility_1_1Text.html#a525e8e06584efc964f32f1d7f2c7ade9">Accessibility::Text::characterCount</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The total current number of characters in the <a class="el" href="interfaceAccessibility_1_1Text.html">Text</a> object, including whitespace and non-spacing characters. </p>
</div>
</div>
<hr/>The documentation for this interface was generated from the following file:<ul>
<li>/home/liyuan/src/at-spi/idl/<a class="el" href="Accessibility__Text_8idl_source.html">Accessibility_Text.idl</a></li>
</ul>
</div>
<hr class="footer"/><address class="footer"><small>Generated on Mon Sep 27 2010 16:50:43 for at-spi-idl by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.1 </small></address>
</body>
</html>
