diff options
author | Frank Schoenheit [fs] <frank.schoenheit@oracle.com> | 2011-01-24 11:44:36 +0100 |
---|---|---|
committer | Frank Schoenheit [fs] <frank.schoenheit@oracle.com> | 2011-01-24 11:44:36 +0100 |
commit | b7f54d1f8a7388f50f4e3172015dd072ceed5f35 (patch) | |
tree | 0e48c2e823a00997d5608c57ae976776324bd334 | |
parent | gridsort: document the relationship between soorting the data and notifying X... (diff) | |
download | core-b7f54d1f8a7388f50f4e3172015dd072ceed5f35.tar.gz core-b7f54d1f8a7388f50f4e3172015dd072ceed5f35.zip |
gridsort: re-did the column resizing
- introduced XGridColumn.Flexibility, determining to which degree the column is resized during auto-column-resizing
- removed XGridColumn.PreferredWidth - there really is no need for this anymore now
- documented the relationship between XGridColumn.Flexibility and XGridColumn.Resizeable
- re-implemented TableControl_Impl::impl_ni_updateColumnWidths, with (hopefully) less magic
-rw-r--r-- | offapi/com/sun/star/awt/grid/XGridColumn.idl | 43 |
1 files changed, 35 insertions, 8 deletions
diff --git a/offapi/com/sun/star/awt/grid/XGridColumn.idl b/offapi/com/sun/star/awt/grid/XGridColumn.idl index da3d5c8ade91..a73025d7715a 100644 --- a/offapi/com/sun/star/awt/grid/XGridColumn.idl +++ b/offapi/com/sun/star/awt/grid/XGridColumn.idl @@ -29,6 +29,7 @@ #include <com/sun/star/lang/XComponent.idl> #include <com/sun/star/style/HorizontalAlignment.idl> +#include <com/sun/star/lang/IllegalArgumentException.idl> #include <com/sun/star/awt/grid/XGridColumnListener.idl> #include <com/sun/star/util/XCloneable.idl> @@ -51,24 +52,50 @@ interface XGridColumn */ interface ::com::sun::star::util::XCloneable; - /** Specifies the an idendifier of the colomn.**/ + /** specifies an identifier of the column + + <p>This identifier will not be evaluated by the grid control, or its model. It is merely for clients + to identify particular columns.</p> + */ [attribute] any Identifier; - /** Specifies the default column witdth. **/ + /** specifies the current width of the column. + */ [attribute] long ColumnWidth; - /** Specifies the preferred column witdth. **/ - [attribute] long PreferredWidth; - - /** Specifies the min column witdth. **/ + /** specifies the minimal width the column can have. + */ [attribute] long MinWidth; - /** Specifies the max column witdth. **/ + /** specifies the maximal width the column can have. + */ [attribute] long MaxWidth; - /** Specifies whether column has fixed size or not. **/ + /** controls whether or not the column's width is fixed or not. + + <p>If this is <TRUE/>, the user can interactively change the column's width. Also, the column is subject to + auto-resizing, if its <member>Flexibility</member> attribute is greater <code>0</code>.</p> + */ [attribute] boolean Resizeable; + /** specifies the flexibility of the column when it is automatically resized due to the grid control as a whole + being resized. + + <p>Specify <code>0</code> here if you do not want the column to be resized automatically.</p> + + <p>If a column has a flexibility greater than 0, it is set in relationship to the flexibility of all + other such columns, and the respective widths of the columns are changed in the same relationship.</p> + + <p>Note that a column's flexibility is ignored if its <member>Resizeable</member> attribute is + <FALSE/>.</p> + + <p>A column's flexibility cannot be negative, attempts to set a negative value will raise an exception.</p> + */ + [attribute] long Flexibility + { + set raises ( ::com::sun::star::lang::IllegalArgumentException ); + }; + /** Specifies the horizontal alignment of the content in the control. */ [attribute] ::com::sun::star::style::HorizontalAlignment HorizontalAlign; |