Setter.Value プロパティ

定義

名前空間:

Microsoft.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 で Setter に を指定Valueするさまざまな方法があります。

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

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

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

スタイルとテンプレート

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

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

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