<html> <head> <title>Service ObjectInspector</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <link rel="stylesheet" type="text/css" href="../../../../idl.css"> </head> <body> <div id="adc-idlref"> <a name="_top_"> </a><table class="navimain" border="0" cellpadding="3"> <tr> <td class="navimain"><a href="../module-ix.html" class="navimain">Overview</a></td> <td class="navimain"><a href="module-ix.html" class="navimain">Module</a></td> <td class="navimainnone">Use</td> <td class="navimainnone">Devguide</td> <td class="navimain"><a href="../../../../index-files/index-1.html" class="navimain">Index</a></td> </tr> </table> <table class="navisub" border="0" cellpadding="0"> <tr> <td class="navisub"><a href="#ConstructorsSummary" class="navisub">Constructors' Summary</a></td> <td class="navisub"><a href="#ConstructorsDetails" class="navisub">Constructors' Details</a></td> </tr> </table> <hr> <table border="0" width="100%" cellpadding="5" cellspacing="3" class="title-table" style="margin-bottom:6pt;"> <tr> <td><p class="namechain"><a href="../../../../module-ix.html" class="namechain">::</a> <a href="../../../module-ix.html" class="namechain">com</a> :: <a href="../../module-ix.html" class="namechain">sun</a> :: <a href="../module-ix.html" class="namechain">star</a> :: <a href="module-ix.html" class="namechain">inspection</a> :: </p> </td> </tr> <tr> <td class="title"><table class="title-table" width="99%"> <tr> <td width="25%" class="title2">unpublished </td> <td width="50%" class="title">service ObjectInspector</td> <td width="*"/></tr> </table> </td> </tr> <tr> <td><dl> <dt><b>Supported Interface</b></dt> <dd><a href="XObjectInspector.html">XObjectInspector</a></dd> </dl> </td> </tr> <tr> <td><dl> <dt><b>Description</b></dt> <dd>describes an ::com::sun::star::<a href="../frame/module-ix.html">frame</a>::<a href="../frame/Controller.html">Controller</a> which can be used to browse and modify properties of components. </dd> <dd><p>The controller can be plugged into an ::com::sun::star::<a href="../frame/module-ix.html">frame</a>::<a href="../frame/XFrame.html">XFrame</a>, and will provide a visual component for inspecting and modifying component properties.<br/> Note that "property" here is a generic term - any aspect of a component can be considered a property, as long as some property handler is able to describe this aspect in a property-like way.</p> <p>The basic idea is that one facet of the inspected component is represented by a single line of controls: A label, an input control, and optionally one or two buttons which, when pressed, trigger additional user interaction (e.g. a more sophisticated dialog to enter a property value).</p> <p>Additionally, property lines can be grouped into different categories. A usual implementation of such categories would be tab pages, but other implementations are possible, too.</p> <p>Even more, the inspector can optionally display a help section at the bottom of its window, which can display arbitrary (context-sensitive) help texts.</p> <p>An <a href="ObjectInspector.html">ObjectInspector</a> needs one or more property handlers which describe the facets of an inspected component - without such handlers, the inspector window will simply stay empty.</p> <p>The property handlers, as well as more information about the layout of the inspector, are provided by a inspector model, which has to be implemented by the user of the inspector.</p> <p/> <p>Since property handlers might have the need to raise UI, they will be created with a context value named "DialogParentWindow", which contains an XWindow which should be used as parent of any windows to raise.<br/> If the ::com::sun::star::<a href="../uno/module-ix.html">uno</a>::<a href="../uno/XComponentContext.html">XComponentContext</a> in which the <a href="ObjectInspector.html">ObjectInspector</a> was created already contains such a value, it is not overwritten. Only if it doesn't, the inspector will add an own value - which contains the inspector's main window - to the context when creating handlers.</p> </dd> <dt><b>Since </b></dt> <dd>OpenOffice 2.0.3</dd> <dt><b>See also</b></dt> <dd><a href="XPropertyHandler.html">XPropertyHandler</a>, <a href="LineDescriptor.html">LineDescriptor</a>, <a href="PropertyControlType.html">PropertyControlType</a>, <a href="ObjectInspectorModel.html">ObjectInspectorModel</a>, ::com::sun::star::<a href="../uno/module-ix.html">uno</a>::<a href="../uno/XComponentContext.html">XComponentContext</a>, ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/XMultiComponentFactory.html">XMultiComponentFactory</a></dd> </dl> </td> </tr> </table> <hr> <hr> <a name="ConstructorsSummary"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle" colspan="2">Constructors' Summary</td> </tr> <tr> <td class="imsum_left"><a href="#createDefault">createDefault</a></td> <td class="imsum_right">creates a default instance of the ObjectInspector </td> </tr> <tr> <td class="imsum_left"><a href="#createWithModel">createWithModel</a></td> <td class="imsum_right">creates an instance of the ObjectInspector, using a given <a href="ObjectInspectorModel.html">ObjectInspectorModel</a> </td> </tr> </table> <a name="ConstructorsDetails"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle">Constructors' Details</td> </tr> <tr> <td class="imdetail"><a name="createDefault" class="membertitle">createDefault</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center"> <tr> <td><table class="table-in-method" border="0"> <tr> <td valign="top" colspan="3"/></tr> <tr> <td valign="top"><b>createDefault</b>();</td> </tr> </table> <hr> <dl> <dt><b>Description</b></dt> <dd>creates a default instance of the ObjectInspector </dd> <dt><b/></dt> <dd/></dl> </td> </tr> </table> </td> </tr> <tr> <td class="imdetail"><a name="createWithModel" class="membertitle">createWithModel</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center"> <tr> <td><table class="table-in-method" border="0"> <tr> <td valign="top" colspan="3"/></tr> <tr> <td valign="top"><b>createWithModel</b>(</td> <td valign="top">[in] <a href="XObjectInspectorModel.html">XObjectInspectorModel</a></td> <td valign="bottom"> Model )</td> </tr> <tr> <td valign="top" align="right">raises( </td> <td valign="top" colspan="2">::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/IllegalArgumentException.html">IllegalArgumentException</a> );</td> </tr> </table> <hr> <dl> <dt><b>Description</b></dt> <dd>creates an instance of the ObjectInspector, using a given <a href="ObjectInspectorModel.html">ObjectInspectorModel</a> </dd> <dt><b>Throws</b></dt> <dd>::com::sun::star::lang::IllegalArgumentException if <arg>Model</arg> is <b>NULL</b>. </dd> <dt><b/></dt> <dd/></dl> </td> </tr> </table> </td> </tr> </table> <br> <a href="#_top_">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright © 2008 Sun Microsystems, Inc.</p> </div> <!-- id="adc-idlref" --> </body> </html>