FrameworkElement.Style Propiedad

Definición

Obtiene o establece el estilo que se usa este elemento cuando se representa.

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

Style

Estilo aplicado, no predeterminado para el elemento, si está presente. En caso contrario, es null. El valor predeterminado para un objeto FrameworkElement construido de forma predeterminada es null.

Ejemplos

En el ejemplo siguiente se define un estilo en un diccionario de recursos.

<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, el estilo actual suele proporcionarse mediante un estilo predeterminado para controlar temas o desde estilos que se aplican generalmente a los controles de ese tipo por recursos en el nivel de página o aplicación (un estilo implícito). Esta propiedad no establece ni devuelve estilos predeterminados (tema), pero devuelve un estilo implícito o un estilo explícito que actúa en el elemento. En el caso de estilos implícitos o explícitos, no importa si el estilo se especifica como un recurso o se define localmente.

Establecer los estilos tiene algunas restricciones. Puede restablecer toda Style la propiedad a un nuevo Style en cualquier momento, lo que forzará la reposición de un diseño. Sin embargo, tan pronto como ese estilo se coloque en uso por un elemento cargado, se Style debe considerar sellado. Si se intenta realizar un cambio en cualquier propiedad individual de un estilo en uso (como cualquier elemento de la colección de Setters) se produce una excepción. Un estilo que se define en el marcado se considera que está en uso en cuanto se carga desde un diccionario de recursos (para recursos) o se carga la página en la que se encuentra (para los estilos insertados).

Style es una propiedad de dependencia con prioridad especial. El estilo establecido localmente generalmente funciona con la prioridad más alta en el sistema de propiedades. Si es Style null en este momento, durante la carga del sistema de propiedades comprueba los estilos implícitos en los recursos locales o de aplicación que especifican ese tipo. Si el estilo sigue siendo nulo después de este paso, el estilo de actuación para fines de presentación suele provenír del estilo predeterminado (tema), pero el estilo predeterminado no se devuelve en el valor de propiedad Style . Consulte Precedencia de valor de propiedad de dependencia o Aplicación de estilos y plantillas.

Uso de atributos XAML

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

Uso de elementos de propiedad XAML

Valores XAML

resourceExtension
Uno de los siguientes: , o . Consulta Recursos XAML.

styleResourceKey
Clave que identifica el estilo que se solicita. La clave hace referencia a un recurso existente en .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. Consulte Estilos y plantillas insertados. Una referencia de enlace mediante TemplateBinding o Binding también es posible, pero poco común.

Información sobre propiedades de dependencia

Campo identificador StyleProperty
Propiedades de metadatos establecidas en true AffectsMeasure

Se aplica a