ImageBrush Clase

Definición

public ref class ImageBrush sealed : TileBrush

/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ImageBrush final : TileBrush

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class ImageBrush final : TileBrush

[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ImageBrush : TileBrush

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class ImageBrush : TileBrush

Public NotInheritable Class ImageBrush
Inherits TileBrush

<ImageBrush .../>

Herencia

Object Platform::Object IInspectable DependencyObject Brush TileBrush ImageBrush

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Ejemplos

En este ejemplo XAML se muestra cómo establecer la propiedad Foreground de un TextBlock en imageBrush, cuya imagen se usa como relleno para el texto representado por TextBlock.

<!-- TextBlock with an image brush applied to the text. -->
<TextBlock FontFamily="Verdana" FontSize="72"
 FontStyle="Italic" FontWeight="Bold">
    SHRUBBERY
  <TextBlock.Foreground>
    <ImageBrush ImageSource="forest.jpeg"/>
  </TextBlock.Foreground>
</TextBlock>

Comentarios

ImageBrush es un tipo de pincel que define su contenido como una imagen que se puede estirar y alinear opcionalmente. Los usos de imageBrush incluyen efectos decorativos para texto o fondos de imagen para controles o contenedores de diseño.

Es útil usar un ImageBrush en lugar de un control Image en dos escenarios principales:

1. Quiere pintar un área no rectangular, como una elipse o un borde con una imagen.
2. Quiere usar un único ImageBrush para pintar varias áreas o UIElements con la misma imagen, lo que es más eficaz que usar varios controles image .

Si define un ImageBrush mediante código, use el constructor predeterminado y, a continuación, establezca ImageBrush.ImageSource. Esto requiere bitmapImage (no un identificador uniforme de recursos [URI]) en el código. Si el origen es una secuencia, usa el método SetSourceAsync para inicializar el valor. Si el origen es un identificador uniforme de recursos (URI), que incluye contenido en la aplicación que usa los esquemas ms-appx o ms-resource , use el constructor BitmapImage que toma un identificador uniforme de recursos (URI). También puedes considerar la posibilidad de controlar el evento ImageOpened si hay problemas de temporización al recuperar o descodificar el origen de la imagen, ya que es posible que necesites que aparezca otro contenido hasta que el origen de la imagen esté disponible. Consulta ejemplo de imágenes XAML para obtener código de ejemplo.

La propiedad Stretch es importante para cómo se aplica la imagen cuando se usa como pincel. Algunas imágenes se ven bien cuando se extienden según se aplican a una propiedad Brush determinada con el comportamiento Fill , mientras que otras imágenes no se estiran o escalan bien y pueden requerir un valor de None o Uniform para Stretch. Experimente con valores diferentes para Stretch para ver qué comportamiento se ve mejor cuando se aplica a la interfaz de usuario.

Orígenes y escala de las imágenes

Debes crear los orígenes de imágenes en varios tamaños recomendados, para asegurarte de que la aplicación tenga un aspecto excelente cuando Windows 8 la escale. Al especificar imageSource para imageBrush, puede usar una convención de nomenclatura que hará referencia automáticamente al recurso correcto para el escalado actual. Para ver información más específica acerca de la convención de nomenclatura y otros temas, consulta Inicio rápido: usar recursos de archivo o imagen.

Para obtener más información sobre cómo diseñar el escalado, consulta Directrices de experiencia de usuario para el diseño y el escalado.

Notas de las versiones anteriores

Windows 8

Windows 8 tenía un problema con la resolución ImageSource de un valor de URI de atributo XAML, si ImageBrush forma parte de un estilo XAML o plantilla que se aplica a un control. El uso del control a veces usaría un URI base específico del componente en lugar del URI base adecuado para el estilo o la plantilla, que normalmente procede de la aplicación. El problema se ha corregido a partir de Windows 8.1; el URI base se determina correctamente para los recursos de la aplicación o los recursos de componentes en función del ámbito que necesite el URI base. Las aplicaciones compiladas para Windows 8 podrían haber usado soluciones alternativas para este comportamiento, colocando sus archivos de origen de imagen en el lugar "incorrecto", donde el URI XAML se resolvería y la aplicación mostraría las imágenes. Si vas a migrar XAML de Windows 8 a Windows 8.1 debes probar los usos de ImageBrush en un estilo o plantilla de xaml y comprobar que la resolución de imágenes de la aplicación funciona con Windows 8.1. Si tiene un problema, debe mover los archivos de origen de la imagen dentro del paquete para que estén en el ámbito de recursos correcto para el nuevo comportamiento.

Las aplicaciones compiladas para Windows 8 que se ejecuten en Windows 8.1 siguen usando el comportamiento de Windows 8.

Constructores

Propiedades

Métodos

Eventos

Se aplica a

Consulte también

• TileBrush
• Image
• Image e ImageBrush
• Ejemplo de dibujo basado en vectores XAML (consulte escenario 2)