FrameworkContentElement.Style Propiedad

Definición

Obtiene o establece el estilo que se va a usar por este 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 de propiedad

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

Ejemplos

En el ejemplo siguiente se establece una Resources colección en un FlowDocument elemento raíz y, a continuación, se hace referencia a ella como un recurso como un estilo específico para .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>

Comentarios

A menudo, el estilo actual se proporciona mediante un estilo predeterminado de creación de temas o de estilos que generalmente se aplican a objetos 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 el estilo implícito o un estilo explícito. En el caso de estilos implícitos o explícitos, no importa si se tiene acceso al estilo como un recurso o definido 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 el Style valor es NULL en este momento, durante la carga del sistema de propiedades comprueba si hay estilos implícitos como recursos definidos que especifican ese tipo. Si el estilo sigue siendo nulo después de este paso, el estilo procede 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.

Uso de atributos XAML

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

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 property es técnicamente posible, pero no se recomienda. 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