Partilhar via


FrameworkContentElement.Style Propriedade

Definição

Obtém ou define o estilo a ser usado por esse elemento.

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 FrameworkContentElement construído por padrão é null.

Exemplos

O exemplo a seguir estabelece uma Resources coleção em um FlowDocument elemento raiz e, em seguida, faz referência a ela 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>

Comentários

O estilo atual geralmente é fornecido por um estilo padrão de temas ou por estilos geralmente aplicados a objetos 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 o estilo implícito ou um estilo explícito. No caso de estilos implícitos ou explícitos, não importa se o estilo é acessado 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 é carregado de um dicionário de recursos (para recursos) ou a página em que está contida é 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á os estilos implícitos como recursos definidos que especificam esse tipo. Se o estilo ainda for nulo após essa etapa, o estilo será proveniente do estilo padrão (tema), mas o estilo padrão não será retornado no valor da Style propriedade. Consulte precedência de valor da propriedade dependency.

Uso do Atributo XAML

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

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. 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

Aplica-se a