gridsort: added XGridColumnModel::createColumn

1 files changed, 18 insertions, 10 deletions

diff --git a/offapi/com/sun/star/awt/grid/XGridColumnModel.idl b/offapi/com/sun/star/awt/grid/XGridColumnModel.idl
index 462fdf47d..b2127efb1 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.
+            the index of new created column.
+
+        @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 );
+    long addColumn( [in] XGridColumn column )
+        raises ( ::com::sun::star::lang::IllegalArgumentException );
 
-    /*
-    long getSelectedCount();
-    
-    sequence<XGridColumn> getSelectedColumns();
-    
-    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