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

翻訳前ページへ


Interface XPropertyHandler
Language

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

API

SDK

Tips ‘n’ Tricks

Miscellaneous


:: com :: sun :: 星/主役にする :: 査察 ::

interface XPropertyHandler
Base Interfaces
XPropertyHandler
┗ ::com::sun::星/主役にする::lang::XComponent

::com::sun::星/主役にする::lang::XComponent
Description
used for controlling 資源s acquired by the handler

::com::sun::星/主役にする::lang::XComponent::配置する/処分する/したい気持ちにさせる is invoked when the 所有物/資産/財産 handler is not needed by the 反対する 視察官 anymore. Handler 実施s should clean up any 資源s here.

Description
is the basic interface for 反対する 査察.

The ObjectInspector itself does not know anything about the 反対する it is 検査/視察するing, all (警察などへの)密告,告訴(状) is 得るd 経由で XPropertyHandlers. Also, 所有物/資産/財産 handlers are 責任がある 述べるing the 使用者 interface which should be used to interact with the 使用者, with 尊敬(する)・点 to a given 面 of the 検査/視察するd 構成要素.

Since
OOo 2.0.3
See also
ObjectInspector, LineDescriptor

Methods' 要約
検査/視察する 貯蔵所d the 所有物/資産/財産 handler to a new 構成要素  
getPropertyValue retrieves the 現在の value of a 所有物/資産/財産  
setPropertyValue 始める,決めるs the value of a 所有物/資産/財産  
getPropertyState returns the 明言する/公表する of a 所有物/資産/財産  
describePropertyLine 述べるs the UI to be used to 代表する the 所有物/資産/財産  
convertToPropertyValue 変えるs a given 支配(する)/統制する-両立できる value to a 所有物/資産/財産 value  
convertToControlValue 変えるs a given 所有物/資産/財産 value to a 支配(する)/統制する-両立できる value  
addPropertyChangeListener 登録(する)s a listener for notification about 所有物/資産/財産 value changes  
removePropertyChangeListener 取り消すs a listener for notification about 所有物/資産/財産 value changes  
getSupportedProperties returns the 所有物/資産/財産s which the handler can 扱う  
getSupersededProperties returns the 所有物/資産/財産s which are to be superseded by this handler  
getActuatingProperties retrieve the actuating 所有物/資産/財産s which this handler is 利益/興味d in  
isComposable 決定するs whether a given 所有物/資産/財産, which the handler is 責任がある, is composable.  
onInteractivePropertySelection called when a browse button belonging to a 所有物/資産/財産 UI 代表 has been clicked  
actuatingPropertyChanged updates the UI of 扶養家族 所有物/資産/財産s when the value of a 確かな actuating 所有物/資産/財産 changed  
一時停止する 一時停止するs the handler  
Methods' 詳細(に述べる)s
検査/視察する
無効の
検査/視察する( [in] ::com::sun::星/主役にする::uno::XInterface  構成要素 )
raises( ::com::sun::星/主役にする::lang::NullPointerException );

Description
貯蔵所d the 所有物/資産/財産 handler to a new 構成要素
Parameter 構成要素
the 構成要素 to 検査/視察する. Must not be NULL
Throws
com::sun::星/主役にする::lang::NullPointerException if the 構成要素 is NULL
getPropertyValue
any
getPropertyValue( [in] string  PropertyName )
raises( ::com::sun::星/主役にする::beans::UnknownPropertyException );

Description
retrieves the 現在の value of a 所有物/資産/財産
Parameter PropertyName
the 指名する of the 所有物/資産/財産 whose value is to be retrieved
Throws
com::sun::星/主役にする::beans::UnknownPropertyException if the given 所有物/資産/財産 is not supported by the 所有物/資産/財産 handler
setPropertyValue
無効の
setPropertyValue( [in] string  PropertyName,
[in] any  Value )
raises( ::com::sun::星/主役にする::beans::UnknownPropertyException );

Description
始める,決めるs the value of a 所有物/資産/財産
Parameter PropertyName
the 指名する of the 所有物/資産/財産 whose value is to be 始める,決める
Parameter Value
the 所有物/資産/財産 value to 始める,決める
Throws
com::sun::星/主役にする::beans::UnknownPropertyException if the given 所有物/資産/財産 is not supported by the 所有物/資産/財産 handler
getPropertyState
::com::sun::星/主役にする::beans::PropertyState
getPropertyState( [in] string  PropertyName )
raises( ::com::sun::星/主役にする::beans::UnknownPropertyException );

Description
returns the 明言する/公表する of a 所有物/資産/財産
Parameter PropertyName
the 指名する of the 所有物/資産/財産 whose 明言する/公表する is to be retrieved
Throws
com::sun::星/主役にする::beans::UnknownPropertyException if the given 所有物/資産/財産 is not supported by the 所有物/資産/財産 handler
describePropertyLine
LineDescriptor
describePropertyLine( [in] string  PropertyName,
[in] XPropertyControlFactory  ControlFactory )
raises( ::com::sun::星/主役にする::beans::UnknownPropertyException,
::com::sun::星/主役にする::lang::NullPointerException );

Description
述べるs the UI to be used to 代表する the 所有物/資産/財産
Parameter PropertyName
the 指名する of the 所有物/資産/財産 whose 使用者 interface is to be 述べるd 実施
Parameter ControlFactory
a factory for creating XPropertyControl instances. Must not be NULL.
Returns
the descriptor of the 所有物/資産/財産 line.
Throws
com::sun::星/主役にする::beans::UnknownPropertyException if the given 所有物/資産/財産 is not supported by this handler
Throws
com::sun::星/主役にする::lang::NullPointerException if ControlFactory is NULL.
See also
PropertyControlType, LineDescriptor
convertToPropertyValue
any
convertToPropertyValue( [in] string  PropertyName,
[in] any  ControlValue )
raises( ::com::sun::星/主役にする::beans::UnknownPropertyException );

Description
変えるs a given 支配(する)/統制する-両立できる value to a 所有物/資産/財産 value

In describePropertyLine, a 所有物/資産/財産 handler 宣言するd which type of 支配(する)/統制する should be used to 陳列する,発揮する the value of a 確かな 所有物/資産/財産. To 許す to use the same 支配(する)/統制する type for different 所有物/資産/財産s, and in particular, for 所有物/資産/財産s of different type, 転換s between 支配(する)/統制するs values and 所有物/資産/財産 values are needed.

This method 変えるs a 支配(する)/統制する value into a 所有物/資産/財産 value, which subsequently can be used in 合同 with setPropertyValue.

Parameter PropertyName
The 指名する of the 転換's 的 所有物/資産/財産.
Parameter ControlValue
The to-be-変えるd 支配(する)/統制する value. This value has been 得るd from an XPropertyControl, using its Value せいにする.
Throws
com::sun::星/主役にする::beans::UnknownPropertyException if the given 所有物/資産/財産 is not supported by the 所有物/資産/財産 handler
See also
convertToControlValue, describePropertyLine, XPropertyControl, getPropertyValue
convertToControlValue
any
convertToControlValue( [in] string  PropertyName,
[in] any  PropertyValue,
[in] type  ControlValueType )
raises( ::com::sun::星/主役にする::beans::UnknownPropertyException );

Description
変えるs a given 所有物/資産/財産 value to a 支配(する)/統制する-両立できる value

In describePropertyLine, a 所有物/資産/財産 handler 宣言するd which type of 支配(する)/統制する should be used to 陳列する,発揮する the value of a 確かな 所有物/資産/財産. To 許す to use the same 支配(する)/統制する type for different 所有物/資産/財産s, and in particular, for 所有物/資産/財産s of different type, 転換s between 支配(する)/統制するs values and 所有物/資産/財産 values are needed.

This method 変えるs a 所有物/資産/財産 value, which has 以前 been 得るd using getPropertyValue, into a 支配(する)/統制する-両立できる value, which can be used with XPropertyControl's XPropertyControl::Value せいにする.

A usual 使用/適用 of this method are 名簿(に載せる)/表(にあげる) boxes: There is a generic 名簿(に載せる)/表(にあげる) box 実施, which is able to 陳列する,発揮する a simple 名簿(に載せる)/表(にあげる) of strings. Usually, every string 代表するs one possible 所有物/資産/財産 value. To translate between those 所有物/資産/財産 values and the 陳列する,発揮するd strings, convertToControlValue and convertToPropertyValue are used.

The method is not invoked if the 支配(する)/統制する's value type (XPropertyControl::ValueType equals the 所有物/資産/財産's value type.

Parameter PropertyName
The 指名する of the 所有物/資産/財産 whose value is to be 変えるd.
Parameter PropertyValue
The to-be-変えるd 所有物/資産/財産 value.
Parameter ControlValueType
The 的 type of the 転換. This type is 決定するd by the 支配(する)/統制する which is used to 陳列する,発揮する the 所有物/資産/財産, which in turn is 決定するd by the handler itself in describePropertyLine.
Speaking 厳密に, this is passed for convenience only, since every XPropertyHandler 実施 should know 正確に/まさに which type to 推定する/予想する, since it 暗黙に 決定するd this type in describePropertyLine by creating an appropriate XPropertyControl.
Throws
com::sun::星/主役にする::beans::UnknownPropertyException if the given 所有物/資産/財産 is not supported by the 所有物/資産/財産 handler
See also
convertToPropertyValue, describePropertyLine, XPropertyControl, getPropertyValue
addPropertyChangeListener
無効の
addPropertyChangeListener( [in] ::com::sun::星/主役にする::beans::XPropertyChangeListener  Listener )
raises( ::com::sun::星/主役にする::lang::NullPointerException );

Description
登録(する)s a listener for notification about 所有物/資産/財産 value changes

An XPropertyHandler 実施 might decide to ignore this call. However, in this 事例/患者 所有物/資産/財産 value changes made by third party 構成要素s are not 反映するd in the 反対する 視察官.

If a handler 実施 supports 所有物/資産/財産 change listeners, it must be able to 対処する with a call to addPropertyChangeListener even if 現在/一般に no 構成要素 is 存在 検査/視察するd. In this 事例/患者, the listener must become active as soon as a new introspectee is 始める,決める in the next 検査/視察する call.

Parameter Listener
the listener to 通知する about 所有物/資産/財産 changes
Throws
com::sun::星/主役にする::lang::NullPointerException if the listener is NULL
See also
removePropertyChangeListener
removePropertyChangeListener
無効の
removePropertyChangeListener( [in] ::com::sun::星/主役にする::beans::XPropertyChangeListener  Listener );

Description
取り消すs a listener for notification about 所有物/資産/財産 value changes
See also
addPropertyChangeListener
getSupportedProperties
sequence< ::com::sun::星/主役にする::beans::所有物/資産/財産 >
getSupportedProperties();

Description
returns the 所有物/資産/財産s which the handler can 扱う

A handler is 許すd to return an empty sequence here, 示すing that for the given introspectee, no 所有物/資産/財産s 扱うing can be 供給するd. This might happen when a 直す/買収する,八百長をするd 始める,決める of 所有物/資産/財産 handlers is used for a variety of 構成要素s to 検査/視察する, where not all handlers can really 対処する with all 構成要素s.

In the 事例/患者 of returning an empty sequence here, the 所有物/資産/財産 handler is ignored by all その上の 過程ing in the 反対する 視察官.

getSupersededProperties
sequence< string >
getSupersededProperties();

Description
returns the 所有物/資産/財産s which are to be superseded by this handler

Besides defining an own 始める,決める of 所有物/資産/財産s (see getSupportedProperties), a 所有物/資産/財産 handler can also 宣言する that foreign 所有物/資産/財産s (which it is not 責任がある) are superseded by its own 所有物/資産/財産s.

This is usually used if your handler is used with another, more generic one, which should continue to be 責任がある all 所有物/資産/財産s, except a few which your handler 扱うs more elegantly.

In such a 事例/患者, 簡単に return those 所有物/資産/財産s here.

There is a 優先 in the 所有物/資産/財産 handlers used by an ObjectInspector, which also is important for the superseded 所有物/資産/財産s. This 優先 is 暗示するd by the 優先 of factories to create the 所有物/資産/財産 handlers, as denoted in the XObjectInspectorModel::HandlerFactories せいにする.

With this in mind, 所有物/資産/財産 handlers can only supersede 所有物/資産/財産s which are supported by a handler 先行する them, but not 所有物/資産/財産s of handlers 後継するing them.

For instance, imaging an XObjectInspectorModel which 供給するs three factories, for handler A, B, and C - in this order. Now if A supports the 所有物/資産/財産 Foo, C supports 妨げる/法廷,弁護士業, and B supersedes both Foo and 妨げる/法廷,弁護士業, them the result is 妨げる/法廷,弁護士業 is still 現在の. This is because B に先行するs C, so it cannot, by 鮮明度/定義, supersede 所有物/資産/財産s which are supported by C.

If getSupportedProperties returned an empty sequence, this method will not be called.

See also
XObjectInspectorModel::HandlerFactories
getActuatingProperties
sequence< string >
getActuatingProperties();

Description
retrieve the actuating 所有物/資産/財産s which this handler is 利益/興味d in

In general, 所有物/資産/財産s can be 宣言するd as "actuating", that is, when their value changes, the UI for other 所有物/資産/財産s needs to be updated (e.g. enabled or 無能にするd).

With this method, a handler can 宣言する that it feels 責任がある some/all of the depending 所有物/資産/財産s of 確かな actuating 所有物/資産/財産s.

Whenever the value of an actuating 所有物/資産/財産 changes, all handlers which 表明するd their 利益/興味 in this particular actuating 所有物/資産/財産s are called with their actuatingPropertyChanged method.

If getSupportedProperties returned an empty sequence, this method will not be called

isComposable
boolean
isComposable( [in] string  PropertyName )
raises( ::com::sun::星/主役にする::beans::UnknownPropertyException );

Description
決定するs whether a given 所有物/資産/財産, which the handler is 責任がある, is composable.

An 反対する 視察官 can 検査/視察する 多重の 構成要素s at once, 陳列する,発揮するing the 交差点 of their 所有物/資産/財産s. For this, all 構成要素s are 診察するd for their 所有物/資産/財産s, and all 所有物/資産/財産s which 存在する for all 構成要素s, and are 宣言するd to be composable by their 各々の handler, are 陳列する,発揮するd in the 視察官 UI.

Parameter PropertyName
the 指名する of the 所有物/資産/財産 whose composability is to be 決定するd
Throws
com::sun::星/主役にする::beans::UnknownPropertyException if the given 所有物/資産/財産 is not supported by the 所有物/資産/財産 handler
onInteractivePropertySelection
InteractiveSelectionResult
onInteractivePropertySelection( [in] string  PropertyName,
[in] boolean  最初の/主要な,
[out] any  out_Data,
[in] XObjectInspectorUI  InspectorUI )
raises( ::com::sun::星/主役にする::beans::UnknownPropertyException,
::com::sun::星/主役にする::lang::NullPointerException );

Description
called when a browse button belonging to a 所有物/資産/財産 UI 代表 has been clicked

所有物/資産/財産 handlers can raise a 献身的な UI for entering or somehow changing a 所有物/資産/財産 value. Usually, this will be a modal dialog, but it can also be a 非,不,無-modal 使用者 interface 構成要素.

Availability of this feature is 示すd by the LineDescriptor::HasPrimaryButton and LineDescriptor::HasSecondaryButton members of a LineDescriptor, which the XPropertyHandler fills in its describePropertyLine method.

When this method is called, the 所有物/資産/財産 handler should raise the UI needed to enter the 所有物/資産/財産 value, and return the result of this (see InteractiveSelectionResult).

It is recommended that 所有物/資産/財産 handlers do not 直接/まっすぐに 始める,決める the 所有物/資産/財産 value which has been obatined from the 使用者, but 蓄える/店 it in the 生産(高)-parameter Data, and return InteractiveSelectionResult::ObtainedValue.

If a handler 始める,決めるs the new 所有物/資産/財産 value 直接/まっすぐに, and returns InteractiveSelectionResult::ObtainedValue, this 暗示するs that the 所有物/資産/財産 cannot 適切に be 扱うd in 事例/患者 the 反対する 視察官 is 検査/視察するing an 交差点 of 多重の 構成要素s, since in this 事例/患者 onInteractivePropertySelection will be called at one handler only, however the new 所有物/資産/財産 would have to be 今後d to all handlers.

If a 所有物/資産/財産 is not composeable, 直接/まっすぐに setting the new 所有物/資産/財産 value does not 産する/生じる any problem, as long as 所有物/資産/財産 listeners are 適切に 通知するd of the change.

Parameter PropertyName
The 指名する of the 所有物/資産/財産 whose browse button has been clicked
Parameter 最初の/主要な
true if and only if the 最初の/主要な button has been clicked, 誤った さもなければ
Parameter out_Data
If the method returns InteractiveSelectionResult::ObtainedValue, then out_Data 含む/封じ込めるs the value which has been interactively 得るd from the 使用者, and which still needs to be 始める,決める at the 検査/視察するd 構成要素.
Parameter InspectorUI
供給するs 接近 to the 反対する 視察官 UI. 実施s should use this if the 所有物/資産/財産 選択 要求するs 非,不,無-modal 使用者 input. In those 事例/患者s, onInteractivePropertySelection should return InteractiveSelectionResult::未解決の, and the UI for (at least) the 所有物/資産/財産 whose input is still 未解決の should be 無能にするd.
Returns
the result of the interactive 所有物/資産/財産 value 選択.
Throws
com::sun::星/主役にする::beans::UnknownPropertyException if the given 所有物/資産/財産 is not supported by the 所有物/資産/財産 handler
Throws
com::sun::星/主役にする::lang::NullPointerException if InspectorUI is NULL
See also
describePropertyLine, addPropertyChangeListener, isComposable
actuatingPropertyChanged
無効の
actuatingPropertyChanged( [in] string  ActuatingPropertyName,
[in] any  NewValue,
[in] any  OldValue,
[in] XObjectInspectorUI  InspectorUI,
[in] boolean  FirstTimeInit )
raises( ::com::sun::星/主役にする::lang::NullPointerException );

Description
updates the UI of 扶養家族 所有物/資産/財産s when the value of a 確かな actuating 所有物/資産/財産 changed

This method is called whenever a 所有物/資産/財産 value changes, 限られた/立憲的な to those 所有物/資産/財産s whose changes the handler 表明するd 利益/興味 in (see getActuatingProperties).

Parameter ActuatingPropertyName
the id of the actuating 所有物/資産/財産.
Parameter NewValue
the new value of the 所有物/資産/財産
Parameter OldValue
the old value of the 所有物/資産/財産
Parameter InspectorUI
a callback for updating the 反対する 視察官 UI
Parameter FirstTimeInit
If true, the method is called for the first-time update of the 各々の 所有物/資産/財産, that is, when the 所有物/資産/財産 browser is just initializing with the 所有物/資産/財産s of the introspected 反対する.
If 誤った, there was a real ::com::sun::星/主役にする::beans::XPropertyChangeListener::propertyChange event which 誘発する/引き起こすd the call.

In some 事例/患者s it may be necessary to differentiate between both 状況/情勢s. For instance, if you want to 始める,決める the value of another 所有物/資産/財産 when an actuating 所有物/資産/財産's value changed, you should definitely not do this when FirstTimeInit is true.
Throws
com::sun::星/主役にする::lang::NullPointerException if InspectorUI is NULL
一時停止する
boolean
一時停止する( [in] boolean  一時停止する );

Description
一時停止するs the handler

A XPropertyHandler is used by a XObjectInspector instance, which 器具/実施するs the XController interface. By 鮮明度/定義, a XObjectInspector always 今後s all 一時停止する requests (::com::sun::星/主役にする::でっちあげる,人を罪に陥れる::XController::一時停止する) to all it's handlers.

The usual use 事例/患者 for this method are 非,不,無-modal 使用者 interface 構成要素s used for 所有物/資産/財産 value input. Such a 構成要素 might have been opened during onInteractivePropertySelection. If a 所有物/資産/財産 handler receives a 一時停止する call, it should 今後 the 中断 request to the UI 構成要素, and 拒否権 中断 of the XObjectInspector as appropriate.

If 中断 is not to be 拒否権d, then all 非,不,無-modal UI 構成要素s opened by the handler should have been の近くにd when it returns from the 一時停止する call.

Parameter 一時停止する
Whether the handler is to be 一時停止するd true or 反動的なd (誤った). The latter happens if a handler was 首尾よく 一時停止するd, but an 外部の instance 拒否権d the whole 中断 過程.
Returns
true if the handler does 許す 中断, 誤った if it 拒否権s it.
最高の,を越す of Page

Apache Software Foundation

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

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