<!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::StreamableContent 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_1StreamableContent.html">Accessibility::StreamableContent</a> </li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> </div>
<div class="headertitle">
<h1>Accessibility::StreamableContent Interface Reference</h1> </div>
</div>
<div class="contents">
<!-- doxytag: class="Accessibility::StreamableContent" -->
<p><code>import "<a class="el" href="Accessibility__StreamableContent_8idl_source.html">Accessibility_StreamableContent.idl</a>";</code></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="namespaceAccessibility.html#af0a087a022848a7c6610ad237ecc845d">StringSeq</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1StreamableContent.html#a0c845bf7f9b0b375d349d469709b0310">getContentTypes</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">Bonobo::Stream </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1StreamableContent.html#a673765180c88d1bc9050b6463570dc2d">getContent</a> (in string contentType)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="interfaceAccessibility_1_1ContentStream.html">ContentStream</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1StreamableContent.html#a9504205fd5db0ab430f31f9da372ba83">getStream</a> (in string contentType)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">string </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1StreamableContent.html#a1b403cb08c57d7319ad2537134b1662b">getURI</a> (in string contentType)</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>An interface whereby an object allows its backing content to be streamed to clients. Negotiation of content type is allowed. Clients may examine the backing data and transform, convert, or parse the content in order to present it in an alternate form to end-users.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>The <a class="el" href="interfaceAccessibility_1_1StreamableContent.html">StreamableContent</a> interface is particularly useful for saving, printing, or post-processing entire documents, or for persisting alternate views of a document. If document content itself is being serialized, stored, or converted, then use of the <a class="el" href="interfaceAccessibility_1_1StreamableContent.html">StreamableContent</a> interface can help address performance issues. Unlike most AT-SPI/Accessibility interfaces, this interface is not strongly tied to the current user-agent view of the a particular document, but may in some cases give access to the underlying model data. </dd></dl>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a673765180c88d1bc9050b6463570dc2d"></a><!-- doxytag: member="Accessibility::StreamableContent::getContent" ref="a673765180c88d1bc9050b6463570dc2d" args="(in string contentType)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Bonobo::Stream Accessibility::StreamableContent::getContent </td>
<td>(</td>
<td class="paramtype">in string </td>
<td class="paramname"> <em>contentType</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p><br/>
DEPRECATED, use getStream instead. getContent: Retrieve this object's content, in a format appropriate to a requested mimetype.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>the data is returned as an object of type Bonobo::Stream. The primary methods which are supported on Bonobo::Streams for the purposes of the StreamableContent API are <code>seek</code> and <code>read</code>. <code>seek</code> may not be supported for all mimetypes or all implementors.</dd></dl>
<div class="fragment"><pre class="fragment">
long Bonobo::Stream:seek (in long offset, in SeekType whence)
raises (NoPermission, IOError)
void Bonobo::Stream:read (in long count, out iobuf buffer)
raises (NoPermission, IOError)
</pre></div><dl class="see"><dt><b>See also:</b></dt><dd>Bonobo::Stream</dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a Bonobo::Stream whose mimetype matches <em>contentType</em>, if available, or <code>NIL</code>. </dd></dl>
</div>
</div>
<a class="anchor" id="a0c845bf7f9b0b375d349d469709b0310"></a><!-- doxytag: member="Accessibility::StreamableContent::getContentTypes" ref="a0c845bf7f9b0b375d349d469709b0310" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="namespaceAccessibility.html#af0a087a022848a7c6610ad237ecc845d">StringSeq</a> Accessibility::StreamableContent::getContentTypes </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>getContentTypes: </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the list of available mimetypes for this object's content. </dd></dl>
</div>
</div>
<a class="anchor" id="a9504205fd5db0ab430f31f9da372ba83"></a><!-- doxytag: member="Accessibility::StreamableContent::getStream" ref="a9504205fd5db0ab430f31f9da372ba83" args="(in string contentType)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="interfaceAccessibility_1_1ContentStream.html">ContentStream</a> Accessibility::StreamableContent::getStream </td>
<td>(</td>
<td class="paramtype">in string </td>
<td class="paramname"> <em>contentType</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Retrieve this object's content, in a format appropriate to a requested mimetype, as a ContentStream instance.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>This method supercedes the older getContent method, which relied on the Bonobo::Stream API. <code>seek</code> may not be supported for all mimetypes or all implementors.</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>contentType</em> </td><td>a string specifying the desired mimetype for the content stream. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a Stream whose mimetype matches <em>contentType</em>, if available, or <code>NIL</code>. </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>AT-SPI 1.8.0 </dd></dl>
</div>
</div>
<a class="anchor" id="a1b403cb08c57d7319ad2537134b1662b"></a><!-- doxytag: member="Accessibility::StreamableContent::getURI" ref="a1b403cb08c57d7319ad2537134b1662b" args="(in string contentType)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">string Accessibility::StreamableContent::getURI </td>
<td>(</td>
<td class="paramtype">in string </td>
<td class="paramname"> <em>contentType</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get a URI pointing to the content of the specified type, if such a URI can be obtained. Not all streamable content providers have URI representations.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>contentType</em> </td><td>a string specifying the desired mimetype for the content stream. If NULL, then a URI for the default content type will be returned, if available.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a string which constitutes a URI for a stream of the specified content type, or NULL if no such URI can be obtained. </dd></dl>
</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__StreamableContent_8idl_source.html">Accessibility_StreamableContent.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>
