ImageIcon 類別

  • 參考

定義

命名空間:
Microsoft.UI.Xaml.Controls
編輯

表示使用 影像 做為其內容的圖示。

本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

/// [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
繼承
IconElement
ImageIcon
屬性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

範例

提示

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

WinUI 3 資源庫和WinUI 2 資源庫應用程式包含大部分 WinUI 3 和 WinUI 2 控制項、特性和功能的互動式範例。

如果已安裝，請按一下下列連結加以開啟： WinUI 3 資源庫 或 WinUI 2 資源庫。

如果未安裝，您可以從 Microsoft Store 下載 WinUI 3 資源庫 和 WinUI 2 資源庫 。

您也可以從 GitHub 取得的原始程式碼 (使用 WinUI 3 的主要 分支和 WinUI 2) 的 winui2 分支。

下列範例顯示具有 的 ImageIconAppBarButton。 來源 會指定包含在應用程式套件中的影像。

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

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

以下示範如何從點陣圖資料流程載入 ImageIcon 。

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

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

備註

支援的映射類型是.bmp、.gif、.jpg、.png、.wdp 和 .tiff。

影像在透明背景上應該為實心。

只會使用多框架影像的第一個畫面。 若要使用動畫圖標，請參閱 AnimatedIcon。

由於支援的檔案類型， ImageIcon 會忽略 Foreground 屬性，因此您無法像在其他 IconSource 衍生控制項上一樣變更前景色彩。

ImageIcon 通常會與 AppBarButton搭配使用，但可在任何 IconElement 位置使用。

建構函式

ImageIcon()

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

本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

屬性

Source

取得或設定要作為圖示之影像檔案的 URI。

本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
SourceProperty

識別 Source 相依性屬性。

本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

適用於

另請參閱