ImageIcon Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 : IconElementPublic Class ImageIcon
Inherits IconElement- Ereditarietà
-
ImageIcon
- Attributi
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 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 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). |