gridsort: added XGridColumnModel::createColumn

1 files changed, 17 insertions, 9 deletions

diff --git a/offapi/com/sun/star/awt/grid/XGridColumnModel.idl b/offapi/com/sun/star/awt/grid/XGridColumnModel.idl
index ac281c8bad65..94ddc4eb5eeb 100644
--- a/offapi/com/sun/star/awt/grid/XGridColumnModel.idl
+++ b/offapi/com/sun/star/awt/grid/XGridColumnModel.idl
@@ -34,6 +34,7 @@
 #include <com/sun/star/awt/grid/XGridColumn.idl>
 #include <com/sun/star/container/XContainer.idl>
 #include <com/sun/star/lang/IndexOutOfBoundsException.idl>
+#include <com/sun/star/lang/IllegalArgumentException.idl>
 
 //=============================================================================
 
@@ -69,22 +70,29 @@ interface XGridColumnModel
     long getColumnCount();
 
     /** Adds a column to the model.
+
+        </p>You should use the <member>createColumn</member> member to create a new column. This gives
+        implementations of the <code>XGridColumnModel</code> interface the possibility to provide own column
+        implementations which extend the basic <type>GridColumn</type> type.</p>
+
         @param column
             the column to add to the model.
-
         @returns
-                the index of new created column.
-    */
-    long addColumn( [in] XGridColumn column );
-
-    /*
-    long getSelectedCount();
+            the index of new created column.
 
-    sequence<XGridColumn> getSelectedColumns();
+        @throws ::com::sun::star::lang::IllegalArgumentException
+            if the given column is not a valid element for the column container, or if it is <NULL/>.
+    */
+    long addColumn( [in] XGridColumn column )
+        raises ( ::com::sun::star::lang::IllegalArgumentException );
 
-    sequence<long> getSelectedIndex();
+    /** creates a new column for use with the column model.
 
+        <p>The newly created column is not yet inserted into the column container, you need to call <member>addColumn</member>
+        after you initialized the column object.</p>
     */
+    XGridColumn
+        createColumn();
 
     /** Returns all columns of the model.
         @returns