<?xml version="1.0" encoding="UTF-8"?>
<node xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0" name="/node">
-
-
-
-
-
<interface name="org.freedesktop.atspi.ContentStream">
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
<p>An interface by which the requested data from a StreamableContent object
- may be read by the client.
- @note this interface supercedes the use of BonoboStream by previous
- versions of StreamableContent. </p>
-
- <p>@since AT-SPI 1.7.0 </p>
+ may be read by the client.</p>
</tp:docstring>
</interface>
<tp:enum name="SeekType" type="u">
</tp:docstring>
<tp:enumvalue suffix="SEEK_SET">
<tp:docstring>
- < Seek from the start of the stream or data source.
+ Seek from the start of the stream or data source.
</tp:docstring>
</tp:enumvalue>
<tp:enumvalue suffix="SEEK_CURRENT" value="1">
<tp:docstring>
- < Seek relative to the current position.
+ Seek relative to the current position.
</tp:docstring>
</tp:enumvalue>
<tp:enumvalue suffix="SEEK_END" value="2">
<tp:docstring>
- < Seek from the end of the file, stream, or data source.
+ Seek from the end of the file, stream, or data source.
</tp:docstring>
</tp:enumvalue>
</tp:enum>
</tp:errors>
<method name="seek">
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>Seek to a specified position in the Stream.
- @param offset an offset specifying the requested position in the stream,
- relative to the SeekType specified in \c whence.
- @param whence a SeekType specifying the reference point from which the
- seek offset is calculated. Some forms of seek are not supported by certain
- implementations of Stream, in which case a NotSupported exception will be raised.</p>
+ <p>Seek to a specified position in the Stream.</p>
</tp:docstring>
- <arg direction="in" name="offset" type="i"/>
- <arg direction="in" name="whence" type="u" tp:type="SeekType"/>
+ <arg direction="in" name="offset" type="i">
+ <tp:docstring>
+ An offset specifying the requested position in the stream,
+ relative to the SeekType specified in <code>whence.</code>
+ </tp:docstring>
+ </arg>
+ <arg direction="in" name="whence" type="u" tp:type="SeekType">
+ <tp:docstring>
+ A SeekType specifying the reference point from which the
+ seek offset is calculated. Some forms of seek are not supported by certain
+ implementations of Stream, in which case a NotSupported exception will be raised.
+ </tp:docstring>
+ </arg>
<arg direction="out" type="i">
<tp:docstring>
- the actual resulting offset, if no exception was raised.
+ The actual resulting offset, if no exception was raised.
</tp:docstring>
</arg>
<tp:possible-errors>
<arg direction="out" name="buffer" type="ay" tp:type="iobuf"/>
<arg direction="out" type="i">
<tp:docstring>
- the number of bytes actually read into the client buffer.
+ The number of bytes actually read into the client buffer.
</tp:docstring>
</arg>
<tp:possible-errors>
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
<p>close the stream and release associated resources.
A client should not perform further operations on a
- StreamableContent::Stream object after closing it.</p>
- </tp:docstring>
-</method>
-<method name="unimplemented">
- <tp:docstring>
- /cond
+ StreamableContent.Stream object after closing it.</p>
</tp:docstring>
</method>
-<method name="unimplemented2">
-</method>
<interface name="org.freedesktop.atspi.StreamableContent">
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
<p>An interface whereby an object allows its backing content
transform, convert, or parse the content in order to
present it in an alternate form to end-users. </p>
- <p>@note The StreamableContent interface is particularly useful for saving,
+ <p>The StreamableContent 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 StreamableContent interface can help address performance
- issues. Unlike most AT-SPI/Accessibility interfaces, this interface
+ 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.</p>
</tp:docstring>
<method name="getContentTypes">
- <tp:docstring>
- getContentTypes:
- </tp:docstring>
<arg direction="out" type="as" tp:type="StringSeq">
<tp:docstring>
- the list of available mimetypes for this object's content.
+ The list of available mimetypes for this object's content.
</tp:docstring>
</arg>
</method>
<method name="getContent">
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>\n DEPRECATED, use getStream instead.
+ <p>DEPRECATED, use getStream instead.
getContent:
Retrieve this object's content, in a format appropriate to a
requested mimetype. </p>
-
- <p>@note 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 \c seek and \c read.
- \c seek may not be supported for all mimetypes or
- all implementors. </p>
-
- <p>\verbatim
- 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)
- \endverbatim </p>
-
- <p>@see ::Bonobo::Stream </p>
- </tp:docstring>
- <arg direction="in" name="contentType" type="s"/>
- <arg direction="out" type="FIXME" tp:type="Bonobo::Stream">
- <tp:docstring>
- a ::Bonobo::Stream whose mimetype matches \a contentType,if available, or \c NIL.
</tp:docstring>
+ <arg direction="in" name="contentType" type="s">
</arg>
</method>
<method name="getStream">
<p>Retrieve this object's content, in a format appropriate to a
requested mimetype, as a ::ContentStream instance. </p>
- <p>@note This method supercedes the older getContent method, which
- relied on the Bonobo::Stream API.
- \c seek may not be supported for all mimetypes or
- all implementors. </p>
-
- <p>@param contentType a string specifying the desired mimetype for the content stream.</p>
</tp:docstring>
- <arg direction="in" name="contentType" type="s"/>
+ <arg direction="in" name="contentType" type="s">
+ <tp:docstring>
+ <p>A string specifying the desired mimetype for the content stream.</p>
+ </tp:docstring>
+ </arg>
<arg direction="out" type="FIXME" tp:type="ContentStream">
<tp:docstring>
- a Stream whose mimetype matches \a contentType,if available, or \c NIL.@since AT-SPI 1.8.0
+ A Stream whose mimetype matches contentType,if available, or NIL.
</tp:docstring>
</arg>
</method>
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
<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>
-
- <p>@param contentType 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. </p>
</tp:docstring>
- <arg direction="in" name="contentType" type="s"/>
+ <arg direction="in" name="contentType" type="s">
+ <tp:docstring>
+ <p>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. </p>
+ </tp:docstring>
+ </arg>
<arg direction="out" type="s">
<tp:docstring>
- a string which constitutes a URI for a stream of the specifiedcontent type, or NULL if no such URI can be obtained.
+ A string which constitutes a URI for a stream of the specifiedcontent type, or NULL if no such URI can be obtained.
</tp:docstring>
</arg>
</method>
- <method name="unImplemented">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>\cond
- unImplemented: </p>
-
- <p>placeholders for future expansion.</p>
- </tp:docstring>
- </method>
- <method name="unImplemented2">
- </method>
</interface>
</node>