ImageIcon Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 : IconElementPublic Class ImageIcon
Inherits IconElement- Herança
-
ImageIcon
- Atributos
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 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 Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows). |