ImageIconSource 類別

定義

命名空間:

Microsoft.UI.Xaml.Controls

表示使用影像類型做為其內容的圖示來源。 目前支援的映像類型為 .bmp、.gif、.jpg、.png、.wdp 和 .tiff。

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

繼承

Object IInspectable DependencyObject IconSource ImageIconSource

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

範例

提示

如需詳細資訊、設計指引和程式碼範例，請參閱 Windows 應用程式的圖示。

開啟 WinUI 3 資源庫應用程式，並查看 IconElement 運作情形。

WinUI 3 資源庫應用程式包含大部分 WinUI 3 控制件、特性和功能的互動式範例。 從 Microsoft Store 取得應用程式，或在 GitHub 上取得原始程式碼。

下列範例顯示具有 ImageIconSource 的 AppBarButton 。 ImageSource 會指定包含在應用程式套件中的映像。

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

<AppBarButton >
    <AppBarButton.Icon>
        <IconSourceElement>
            <muxc:ImageIconSource ImageSource="ms-appx:///Assets/globe.png"/>
        </IconSourceElement>
    </AppBarButton.Icon>
</AppBarButton>

以下示範如何從位圖數據流載入 ImageIconSource。

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

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

備註

ImageIconSource 類似於 ImageIcon。 不過，因為它不是 FrameworkElement，所以可以共用。

建構函式

ImageIconSource()

初始化 ImageIconSource 類別的新執行個體。

屬性

Dispatcher	一律會在 Windows 應用程式 SDK 應用程式中傳null回。 請改用 DispatcherQueue 。 (繼承來源 DependencyObject)
DispatcherQueue	DispatcherQueue取得與這個 物件相關聯的 。 DispatcherQueue表示即使程式代碼是由非UI線程起始，也可以存取 DependencyObject UI線程上的設備。 (繼承來源 DependencyObject)
Foreground	取得或設定筆刷，繪製控件的前景色彩。 (繼承來源 IconSource)
ImageSource	取得或設定要作為圖示來源之圖像檔案的 URI。
ImageSourceProperty	識別 ImageSource 相依性屬性。

方法

ClearValue(DependencyProperty)	清除相依性屬性的本機值。 (繼承來源 DependencyObject)
CreateIconElement()	建立圖示 UI 元素。 (繼承來源 IconSource)
CreateIconElementCore()	建立圖示 UI 元素。 (繼承來源 IconSource)
GetAnimationBaseValue(DependencyProperty)	傳回為相依性屬性建立的任何基底值，如果動畫未使用中，則適用此屬性。 (繼承來源 DependencyObject)
GetIconElementPropertyCore(DependencyProperty)	將 IconSource 屬性對應至 IconElementProperties。 (繼承來源 IconSource)
GetValue(DependencyProperty)	從 DependencyObject 傳回相依性屬性的目前有效值。 (繼承來源 DependencyObject)
ReadLocalValue(DependencyProperty)	如果已設定本機值，則傳回相依性屬性的本機值。 (繼承來源 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	註冊通知函式，以接聽此 DependencyObject 實例上特定 DependencyProperty 的變更。 (繼承來源 DependencyObject)
SetValue(DependencyProperty, Object)	設定 DependencyObject 上相依性屬性的本機值。 (繼承來源 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消先前透過呼叫 RegisterPropertyChangedCallback 註冊的變更通知。 (繼承來源 DependencyObject)

另請參閱

• IconElement
• AppBarButton
• Image
• 適用於 UWP 應用程式的圖示