FrameworkElement.Style Propriedade

Definição

Obtém ou define o estilo usado por este elemento quando ele é renderizado.Gets or sets the style used by this element when it is rendered.

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

O estilo não padrão aplicado a esse elemento, se houver.The applied, nondefault style for the element, if present. Caso contrário, null.Otherwise, null. O padrão para um FrameworkElement construído por padrão é null.The default for a default-constructed FrameworkElement is null.

Exemplos

O exemplo a seguir define um estilo em um dicionário de recursos.The following example defines a style in a resource dictionary.

<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 controlá-los ou de estilos geralmente aplicados a controles desse tipo por recursos em nível de página ou aplicativo (um estilo implícito).For controls, the current style is often provided by a default style from control theming, or from styles generally applied to controls of that type by resources at page or application level (an implicit style). Essa propriedade não define nem retorna estilos padrão (tema), mas retorna um estilo implícito ou um estilo explícito que está agindo no elemento.This property does not set or return default (theme) styles, but it does return either an implicit style or an explicit style that is acting on the element. No caso de estilos implícitos ou explícitos, não importa se o estilo é especificado como um recurso ou definido localmente.In the case of implicit or explicit styles, it does not matter whether the style is specified as a resource or defined locally.

Definir os estilos tem algumas restrições.Setting the styles has some restrictions. Você pode redefinir toda a propriedade Style para uma nova Style a qualquer momento, o que forçará uma recomposição de layout.You can reset the entire Style property to a new Style at any time, which will force a layout recomposition. No entanto, assim que esse estilo é colocado em uso por um elemento Loaded, o Style deve ser considerado lacrado.However, as soon as that style is placed in use by a loaded element, the Style should be considered sealed. A tentativa de 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.Attempting to make a change to any individual property of an in-use style (such as anything within the collection of Setters) causes an exception to be thrown. Um estilo definido na marcação é considerado em uso assim que é carregado de um dicionário de recursos (para recursos) ou a página na qual ele está contido é carregada (para estilos embutidos).A style that is defined in markup is considered to be in use as soon as it is loaded from a resource dictionary (for resources), or the page it is contained within is loaded (for inline styles).

Style é uma propriedade de dependência com precedência especial.Style is a dependency property with special precedence. O estilo definido localmente geralmente opera na precedência mais alta no sistema de propriedades.The locally set style generally operates at the highest precedence in the property system. Se o Style for nulo neste ponto, durante o carregamento, o sistema de propriedades verificará se há estilos implícitos em recursos locais ou de aplicativo que especificam esse tipo.If the Style is null at this point, during loading the property system checks for implicit styles in local or application resources that specify that type. 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 propriedade Style.If the style is still null after this step, then the acting style for presentation purposes generally comes from the default (theme) style, but the default style is not returned in the Style property value. Consulte precedência de valor da propriedade de dependência ou estilo e modelagem.See Dependency Property Value Precedence or Styling and Templating.

Uso do Atributo XAMLXAML Attribute Usage

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

Uso do elemento propriedade XAMLXAML Property Element Usage

Valores XAMLXAML Values

resourceExtensionresourceExtension
Um dos seguintes:, ou.One of the following: , or . Consulte recursos XAML.See XAML Resources.

styleResourceKeystyleResourceKey
A chave que identifica o estilo que está sendo solicitado.The key that identifies the style being requested. A chave refere-se a um recurso existente em um ResourceDictionary.The key refers to an existing resource in a ResourceDictionary.

Observação

A sintaxe do elemento Property é tecnicamente possível, mas não é recomendada para a maioria dos cenários de estilo.Property element syntax is technically possible, but not recommended for most style scenarios. Consulte estilos e modelos embutidos.See Inline Styles and Templates. Uma referência de associação usando TemplateBinding ou Binding também é possível, mas não comum.A binding reference using TemplateBinding or Binding is also possible, but uncommon.

Informações de Propriedade de DependênciaDependency Property Information

Campo de identificadorIdentifier field StyleProperty
Propriedades de metadados definidas como trueMetadata properties set to true AffectsMeasure

Aplica-se a