ImageIcon Clase

  • Referencia

Definición

Espacio de nombres:
Microsoft.UI.Xaml.Controls
Editar

Representa un icono que usa una imagen como contenido.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para 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 : IconElement
Public Class ImageIcon
Inherits IconElement
Herencia
IconElement
ImageIcon
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.

Las aplicaciones WinUI 3 Gallery y WinUI 2 Gallery incluyen ejemplos interactivos de la mayoría de los controles, características y funcionalidades de WinUI 3 y WinUI 2.

Si ya se instalaron, haga clic en los vínculos siguientes para abrirlas: WinUI 3 Gallery o WinUI 2 Gallery.

Si no están instaladas, puede descargar WinUI 3 Gallery y WinUI 2 Gallery desde Microsoft Store.

También puede obtener el código fuente de ambas desde GitHub (use la bifurcación principal para WinUI 3 y la bifurcación winui2 para WinUI 2).

En el ejemplo siguiente se muestra un appBarButton con .ImageIcon Source especifica una imagen que se incluye en el paquete de la aplicación.

<!--
xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
-->

<AppBarButton Label="ImageIcon">
    <AppBarButton.Icon>
        <muxc:ImageIcon Source="ms-appx:///Assets/globe.png"/>
    </AppBarButton.Icon>
</AppBarButton>

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

// using muxc = Microsoft.UI.Xaml.Controls;

var bitmapSource = new BitmapSource();
await bitmapSource.SetSourceAsync(bitmapStream);
var icon = new muxc.ImageIcon() { Source = bitmapSource };

Comentarios

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

La imagen debe ser sólida en un fondo transparente.

Solo se usa el primer fotograma de una imagen de varios fotogramas. Para usar iconos animados, consulta AnimatedIcon.

Debido a los tipos de archivo admitidos, ImageIcon omite la propiedad Foreground , por lo que no puede cambiar el color de primer plano como puede en otros controles derivados de IconSource .

ImageIconnormalmente se usa con un AppBarButton, pero se puede usar dondequiera que se pueda usar .IconElement

Constructores

ImageIcon()

Inicializa una nueva instancia de la clase ImageIcon.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Propiedades

Source

Obtiene o establece el URI del archivo de imagen que se va a usar como icono.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
SourceProperty

Identifica la propiedad de dependencia Source.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Se aplica a

Consulte también