通过

ImageIcon 类

  • 参考

定义

命名空间:
Microsoft.UI.Xaml.Controls
编辑

表示使用 图像 作为其内容的图标。

本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) 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 使用 main 分支，对 WinUI 2 使用 winui2 分支）。

以下示例演示具有 ImageIcon的 AppBarButton。 Source 指定应用包中包含的图像。

<!--
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 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。

属性

Source

获取或设置要用作图标的图像文件的 URI。

本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
SourceProperty

标识 Source 依赖项属性。

本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。

适用于

另请参阅