INTEGRATION: CWS oihelp (1.3.140); FILE MERGED

2006/11/14 07:59:09 fs 1.3.140.2: #i71485# constructors
2006/11/13 12:46:02 fs 1.3.140.1: #i71485# support for an optional help section in the object inspector

1 files changed, 24 insertions, 3 deletions

diff --git a/offapi/com/sun/star/inspection/ObjectInspector.idl b/offapi/com/sun/star/inspection/ObjectInspector.idl
index 1b202d62f..d11698a5f 100644
--- a/offapi/com/sun/star/inspection/ObjectInspector.idl
+++ b/offapi/com/sun/star/inspection/ObjectInspector.idl
@@ -4,9 +4,9 @@
  *
  *  $RCSfile: ObjectInspector.idl,v $
  *
- *  $Revision: 1.3 $
+ *  $Revision: 1.4 $
  *
- *  last change: $Author: vg $ $Date: 2006-03-31 12:02:28 $
+ *  last change: $Author: kz $ $Date: 2006-12-13 11:45:14 $
  *
  *  The Contents of this file are made available subject to
  *  the terms of GNU Lesser General Public License Version 2.1.
@@ -39,6 +39,10 @@
 #include <com/sun/star/inspection/XObjectInspector.idl>
 #endif
 
+#ifndef __com_sun_star_lang_IllegalArgumentException_idl__
+#include <com/sun/star/lang/IllegalArgumentException.idl>
+#endif
+
 //=============================================================================
 module com {  module sun {  module star {  module inspection {
 
@@ -58,13 +62,15 @@ module com {  module sun {  module star {  module inspection {
     <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 <type>ObjectInspector</type> 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
@@ -86,6 +92,21 @@ module com {  module sun {  module star {  module inspection {
 */
 service ObjectInspector : XObjectInspector
 {
+    /** creates a default instance of the ObjectInspector
+
+        @since OOo 2.2
+    */
+    createDefault();
+
+    /** creates an instance of the ObjectInspector, using a given <type>ObjectInspectorModel</type>
+
+        @throws ::com::sun::star::lang::IllegalArgumentException
+            if <arg>Model</arg> is <NULL/>.
+
+        @since OOo 2.2
+    */
+    createWithModel( [in] XObjectInspectorModel Model )
+        raises ( ::com::sun::star::lang::IllegalArgumentException );
 };
 
 //=============================================================================