FrameworkElement.Style Vlastnost

Definice

Získá nebo nastaví styl používaný tímto prvkem při vykreslení.

public:
 property System::Windows::Style ^ Style { System::Windows::Style ^ get(); void set(System::Windows::Style ^ value); };
public System.Windows.Style Style { get; set; }
member this.Style : System.Windows.Style with get, set
Public Property Style As Style

Hodnota vlastnosti

Použitý, nedefaultní styl elementu, pokud je k dispozici. V opačném případě null. Výchozí hodnota pro výchozí vytvořený FrameworkElement objekt je null.

Příklady

Následující příklad definuje styl ve slovníku prostředků.

<Page.Resources>
<Style TargetType="Border" x:Key="PageBackground">
  <Setter Property="Background" Value="Blue"/>
</Style>
<Border Style="{StaticResource PageBackground}">
</Border>

Poznámky

U ovládacích prvků je aktuální styl často poskytován výchozím stylem z motivů ovládacích prvků nebo ze stylů obecně použitých u ovládacích prvků tohoto typu prostředky na úrovni stránky nebo aplikace (implicitní styl). Tato vlastnost nenastavuje nebo nevrací výchozí styly (motiv), ale vrací buď implicitní styl, nebo explicitní styl, který působí na elementu. V případě implicitních nebo explicitních stylů nezáleží na tom, zda je styl zadán jako prostředek nebo definovaný místně.

Nastavení stylů má určitá omezení. Celou Style vlastnost můžete kdykoli obnovit na novou Style , která vynutí překompozici rozložení. Nicméně, jakmile je tento styl použit načtený prvek, Style je třeba považovat zapečetěné. Při pokusu o provedení změny jakékoli jednotlivé vlastnosti stylu použití (například cokoli v kolekci Setters) dojde k výjimce. Styl definovaný v revizích se považuje za použitelný, jakmile se načte ze slovníku prostředků (pro prostředky) nebo se načte stránka, ve které se nachází (pro vložené styly).

Style je vlastnost závislosti se zvláštní prioritou. Místně nastavený styl obecně funguje s nejvyšší prioritou v systému vlastností. Pokud je v tomto okamžiku Style null, při načítání systému vlastností kontroluje implicitní styly v místních nebo aplikačních prostředcích, které určují tento typ. Pokud je styl po tomto kroku stále null, pak herecký styl pro účely prezentace obecně pochází z výchozího stylu (motivu), ale výchozí styl není vrácen v hodnotě Style vlastnosti. Viz priorita hodnot vlastností závislosti nebo styling a šablonování.

Použití atributu XAML

<object Style="{resourceExtension styleResourceKey}"/>

Použití elementu vlastnosti XAML

Hodnoty XAML

resourceExtension Jedna z následujících možností: nebo . Viz prostředky XAML.

styleResourceKey Klíč, který identifikuje požadovaný styl. Klíč odkazuje na existující prostředek v objektu ResourceDictionary.

Poznámka:

Syntaxe elementu vlastnosti je technicky možná, ale nedoporučuje se pro většinu scénářů stylu. Viz vložené styly a šablony. Odkaz na vazbu pomocí TemplateBinding nebo Binding je také možný, ale neobvyklý.

Informace o vlastnosti závislosti

Položka Hodnota
Pole Identifikátor StyleProperty
Vlastnosti metadat nastavené na true AffectsMeasure

Platí pro