specifies a model for a control which can display form data in a table-like way.
In opposite to other form controls, grid controls do not only
display the single current value of a column they are bound to. Moreover, they do
display not only the current row of the form, but all rows (at least potentially, limited
by the control size, of course).
The table rows in a grid control correspond to the rows in the DataForm
the control belongs to, and the columns correspond to single columns of the form's row set.
Columns of a grid control are modeled by own objects, too. They are very similar to usual
::com::sun::star::form::DataAwareControlModels modeling other "single-value" controls, but they are not described
as own services. Instead, they need to be created using the ::com::sun::star::form::XGridColumnFactory interface.
provides basic functionality of a container of ::com::sun::star::form::FormComponents.
All the container-related methods of this service related to control models,
this is what are the container elements for a GridControl.
As the ::com::sun::star::form::FormComponents service also specifies
the ::com::sun::star::script::XEventAttacherManager service, grid control models
also provide a scripting environment for their columns.
allows to create column models to be inserted into the control model.
Note that the object returned by the ::com::sun::star::form::XGridColumnFactory::createColumn
method is not part of the grid control, yet. It needs to be inserted using any of the
container interfaces.
You always need to use this interface for creating columns for the grid control.
Column models not created this way will not be accepted when inserted later on.
In a grid control, single columns can be selected (at most one at a time).
For various unfortunate reaons, this selection is an aspect of the model, not of the
control as you would expect.
This interface is deprecated, new implementations should not use it anymore, as it is to
be superseeded by a solution which is bound to the control, not the model.
The reset of the control is forwarded to all it's elements, means to all the column models.
As grid columns are very much like data-aware stand-alone controls, you can find a description
of the reset functionality in ::com::sun::star::form::DataAwareControlModel::XReset.