ImageIcon Classe

  • Referência

Definição

Namespace:
Microsoft.UI.Xaml.Controls
Editar

Representa um ícone que usa uma Imagem como seu conteúdo.

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ImageIcon : IconElement
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class ImageIcon : IconElement
Public Class ImageIcon
Inherits IconElement
Herança
IconElement
ImageIcon
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemplos

Dica

Para obter mais informações, diretrizes de design e exemplos de código, consulte Ícones para aplicativos do Windows.

Os aplicativos da Galeria do WinUI 3 e da Galeria do WinUI 2 incluem exemplos interativos da maioria dos controles, recursos e funcionalidade do WinUI 3 e do WinUI 2.

Se já estiverem instalado, abra-os clicando nos seguintes links: Galeria do WinUI 3 ou Galeria do WinUI 2.

Se eles não estiverem instalados, você poderá baixar a Galeria do WinUI 3 e a Galeria do WinUI 2 da Microsoft Store.

Você também pode obter o código-fonte para ambos do GitHub (use o branch main para WinUI 3 e o branch winui2 para WinUI 2).

O exemplo a seguir mostra um AppBarButton com um ImageIcon. A origem especifica uma imagem incluída no pacote do aplicativo.

<!--
xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
-->

<AppBarButton Label="ImageIcon">
    <AppBarButton.Icon>
        <muxc:ImageIcon Source="ms-appx:///Assets/globe.png"/>
    </AppBarButton.Icon>
</AppBarButton>

Aqui, mostramos como carregar um ImageIcon de um fluxo de bitmap.

// using muxc = Microsoft.UI.Xaml.Controls;

var bitmapSource = new BitmapSource();
await bitmapSource.SetSourceAsync(bitmapStream);
var icon = new muxc.ImageIcon() { Source = bitmapSource };

Comentários

Os tipos de imagem com suporte são .bmp, .gif, .jpg, .png, .wdp e .tiff.

A imagem deve ser sólida em uma tela de fundo transparente.

Somente o primeiro quadro de uma imagem de vários quadros é usado. Para usar ícones animados, consulte AnimatedIcon.

Devido aos tipos de arquivo com suporte, ImageIcon ignora a propriedade Foreground , portanto, você não pode alterar a cor de primeiro plano como pode em outros controles derivados de IconSource .

ImageIcon normalmente é usado com um AppBarButton, mas pode ser usado onde quer que um IconElement possa ser usado.

Construtores

ImageIcon()

Inicializa uma nova instância da classe ImageIcon.

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Propriedades

Source

Obtém ou define o URI do arquivo de imagem a ser usado como o ícone.

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SourceProperty

Identifica a propriedade de dependência Source.

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Aplica-se a

Confira também