Setter.Value プロパティ

定義

名前空間:

Windows.UI.Xaml

Setter で指定されたプロパティに適用する値を取得または設定します。

public:
 property Platform::Object ^ Value { Platform::Object ^ get(); void set(Platform::Object ^ value); };

IInspectable Value();

void Value(IInspectable value);

public object Value { get; set; }

var object = setter.value;
setter.value = object;

Public Property Value As Object

<Setter ...>
  <Setter.Value>
    objectValue
  </Setter.Value>
</Setter>
- or -
<Setter Value="attributeValue"/>
-or-
<Setter Value="extensionUsage"/>

プロパティ値

Object

Platform::Object

IInspectable

Setter で指定されたプロパティに適用する値。

注釈

XAML 構文からわかるように、XAML では セッター の値を指定するさまざまな方法があります。

• 属性として、文字列値を使用します。 このような文字列値は、数値の設定、列挙体からの名前付き値、URI (Uniform Resource Identifier) などの単純なケースでは、プロパティ固有の型に暗黙的に変換できます。
• XAML オブジェクト要素構文で宣言され、オブジェクト要素がプロパティ要素の使用法内で入れ子になっている完全な新しいオブジェクトとして。
• 引用符内で {StaticResource} マークアップ拡張 の使用法を持つ属性として。 通常、プロパティの値型によって、適切な構文が決まります。 XAML の使用方法の詳細については、「XAML の 概要 」または 「XAML 構文ガイド」を参照してください。 ほとんどの XAML UI プロパティには属性構文を使用できます。また、プロパティ要素の使用状況やリソース参照を特に必要とする UI プロパティはあまり一般的ではありません。 {StaticResource} マークアップ拡張の使用法は、文字列や数値の値が複数のスタイルまたはプロパティで共有されている場合でも適切です。

Setter で Property プロパティと Value プロパティの両方を指定する必要があります。 それ以外の場合は、例外がスローされます ( Setter が XAML で作成されるか、コードで変更されているかに応じて、解析例外またはランタイム エラー)。

コードを使用して Setter インスタンスにアクセスする場合、親 Style の IsSealed プロパティの値が true の場合、Setter インスタンスのプロパティの値を変更することはできません。 これは、個々の Setter の IsSealed プロパティによっても報告されます。 ランタイムが UI 要素にスタイルを適用し、UI に表示する場合、システムはこれらのプロパティを true に設定します。 封印された セッター を変更しようとすると、ランタイム エラーがスローされます。

スタイルとテンプレート

Style で Setter を使用して、任意の依存関係プロパティに値を適用できます。 ただし、一般的なスタイルの XAML マークアップの大部分を構成するのは、Control 派生クラスの Template プロパティの Setter です。 を持つ Property="Template"Setter の Value は、ほとんどの場合、ControlTemplate オブジェクト要素を含むプロパティ要素として指定されます。

Style を使用してコントロール テンプレートを定義する場合、その Control.Template セッターの Style 要素の TargetType と ControlTemplate 要素の TargetType は常に同じ値を使用する必要があります。

テンプレート セッターは、そのテンプレートが適用されるコントロール インスタンスの基本的なテンプレート UI 定義を定義します。 また、コントロールのビジュアル状態と、既定のテーマの切り替えなどの状態ベースの UI 定義も含まれています。 ListBox などの複雑なコントロールの場合、既定のテンプレート Style と 内の ControlTemplate には、数百行の XAML を含めることができます。 コントロール テンプレート シナリオにおける Style の役割の詳細については、「 クイック スタート: コントロール テンプレート」を参照してください。