このページはEtoJ逐語翻訳フィルタによって翻訳生成されました。

翻訳前ページへ


Interface XFormController
Language

The 解放する/自由な and Open 生産性 控訴
解放(する)d: Apache OpenOffice 4.1.16

API

SDK

Tips ‘n’ Tricks

Miscellaneous


:: com :: sun :: 星/主役にする :: form :: runtime ::

unpublished interface XFormController
Base Interfaces
XFormController
┣ ::com::sun::星/主役にする::awt::XTabController
┣ ::com::sun::星/主役にする::コンテナ::XChild
┣ ::com::sun::星/主役にする::コンテナ::XIndexAccess
┃ ┗ ::com::sun::星/主役にする::コンテナ::XElementAccess
┣ ::com::sun::星/主役にする::コンテナ::XEnumerationAccess
┃ ┗ ::com::sun::星/主役にする::コンテナ::XElementAccess
┣ ::com::sun::星/主役にする::lang::XComponent
┣ ::com::sun::星/主役にする::util::XModifyBroadcaster
┣ ::com::sun::星/主役にする::form::XConfirmDeleteBroadcaster
┣ ::com::sun::星/主役にする::sdb::XSQLErrorBroadcaster
┣ ::com::sun::星/主役にする::sdb::XRowSetApproveBroadcaster
┣ ::com::sun::星/主役にする::form::XDatabaseParameterBroadcaster2
┃ ┗ ::com::sun::星/主役にする::form::XDatabaseParameterBroadcaster
┣ ::com::sun::星/主役にする::util::XModeSelectorXFilterController

::com::sun::星/主役にする::awt::XTabController
Description
is used for tab controlling and 配合 of the 支配(する)/統制するs.

The model 得るd 経由で ::com::sun::星/主役にする::awt::XTabController::getModel is the form for which the 監査役 is responsible.

::com::sun::星/主役にする::コンテナ::XChild
Description
許すs 接近 to the parent 監査役.
::com::sun::星/主役にする::コンテナ::XIndexAccess
Description
許すs 接近 to the sub 監査役s.
::com::sun::星/主役にする::コンテナ::XEnumerationAccess
Description
許すs enumerating sub 監査役s
::com::sun::星/主役にする::lang::XComponent
Description
許すs life time 支配(する)/統制する of the 監査役.
::com::sun::星/主役にする::util::XModifyBroadcaster
Description
許すs to 登録(する) as listener for modifications in the 支配(する)/統制するs which the 監査役 is responsible for.
::com::sun::星/主役にする::form::XConfirmDeleteBroadcaster
Description
used to 通知する deletions of data in the form before they happen.

A form 監査役 listens for deletion events at the form it is 責任がある. If and only if no ::com::sun::星/主役にする::form::XConfirmDeleteListener is 登録(する)d at the 監査役, it uses an own dialog to ask the 使用者 for 確定/確認.

::com::sun::星/主役にする::sdb::XSQLErrorBroadcaster
Description
is used to 通知する errors which happen in the form the 監査役 is 責任がある.

A form 監査役 listens for error events at the form it is 責任がある. If and only if no ::com::sun::星/主役にする::sdb::XSQLErrorListener is 登録(する)d at the 監査役, it uses an own dialog to 通知する the 使用者 of the error.

::com::sun::星/主役にする::sdb::XRowSetApproveBroadcaster
Description
is used for multiplexing 列/漕ぐ/騒動 始める,決める events happening on the form which the 監査役 is 責任がある.
::com::sun::星/主役にする::form::XDatabaseParameterBroadcaster2
Description
is used broadcasting parameter events in the form.

A form 監査役 listens for parameter events at the form it is 責任がある. If and only if no ::com::sun::星/主役にする::form::XDatabaseParameterListener is 登録(する)d at the 監査役, it uses an own dialog to ask the 使用者 for parameter values.

::com::sun::星/主役にする::util::XModeSelector
Description
許すs switching the form 監査役 to different 操作/手術 方式s.

The two 方式s usually (but not やむを得ず) supported by a form 監査役 are the DataMode and the FilterMode, where the former is the usual modus operandi for 陳列する,発揮するing and 修正するing data, and the latter is a special 方式 to enter a filter for the database form which the 監査役 is 責任がある.

XFilterController
Usage 制限s
optional
Description
許すs controlling the filter 方式.

If the form 監査役 supports a form based filter 方式, then it shall also support the XFilterController interface, which 許すs controlling this 方式.

Usage 制限s
not published
Description
明示するs a 構成要素 controlling the interaction between the 使用者 and form functionality.

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.
Since
OOo 3.3
See also
::com::sun::星/主役にする::form::構成要素, ::com::sun::星/主役にする::form::binding::BindableControlModel, ::com::sun::星/主役にする::sdb::DataSource::Settings

Methods' 要約
addActivateListener 追加するs the 明示するd listener to receive notifications whenever the 活性化 明言する/公表する of the 監査役 changes.  
removeActivateListener 除去するs the 明示するd listener from the 名簿(に載せる)/表(にあげる) of 構成要素s to receive notifications whenever the 活性化 明言する/公表する of the 監査役 changes.  
addChildController 追加するs a 監査役 to the 名簿(に載せる)/表(にあげる) of child 監査役s  
せいにするs' 要約
FormOperations denotes the instance which is used to 器具/実施する 操作/手術s on the form which the 監査役 作品 for.  
CurrentControl provicdes 接近 to the 現在/一般に active 支配(する)/統制する  
状況 許すs to 委任する/代表 確かな 仕事s to the 状況 of the form 監査役  
InteractionHandler used (if not NULL) for 使用者 interactions 誘発する/引き起こすd by the form 監査役.  
Methods' 詳細(に述べる)s
addActivateListener
無効の
addActivateListener( [in] ::com::sun::星/主役にする::form::XFormControllerListener  _Listener );

Description
追加するs the 明示するd listener to receive notifications whenever the 活性化 明言する/公表する of the 監査役 changes.
removeActivateListener
無効の
removeActivateListener( [in] ::com::sun::星/主役にする::form::XFormControllerListener  _Listener );

Description
除去するs the 明示するd listener from the 名簿(に載せる)/表(にあげる) of 構成要素s to receive notifications whenever the 活性化 明言する/公表する of the 監査役 changes.
addChildController
無効の
addChildController( [in] XFormController  _ChildController )
raises( ::com::sun::星/主役にする::lang::IllegalArgumentException );

Description
追加するs a 監査役 to the 名簿(に載せる)/表(にあげる) of child 監査役s
Throws
::com::sun::星/主役にする::lang::IllegalArgumentException if the given 監査役 is NULL, or cannot rightfully be a child 監査役. Since 監査役s mirror the 階層制度 of the forms the are 責任がある, this means that the form of the given child 監査役 must be a child of the 監査役 at which the method is invoked.
せいにするs' 詳細(に述べる)s
FormOperations
[ readonly ] XFormOperations FormOperations;
Description
denotes the instance which is used to 器具/実施する 操作/手術s on the form which the 監査役 作品 for.

This instance can be used, for instance, to 決定する the 現在の 明言する/公表する of 確かな form features.

CurrentControl
[ readonly ] ::com::sun::星/主役にする::awt::XControl CurrentControl;
Description
provicdes 接近 to the 現在/一般に active 支配(する)/統制する
状況
XFormControllerContext 状況;
Description
許すs to 委任する/代表 確かな 仕事s to the 状況 of the form 監査役
InteractionHandler
::com::sun::星/主役にする::仕事::XInteractionHandler InteractionHandler;
Description
used (if not NULL) for 使用者 interactions 誘発する/引き起こすd by the form 監査役.
最高の,を越す of Page

The ASF

Copyright & License | Privacy | 接触する Us | 寄付する | Thanks

Apache, OpenOffice, OpenOffice.org and the seagull logo are 登録(する)d trademarks of The Apache ソフトウェア 創立/基礎. The ASF logo is a trademark of The Apache ソフトウェア 創立/基礎. Other 指名するs appearing on the 場所/位置 may be trademarks of their 各々の owners.