ImageBrush Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Pinta un área con una imagen. El origen de la imagen se obtiene normalmente a partir de formatos de archivo como Joint Photographic Experts Group (JPEG).
public ref class ImageBrush sealed : TileBrush/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ImageBrush : TileBrushPublic NotInheritable Class ImageBrush
Inherits TileBrush<ImageBrush .../>
- Herencia
- Atributos
Ejemplos
En este ejemplo XAML se muestra cómo establecer la propiedad Foreground de un TextBlock en un 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.
Resulta útil usar un ImageBrush en lugar de un control Image en dos escenarios principales:
- Quiere pintar un área no rectangular, como una elipse o un borde con una imagen.
- Quiere usar un solo ImageBrush para pintar varias áreas o UIElements con la misma imagen, que es más eficaz que usar varios controles de imagen .
Si define un ImageBrush mediante código, use el constructor predeterminado y, a continuación, establezca ImageBrush.ImageSource. Esto requiere un elemento 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 el ejemplo de imágenes XAML para obtener código de ejemplo.
Note
Puede usar el control automático para acceder a recursos no calificados con calificadores de escala y referencia cultural actuales, o puede usar ResourceManager y ResourceMap con calificadores para la referencia cultural y la escala para obtener los recursos directamente. Para obtener más información, consulte Sistema de administración de recursos.
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 como aplicadas a una propiedad Brush determinada con el comportamiento Relleno , mientras que otras imágenes no se estiran o escalan bien y pueden requerir un valor de None o Uniform for Stretch. Experimente con valores diferentes para Stretch para ver qué comportamiento se ve mejor cuando se aplica a la interfaz de usuario.
Orígenes de imágenes y escalado
Debes crear tus orígenes de imágenes en varios tamaños recomendados, para asegurarte de que la aplicación sea excelente cuando Windows 8 la escala. Al especificar imageSource para un imageBrush, puede usar una convención de nomenclatura que hará referencia automáticamente al recurso correcto para el escalado actual. Para obtener información específica sobre la convención de nomenclatura y más información, consulte Inicio rápido: Uso de recursos de archivo o imagen.
Para obtener más información sobre cómo diseñar el escalado, consulta Directrices de experiencia del usuario para el diseño y el escalado.
Constructores
| Nombre | Description |
|---|---|
| ImageBrush() |
Inicializa una nueva instancia de la clase ImageBrush . |
Propiedades
| Nombre | Description |
|---|---|
| AlignmentX |
Obtiene o establece la alineación horizontal del contenido en el icono base TileBrush . (Heredado de TileBrush) |
| AlignmentY |
Obtiene o establece la alineación vertical del contenido en el icono base tileBrush . (Heredado de TileBrush) |
| Dispatcher |
Siempre devuelve |
| DispatcherQueue |
Obtiene el objeto |
| ImageSource |
Obtiene o establece el origen de la imagen mostrado por este ImageBrush. En el código que estableces con una instancia de subclase ImageSource , en XAML la estableces con un URI en un archivo de origen de imagen. |
| ImageSourceProperty |
Identifica la propiedad de dependencia ImageSource . |
| Opacity |
Obtiene o establece el grado de opacidad de un pincel. (Heredado de Brush) |
| RelativeTransform |
Obtiene o establece la transformación que se aplica al pincel mediante coordenadas relativas. (Heredado de Brush) |
| Stretch |
Obtiene o establece un valor que especifica cómo se extiende el contenido de este TileBrush para ajustarse a sus mosaicos. (Heredado de TileBrush) |
| Transform |
Obtiene o establece la transformación que se aplica al pincel. (Heredado de Brush) |
Métodos
| Nombre | Description |
|---|---|
| ClearValue(DependencyProperty) |
Borra el valor local de una propiedad de dependencia. (Heredado de DependencyObject) |
| GetAnimationBaseValue(DependencyProperty) |
Devuelve cualquier valor base establecido para una propiedad de dependencia, que se aplicaría en los casos en los que una animación no está activa. (Heredado de DependencyObject) |
| GetValue(DependencyProperty) |
Devuelve el valor efectivo actual de una propiedad de dependencia de dependencyObject. (Heredado de DependencyObject) |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
Define una propiedad que se puede animar. (Heredado de Brush) |
| PopulatePropertyInfoOverride(String, AnimationPropertyInfo) |
Cuando se reemplaza en una clase derivada, define una propiedad que se puede animar. (Heredado de Brush) |
| ReadLocalValue(DependencyProperty) |
Devuelve el valor local de una propiedad de dependencia, si se establece un valor local. (Heredado de DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registra una función de notificación para escuchar los cambios en una dependencyProperty específica en esta instancia de DependencyObject . (Heredado de DependencyObject) |
| SetValue(DependencyProperty, Object) |
Establece el valor local de una propiedad de dependencia en dependencyObject. (Heredado de DependencyObject) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Cancela una notificación de cambio registrada anteriormente llamando a RegisterPropertyChangedCallback. (Heredado de DependencyObject) |
Eventos
| Nombre | Description |
|---|---|
| ImageFailed |
Se produce cuando se produce un error asociado a la recuperación o formato de la imagen. |
| ImageOpened |
Se produce cuando el origen de la imagen se descarga y descodifica sin errores. Puede usar este evento para determinar el tamaño de una imagen antes de representarla. |