LibreOffice
LibreOffice 25.2 SDK API Reference
 
Loading...
Searching...
No Matches
com::sun::star::form::runtime::FormFeature Constant Group Reference

specifies the operations on a user interface form, as supported by the XFormOperations interface. More...

Variables

const short MoveAbsolute = 1
 moves the form to a record given by absolute position.
 
const short TotalRecords = 2
 determines the number of total records in the form, including the potentially active insertion row.
 
const short MoveToFirst = 3
 moves the form to the first record
 
const short MoveToPrevious = 4
 moves the form to the record before the current record, if there is any
 
const short MoveToNext = 5
 moves the form to the record after the current record, if there is any
 
const short MoveToLast = 6
 moves the form to the last record
 
const short MoveToInsertRow = 7
 moves the form to the insertion row, if privileges allow
 
const short SaveRecordChanges = 8
 saves all changes in the form's current record, including changes in the current control which had not yet been committed to the form
 
const short UndoRecordChanges = 9
 reverts all changes in the form's current record, including changes in the current control which had not yet been committed to the form
 
const short DeleteRecord = 10
 deletes the current record, while honoring any registered com::sun::star::form::XConfirmDeleteListeners
 
const short ReloadForm = 11
 reloads the form content
 
const short SortAscending = 12
 sorts the form ascending by the field which the active form control is bound to.
 
const short SortDescending = 13
 sorts the form descending by the field which the active form control is bound to.
 
const short InteractiveSort = 14
 opens a dialog which allows the user to interactively specify a form sorting order
 
const short AutoFilter = 15
 adds a filter to the form, which is defined by the active form control and its current value
 
const short InteractiveFilter = 16
 opens a dialog which allows the user to interactively specify a form filter
 
const short ToggleApplyFilter = 17
 toggles the com::sun::star::sdb::RowSet::ApplyFilter property of the form.
 
const short RemoveFilterAndSort = 18
 removes all filter and sort criteria put on the form.
 
const short RefreshCurrentControl = 19
 refreshes the current control
 

Detailed Description

specifies the operations on a user interface form, as supported by the XFormOperations interface.

Since
OOo 2.2

Variable Documentation

◆ AutoFilter

const short AutoFilter = 15

adds a filter to the form, which is defined by the active form control and its current value

For instance, if the currently active form control is bound to a table field named Price, and currently has a value of 100, then invoking the AutoFilter operation will put an additional filter Price = 100 on the form.

◆ DeleteRecord

const short DeleteRecord = 10

deletes the current record, while honoring any registered com::sun::star::form::XConfirmDeleteListeners

◆ InteractiveFilter

const short InteractiveFilter = 16

opens a dialog which allows the user to interactively specify a form filter

◆ InteractiveSort

const short InteractiveSort = 14

opens a dialog which allows the user to interactively specify a form sorting order

◆ MoveAbsolute

const short MoveAbsolute = 1

moves the form to a record given by absolute position.

This operation cannot be executed without arguments. When executing it (i.e. when calling com::sun::star::form::runtime::XFormOperations::executeWithArguments()), you need to specify a parameter named Position of type long, which denotes the position to move the form to.

◆ MoveToFirst

const short MoveToFirst = 3

moves the form to the first record

◆ MoveToInsertRow

const short MoveToInsertRow = 7

moves the form to the insertion row, if privileges allow

◆ MoveToLast

const short MoveToLast = 6

moves the form to the last record

◆ MoveToNext

const short MoveToNext = 5

moves the form to the record after the current record, if there is any

◆ MoveToPrevious

const short MoveToPrevious = 4

moves the form to the record before the current record, if there is any

◆ RefreshCurrentControl

const short RefreshCurrentControl = 19

refreshes the current control

Basically, this means calling XRefreshable::refresh on the current control, if it supports this interface.

Since
OOo 3.1

◆ ReloadForm

const short ReloadForm = 11

reloads the form content

◆ RemoveFilterAndSort

const short RemoveFilterAndSort = 18

removes all filter and sort criteria put on the form.

Note that this does not apply to criteria which are part of the form's data source. That is, if you bind the form to the SQL command SELECT * FROM Articles WHERE Price > 100, then the Price > 100 filter will not be removed.

Effectively, this operation resets the com::sun::star::sdb::RowSet::Filter and com::sun::star::sdb::RowSet::Order properties of the form.

◆ SaveRecordChanges

const short SaveRecordChanges = 8

saves all changes in the form's current record, including changes in the current control which had not yet been committed to the form

◆ SortAscending

const short SortAscending = 12

sorts the form ascending by the field which the active form control is bound to.

◆ SortDescending

const short SortDescending = 13

sorts the form descending by the field which the active form control is bound to.

◆ ToggleApplyFilter

const short ToggleApplyFilter = 17

toggles the com::sun::star::sdb::RowSet::ApplyFilter property of the form.

◆ TotalRecords

const short TotalRecords = 2

determines the number of total records in the form, including the potentially active insertion row.

This is not strictly an operation you can do on a form, but rather a state you can retrieve (and display to the user) using the XFormOperations's respective methods.

The state obtained here is a string, not a number. This is because in an UI form, the fact that the current record count is not yet known (since not all records have been visited, yet) is indicated by an asterisk (*) besides the record count.

◆ UndoRecordChanges

const short UndoRecordChanges = 9

reverts all changes in the form's current record, including changes in the current control which had not yet been committed to the form