INTEGRATION: CWS fwkbugfix02 (1.2.148); FILE MERGED

2004/04/19 12:37:48 mav 1.2.148.7: #116056# interfaces review
2004/04/19 12:02:03 mav 1.2.148.6: #116056# interfaces review
2004/04/19 11:19:01 mav 1.2.148.5: #116056# interfaces review
2004/04/19 11:18:17 mav 1.2.148.4: #116056# interfaces review
2004/04/19 09:16:14 mav 1.2.148.3: #116056# object map mode
2004/03/25 10:51:05 mav 1.2.148.2: #116056# interfaces review
2004/03/22 10:14:37 mav 1.2.148.1: #115011# review idl files

1 files changed, 26 insertions, 19 deletions

diff --git a/offapi/com/sun/star/embed/XVisualObject.idl b/offapi/com/sun/star/embed/XVisualObject.idl
index 623989dc8aed..a0b6609650a9 100644
--- a/offapi/com/sun/star/embed/XVisualObject.idl
+++ b/offapi/com/sun/star/embed/XVisualObject.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: XVisualObject.idl,v $
  *
- *  $Revision: 1.2 $
+ *  $Revision: 1.3 $
  *
- *  last change: $Author: kz $ $Date: 2003-09-11 10:28:17 $
+ *  last change: $Author: hr $ $Date: 2004-05-10 18:08:38 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -83,24 +83,26 @@
  module com {  module sun {  module star {  module embed {
 
 //=============================================================================
-/** represents common visualisation functionality for embedded objects
+/** represents common visualisation functionality for embedded objects.
  */
 interface XVisualObject: ::com::sun::star::uno::XInterface
 {
     //-------------------------------------------------------------------------
-    /** Provides object with the name of container document
+    /** sets the size of object's visual area.
 
-        @param sName
-            name of the container document
-     */
-    void setContainerName( [in] string sName );
+        <p>
+        The size must be provided in logical units according to map mode the
+        object communicates in.
+        </p>
 
-    //-------------------------------------------------------------------------
-    /** Sets the size of object's visual area
+        <p>
+        If an object is inplace- or ui-active the method must not initiate
+        repainting itself.
+        </p>
 
         @param nAspect
             the aspect specifying the form of object representation
-            can take values from Aspects constant set
+            can take values from <type>Aspects</type> constant set
 
         @param aSize
             the new size of the visual area
@@ -114,18 +116,23 @@ interface XVisualObject: ::com::sun::star::uno::XInterface
         @throws ::com::sun::star::uno::Exception
             the object failed to resize
      */
-    void setVisAreaSize( [in] hyper nAspect,
+    void setVisualAreaSize( [in] hyper nAspect,
                          [in] ::com::sun::star::awt::Size aSize )
         raises( ::com::sun::star::lang::IllegalArgumentException,
                 ::com::sun::star::embed::WrongStateException,
                 ::com::sun::star::uno::Exception );
 
     //-------------------------------------------------------------------------
-    /** Gets the size of object's visual area
+    /** gets the size of object's visual area.
+
+        <p>
+        The size must be provided in logical units according to map mode the
+        object communicates in.
+        </p>
 
         @param nAspect
             the aspect specifying the form of object representation
-            can take values from Aspects constant set
+            can take values from <type>Aspects</type> constant set
 
         @return
             the size of visual area
@@ -136,22 +143,22 @@ interface XVisualObject: ::com::sun::star::uno::XInterface
         @throws ::com::sun::star::embed::WrongStateException
             the object is in wrong state
      */
-    ::com::sun::star::awt::Size getVisAreaSize( [in] hyper nAspect )
+    ::com::sun::star::awt::Size getVisualAreaSize( [in] hyper nAspect )
         raises( ::com::sun::star::lang::IllegalArgumentException,
                 ::com::sun::star::embed::WrongStateException,
                 ::com::sun::star::uno::Exception );
 
     //-------------------------------------------------------------------------
-    /** Retrieves cached visual representation if any
+    /** retrieves map mode the object communicates in.
 
         @return
-            the cached visual representation of the object
+            the map mode the object communicates in, it can take values from
+            <type>EmbedMapModes</type> constant
 
         @throws ::com::sun::star::uno::Exception
      */
-    any getVisualCache( [in] hyper nAspect )
+    long getMapMode( [in] hyper nAspect )
         raises( ::com::sun::star::uno::Exception );
-
 };
 
 //=============================================================================