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í.
Pintar 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 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:
- Quiere pintar un área no rectangular, como una elipse o un borde con una imagen.
- 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.
Nota
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, consulta 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 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.
Constructores
| ImageBrush() |
Inicializa una nueva instancia de la clase ImageBrush . |
Propiedades
| 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 de 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 lo 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
| 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 invalida 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 mediante una llamada a RegisterPropertyChangedCallback. (Heredado de DependencyObject) |
Eventos
| ImageFailed |
Se produce cuando hay 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 representarlo. |