ImageIconSource Classe

Definição

Namespace:: Microsoft.UI.Xaml.Controls

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.

Editar

Representa uma fonte de ícone que usa um tipo de imagem como seu conteúdo.

/// [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 ImageIconSource : IconSource

[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 ImageIconSource : IconSource

Public Class ImageIconSource
Inherits IconSource

Herança: Object IInspectable DependencyObject IconSource ImageIconSource

Atributos: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemplos

Important

ImageIconSource é limitado a ser usado com a IconSource propriedade de determinados controles. Consulte Comentários para obter mais informações.

Tip

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

Abra o aplicativo Da Galeria do WinUI 3 e veja IconElement em ação

O aplicativo Galeria da WinUI 3 inclui exemplos interativos da maioria dos controles, recursos e funcionalidades da WinUI 3. Obtenha o aplicativo na Microsoft Store ou obtenha o código-fonte no GitHub.

O exemplo a seguir mostra um InfoBar com um ImageIconSource. ImageSource especifica uma imagem incluída no pacote do aplicativo.

<InfoBar Title="InfoBar Title"
         Message="This is an InfoBar message." 
         IsOpen="True">
    <InfoBar.IconSource>
        <ImageIconSource ImageSource="ms-appx:///Assets/StoreLogo.png"/>
    </InfoBar.IconSource>
</InfoBar>

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

var bitmapSource = new BitmapSource();
await bitmapSource.SetSourceAsync(bitmapStream);
var icon = new ImageIconSource() { ImageSource = bitmapSource };

Comentários

ImageIconSource é limitado a ser usado com a IconSource propriedade desses controles:

Outro uso de ImageIconSource não resultará em um erro, mas a imagem não será mostrada. Por exemplo, esse uso de ImageIconSource com IconSourceElement não mostrará a imagem.

<!-- INCORRECT CODE - DO NOT USE -->
<AppBarButton >
    <AppBarButton.Icon>
        <IconSourceElement>
            <ImageIconSource ImageSource="ms-appx:///Assets/StoreLogo.png"/>
        </IconSourceElement>
    </AppBarButton.Icon>
</AppBarButton>
<!-- INCORRECT CODE - DO NOT USE -->

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

ImageIconSource é semelhante a ImageIcon. No entanto, como não é um FrameworkElement, ele pode ser compartilhado.

Construtores

Nome	Description
ImageIconSource()	Inicializa uma nova instância da classe `ImageIconSource`.

Propriedades

Nome	Description
Dispatcher	Sempre retorna `null` em um aplicativo do SDK de Aplicativo do Windows. Em vez disso , use DispatcherQueue . (Herdado de DependencyObject)
DispatcherQueue	Obtém o `DispatcherQueue` que este objeto está associado. Representa `DispatcherQueue` uma instalação que pode acessar o `DependencyObject` thread da interface do usuário mesmo se o código for iniciado por um thread que não seja da interface do usuário. (Herdado de DependencyObject)
Foreground	Obtém ou define um pincel que pinta a cor do primeiro plano do controle. (Herdado de IconSource)
ImageSource	Obtém ou define o URI do arquivo de imagem a ser usado como a origem do ícone.
ImageSourceProperty	Identifica a `ImageSource` propriedade de dependência.

Métodos

Nome	Description
ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade de dependência. (Herdado de DependencyObject)
CreateIconElement()	Cria um elemento de interface do usuário de ícone. (Herdado de IconSource)
CreateIconElementCore()	Cria um elemento de interface do usuário de ícone. (Herdado de IconSource)
GetAnimationBaseValue(DependencyProperty)	Retorna qualquer valor base estabelecido para uma propriedade de dependência, que se aplicaria em casos em que uma animação não está ativa. (Herdado de DependencyObject)
GetIconElementPropertyCore(DependencyProperty)	Mapeia as propriedades do IconSource para IconElementProperties. (Herdado de IconSource)
GetValue(DependencyProperty)	Retorna o valor efetivo atual de uma propriedade de dependência de um DependencyObject. (Herdado de DependencyObject)
ReadLocalValue(DependencyProperty)	Retorna o valor local de uma propriedade de dependência, se um valor local for definido. (Herdado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra uma função de notificação para escutar alterações em um DependencyProperty específico nesta instância dependencyObject . (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência em um DependencyObject. (Herdado de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela uma notificação de alteração que foi registrada anteriormente chamando RegisterPropertyChangedCallback. (Herdado de DependencyObject)

Aplica-se a

Confira também

Comentários

Esta página foi útil?