FrameworkContentElement.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 FrameworkContentElement é null.

Exemplos

O exemplo seguinte estabelece uma Resources coleção num FlowDocument elemento raiz e depois referencia-o como um recurso como um estilo específico para um Paragraph.

<FlowDocument
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class=" SDKSample.Page2">
  <FlowDocument.Resources>
    <Style TargetType="{x:Type Paragraph}" x:Key="BluePara">
      <Setter Property="Background" Value="Blue"/>
      <Setter Property="FontSize" Value="18"/>
      <Setter Property="Foreground" Value="LightBlue"/>
      <Setter Property="FontFamily" Value="Trebuchet MS"/>
    </Style>
  </FlowDocument.Resources>
  <Paragraph Style="{StaticResource BluePara}">Lorem ipsum etc.</Paragraph>
</FlowDocument>

Observações

O estilo atual é frequentemente fornecido por um estilo padrão da tematização, ou por estilos geralmente aplicados a objetos 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 o estilo implícito ou um estilo explícito. No caso de estilos implícitos ou explícitos, não importa se o estilo é acedido 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 como recursos definidos que especificam esse tipo. Se o estilo continuar nulo após este passo, então o estilo vem do estilo padrão (tema), mas o estilo padrão não é devolvido no valor da Style propriedade. Ver Precedência de Valor de Propriedade de Dependência.

Uso de atributos XAML

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

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