ImageBrush Classe

Definição

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 .../>

Herança

Object Platform::Object IInspectable DependencyObject Brush TileBrush ImageBrush

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Exemplos

Este exemplo XAML mostra como definir a propriedade Foreground de um TextBlock como um ImageBrush, cuja imagem é usada como o preenchimento do texto renderizado 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>

Comentários

Um ImageBrush é um tipo de pincel que define seu conteúdo como uma imagem que pode ser alongada e alinhada opcionalmente. Os usos para um ImageBrush incluem efeitos decorativos para texto ou planos de fundo de imagem para controles ou contêineres de layout.

É útil usar um ImageBrush em vez de um controle Image em dois cenários de main:

1. Você deseja pintar uma área não retangular, como uma elipse ou borda com uma imagem
2. Você deseja usar um único ImageBrush para pintar várias áreas ou UIElements com a mesma imagem, o que é mais eficiente do que usar vários controles image

Se você definir um ImageBrush usando código, use o construtor padrão e defina ImageBrush.ImageSource. Isso requer um BitmapImage (não um URI (Uniform Resource Identifier)) no código. Se a sua origem for um fluxo, use o método SetSourceAsync para iniciar o valor. Se sua origem for um URI (Uniform Resource Identifier), que inclui conteúdo em seu aplicativo que usa os esquemas ms-appx ou ms-resource , use o construtor BitmapImage que usa um URI (Uniform Resource Identifier). Você também pode considerar a manipulação do evento ImageOpened se houver algum problema de temporização com a recuperação ou decodificação da origem da imagem, em que você pode precisar de conteúdo alternativo para exibir até que a origem da imagem esteja disponível. Confira Exemplo de imagens XAML para obter um código de exemplo.

A propriedade Stretch é importante para como a imagem é aplicada quando usada como um pincel. Algumas imagens parecem boas quando alongadas conforme aplicado a uma determinada propriedade Brush com o comportamento Fill , enquanto outras imagens não alongam ou dimensionam bem e podem exigir um valor de None ou Uniform para Stretch. Experimente valores diferentes para o Stretch para ver qual comportamento parece melhor quando aplicado à interface do usuário.

Origens de imagens e dimensionamento

Você deve criar suas fontes de imagem em vários tamanhos recomendados, para garantir que seu aplicativo fique ótimo quando Windows 8 dimensioná-lo. Ao especificar um ImageSource para um ImageBrush, você pode usar uma convenção de nomenclatura que referenciará automaticamente o recurso correto para o dimensionamento atual. Para saber mais sobre a convenção de nomenclatura, confira Início rápido: usando recursos de arquivo ou imagem.

Para obter mais informações sobre como projetar para dimensionamento, consulte Diretrizes de experiência do usuário para layout e dimensionamento.

Observações para versões anteriores

Windows 8

Windows 8 teve um problema com a resolução ImageSource de um valor de URI de atributo XAML, se ImageBrush fizer parte de um estilo XAML ou modelo aplicado a um controle. Às vezes, o uso do controle usaria um URI base específico do componente em vez do URI base apropriado para o estilo ou modelo, que geralmente vem do aplicativo. O problema foi corrigido começando com Windows 8.1; o URI base é determinado corretamente para recursos de aplicativo ou recursos de componente, dependendo do escopo que precisa do URI base. Os aplicativos que foram compilados para Windows 8 podem ter usado soluções alternativas para esse comportamento, colocando seus arquivos de origem de imagem no lugar "errado", onde o URI XAML resolve e o aplicativo mostraria as imagens. Se você estiver migrando XAML de Windows 8 para Windows 8.1 deverá testar os usos do ImageBrush em um estilo ou modelo do XAML e verificar se a resolução de imagem em seu aplicativo está funcionando com Windows 8.1. Se você tiver um problema, mova os arquivos de origem da imagem dentro do pacote para que eles estejam no escopo de recurso correto para o novo comportamento.

Os aplicativos que foram compilados para Windows 8, mas estão sendo executados no Windows 8.1, continuam a adotar o comportamento do Windows 8.

Construtores

Propriedades

Métodos

Eventos

Aplica-se a

Confira também

• TileBrush
• Image
• Image e ImageBrush
• Exemplo de desenho baseado em vetor XAML (consulte Cenário 2)