ImageIconSource Clase

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Controls

Representa un origen de icono que usa un tipo de imagen como contenido.

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

Importante

ImageIconSource se limita a usar con la IconSource propiedad de determinados controles. Consulta Comentarios para obtener más información.

Tip

Para obtener más información, instrucciones de diseño y ejemplos de código, consulta Icons 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, características y funcionalidades de WinUI 3. Obtenga la aplicación en Microsoft Store u obtenga el código fuente en GitHub.

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

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

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

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

Comentarios

ImageIconSource se limita a usar con la IconSource propiedad de estos controles:

• InfoBadge.IconSource
• InfoBar.IconSource
• SwipeItem.IconSource
• TabViewItem.IconSource
• TeachingTip.IconSource
• TitleBar.IconSource

Otro uso de ImageIconSource no producirá un error, pero no se mostrará la imagen. Por ejemplo, este uso de ImageIconSource con IconSourceElement no mostrará la imagen.

<!-- 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 -->

Los tipos de imagen admitidos se .bmp, .gif, .jpg, .png, .wdp y .tiff.

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

Constructores

Nombre	Description
ImageIconSource()	Inicializa una nueva instancia de la clase ImageIconSource.

Propiedades

Nombre	Description
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 la interfaz de usuario incluso si el código lo inicia un subproceso que no es de interfaz de usuario. (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 ImageSource propiedad de dependencia.

Métodos

Nombre	Description
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
• Image
• Iconos en aplicaciones de Windows