ImageIconSource Classe

Definizione

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

Rappresenta un'origine icona che usa un tipo di immagine come contenuto.

/// [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
Ereditarietà
Object IInspectable DependencyObject IconSource ImageIconSource
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Esempio

Important

ImageIconSource è limitato all'uso con la IconSource proprietà di determinati controlli. Per altre info, vedi La sezione Osservazioni.

Tip

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

Aprire l'app Raccolta WinUI 3 e vedere IconElement in azione

L'app Raccolta WinUI 3 include esempi interattivi della maggior parte dei controlli e delle funzionalità di WinUI 3. Ottenere l'app dal Microsoft Store o ottenere il codice sorgente in GitHub.

L'esempio seguente mostra un Elemento InfoBar con ImageIconSource. ImageSource specifica un'immagine inclusa nel pacchetto dell'app.

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

Qui viene illustrato come caricare un oggetto ImageIconSource da un flusso bitmap.

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

Commenti

ImageIconSource è limitato all'uso con la IconSource proprietà di questi controlli:

L'altro utilizzo di ImageIconSource non genererà un errore, ma l'immagine non verrà visualizzata. Ad esempio, questo uso di ImageIconSource con IconSourceElement non mostrerà l'immagine.

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

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

ImageIconSource è simile a ImageIcon. Tuttavia, poiché non è un FrameworkElement, può essere condiviso.

Costruttori

Nome Descrizione
ImageIconSource()

Inizializza una nuova istanza della classe ImageIconSource.

Proprietà

Nome Descrizione
Dispatcher

Restituisce null sempre in un'app di SDK per app di Windows. Usare invece DispatcherQueue .

(Ereditato da DependencyObject)
DispatcherQueue

Ottiene l'oggetto DispatcherQueue a cui è associato questo oggetto. Rappresenta DispatcherQueue una funzionalità che può accedere al nel thread dell'interfaccia DependencyObject utente anche se il codice viene avviato da un thread non dell'interfaccia utente.

(Ereditato da DependencyObject)
Foreground

Ottiene o imposta un pennello che disegna il colore di primo piano del controllo.

(Ereditato da IconSource)
ImageSource

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

Identifica la ImageSource proprietà di dipendenza.

Metodi

Nome Descrizione
ClearValue(DependencyProperty)

Cancella il valore locale di una proprietà di dipendenza.

(Ereditato da DependencyObject)
CreateIconElement()

Crea un elemento dell'interfaccia utente icona.

(Ereditato da IconSource)
CreateIconElementCore()

Crea un elemento dell'interfaccia utente icona.

(Ereditato da IconSource)
GetAnimationBaseValue(DependencyProperty)

Restituisce qualsiasi valore di base stabilito per una proprietà di dipendenza, che si applica nei casi in cui un'animazione non è attiva.

(Ereditato da DependencyObject)
GetIconElementPropertyCore(DependencyProperty)

Esegue il mapping delle proprietà IconSource a IconElementProperties .

(Ereditato da IconSource)
GetValue(DependencyProperty)

Restituisce il valore effettivo corrente di una proprietà di dipendenza da dependencyObject.

(Ereditato da DependencyObject)
ReadLocalValue(DependencyProperty)

Restituisce il valore locale di una proprietà di dipendenza, se è impostato un valore locale.

(Ereditato da DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Registra una funzione di notifica per l'ascolto delle modifiche a una dipendenza specifica in questa istanza dependencyObject .

(Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)

Imposta il valore locale di una proprietà di dipendenza in un Oggetto DependencyObject.

(Ereditato da DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Annulla una notifica di modifica registrata in precedenza chiamando RegisterPropertyChangedCallback.

(Ereditato da DependencyObject)

Si applica a

Vedi anche