デザイナーでユーザーが行ったプロパティの変更をキャプチャし、デザイン時にカスタム ロジックを使用して新しい値を提供します。
名前空間: Microsoft.Windows.Design.Model
アセンブリ: Microsoft.Windows.Design.Interaction (Microsoft.Windows.Design.Interaction.dll 内)
構文
'宣言
Public Overridable Function TranslatePropertyValue ( _
item As ModelItem, _
identifier As PropertyIdentifier, _
value As Object _
) As Object
public virtual Object TranslatePropertyValue(
ModelItem item,
PropertyIdentifier identifier,
Object value
)
public:
virtual Object^ TranslatePropertyValue(
ModelItem^ item,
PropertyIdentifier identifier,
Object^ value
)
abstract TranslatePropertyValue :
item:ModelItem *
identifier:PropertyIdentifier *
value:Object -> Object
override TranslatePropertyValue :
item:ModelItem *
identifier:PropertyIdentifier *
value:Object -> Object
public function TranslatePropertyValue(
item : ModelItem,
identifier : PropertyIdentifier,
value : Object
) : Object
パラメーター
- item
型: Microsoft.Windows.Design.Model.ModelItem
プロパティの変更をキャプチャする対象の ModelItem。
- identifier
型: Microsoft.Windows.Design.Metadata.PropertyIdentifier
ユーザーが値を変更しているプロパティ。
- value
型: System.Object
ユーザーが変更するプロパティの新しい値。
戻り値
型: System.Object
デザイナーでプロパティに設定する値。
例外
| 例外 | 条件 |
|---|---|
| ArgumentNullException | item は nullnull 参照 (Visual Basic では Nothing) なので、 |
| ArgumentNullException | identifier が空です。 |
解説
TranslatePropertyValue メソッドは、Properties のプロパティごとに 1 回ずつ呼び出されます。 戻り値は、新しい値か、またはメソッドに渡された値と同じ値です。
これらの変更は、デザイナーにのみ影響します。 実行時には、プロパティが、ユーザーが設定した値と共に表示されます。
重要
この方法を使用した場合、デザイナー内でのプロパティの動作が、XAML ビュー内のプロパティの値と一致しません。 XAML ビューには、デザイン時にユーザーが入力した値が表示されます。 XAML ビュー内の値は、プロパティの実行時の動作を表します。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。 このメンバーは、部分的に信頼されているコードから使用することはできません。 詳細については、「部分信頼コードからのライブラリの使用」を参照してください。