FrameworkElement.Style Propriedade

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 de Propriedade

O estilo aplicado e não padrão para o elemento, se presente. Caso contrário, null. O padrão para um padrão construído FrameworkElement é null.

Exemplos

O exemplo seguinte define um estilo num dicionário de recursos.

<Page.Resources>

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

<Border Style="{StaticResource PageBackground}">

</Border>

Observações

Para controlos, o estilo atual é frequentemente fornecido por um estilo padrão a partir da temática de controlos, ou por estilos geralmente aplicados a controlos desse tipo por recursos ao nível da página ou aplicação (um estilo implícito). Esta propriedade não define nem devolve estilos padrão (tema), mas devolve um estilo implícito ou um estilo explícito que atua sobre o elemento. No caso de estilos implícitos ou explícitos, não importa se o estilo é especificado como recurso ou definido localmente.

Definir os estilos tem algumas restrições. Podes repor toda Style a propriedade para uma nova Style a qualquer momento, o que vai forçar uma recomposição do layout. No entanto, assim que esse estilo é colocado em uso por um elemento carregado, deve Style ser considerado selado. Tentar alterar qualquer propriedade individual de um estilo em uso (como qualquer coisa dentro da coleção de Setters) provoca uma exceção. Um estilo definido em marcação é considerado em uso assim que é carregado a partir de um dicionário de recursos (para recursos), ou a página onde está contido é carregada (para estilos inline).

Style é uma propriedade de dependência com precedência especial. O estilo localmente definido geralmente opera com a precedência mais alta no sistema de propriedades. Se o Style for nulo neste ponto, durante o carregamento o sistema de propriedades verifica estilos implícitos em recursos locais ou de aplicação que especifiquem esse tipo. Se o estilo continuar nulo após este passo, então o estilo de atuação para fins de apresentação geralmente provém do estilo padrão (tema), mas o estilo padrão não é devolvido no Style valor da propriedade. Ver Valor de Propriedade de Dependência Precedência ou Estilização e Templação.

Uso de atributos XAML

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

Uso do elemento de propriedade XAML

Valores XAML

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

StyleResourceKey A chave que identifica o estilo solicitado. A chave refere-se a um recurso existente num ResourceDictionary.

Informação de Propriedade de Dependência