FrameworkElement.Style Propiedad

Definición

Obtiene o establece el estilo que se usa este elemento cuando se representa.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 de propiedad

Estilo aplicado, no predeterminado para el elemento, si está presente.The applied, nondefault style for the element, if present. En caso contrario, es null.Otherwise, null. El valor predeterminado para un objeto FrameworkElement construido de forma predeterminada es null.The default for a default-constructed FrameworkElement is null.

Ejemplos

En el ejemplo siguiente se define un estilo en un diccionario 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>

Comentarios

En el caso de los controles, a menudo el estilo actual se proporciona mediante un estilo predeterminado desde el control de la información, o desde los estilos que se suelen aplicar a los controles de ese tipo por recursos en el nivel de página o aplicación (un 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). Esta propiedad no establece o devuelve estilos predeterminados (tema), pero devuelve un estilo implícito o un estilo explícito que actúa en el 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. En el caso de los estilos implícitos o explícitos, no importa si el estilo se especifica como un recurso o se define localmente.In the case of implicit or explicit styles, it does not matter whether the style is specified as a resource or defined locally.

La configuración de los estilos tiene algunas restricciones.Setting the styles has some restrictions. Puede restablecer la propiedad Style completa en un Style nuevo en cualquier momento, lo que forzará la recomposición del diseño.You can reset the entire Style property to a new Style at any time, which will force a layout recomposition. Sin embargo, en cuanto el estilo se coloca en uso por un elemento cargado, el Style debe considerarse sellado.However, as soon as that style is placed in use by a loaded element, the Style should be considered sealed. Al intentar realizar un cambio en cualquier propiedad individual de un estilo en uso (por ejemplo, cualquier elemento dentro de la colección de Setters), se produce una excepción.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. Un estilo que se define en el marcado se considera que está en uso en cuanto se carga desde un diccionario de recursos (para los recursos) o cuando se carga la página en la que se encuentra (para los estilos en línea).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 es una propiedad de dependencia con una prioridad especial.Style is a dependency property with special precedence. Normalmente, el estilo establecido localmente funciona con la prioridad más alta en el sistema de propiedades.The locally set style generally operates at the highest precedence in the property system. Si el Style es null en este momento, durante la carga el sistema de propiedades comprueba los estilos implícitos en los recursos locales o de aplicación que especifican ese 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. Si el estilo sigue siendo NULL después de este paso, el estilo de actuación con fines de presentación suele proceder del estilo predeterminado (tema), pero el estilo predeterminado no se devuelve en el valor de la propiedad 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 prioridad de los valores de propiedad de dependencia o estilo y plantillas.See Dependency Property Value Precedence or Styling and Templating.

Uso de atributos XAMLXAML Attribute Usage

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

Uso de elementos de propiedad XAMLXAML Property Element Usage

Valores XAMLXAML Values

resourceExtensionresourceExtension
Uno de los siguientes:, o.One of the following: , or . Vea recursos XAML.See XAML Resources.

styleResourceKeystyleResourceKey
Clave que identifica el estilo que se va a solicitar.The key that identifies the style being requested. La clave hace referencia a un recurso existente en un ResourceDictionary.The key refers to an existing resource in a ResourceDictionary.

Nota

La sintaxis del elemento de propiedad es técnicamente posible, pero no se recomienda para la mayoría de los escenarios de estilo.Property element syntax is technically possible, but not recommended for most style scenarios. Vea estilos y plantillas en línea.See Inline Styles and Templates. También es posible usar una referencia de enlace con TemplateBinding o Binding, pero no es muy habitual.A binding reference using TemplateBinding or Binding is also possible, but uncommon.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field StyleProperty
Propiedades de metadatos establecidas en trueMetadata properties set to true AffectsMeasure

Se aplica a