FrameworkContentElement.DefaultStyleKey プロパティ


このコントロールのスタイル テンプレートをテーマ内で検索するために使用するキーを取得または設定します。Gets or sets the key to use to find the style template for this control in themes.

protected public:
 property System::Object ^ DefaultStyleKey { System::Object ^ get(); void set(System::Object ^ value); };
protected internal object DefaultStyleKey { get; set; }
member this.DefaultStyleKey : obj with get, set
Protected Friend Property DefaultStyleKey As Object


スタイルのキー。The style key. スタイルを設定する要素の Type になっていないと、テーマ スタイルの参照の一部として正しく機能しません。To work correctly as part of theme style lookup, this value is expected to be the Type of the element being styled. null は、特定のケースで許容される値です。null is an accepted value for a certain case.


このプロパティは、通常、直接の setter では設定されません。This property is typically not set through any of its direct setters. 代わりに、新しいサブクラスを作成するたびに、この依存関係プロパティの型固有のメタデータをオーバーライドします。Instead, you override the type-specific metadata of this dependency property every time you create a new subclass. サブクラスを作成する場合は、コントロールサブクラスの静的コンストラクター内で、DefaultStyleKeyProperty 識別子に対して OverrideMetadata メソッドを呼び出します。When you subclass, call the OverrideMetadata method against the DefaultStyleKeyProperty identifier, within the static constructor of the control subclass.

たとえば、Bold などのインラインクラスでは、静的コンストラクター内の DefaultStyleKey メタデータをオーバーライドし、いくつかのインスタンスコンストラクターを公開すること以外に、ほとんどの実装はほとんどありません。For instance, an inline class such as Bold actually has very little implementation beyond overriding the DefaultStyleKey metadata in its static constructor, and exposing several instance constructors. Bold タグで囲まれた要素は BoldFontWeight プロパティを取得しますが、DefaultStyleKey の既定値を typeof(Bold)に設定することによって参照されたテーマスタイル内に実装されます。The fact that elements surrounded by the Bold tag gain a FontWeight property of Bold is implemented within the theme style that was referenced by setting the default value of DefaultStyleKey to typeof(Bold).

要素またはコントロールがテーマスタイルを意図的に使用しないようにするには、OverridesDefaultStyle プロパティを trueに設定します。If you want your element or control to deliberately not use theme styles, set the OverridesDefaultStyle property to true.

依存プロパティ情報Dependency Property Information

識別子フィールドIdentifier field DefaultStyleKeyProperty
メタデータプロパティが true に設定されるMetadata properties set to true AffectsMeasure