blob: 1ae557256cd96eff958e32125c2ff7fe6cf5c8f1 [file] [log] [blame]
<html>
<head>
<title>class OPropertySetHelper</title>
<style> h1 { font-size:20pt; margin-top:3pt; margin-bottom:7pt; }
h2 { font-family:"Arial"; font-size:16pt; margin-top:3pt; margin-bottom:5pt; }
h3 { font-size:13pt; margin-top:2pt; margin-bottom:3pt; }
h4 { font-size:10pt; font-weight:bold; margin-top:2pt; margin-bottom:1pt; }
dl { margin-top:1pt; margin-bottom:1pt; }
dl.member { margin-top:1pt; margin-bottom:1pt; background-color:#eeeeff; }
dt { font-size:10pt; font-weight:bold; margin-top:2pt; margin-bottom:1pt; }
dt.member { font-size:13pt; font-weight:bold; margin-top:2pt; margin-bottom:1pt; }
dt.simple { font-size:10pt; font-weight:normal; margin-top:2pt; margin-bottom:1pt; }
dd { font-size:10pt; margin-top:1pt; margin-bottom:1pt; }
dd.member { font-size:10pt; margin-top:1pt; margin-bottom:1pt; background-color:#ffffff; }
p { font-size:10pt; margin-top:3pt; margin-bottom:1pt; }
pre { font-family: Times, serif; font-size:10pt; margin-top:1pt; margin-bottom:1pt; }
tr { font-size:10pt; }
td { font-size:10pt; }
</style>
<meta HTTP-EQUIV="content-type" CONTENT="text/html; charset=UTF-8">
</head>
<body bgcolor="#ffffff">
<a name="_top_"> </a>
<table border="0" cellpadding="1" cellspacing="0">
<tr align="center" valign="top">
<td bgcolor="#eeeeff">&nbsp;<a href="../../index.html" alt><font family="Arial" color="#000000" size="+1"><b>Overview</b></font></a>&nbsp;</td>
<td bgcolor="#eeeeff">&nbsp;<a href="index.html" alt><font family="Arial" color="#000000" size="+1"><b>Namespace</b></font></a>&nbsp;</td>
<td bgcolor="#2222ad">&nbsp;<font family="Arial" color="#ffffff" size="+1"><b>Class</b></font>&nbsp;</td>
<td bgcolor="#eeeeff">&nbsp;<a href="../../index-files/index-1.html" alt><font family="Arial" color="#000000" size="+1"><b>Index</b></font></a>&nbsp;</td>
<td bgcolor="#eeeeff">&nbsp;<a href="../../help.html" alt><font family="Arial" color="#000000" size="+1"><b>Help</b></font></a>&nbsp;</td>
</tr>
</table>
<table 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">PROTECTED 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="#prot_ops"><font size="-2"><b>METHODS</b></font></a>
|&nbsp;<font size="-2">STATIC METHODS</font>
|&nbsp;<a href="#prot_vars"><font size="-2"><b>DATA</b></font></a>
|&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;<a href="#priv_ops"><font size="-2"><b>METHODS</b></font></a>
|&nbsp;<font size="-2">STATIC METHODS</font>
|&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>cppu</b></font></a><font size="+1"> :: </font><div align="center" style="background-color:#ccccff; line-height:26pt;"><h2>class OPropertySetHelper</h2>
</div><hr>
<dl>
<dt>Base Classes</dt>
<dd><pre style="font-family:monospace;">
<span style="color:#33ff33;">com::sun::star::beans::<a href="../../../../common/ref/com/sun/star/beans/XMultiPropertySet.html">XMultiPropertySet</a> (public)</span>
|
| <span style="color:#33ff33;">com::sun::star::beans::<a href="../../../../common/ref/com/sun/star/beans/XFastPropertySet.html">XFastPropertySet</a> (public)</span>
| |
| | <span style="color:#33ff33;">com::sun::star::beans::<a href="../../../../common/ref/com/sun/star/beans/XPropertySet.html">XPropertySet</a> (public)</span>
| | |
+----+----+--<strong>OPropertySetHelper</strong>
</pre></dd>
</dl>
<dl>
<dt>Known Derived Classes</dt>
<dd>None.</dd>
</dl>
<br>
<table border cellspacing="0">
<tr>
<td bgcolor="#eeeeff" width="25%" style="font-family:Arial; font-size:8pt; font-weight:bold;">virtual</td>
<td bgcolor="#eeeeff" width="25%" style="font-family:Arial; font-size:8pt; font-weight:bold;">abstract</td>
<td bgcolor="#eeeeff" width="25%" style="font-family:Arial; font-size:8pt; font-weight:bold;">interface</td>
<td bgcolor="#eeeeff" width="25%" style="font-family:Arial; font-size:8pt; font-weight:bold;">template</td>
</tr>
<tr>
<td style="font-family:Arial; font-size:8pt; font-weight:bold;">YES</td>
<td style="font-family:Arial; font-size:8pt; font-weight:bold;">YES</td>
<td style="font-family:Arial; font-size:8pt; font-weight:bold;">YES</td>
<td style="font-family:Arial; font-size:8pt;">NO</td>
</tr>
</table>
<dl>
<dt>Description</dt>
<dd>This abstract class maps the methods of the interfaces XMultiPropertySet, XFastPropertySet
and XPropertySet to the methods getInfoHelper, convertFastPropertyValue,
setFastPropertyValue_NoBroadcast and getFastPropertyValue. You must derive from
this class and overload the methods.
It provides a standard implementation of the XPropertySetInfo.
The XPropertiesChangeListener are inserted in the rBHelper.aLC structure.
The XPropertyChangeListener and XVetoableChangeListener with no names are inserted
in the rBHelper.aLC structure. So it is possible to advise property listeners with
the connection point interfaces. But only listeners that listen to all property changes.
</dd>
</dl>
<dl>
<dt>File</dt>
<dd>propshlp.hxx</dd>
</dl>
<hr>
<dl>
<dt bgcolor="#CCCCFF"><a name="publ_"><h3>Public Members</h3>
</a>
</dt>
<dd><a name="publ_ops"> </a>
<table cellpadding="5" cellspacing="0" width="100%">
<tr bgcolor="#CCCCFF">
<td colspan="2"><h4>Methods</h4>
</td>
</tr>
<tr>
<td> <br>
<a href="OPropertySetHelper/o.html#OPropertySetHelper-994">OPropertySetHelper</a>( OBroadcastHelper &amp; rBHelper ) throw( );</td>
<td width="50%"> </td>
</tr>
<tr>
<td> <br>
<a href="OPropertySetHelper/o.html#~OPropertySetHelper-1">~OPropertySetHelper</a>( ) throw( );</td>
<td width="50%"> You must call disposing before destruction.
</td>
</tr>
<tr>
<td>::com::sun::star::uno::Any <br>
<a href="OPropertySetHelper/o.html#queryInterface-995">queryInterface</a>( const ::com::sun::star::uno::Type &amp; rType ) throw( ::com::sun::star::uno::RuntimeException );</td>
<td width="50%"> Only returns a reference to XMultiPropertySet, XFastPropertySet, XPropertySet and
XEventListener.
</td>
</tr>
<tr>
<td>void <br>
<a href="OPropertySetHelper/o.html#disposing-1">disposing</a>( ) throw( );</td>
<td width="50%"> Send a disposing notification to the listeners in the conatiners aBoundLC
and aVetoableLC.
</td>
</tr>
<tr>
<td>virtual void <br>
<a href="OPropertySetHelper/o.html#setPropertyValue-996">setPropertyValue</a>( const ::rtl::OUString &amp; rPropertyName, const ::com::sun::star::uno::Any &amp; aValue ) throw( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::beans::PropertyVetoException, ::com::sun::star::lang::IllegalArgumentException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );</td>
<td width="50%"> </td>
</tr>
<tr>
<td>virtual ::com::sun::star::uno::Any <br>
<a href="OPropertySetHelper/o.html#getPropertyValue-997">getPropertyValue</a>( const ::rtl::OUString &amp; aPropertyName ) throw( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );</td>
<td width="50%"> Throw UnknownPropertyException if the property with the name
rPropertyName does not exist.
</td>
</tr>
<tr>
<td>virtual void <br>
<a href="OPropertySetHelper/o.html#addPropertyChangeListener-998">addPropertyChangeListener</a>( const ::rtl::OUString &amp; aPropertyName, const ::com::sun::star::uno::Reference&lt; ::com::sun::star::beans::XPropertyChangeListener &gt; &amp; aListener ) throw( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );</td>
<td width="50%"> Ignored if the property is not bound. </td>
</tr>
<tr>
<td>virtual void <br>
<a href="OPropertySetHelper/o.html#removePropertyChangeListener-998">removePropertyChangeListener</a>( const ::rtl::OUString &amp; aPropertyName, const ::com::sun::star::uno::Reference&lt; ::com::sun::star::beans::XPropertyChangeListener &gt; &amp; aListener ) throw( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );</td>
<td width="50%"> Ignored if the property is not bound. </td>
</tr>
<tr>
<td>virtual void <br>
<a href="OPropertySetHelper/o.html#addVetoableChangeListener-999">addVetoableChangeListener</a>( const ::rtl::OUString &amp; aPropertyName, const ::com::sun::star::uno::Reference&lt; ::com::sun::star::beans::XVetoableChangeListener &gt; &amp; aListener ) throw( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );</td>
<td width="50%"> Ignored if the property is not constrained. </td>
</tr>
<tr>
<td>virtual void <br>
<a href="OPropertySetHelper/o.html#removeVetoableChangeListener-999">removeVetoableChangeListener</a>( const ::rtl::OUString &amp; aPropertyName, const ::com::sun::star::uno::Reference&lt; ::com::sun::star::beans::XVetoableChangeListener &gt; &amp; aListener ) throw( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );</td>
<td width="50%"> Ignored if the property is not constrained. </td>
</tr>
<tr>
<td>virtual void <br>
<a href="OPropertySetHelper/o.html#setFastPropertyValue-1000">setFastPropertyValue</a>( sal_Int32 nHandle, const ::com::sun::star::uno::Any &amp; rValue ) throw( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::beans::PropertyVetoException, ::com::sun::star::lang::IllegalArgumentException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );</td>
<td width="50%"> </td>
</tr>
<tr>
<td>virtual ::com::sun::star::uno::Any <br>
<a href="OPropertySetHelper/o.html#getFastPropertyValue-1001">getFastPropertyValue</a>( sal_Int32 nHandle ) throw( ::com::sun::star::beans::UnknownPropertyException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );</td>
<td width="50%"> </td>
</tr>
<tr>
<td>virtual void <br>
<a href="OPropertySetHelper/o.html#setPropertyValues-1002">setPropertyValues</a>( const ::com::sun::star::uno::Sequence&lt; ::rtl::OUString &gt; &amp; PropertyNames, const ::com::sun::star::uno::Sequence&lt; ::com::sun::star::uno::Any &gt; &amp; Values ) throw( ::com::sun::star::beans::PropertyVetoException, ::com::sun::star::lang::IllegalArgumentException, ::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException );</td>
<td width="50%"> </td>
</tr>
<tr>
<td>virtual ::com::sun::star::uno::Sequence&lt; ::com::sun::star::uno::Any &gt; <br>
<a href="OPropertySetHelper/o.html#getPropertyValues-1003">getPropertyValues</a>( const ::com::sun::star::uno::Sequence&lt; ::rtl::OUString &gt; &amp; PropertyNames ) throw( ::com::sun::star::uno::RuntimeException );</td>
<td width="50%"> </td>
</tr>
<tr>
<td>virtual void <br>
<a href="OPropertySetHelper/o.html#addPropertiesChangeListener-1004">addPropertiesChangeListener</a>( const ::com::sun::star::uno::Sequence&lt; ::rtl::OUString &gt; &amp; PropertyNames, const ::com::sun::star::uno::Reference&lt; ::com::sun::star::beans::XPropertiesChangeListener &gt; &amp; Listener ) throw( ::com::sun::star::uno::RuntimeException );</td>
<td width="50%"> </td>
</tr>
<tr>
<td>virtual void <br>
<a href="OPropertySetHelper/o.html#removePropertiesChangeListener-1005">removePropertiesChangeListener</a>( const ::com::sun::star::uno::Reference&lt; ::com::sun::star::beans::XPropertiesChangeListener &gt; &amp; Listener ) throw( ::com::sun::star::uno::RuntimeException );</td>
<td width="50%"> </td>
</tr>
<tr>
<td>virtual void <br>
<a href="OPropertySetHelper/o.html#firePropertiesChangeEvent-1004">firePropertiesChangeEvent</a>( const ::com::sun::star::uno::Sequence&lt; ::rtl::OUString &gt; &amp; PropertyNames, const ::com::sun::star::uno::Reference&lt; ::com::sun::star::beans::XPropertiesChangeListener &gt; &amp; Listener ) throw( ::com::sun::star::uno::RuntimeException );</td>
<td width="50%"> </td>
</tr>
</table>
<hr>
<a name="publ_static_ops"> </a>
<table cellpadding="5" cellspacing="0" width="100%">
<tr bgcolor="#CCCCFF">
<td colspan="2"><h4>Static Methods</h4>
</td>
</tr>
<tr>
<td>static ::com::sun::star::uno::Reference&lt; ::com::sun::star::beans::XPropertySetInfo &gt; <br>
<a href="OPropertySetHelper/o.html#createPropertySetInfo-1006">createPropertySetInfo</a>( IPropertyArrayHelper &amp; rProperties ) throw( );</td>
<td width="50%"> The property sequence is created in the call. The interface isn't used after the call.
</td>
</tr>
</table>
<hr>
</dd>
</dl>
<dl>
<dt bgcolor="#CCCCFF"><a name="prot_"><h3>Protected Members</h3>
</a>
</dt>
<dd><a name="prot_ops"> </a>
<table cellpadding="5" cellspacing="0" width="100%">
<tr bgcolor="#CCCCFF">
<td colspan="2"><h4>Methods</h4>
</td>
</tr>
<tr>
<td>void <br>
<a href="OPropertySetHelper/o.html#fire-1007">fire</a>( sal_Int32 * pnHandles, const ::com::sun::star::uno::Any * pNewValues, const ::com::sun::star::uno::Any * pOldValues, sal_Int32 nCount, sal_Bool bVetoable );</td>
<td width="50%"> This method fire events to all registered property listeners.
</td>
</tr>
<tr>
<td>void <br>
<a href="OPropertySetHelper/o.html#setFastPropertyValues-1008">setFastPropertyValues</a>( sal_Int32 nSeqLen, sal_Int32 * pHandles, const ::com::sun::star::uno::Any * pValues, sal_Int32 nHitCount ) throw( ::com::sun::star::uno::Exception );</td>
<td width="50%"> Set multiple properties with the handles.
</td>
</tr>
<tr>
<td>virtual IPropertyArrayHelper &amp; <br>
<a href="OPropertySetHelper/o.html#getInfoHelper-1">getInfoHelper</a>( ) = 0;</td>
<td width="50%"> This abstract method must return the name to index table. This table contains all property
names and types of this object. The method is not implemented in this class.
</td>
</tr>
<tr>
<td>virtual sal_Bool <br>
<a href="OPropertySetHelper/o.html#convertFastPropertyValue-1009">convertFastPropertyValue</a>( ::com::sun::star::uno::Any &amp; rConvertedValue, ::com::sun::star::uno::Any &amp; rOldValue, sal_Int32 nHandle, const ::com::sun::star::uno::Any &amp; rValue ) throw( ::com::sun::star::lang::IllegalArgumentException ) = 0;</td>
<td width="50%"> </td>
</tr>
<tr>
<td>virtual void <br>
<a href="OPropertySetHelper/o.html#setFastPropertyValue_NoBroadcast-1000">setFastPropertyValue_NoBroadcast</a>( sal_Int32 nHandle, const ::com::sun::star::uno::Any &amp; rValue ) throw( ::com::sun::star::uno::Exception ) = 0;</td>
<td width="50%"> </td>
</tr>
<tr>
<td>virtual void <br>
<a href="OPropertySetHelper/o.html#getFastPropertyValue-1010">getFastPropertyValue</a>( ::com::sun::star::uno::Any &amp; rValue, sal_Int32 nHandle ) const = 0;</td>
<td width="50%"> </td>
</tr>
</table>
<hr>
<a name="prot_vars"> </a>
<table cellpadding="5" cellspacing="0" width="100%">
<tr bgcolor="#CCCCFF">
<td colspan="2"><h4>Data</h4>
</td>
</tr>
<tr bgcolor="white">
<td><a href="t-OBroadcastHelper.html">OBroadcastHelper</a> &amp; <a href="OPropertySetHelper/d.html#rBHelper"><strong>rBHelper;</strong></a></td>
<td>The common data of a broadcaster. Use the mutex, disposing state and the listener container. </td>
</tr>
<tr bgcolor="white">
<td><a href="c-OMultiTypeInterfaceContainerHelperInt32.html">OMultiTypeInterfaceContainerHelperInt32</a> <a href="OPropertySetHelper/d.html#aBoundLC"><strong>aBoundLC;</strong></a></td>
<td>Container for the XProperyChangedListener. The listeners are inserted by handle.
</td>
</tr>
<tr bgcolor="white">
<td><a href="c-OMultiTypeInterfaceContainerHelperInt32.html">OMultiTypeInterfaceContainerHelperInt32</a> <a href="OPropertySetHelper/d.html#aVetoableLC"><strong>aVetoableLC;</strong></a></td>
<td>Container for the XPropertyVetoableListener. The listeners are inserted by handle.
</td>
</tr>
<tr bgcolor="white">
<td>void * <a href="OPropertySetHelper/d.html#m_pReserved"><strong>m_pReserved;</strong></a></td>
<td>reserved for future use. do not use.
</td>
</tr>
</table>
<hr>
</dd>
</dl>
<dl>
<dt bgcolor="#CCCCFF"><a name="priv_"><h3>Private Members</h3>
</a>
</dt>
<dd><a name="priv_ops"> </a>
<table cellpadding="5" cellspacing="0" width="100%">
<tr bgcolor="#CCCCFF">
<td colspan="2"><h4>Methods</h4>
</td>
</tr>
<tr>
<td> <br>
<a href="OPropertySetHelper/o.html#OPropertySetHelper-1011">OPropertySetHelper</a>( const OPropertySetHelper &amp; ) throw( );</td>
<td width="50%"> </td>
</tr>
<tr>
<td>OPropertySetHelper &amp; <br>
<a href="OPropertySetHelper/o.html#operator=-1011">operator=</a>( const OPropertySetHelper &amp; ) throw( );</td>
<td width="50%"> </td>
</tr>
</table>
<hr>
</dd>
</dl>
<a href="#_top_" class="objchapter">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright 2002 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, CA 94303 USA.</p>
</body>