As soon as a form (含む/封じ込めるing 支配(する)/統制するs) is to be 現在のd to the 使用者,
there is a need for an instance controlling the 使用者 interaction.
Such a FormController is 責任がある dialog 過程ing,
like controlling the tab order and the 配合 of 支配(する)/統制するs.
As a form may 含む/封じ込める one or many subforms, a FormController may
含む/封じ込める one or more other FormControllers, so the form model structure or 階層制度
is 反映するd in the structure of FormControllers. That is, retrieving the parent of
the model of a 監査役 will give you the same 反対する as retrieving the model of the parent of
the 監査役. 類似して, retrieving the model of the nth child of
a 監査役 gives you the same 反対する as retrieving the nth child of
the model of the 監査役.
A 監査役 is called active if one of the 支配(する)/統制するs it is 責任がある has the 焦点(を合わせる),
else inactive. To be 通知するd whenever this 活性化 明言する/公表する of a given 監査役 changes, you can
追加する listeners.
This interface supersedes the ::com::sun::星/主役にする::form::FormController.
責任/義務s
A FormController is 責任がある a ::com::sun::星/主役にする::awt::UnoControlContainer,
and all 支配(する)/統制するs therein.
その上に, a form 監査役 is 責任がある 妨げるing 無効の 使用者 input. That is, if the form
含む/封じ込めるs 支配(する)/統制するs bound to a database, or to an 外部の validator, then the form 監査役 will
check their 現在の value when the 現在の 記録,記録的な/記録する is to be saved to the database.
First, it will check whether any 支配(する)/統制するs with an 外部の validator 存在する. If so, those validators
will be asked to 実証する the 現在の 支配(する)/統制する content. If this fails, the message 供給するd by the validator
is 陳列する,発揮するd to the 使用者, the 支配(する)/統制する is 焦点(を合わせる)d, and the update of the 記録,記録的な/記録する is 拒否権d.
Second, the 支配(する)/統制するs are 診察するd for NULL values. If a 支配(する)/統制する is bound to a database field which
is 宣言するd to be NOT NULL, no 自動車-increment field, but still NULL, then an error
message is shown to the 使用者 説 that input is 要求するd, the 各々の 支配(する)/統制する is 焦点(を合わせる)d, and
the update of the 記録,記録的な/記録する is 拒否権d.
公式文書,認める that you can precent the second check - for database fields 含む/封じ込めるing NULL values - on
a per-form and a per-database basis.
For the former, you need to 追加する a boolean 所有物/資産/財産 FormsCheckRequiredFields to the form
(aka the FormController's model), using its
::com::sun::星/主役にする::beans::XPropertyContainer::addProperty method, with a value
of 誤った.
For the latter, you need to 始める,決める the 各々の 所有物/資産/財産 of the data source's Settings
(also 指名するd FormsCheckRequiredFields) to 誤った.
Alternatively, you can 妨げる the check on a per-支配(する)/統制する basis, using the
::DataAwareControlModel::InputRequired 所有物/資産/財産 of a 選び出す/独身 支配(する)/統制する model.
If a 支配(する)/統制する which the 監査役 is 責任がある supports the ::com::sun::星/主役にする::でっちあげる,人を罪に陥れる::XDispatchProviderInterception
interface, the 監査役 登録(する)s a 派遣(する) 迎撃戦闘機. Then, the 支配(する)/統制する can try to 委任する/代表 part of its
functionality to the 監査役 by querying the 派遣(する) 迎撃戦闘機 for it.
Below, there's a 名簿(に載せる)/表(にあげる) of URLs which have a defined meaning - if an 実施 supports one of them,
there must be a 保証(人)d semantices. However, 固める/コンクリート 実施s may support an 独断的な sub or 最高の
始める,決める of these URLs.
In general, all URLs start with the same prefix, すなわち .uno:FormController/. To this, a suffix is
appended which 述べるs the requested functionality.
Example: The URL suffix for 削除するing the 現在の 記録,記録的な/記録する is deleteRecord, so the 完全にする URL for
requesting a dispatcher for this functionality is .uno:FormController/deleteRecord.
Some URLs may 要求する parameters. For this, the sequence of ::com::sun::星/主役にする::beans::PropertyValues
passed to the ::com::sun::星/主役にする::でっちあげる,人を罪に陥れる::XDispatch::派遣(する) call is used - every 所有物/資産/財産 value is
used as one 指名するd parameter.
For all URLs, 利益/興味d parties can 登録(する) as status listeners (::com::sun::星/主役にする::でっちあげる,人を罪に陥れる::XStatusListener)
at the dispatchers, and be 通知するd whenever the functionality associated with the URL becomes enabled or
無能にするd.
For instance, the URL with the suffix moveToFirst is associated with moving the form to the first
記録,記録的な/記録する, and it will be 無能にするd in 事例/患者 the form is already positioned on the first 記録,記録的な/記録する.
| URL suffix |
functionality |
| positionForm |
positions the form on a 記録,記録的な/記録する given by 絶対の number.
There's one parameter for this functionality, 指名するd Position, which must be a long
value 明示するing the 絶対の position to which the form should be moved |
| RecordCount |
This is a passive functionality: It cannot be 派遣(する)d, instead, 利益/興味d parties may
use the dispatcher to 追加する as ::com::sun::星/主役にする::でっちあげる,人を罪に陥れる::XStatusListener, and be
通知するd when the 記録,記録的な/記録する count changes.
The status value which is 存在 通知するd (::com::sun::星/主役にする::でっちあげる,人を罪に陥れる::FeatureStateEvent::明言する/公表する)
is a string which can be used to 陳列する,発揮する the 記録,記録的な/記録する count. In particular, if the 記録,記録的な/記録する count is not yet known
(::com::sun::星/主役にする::sdb::RowSet::IsRowCountFinal is 誤った), this is 示すd in the
string, too. |
| moveToFirst |
moves the form to the first 記録,記録的な/記録する |
| moveToPrev |
moves the form to the 記録,記録的な/記録する 先行する the 現在の one |
| moveToNext |
moves the form to the 記録,記録的な/記録する after the 現在の one |
| moveToLast |
moves the form to the last 記録,記録的な/記録する |
| moveToNew |
moves the form to the 事実上の "挿入する 列/漕ぐ/騒動", where new 記録,記録的な/記録するs can be 挿入するd |
| saveRecord |
Commits any 潜在的に 未解決の changes in the 現在の 支配(する)/統制する, and saves the 現在の 記録,記録的な/記録する to
the database, or 挿入するs a new 記録,記録的な/記録する if the form is 現在/一般に positioned on the 事実上の insertion 列/漕ぐ/騒動. |
| undoRecord |
逆戻りするs the changes done to the 現在の 記録,記録的な/記録する. 基本的に, this means refreshing the
現在の 列/漕ぐ/騒動 from the database, and updating all 支配(する)/統制するs with the new content. |
| deleteRecord |
削除するs the 現在の 記録,記録的な/記録する, after asking the 使用者 for 確定/確認. |
| refreshForm |
reloads the 完全にする form. After this, the form is positioned on the first 記録,記録的な/記録する |
| sortUp |
追加するs an order 条項 to the form, to sort it 上がるing by the field which the 現在の 支配(する)/統制する is bound to,
and then reloads the form. |
| sortDown |
追加するs an order 条項 to the form, to sort it descending by the field which the 現在の 支配(する)/統制する is bound to,
and then reloads the form. |
| sort |
opens an dialog, which 許すs the 使用者 to manipulate the 現在の sorting order of the form. If the dialog
is の近くにd with 承認する, the form is reloaded after setting the new sorting order. |
| autoFilter |
creates, from the 現在の 支配(する)/統制する, a filter for the form. This is, if the 現在の 支配(する)/統制する is bound to
the field, say, "顧客", and 含む/封じ込めるs the value "Furs, Inc.", then a filter "顧客 = 'Furs, Inc.'"
is created and 始める,決める at the form. After this, the form is reloaded. |
| filter |
opens an dialog, which 許すs the 使用者 to manipulate the 現在の filter of the form. If the dialog
is の近くにd with 承認する, the form is reloaded after setting the new filter. |
| applyFilter |
Toggles the ::com::sun::星/主役にする::sdb::RowSet::ApplyFilter 所有物/資産/財産
of the form.
Additionally, status listeners will be 供給するd with the 現在の (boolean) 明言する/公表する of this 所有物/資産/財産
in the ::com::sun::星/主役にする::でっちあげる,人を罪に陥れる::FeatureStateEvent::明言する/公表する member of the event
通知するd by the dispatcher. |
| removeFilterOrder |
完全に 除去するs any filter and sorting order from the form, and reloads it. |