chartmultiline: #i108759# enhance API documentation for data access and #i82971#

3 files changed, 32 insertions, 7 deletions

diff --git a/offapi/com/sun/star/chart/XChartDataArray.idl b/offapi/com/sun/star/chart/XChartDataArray.idl
index 234eeea1d..a54c2001f 100644
--- a/offapi/com/sun/star/chart/XChartDataArray.idl
+++ b/offapi/com/sun/star/chart/XChartDataArray.idl
@@ -42,6 +42,8 @@
  
 /** gives access to data represented as an array of rows.
     
+    <p>Can be obtained from interface <type>XChartDocument</type> via method getData().</p>
+
     <p>If used for an <type>XYDiagram</type>, the row number 0
     represents the <i>x</i>-values.</p>
  */
diff --git a/offapi/com/sun/star/chart/XChartDocument.idl b/offapi/com/sun/star/chart/XChartDocument.idl
index 1f2b44b3f..0289dd93e 100644
--- a/offapi/com/sun/star/chart/XChartDocument.idl
+++ b/offapi/com/sun/star/chart/XChartDocument.idl
@@ -139,20 +139,38 @@ published interface XChartDocument: com::sun::star::frame::XModel
     //------------------------------------------------------------------------- 
      
     /** @returns 
-            the data source of the chart. 
+            the data of the chart.
+
+        <p>The returned object supports interface <type>XChartDataArray</type>
+        which can be used to access the concrete data.</p>
+
+        <p>Since OOo 3.3 the returned object also supports interface <type>XComplexDescriptionAccess</type>
+        which can be used to access complex hierarchical axis descriptions.</p>
                  
-        @see ChartData
+        @see XChartData
+        @see XChartDataArray
+        @see XComplexDescriptionAccess
      */
     com::sun::star::chart::XChartData getData(); 
  
     //------------------------------------------------------------------------- 
      
-    /** attaches an external data source to the chart.
+    /** attaches data to the chart.
+
+        <p>The given object needs to support interface <type>XChartDataArray</type>.</p>
+
+        <p>Since OOo 3.3 if the given object might support interface <type>XComplexDescriptionAccess</type>
+        which allows to set complex hierarchical axis descriptions.</p>
+
+        <p>The given data is copied before it is applied to the chart.
+        So changing xData after this call will have no effect on the chart.</p>
 
-        @see ChartData
+        @see XChartData
+        @see XChartDataArray
+        @see XComplexDescriptionAccess
 
         @param xData
-            the component that provides the new data.
+            the object that provides the new data.
      */
     void attachData( [in] com::sun::star::chart::XChartData xData ); 
  
diff --git a/offapi/com/sun/star/chart/XComplexDescriptionAccess.idl b/offapi/com/sun/star/chart/XComplexDescriptionAccess.idl
index 6a706ffc3..0484d0110 100755
--- a/offapi/com/sun/star/chart/XComplexDescriptionAccess.idl
+++ b/offapi/com/sun/star/chart/XComplexDescriptionAccess.idl
@@ -40,8 +40,13 @@
  
 //============================================================================= 
  
-/** gives access to complex column and row descriptions.
- */
+/** Offers access to complex column and row descriptions.
+
+<p>Can be obtained from interface <type>XChartDocument</type> via method getData().</p>
+
+@since OOo 3.3
+*/
+
 published interface XComplexDescriptionAccess : XChartDataArray
 { 
     //-------------------------------------------------------------------------