エクスポート (0) 印刷
すべて展開
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

FrameworkElement.Style プロパティ

2013/12/12

レンダリング中にこのオブジェクトに適用される Style インスタンスを取得または設定します。

Namespace:  System.Windows
アセンブリ:  System.Windows (System.Windows.dll 内)
XAML の XMLNS: xmlns にマップされていません。

public Style Style { get; set; }
<frameworkElement Style="{StaticResource styleResourceKey}"/>

XAML 値

styleResourceKey

要求されているスタイルを識別するキー。このキーは、ResourceDictionary 内の既存のリソースを参照します。

メモメモ:

インライン スタイルを定義する XAML プロパティ要素構文は、技術的には使用可能ですが、FrameworkElement.Style の設定ではお勧めしません。これは、1 回のみ使用するインライン スタイルによって設定されたプロパティは、プロパティを XAML 属性 (またはプロパティ要素) として直接設定することで、簡単に設定できるためです。その同じプロパティを設定するために 1 回のみ使用するスタイルを定義するのは、一般に、マークアップ スタイルとして適切ではありません。また、実行時のプロパティ設定動作の混乱の原因になる可能性もあります。

プロパティ値

型: System.Windows.Style
適用されるオブジェクトのスタイル (存在する場合)。それ以外の場合は null。既定の構築 FrameworkElement の既定値が null です。

依存関係プロパティの識別子フィールド:  StyleProperty

Windows Phone で UI 要素の外観のスタイルを設定する場合、Style プロパティを直接設定するのは一般的な方法ではありません。通常は、次のいずれかの操作によって、UI 要素の外観が設定されます。

  • コントロール作成者がテンプレート化可能なコントロールを作成した場合。コントロールを使用するアプリケーションは、新しい ControlTemplate を提供することにより、その外観を変更できます。

  • コントロール作成者が、コントロールのすべてのインスタンスに適用される既定のスタイルを作成した場合。また、コントロール作成者によってスタイルやテンプレート内の複合オブジェクトを参照するプロパティが公開されると、スタイルやテンプレートを調整しなくても、コントロールの特定の表示形式をプロパティで調整できます (コントロール コンシューマーのようなプロパティのスタイルを設定することもできますが、XAML 宣言の属性としてプロパティを直接設定する方が簡単です)。

スタイル内で設定されているプロパティの値を個別に変更できます。たとえば、Template プロパティが既にスタイルで設定されているとき、実行時にこのプロパティを設定できます。Setters でコレクションに setter を追加することもできます。ただし、読み込まれたオブジェクトによって使用されている Style は、使用が開始された直後にシールされたものと考える必要があります。この状態を検出するには、StyleIsSealed の値を確認します。スタイルが使用中と見なされるのは、オブジェクト ツリーおよび Windows Phone ルート ビジュアルに関連する読み込み済みのオブジェクトで参照された直後です。これは、Style プロパティが設定されたオブジェクトが Loaded イベントを発生させたときに検出できます。使用中のスタイルの個々のプロパティ (Setters コレクション内のプロパティなど) を変更しようとすると、例外がスローされます。

Control から派生したクラスでは、スタイルとテンプレート アプリケーションに関してコントロール作成者の役に立つエントリ ポイントが追加されます。FrameworkElement は、Loaded の前に呼び出される仮想コールバック OnApplyTemplate を定義します。Control から派生したクラスは、非テンプレート値をコントロールのそのインスタンスのテンプレートによって作成されたプロパティに適用するために、このコールバックをオーバーライドして、スタイルが使用中になる前にテンプレートによって設定されたプロパティ値を調整できます。

実行時にクエリを実行した場合、Style プロパティは、適用されているテンプレートからのスタイルを返しません。以前に Style プロパティによって明示的に設定されたスタイルのみを返します。また、暗黙のスタイルは返されません。暗黙のスタイル概念の詳細については、「Style」のトピックを参照してください。

Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示:
© 2015 Microsoft