FrameworkElement.Style Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Obtém ou define o estilo usado por este elemento quando ele é renderizado.

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

Valor da propriedade

Style

O estilo não padrão aplicado a esse elemento, se houver. Caso contrário, null. O padrão para um FrameworkElement construído por padrão é null.

Exemplos

O exemplo a seguir define um estilo em um dicionário de recursos.

<Page.Resources>

<Style TargetType="Border" x:Key="PageBackground">
  <Setter Property="Background" Value="Blue"/>
</Style>

<Border Style="{StaticResource PageBackground}">

</Border>

Comentários

Para controles, o estilo atual geralmente é fornecido por um estilo padrão de temas de controle ou de estilos geralmente aplicados a controles desse tipo por recursos no nível de página ou aplicativo (um estilo implícito). Essa propriedade não define ou retorna estilos padrão (tema), mas retorna um estilo implícito ou um estilo explícito que está atuando no elemento. No caso de estilos implícitos ou explícitos, não importa se o estilo é especificado como um recurso ou definido localmente.

Definir os estilos tem algumas restrições. Você pode redefinir a propriedade inteira Style para uma nova Style a qualquer momento, o que forçará uma recomposição de layout. No entanto, assim que esse estilo for colocado em uso por um elemento carregado, ele Style deverá ser considerado lacrado. Tentar fazer uma alteração em qualquer propriedade individual de um estilo em uso (como qualquer coisa dentro da coleção de Setters) faz com que uma exceção seja gerada. Um estilo definido na marcação é considerado em uso assim que ele é carregado de um dicionário de recursos (para recursos) ou a página na qual ele está contido é carregada (para estilos embutidos).

Style é uma propriedade de dependência com precedência especial. O estilo definido localmente geralmente opera na precedência mais alta do sistema de propriedades. Se o Style valor for nulo neste momento, durante o carregamento do sistema de propriedades verificará estilos implícitos em recursos locais ou de aplicativo que especificam esse tipo. Se o estilo ainda for nulo após essa etapa, o estilo de ação para fins de apresentação geralmente vem do estilo padrão (tema), mas o estilo padrão não é retornado no valor da Style propriedade. Consulte Precedência de valor da propriedade de dependência ou estilo e modelagem.

Uso do Atributo XAML

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

Uso do elemento propriedade XAML

Valores XAML

resourceExtension
Um dos seguintes: , ou . Consulte recursos XAML.

styleResourceKey
A chave que identifica o estilo que está sendo solicitado. A chave refere-se a um recurso existente em um ResourceDictionary.

Observação

A sintaxe do elemento property é tecnicamente possível, mas não é recomendada para a maioria dos cenários de estilo. Consulte estilos e modelos embutidos. Uma referência de associação usando TemplateBinding ou Binding também é possível, mas incomum.

Informações da propriedade de dependência

Campo identificador	StyleProperty
Propriedades de metadados definidas como true	AffectsMeasure