Esta documentación está archivada y no tiene mantenimiento.

SystemColors.HighlightTextBrushKey (Propiedad)

Actualización: noviembre 2007

Obtiene el elemento ResourceKey del objeto SolidColorBrush que pinta el texto de los elementos seleccionados.

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

public static ResourceKey HighlightTextBrushKey { get; }
/** @property */
public static ResourceKey get_HighlightTextBrushKey()

public static function get HighlightTextBrushKey () : ResourceKey

<object property="{DynamicResource {x:Static SystemColors.HighlightTextBrushKey}}"/>
x:StaticExtensiones de marcado x:Static.

Valor de propiedad

Tipo: System.Windows.ResourceKey
Clave de recurso del SolidColorBrush que pinta el texto de los elementos seleccionados. La propiedad IsFrozen de este pincel es true, por lo que no se puede modificar.

Utilice HighlightTextBrushKey para crear una referencia dinámica al pincel que pinta el texto de los elementos seleccionados. Esta referencia dinámica se actualizará automáticamente si el pincel se cambia. Para crear una referencia estática que no se actualice automáticamente, utilice HighlightTextBrush.

La clase SystemColors proporciona acceso a los pinceles y colores del sistema, tales como ControlBrush, ControlBrushKey y DesktopBrush. Un pincel del sistema es un objeto SolidColorBrush que pinta una área con el color del sistema especificado. Un pincel del sistema siempre genera un relleno sólido; no se puede utilizar para crear un degradado.

Puede utilizar los pinceles del sistema como recursos estáticos o dinámicos. Utilice un recurso dinámico si desea que el pincel se actualice automáticamente en caso de que el usuario cambie el pincel del sistema mientras se ejecuta la aplicación; de lo contrario, utilice un recurso estático. La clase SystemColors contiene varias propiedades estáticas que cumplen una convención de nomenclatura estricta:

  • <SystemColor>Brush

    Obtiene una referencia estática a un objeto SolidColorBrush del color del sistema especificado.

  • <SystemColor>BrushKey

    Obtiene una referencia dinámica a un objeto SolidColorBrush del color del sistema especificado.

  • <SystemColor>Color

    Obtiene una referencia estática a una estructura Color del color del sistema especificado.

  • <SystemColor>ColorKey

    Obtiene una referencia dinámica a la estructura Color del color del sistema especificado.

Un color del sistema es una estructura Color que se puede utilizar para configurar un pincel. Por ejemplo, puede crear un degradado con los colores del sistema estableciendo las propiedades Color de los puntos de degradado de un objeto LinearGradientBrush degradado en colores del sistema. Para consultar un ejemplo, vea Cómo: Usar colores del sistema en un degradado.

En el ejemplo siguiente se utiliza una referencia de pincel del sistema dinámica para establecer el fondo de un botón.

<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  WindowTitle="SystemColors Example" Background="White">  
  <StackPanel Margin="20">

    <!-- Uses a dynamic resource to set the 
         background of a button. 
         If the desktop brush changes while this application
         is running, this button will be updated. -->
    <Button 
      Background="{DynamicResource {x:Static SystemColors.DesktopBrushKey}}" 
      Content="Hello, World!" />

  </StackPanel>
</Page>


En el ejemplo siguiente se utiliza una referencia de pincel del sistema estática para establecer el fondo de un botón.

<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  WindowTitle="SystemColors Example" Background="White">  
  <StackPanel Margin="20">

    <!-- Uses a static brush to set the
         background of a button. 
         If the desktop brush changes while this application
         is running, this button will not be updated until
         the page is loaded again. -->
    <Button 
      Background="{x:Static SystemColors.DesktopBrush}" 
      Content="Hello, World!"  /> 

  </StackPanel>
</Page>


Para obtener un ejemplo que muestra cómo utilizar un color del sistema en un degradado, vea Cómo: Usar colores del sistema en un degradado.

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0
Mostrar: