FrameworkContentElement.Style FrameworkContentElement.Style FrameworkContentElement.Style FrameworkContentElement.Style Property

Definición

Obtiene o establece el estilo que se va a usar por este elemento.Gets or sets the style to be used by this element.

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 FrameworkContentElement construido de forma predeterminada es null.The default for a default-constructed FrameworkContentElement is null.

Ejemplos

El siguiente ejemplo se establece un Resources colección en un FlowDocument elemento raíz y, a continuación, hace referencia a él como un recurso como un estilo específico para un Paragraph.The following example establishes a Resources collection on a FlowDocument root element and then references it as a resource as a specific style for a 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

El estilo actual a menudo se proporciona un estilo predeterminado de temas, o de estilos, por lo general se aplican a los objetos de ese tipo por los recursos en el nivel de página o aplicación (un estilo implícito).The current style is often provided by a default style from theming, or from styles generally applied to objects of that type by resources at page or application level (an implicit style). Esta propiedad no predeterminada establece o devuelve estilos (tema), sino devuelve el estilo implícito o explícito.This property does not set or return default (theme) styles, but it does return the implicit style or an explicit style. En el caso de los estilos implícitos o explícitos, no importa si el estilo se puede obtener acceso como un recurso o no definido localmente.In the case of implicit or explicit styles, it does not matter whether the style is accessed as a resource or defined locally.

Establecer los estilos tiene algunas restricciones.Setting the styles has some restrictions. Puede restablecer toda la Style propiedad a un nuevo Style en cualquier momento, lo que forzará una 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, tan pronto como ese 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. Intento de realizar un cambio en cualquier propiedad individual de un estilo en uso (como cualquier elemento dentro de la colección de Setters) hace que se produzca 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án en uso en cuanto se carga desde un diccionario de recursos (para los recursos) o se carga la página que está dentro de (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 prioridad especial.Style is a dependency property with special precedence. Establecida localmente estilo suele 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 la Style es null en este momento, durante la carga el sistema de propiedades busca los estilos implícitos como recursos definidos que especifican ese tipo.If the Style is null at this point, during loading the property system checks for implicit styles as defined resources that specify that type. Si el estilo todavía es nulo después de este paso, a continuación, el estilo procede del estilo predeterminado (tema), pero no se devuelve el estilo predeterminado en el Style valor de propiedad.If the style is still null after this step, then the style comes from the default (theme) style, but the default style is not returned in the Style property value. Consulte Dependency Property Value Precedence.See Dependency Property Value Precedence.

Uso de atributos XAMLXAML Attribute Usage

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

Valores XAMLXAML Values

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

styleResourceKeystyleResourceKey
La clave que identifica el estilo que se solicita.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

Sintaxis de elemento de propiedad es técnicamente posible, pero no se recomienda.Property element syntax is technically possible, but not recommended. Consulte plantillas y estilos alineados.See Inline Styles and Templates. Una referencia de enlace mediante TemplateBinding o Binding también es posible, pero es poco común.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
Establecen las propiedades de metadatos en trueMetadata properties set to true AffectsMeasure

Se aplica a