Sophie

Sophie

distrib > Mandriva > 2008.1 > x86_64 > media > main-testing > by-pkgid > 2c50825dd66d0497b96a67f7fab2ee84 > files > 8506

openoffice.org64-devel-doc-2.4.1.10-1mdv2008.1.x86_64.rpm

<html>
<head>
<title>class Reference</title>
<link rel="stylesheet" type="text/css" href="../../../../../cpp.css">
</head>
<body>
<div id="adc-cppref">

<a name="_top_"> </a><table class="navimain" border="0" cellpadding="1" cellspacing="0">
<tr align="center" valign="top">
<td class="navimain">&nbsp;<a href="../../../../../index.html">Overview</a>&nbsp;</td>
<td class="navimain">&nbsp;<a href="index.html">Namespace</a>&nbsp;</td>
<td class="navimainself">&nbsp;Class&nbsp;</td>
<td class="navimain">&nbsp;<a href="../../../../../index-files/index-1.html">Index</a>&nbsp;</td>
<td class="navimain">&nbsp;<a href="../../../../../help.html">Help</a>&nbsp;</td>
</tr>
</table>
<table class="navisub" cellpadding="0" cellspacing="3">
<tr>
<td width="20%"><font size="-2">PUBLIC MEMBERS:</font></td>
<td>
&nbsp;<font size="-2">CLASSES</font>
|&nbsp;<font size="-2">STRUCTS</font>
|&nbsp;<font size="-2">UNIONS</font>
|&nbsp;<font size="-2">ENUMS</font>
|&nbsp;<font size="-2">TYPEDEFS</font>
|&nbsp;<a href="#publ_ops"><font size="-2"><b>METHODS</b></font></a>
|&nbsp;<a href="#publ_static_ops"><font size="-2"><b>STATIC METHODS</b></font></a>
|&nbsp;<font size="-2">DATA</font>
|&nbsp;<font size="-2">STATIC DATA</font></td>
</tr>
<tr>
<td width="20%"><font size="-2">PRIVATE MEMBERS:</font></td>
<td>
&nbsp;<font size="-2">CLASSES</font>
|&nbsp;<font size="-2">STRUCTS</font>
|&nbsp;<font size="-2">UNIONS</font>
|&nbsp;<font size="-2">ENUMS</font>
|&nbsp;<font size="-2">TYPEDEFS</font>
|&nbsp;<font size="-2">METHODS</font>
|&nbsp;<a href="#priv_static_ops"><font size="-2"><b>STATIC METHODS</b></font></a>
|&nbsp;<font size="-2">DATA</font>
|&nbsp;<font size="-2">STATIC DATA</font></td>
</tr>
</table>
<hr>
<a href="../../../../../names/index.html" alt="Global Namespace in C++"><font size="+1"><b>::</b></font></a> <a href="../../../index.html" alt="namespace"><font size="+1"><b>com</b></font></a><font size="+1"> :: </font><a href="../../index.html" alt="namespace"><font size="+1"><b>sun</b></font></a><font size="+1"> :: </font><a href="../index.html" alt="namespace"><font size="+1"><b>star</b></font></a><font size="+1"> :: </font><a href="index.html" alt="namespace"><font size="+1"><b>uno</b></font></a><font size="+1"> :: </font><br>
<p><strong>template&lt; typename interface_type &gt;</strong></p>
<div class="title"><h2>class Reference</h2>
</div><hr>
<dl>
<dt>Base Classes</dt>
<dd><pre style="font-family:monospace;">
<span class="btpubl"><a href="c-BaseReference.html">BaseReference</a> (public)</span>
  |  
  +--<span class="btself">Reference</span>
</pre></dd>
</dl>
<dl>
<dt>Known Derived Classes</dt>
<dd>None.</dd>
</dl>
<br>
<table class="flag-table" border="1" cellspacing="0">
<tr>
<td width="25%" class="flagname">virtual</td>
<td width="25%" class="flagname">abstract</td>
<td width="25%" class="flagname">interface</td>
<td width="25%" class="flagname">template</td>
</tr>
<tr>
<td class="flagno">NO</td>
<td class="flagno">NO</td>
<td class="flagno">NO</td>
<td class="flagyes">YES</td>
</tr>
</table>
<dl>
<dt>Description</dt>
<dd>Template reference class for interface type derived from BaseReference.
A special constructor given the UNO_QUERY or UNO_REF_QUERY identifier queries interfaces
for reference type.
</dd>
</dl>
<dl>
<dt>File</dt>
<dd>Reference.h</dd>
</dl>
<hr>
<dl>
<dt class="subtitle"><a name="publ_"><h3>Public Members</h3>
</a></dt>
<dd><a name="publ_ops"> </a><table class="childlist" border="1" cellpadding="5" cellspacing="0" width="100%">
<tr class="subtitle">
<td colspan="2"><h4>Methods</h4>
</td>
</tr>
<tr>
<td> <br>
<a href="Reference/o.html#~Reference-2612">~Reference</a>( ) throw( );</td>
<td width="50%"> Destructor: Releases interface if set.
</td>
</tr>
<tr>
<td> <br>
<a href="Reference/o.html#Reference-2613">Reference</a>( ) throw( );</td>
<td width="50%"> Default Constructor: Sets null reference.
</td>
</tr>
<tr>
<td> <br>
<a href="Reference/o.html#Reference-2614">Reference</a>( const Reference&lt; interface_type &gt; &amp; rRef ) throw( );</td>
<td width="50%"> Copy constructor: Copies interface reference.

</td>
</tr>
<tr>
<td> <br>
<a href="Reference/o.html#Reference-2615">Reference</a>( interface_type * pInterface ) throw( );</td>
<td width="50%"> Constructor: Sets given interface pointer.

</td>
</tr>
<tr>
<td> <br>
<a href="Reference/o.html#Reference-2616">Reference</a>( interface_type * pInterface, __sal_NoAcquire  ) throw( );</td>
<td width="50%"> Constructor: Sets given interface pointer without acquiring it.

</td>
</tr>
<tr>
<td> <br>
<a href="Reference/o.html#Reference-2617">Reference</a>( interface_type * pInterface, UnoReference_NoAcquire  ) throw( );</td>
<td width="50%"> Constructor: Sets given interface pointer without acquiring it.
Deprecated, please use SAL_NO_ACQUIRE version.

</td>
</tr>
<tr>
<td> <br>
<a href="Reference/o.html#Reference-2618">Reference</a>( const BaseReference &amp; rRef, UnoReference_Query  ) throw( RuntimeException );</td>
<td width="50%"> Constructor: Queries given interface for reference interface type (interface_type).

</td>
</tr>
<tr>
<td> <br>
<a href="Reference/o.html#Reference-2619">Reference</a>( XInterface * pInterface, UnoReference_Query  ) throw( RuntimeException );</td>
<td width="50%"> Constructor: Queries given interface for reference interface type (interface_type).

</td>
</tr>
<tr>
<td> <br>
<a href="Reference/o.html#Reference-2620">Reference</a>( const Any &amp; rAny, UnoReference_Query  ) throw( RuntimeException );</td>
<td width="50%"> Constructor: Queries given any for reference interface type (interface_type).

</td>
</tr>
<tr>
<td> <br>
<a href="Reference/o.html#Reference-2621">Reference</a>( const BaseReference &amp; rRef, UnoReference_QueryThrow  ) throw( RuntimeException );</td>
<td width="50%"> Constructor: Queries given interface for reference interface type (interface_type).
Throws a RuntimeException if the demanded interface cannot be queried.

</td>
</tr>
<tr>
<td> <br>
<a href="Reference/o.html#Reference-2622">Reference</a>( XInterface * pInterface, UnoReference_QueryThrow  ) throw( RuntimeException );</td>
<td width="50%"> Constructor: Queries given interface for reference interface type (interface_type).
Throws a RuntimeException if the demanded interface cannot be queried.

</td>
</tr>
<tr>
<td> <br>
<a href="Reference/o.html#Reference-2623">Reference</a>( const Any &amp; rAny, UnoReference_QueryThrow  ) throw( RuntimeException );</td>
<td width="50%"> Constructor: Queries given any for reference interface type (interface_type).
Throws a RuntimeException if the demanded interface cannot be queried.

</td>
</tr>
<tr>
<td> <br>
<a href="Reference/o.html#Reference-2624">Reference</a>( const Reference&lt; interface_type &gt; &amp; rRef, UnoReference_SetThrow  ) throw( RuntimeException );</td>
<td width="50%"> Constructor: assigns from the given interface of the same type. Throws a RuntimeException
if the source interface is &lt;NULL/&gt;.

</td>
</tr>
<tr>
<td> <br>
<a href="Reference/o.html#Reference-2625">Reference</a>( interface_type * pInterface, UnoReference_SetThrow  ) throw( RuntimeException );</td>
<td width="50%"> Constructor: assigns from the given interface of the same type. Throws a RuntimeException
if the source interface is &lt;NULL/&gt;.

</td>
</tr>
<tr>
<td> <br>
<a href="Reference/o.html#operator const Reference< XInterface > &-2626">operator const Reference&lt; XInterface &gt; &amp;</a>( ) const throw( );</td>
<td width="50%"> </td>
</tr>
<tr>
<td>interface_type * <br>
<a href="Reference/o.html#operator->-2627">operator-&gt;</a>( ) const throw( );</td>
<td width="50%"> Dereference operator: Used to call interface methods.

</td>
</tr>
<tr>
<td>interface_type * <br>
<a href="Reference/o.html#get-2628">get</a>( ) const throw( );</td>
<td width="50%"> Gets interface pointer. This call does not acquire the interface.

</td>
</tr>
<tr>
<td>void <br>
<a href="Reference/o.html#clear-2629">clear</a>( ) throw( );</td>
<td width="50%"> Clears reference, i.e. releases interface. Reference is null after clear() call.
</td>
</tr>
<tr>
<td>sal_Bool <br>
<a href="Reference/o.html#set-2630">set</a>( const Reference&lt; interface_type &gt; &amp; rRef ) throw( );</td>
<td width="50%"> Sets the given interface. An interface already set will be released.

</td>
</tr>
<tr>
<td>sal_Bool <br>
<a href="Reference/o.html#set-2631">set</a>( interface_type * pInterface ) throw( );</td>
<td width="50%"> Sets the given interface. An interface already set will be released.

</td>
</tr>
<tr>
<td>sal_Bool <br>
<a href="Reference/o.html#set-2632">set</a>( interface_type * pInterface, __sal_NoAcquire  ) throw( );</td>
<td width="50%"> Sets interface pointer without acquiring it. An interface already set will be released.

</td>
</tr>
<tr>
<td>sal_Bool <br>
<a href="Reference/o.html#set-2633">set</a>( interface_type * pInterface, UnoReference_NoAcquire  ) throw( );</td>
<td width="50%"> Sets interface pointer without acquiring it. An interface already set will be released.
Deprecated, please use SAL_NO_ACQUIRE version.

</td>
</tr>
<tr>
<td>sal_Bool <br>
<a href="Reference/o.html#set-2634">set</a>( XInterface * pInterface, UnoReference_Query  ) throw( RuntimeException );</td>
<td width="50%"> Queries given interface for reference interface type (interface_type) and sets it.
An interface already set will be released.

</td>
</tr>
<tr>
<td>sal_Bool <br>
<a href="Reference/o.html#set-2635">set</a>( const BaseReference &amp; rRef, UnoReference_Query  ) throw( RuntimeException );</td>
<td width="50%"> Queries given interface for reference interface type (interface_type) and sets it.
An interface already set will be released.

</td>
</tr>
<tr>
<td>bool <br>
<a href="Reference/o.html#set-2636">set</a>( const Any &amp; rAny, UnoReference_Query  );</td>
<td width="50%"> Queries given any for reference interface type (interface_type)
and sets it.  An interface already set will be released.

</td>
</tr>
<tr>
<td>void <br>
<a href="Reference/o.html#set-2637">set</a>( XInterface * pInterface, UnoReference_QueryThrow  ) throw( RuntimeException );</td>
<td width="50%"> </td>
</tr>
<tr>
<td>void <br>
<a href="Reference/o.html#set-2638">set</a>( const BaseReference &amp; rRef, UnoReference_QueryThrow  ) throw( RuntimeException );</td>
<td width="50%"> </td>
</tr>
<tr>
<td>void <br>
<a href="Reference/o.html#set-2639">set</a>( const Any &amp; rAny, UnoReference_QueryThrow  );</td>
<td width="50%"> </td>
</tr>
<tr>
<td>void <br>
<a href="Reference/o.html#set-2640">set</a>( interface_type * pInterface, UnoReference_SetThrow  ) throw( RuntimeException );</td>
<td width="50%"> </td>
</tr>
<tr>
<td>void <br>
<a href="Reference/o.html#set-2641">set</a>( const Reference&lt; interface_type &gt; &amp; rRef, UnoReference_SetThrow  ) throw( RuntimeException );</td>
<td width="50%"> </td>
</tr>
<tr>
<td>Reference&lt; interface_type &gt; &amp; <br>
<a href="Reference/o.html#operator=-2642">operator=</a>( interface_type * pInterface ) throw( );</td>
<td width="50%"> Assignment operator: Acquires given interface pointer and sets reference.
An interface already set will be released.

</td>
</tr>
<tr>
<td>Reference&lt; interface_type &gt; &amp; <br>
<a href="Reference/o.html#operator=-2643">operator=</a>( const Reference&lt; interface_type &gt; &amp; rRef ) throw( );</td>
<td width="50%"> Assignment operator: Acquires given interface reference and sets reference.
An interface already set will be released.

</td>
</tr>
</table>
<hr>
<a name="publ_static_ops"> </a><table class="childlist" border="1" cellpadding="5" cellspacing="0" width="100%">
<tr class="subtitle">
<td colspan="2"><h4>Static Methods</h4>
</td>
</tr>
<tr>
<td>static Reference&lt; interface_type &gt; <br>
<a href="Reference/o.html#query-2644">query</a>( const BaseReference &amp; rRef ) throw( RuntimeException );</td>
<td width="50%"> Queries given interface reference for type interface_type.

</td>
</tr>
<tr>
<td>static Reference&lt; interface_type &gt; <br>
<a href="Reference/o.html#query-2645">query</a>( XInterface * pInterface ) throw( RuntimeException );</td>
<td width="50%"> Queries given interface for type interface_type.

</td>
</tr>
</table>
<hr>
</dd>
</dl>
<dl>
<dt class="subtitle"><a name="priv_"><h3>Private Members</h3>
</a></dt>
<dd><a name="priv_static_ops"> </a><table class="childlist" border="1" cellpadding="5" cellspacing="0" width="100%">
<tr class="subtitle">
<td colspan="2"><h4>Static Methods</h4>
</td>
</tr>
<tr>
<td>static XInterface * <br>
<a href="Reference/o.html#iquery-2603">iquery</a>( XInterface * pInterface ) throw( RuntimeException );</td>
<td width="50%"> Queries given interface for type interface_type.

</td>
</tr>
<tr>
<td>static XInterface * <br>
<a href="Reference/o.html#iquery_throw-2604">iquery_throw</a>( XInterface * pInterface ) throw( RuntimeException );</td>
<td width="50%"> Queries given interface for type interface_type.
Throws a RuntimeException if the demanded interface cannot be queried.

</td>
</tr>
<tr>
<td>static interface_type * <br>
<a href="Reference/o.html#iset_throw-2605">iset_throw</a>( interface_type * pInterface ) throw( RuntimeException );</td>
<td width="50%"> Returns the given interface if it is not &lt;NULL/&gt;, throws a RuntimeException otherwise.

</td>
</tr>
<tr>
<td>static interface_type * <br>
<a href="Reference/o.html#castFromXInterface-2606">castFromXInterface</a>( XInterface * p );</td>
<td width="50%"> Cast from an &quot;interface pointer&quot; (e.g., BaseReference::_pInterface) to a
pointer to this interface_type.

</td>
</tr>
<tr>
<td>static XInterface * <br>
<a href="Reference/o.html#castToXInterface-2607">castToXInterface</a>( interface_type * p );</td>
<td width="50%"> Cast from a pointer to this interface_type to an &quot;interface pointer&quot;
(e.g., BaseReference::_pInterface).

</td>
</tr>
</table>
<hr>
</dd>
</dl>
<a href="#_top_" class="objchapter">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright &copy; 2008 Sun Microsystems, Inc.</p>

</div> <!-- id="adc-cppref" -->
</body>

</html>