ImageIconSource Classe

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Representa uma fonte de ícone que usa um tipo de imagem como seu conteúdo. Atualmente, os tipos de imagem com suporte são .bmp, .gif, .jpg, .png, .wdp e .tiff.

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

Dica

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

Abra o aplicativo Galeria do WinUI 3 e consulte 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 o código-fonte no GitHub.

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

<AppBarButton >
    <AppBarButton.Icon>
        <IconSourceElement>
            <ImageIconSource ImageSource="ms-appx:///Assets/globe.png"/>
        </IconSourceElement>
    </AppBarButton.Icon>
</AppBarButton>

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 é semelhante a ImageIcon. No entanto, como não é um FrameworkElement, ele pode ser compartilhado.

Construtores

ImageIconSource()

Inicializa uma nova instância da classe ImageIconSource.

Propriedades

Dispatcher	Sempre retorna null em um aplicativo SDK do Aplicativo Windows. Em vez disso, use DispatcherQueue . (Herdado de DependencyObject)
DispatcherQueue	Obtém o ao DispatcherQueue qual esse objeto está associado. O DispatcherQueue representa uma instalação que pode acessar o DependencyObject no thread da interface do usuário mesmo que o código seja 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 de 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 propriedade de dependência ImageSource.

Métodos

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 nos casos em que uma animação não está ativa. (Herdado de DependencyObject)
GetIconElementPropertyCore(DependencyProperty)	Mapeia as propriedades 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 uma DependencyProperty específica 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)

Confira também

• IconElement
• AppBarButton
• Image
• Ícones para aplicativos UWP