Exportar (0) Imprimir
Expandir todo
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

Style (Clase)

Habilita el uso compartido de propiedades, recursos y controladores de eventos entre las instancias de un tipo.

Espacio de nombres:  System.Windows
Ensamblado:  PresentationFramework (en PresentationFramework.dll)
XMLNS para XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

[ContentPropertyAttribute("Setters")]
[DictionaryKeyPropertyAttribute("TargetType")]
[LocalizabilityAttribute(LocalizationCategory.Ignore)]
public class Style : DispatcherObject, INameScope, 
	IAddChild, IQueryAmbient
<Style>
  Setters
</Style>

El tipo Style expone los siguientes miembros.

  NombreDescripción
Método públicoStyle()Inicializa una nueva instancia de la clase Style.
Método públicoStyle(Type)Inicializa una nueva instancia de la clase Style que se va a usar en el objeto Type especificado.
Método públicoStyle(Type, Style)Inicializa una nueva instancia de la clase Style que se va a usar en el objeto Type especificado y se basa en la clase Style especificada.
Arriba

  NombreDescripción
Propiedad públicaBasedOnObtiene o establece un estilo definido que es la base del estilo actual.
Propiedad públicaDispatcherObtiene el objeto Dispatcher al que está asociado DispatcherObject. (Se hereda de DispatcherObject).
Propiedad públicaIsSealedObtiene un valor que indica si el estilo es de sólo lectura y no se puede cambiar.
Propiedad públicaResourcesObtiene o establece la colección de recursos que se pueden usar en el ámbito de este estilo.
Propiedad públicaSettersObtiene una colección de objetos Setter y EventSetter.
Propiedad públicaTargetTypeObtiene o establece el tipo para el que está previsto este estilo.
Propiedad públicaTriggersObtiene una colección de objetos TriggerBase que aplican valores de propiedad basados en condiciones especificadas.
Arriba

  NombreDescripción
Método públicoCheckAccessDetermina si el subproceso de la llamada tiene acceso a DispatcherObject. (Se hereda de DispatcherObject).
Método públicoEquals(Object)Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoGetHashCodeDevuelve el código hash de este objeto Style. (Invalida a Object.GetHashCode()).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoRegisterNameRegistra un nuevo par de nombre y objeto en el ámbito de nombres actual.
Método públicoSealBloquea este estilo, así como todos los generadores y desencadenadores para que no se puedan cambiar.
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método públicoUnregisterNameQuita una asignación de nombre y objeto del ámbito de nombres.
Método públicoVerifyAccessExige que el subproceso de la llamada tenga acceso a DispatcherObject. (Se hereda de DispatcherObject).
Arriba

  NombreDescripción
Implementación explícita de interfacesMétodo privadoIAddChild.AddChildInfraestructura. Agrega un objeto secundario.
Implementación explícita de interfacesMétodo privadoIAddChild.AddTextInfraestructura. Agrega el contenido de texto de un nodo al objeto.
Implementación explícita de interfacesMétodo privadoINameScope.FindNameInfraestructura. Devuelve un objeto que tiene el nombre de identificación proporcionado.
Implementación explícita de interfacesMétodo privadoIQueryAmbient.IsAmbientPropertyAvailableConsulta si la propiedad de ambiente especificada está disponible en el ámbito actual.
Arriba

Puede establecer una clase Style en cualquier elemento que derive de FrameworkElement o FrameworkContentElement. Un estilo se suele declarar normalmente como un recurso de la sección de Resources. Puesto que los estilos son recursos, siguen las mismas reglas de ámbito que se aplican a todos los recursos; por tanto, cuando se declara un estilo, afecta a la parte donde se puede aplicar. Por ejemplo, si se declara el estilo en el elemento raíz del archivo XAML de definición de la aplicación, el estilo se puede usar en cualquier parte de la aplicación. Si se crea una aplicación de navegación y se declara el estilo en uno de sus archivos XAML, el estilo sólo se puede usar en ese archivo XAML. Para obtener más información sobre las reglas de ámbito para los recursos, vea Información general sobre recursos.

La declaración de estilo está formada por un objeto Style que contiene una colección de uno o más objetos Setter. Cada objeto Setter consta de una propiedad Property y una propiedad Value. La propiedad es el nombre de la propiedad del elemento al que se aplica el estilo. Una vez declarado el estilo como recurso, se puede hacer referencia a él como en el caso de cualquier otro recurso.

NotaNota

Si hay más de un establecedor en la colección de establecedores con el mismo valor de la propiedad Property, se usa el establecedor que se declara en último lugar. De igual forma, si se establece un valor para la misma propiedad en un estilo y en un elemento directamente, tiene prioridad el valor establecido en el elemento.

El modelo de estilos y plantillas de Windows Presentation Foundation (WPF) permite el mantenimiento y el uso compartido de una apariencia, así como la separación de presentación y lógica. Este modelo incluye un conjunto de características que permiten personalizar la UI. Este conjunto de características incluye la clase Style, así como las clases siguientes:

Para obtener más información, vea Aplicar estilos y plantillas.

En el ejemplo siguiente se muestra una declaración de estilo que afectará a la propiedad Background de una clase Control.


<Style x:Key="Style1">
  <Setter Property="Control.Background" Value="Yellow"/>
</Style>


Para aplicar el estilo anterior, haga lo siguiente:


<Label Content="Yellow Background" Style="{StaticResource Style1}" />


También puede aplicar estilos a todos los elementos de un tipo especificado mediante la propiedad TargetType. Agregar el tipo de destino al estilo significa que ya no es necesario especificar el nombre completo de la propiedad que se está estableciendo con la sintaxis ClassName.PropertyName. En el ejemplo siguiente se define un estilo que se aplicará a cada elemento TextBlock.


<Style TargetType="{x:Type TextBlock}">
  <Setter Property="FontFamily" Value="Segoe Black" />
  <Setter Property="HorizontalAlignment" Value="Center" />
  <Setter Property="FontSize" Value="12pt" />
  <Setter Property="Foreground" Value="#777777" />
</Style>


NotaNota

Muchos controles de WPF están formados por una combinación de otros controles de WPF, por lo que la creación de un estilo que se aplique a todos los controles de un tipo puede tener un gran impacto. Por ejemplo, si se crea un estilo cuyo destino son los controles TextBlock de un control Canvas, el estilo se aplica a todos los controles TextBlock del lienzo, aunque TextBlock forme parte de otro control, como ListBox.

Para obtener información sobre cómo extender un estilo definido o heredar de él, vea la página BasedOn.

.NET Framework

Compatible con: 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft