Language

The Free and Open Productivity Suite
Released: Apache OpenOffice 4.1.15

API

SDK

Tips ‘n’ Tricks

Miscellaneous


:: com :: sun :: star :: form :: control ::

service GridControl
Description
describes a table-like control for displaying data.

The model of the control has to support the ::com::sun::star::form::component::GridControl service.

See also
::com::sun::star::awt::UnoControl, ::com::sun::star::awt::UnoControlModel

Included Services - Summary
::com::sun::star::awt::UnoControl
(referenced entity's summary:)
specifies an abstract control.
Exported Interfaces - Summary
::com::sun::star::form::XBoundComponent

allows committing the content of the active cell of the control.

::com::sun::star::form::XGrid

allows access to the active cell within the grid. (details)

::com::sun::star::form::XGridControl
::com::sun::star::util::XModifyBroadcaster

used to broadcast modifications made by the user (within the active cell)

::com::sun::star::form::XGridFieldDataSupplier

allows access to the field data of the grid's current row in different formats (details)

::com::sun::star::container::XIndexAccess

allows access to objects wrapping a single column

::com::sun::star::container::XEnumerationAccess

allows creation of an enumeration for the column objects

::com::sun::star::util::XModeSelector

is used to switch the operating modes of the control. (details)

::com::sun::star::view::XSelectionSupplier

used to control the selection of rows in the grid control. (details)

::com::sun::star::frame::XDispatchProviderInterception

allows external components to register dispatchers for some common form actions. (details)

Included Services - Details
::com::sun::star::awt::UnoControl
(referenced entity's summary:)
specifies an abstract control.
Exported Interfaces - Details
::com::sun::star::form::XBoundComponent
Description
allows committing the content of the active cell of the control.
::com::sun::star::form::XGrid
Description
allows access to the active cell within the grid.

Only the column position can be modified using this interface, as the row position within a table control bound to a data source is given implicitly (by the cursor position of the data source).

::com::sun::star::form::XGridControl
Usage Restrictions
optional
::com::sun::star::util::XModifyBroadcaster
Description
used to broadcast modifications made by the user (within the active cell)
::com::sun::star::form::XGridFieldDataSupplier
Usage Restrictions
optional
Description
allows access to the field data of the grid's current row in different formats
::com::sun::star::container::XIndexAccess
Description
allows access to objects wrapping a single column
::com::sun::star::container::XEnumerationAccess
Description
allows creation of an enumeration for the column objects
::com::sun::star::util::XModeSelector
Usage Restrictions
optional
Description
is used to switch the operating modes of the control.

Besides the normal opreration mode (which is used to display the database form's data) the control may for instance support a filter mode.

::com::sun::star::view::XSelectionSupplier
Usage Restrictions
optional
Description
used to control the selection of rows in the grid control.

The selection used with the methods XSelectionSupplier::getSelection and XSelectionSupplier::select is a sequence of Any's.
Here the elements of the Sequence are the bookmarks (in the ::com::sun::star::sdb::RowSet) of the (to-be-) selected rows.

::com::sun::star::frame::XDispatchProviderInterception
Usage Restrictions
optional
Description
allows external components to register dispatchers for some common form actions.

A grid control can contain own UI elements for traveling within the database form it belongs to (This concept seems to make sense, as a grid control - in opposite to other data aware controls - displayes not only one record at a time, but a larger number of records of the database form.)
With the help of this interface, external components which wish to handle such travelings themself can register interceptors for the actions in question.

Usual URLs to use include

.uno:FormSlots/moveToFirst
move the cursor to the first record
.uno:FormSlots/moveToPrev
move the cursor to the previous record
.uno:FormSlots/moveToNext
move the cursor to the next record
.uno:FormSlots/moveToLast
move the cursor to the last record
.uno:FormSlots/moveToNew
move the cursor to the (one and only) new record
.uno:FormSlots/undoRecord
undo the changes done so far in the current record

A concrete implementation of this service may offer more or less URLs, but if it offers some of the URLs above, it must stick to the meanings defined above.


 
Top of Page

Apache Software Foundation

Copyright & License | Privacy | Contact Us | Donate | Thanks

Apache, OpenOffice, OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. The Apache feather logo is a trademark of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.