ImageIconSource Clase

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Controls

Representa un origen de icono que usa un tipo de imagen como contenido. Los tipos de imagen admitidos actualmente son .bmp, .gif, .jpg, .png, .wdp y .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

Herencia

Object IInspectable DependencyObject IconSource ImageIconSource

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Ejemplos

Sugerencia

Para obtener más información, instrucciones de diseño y ejemplos de código, consulta Iconos para aplicaciones de Windows.

Abra la aplicación Galería de WinUI 3 y vea IconElement en acción.

La aplicación WinUI 3 Gallery incluye ejemplos interactivos de la mayoría de los controles, las características y la funcionalidad de WinUI 3. Obtenga la aplicación en Microsoft Store u obtenga el código fuente en GitHub.

En el ejemplo siguiente se muestra un AppBarButton con imageIconSource. ImageSource especifica una imagen que se incluye en el paquete de la aplicación.

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

Aquí se muestra cómo cargar un ImageIconSource desde una secuencia de mapa de bits.

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

Comentarios

ImageIconSource es similar a ImageIcon. Sin embargo, dado que no es un FrameworkElement, se puede compartir.

Constructores

ImageIconSource()

Inicializa una nueva instancia de la clase ImageIconSource.

Propiedades

Dispatcher	Siempre devuelve null en una aplicación de SDK de Aplicaciones para Windows. Use DispatcherQueue en su lugar. (Heredado de DependencyObject)
DispatcherQueue	Obtiene el objeto DispatcherQueue al que está asociado este objeto. DispatcherQueue representa una instalación que puede acceder al DependencyObject en el subproceso de interfaz de usuario incluso si un subproceso que no es de interfaz de usuario inicia el código. (Heredado de DependencyObject)
Foreground	Obtiene o establece un pincel que pinta el color de primer plano del control. (Heredado de IconSource)
ImageSource	Obtiene o establece el URI del archivo de imagen que se va a usar como origen del icono.
ImageSourceProperty	Identifica la propiedad de dependencia ImageSource.

Métodos

ClearValue(DependencyProperty)	Borra el valor local de una propiedad de dependencia. (Heredado de DependencyObject)
CreateIconElement()	Crea un elemento de interfaz de usuario de icono. (Heredado de IconSource)
CreateIconElementCore()	Crea un elemento de interfaz de usuario de icono. (Heredado de IconSource)
GetAnimationBaseValue(DependencyProperty)	Devuelve cualquier valor base establecido para una propiedad de dependencia, que se aplicaría en los casos en los que una animación no está activa. (Heredado de DependencyObject)
GetIconElementPropertyCore(DependencyProperty)	Asigna las propiedades IconSource a IconElementProperties. (Heredado de IconSource)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia de dependencyObject. (Heredado de DependencyObject)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si se establece un valor local. (Heredado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra una función de notificación para escuchar los cambios en una dependencyProperty específica en esta instancia de DependencyObject . (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia en dependencyObject. (Heredado de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela una notificación de cambio registrada anteriormente llamando a RegisterPropertyChangedCallback. (Heredado de DependencyObject)

Consulte también

• IconElement
• AppBarButton
• Image
• Iconos de aplicaciones para UWP