Share via

ImageIcon Classe

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml.Controls
Modifica

Rappresenta un'icona che usa un'immagine come contenuto.

Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di 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
Ereditarietà
IconElement
ImageIcon
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Esempio

Suggerimento

Per altre info, linee guida per la progettazione ed esempi di codice, vedi Icone per le app di Windows.

Le app WinUI 3 Gallery e WinUI 2 Gallery includono esempi interattivi della maggior parte dei controlli WinUI 3 e WinUI 2, funzionalità e funzionalità.

Se è già installato, aprirli facendo clic sui collegamenti seguenti: Raccolta WinUI 3 o Raccolta WinUI 2.

Se non sono installati, è possibile scaricare la raccolta di WinUI 3 e la raccolta winUI 2 da Microsoft Store.

È anche possibile ottenere il codice sorgente per GitHub (usare il ramo principale per WinUI 3 e il ramo winui2 per WinUI 2).

L'esempio seguente mostra un controllo AppBarButton con un oggetto ImageIcon. Source specifica un'immagine inclusa nel pacchetto dell'app.

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

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

Di seguito viene illustrato come caricare un ImageIcon oggetto da un flusso bitmap.

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

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

Commenti

I tipi di immagine supportati sono .bmp, .gif, .jpg, .png, wdp e .tiff.

L'immagine deve essere solida su uno sfondo trasparente.

Viene usato solo il primo fotogramma di un'immagine a più fotogrammi. Per usare le icone animate, vedere AnimatedIcon.

A causa dei tipi di file supportati, ignora la proprietà Foreground, ImageIcon quindi non è possibile modificare il colore di primo piano come è possibile in altri controlli derivati IconSource.

ImageIcon viene in genere usato con un controllo AppBarButton, ma può essere usato ovunque sia possibile usare un oggetto IconElement .

Costruttori

ImageIcon()

Inizializza una nuova istanza della classe ImageIcon.

Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).

Proprietà

Source

Ottiene o imposta l'URI del file di immagine da utilizzare come icona.

Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).
SourceProperty

Identifica la proprietà di dipendenza Source.

Questa documentazione si applica a WinUI 2 per la piattaforma UWP (per WinUI nel SDK per app di Windows, vedi gli spazi dei nomi SDK per app di Windows).

Si applica a

Vedi anche