Window.Icon 属性

定义

命名空间:

System.Windows

程序集:

PresentationFramework.dll

获取或设置窗口的图标。

public:
 property System::Windows::Media::ImageSource ^ Icon { System::Windows::Media::ImageSource ^ get(); void set(System::Windows::Media::ImageSource ^ value); };

public System.Windows.Media.ImageSource Icon { get; [System.Security.SecurityCritical] set; }

public System.Windows.Media.ImageSource Icon { get; set; }

[<set: System.Security.SecurityCritical>]
member this.Icon : System.Windows.Media.ImageSource with get, set

member this.Icon : System.Windows.Media.ImageSource with get, set

Public Property Icon As ImageSource

属性值

ImageSource

一个表示图标的 ImageSource 对象。

属性

SecurityCriticalAttribute

示例

以下示例演示如何设置窗口图标。

<Window
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="SDKSample.MainWindow"
    Icon="WPFIcon1.ico">
</Window>

// Set an icon using code
Uri iconUri = new Uri("pack://application:,,,/WPFIcon2.ico", UriKind.RelativeOrAbsolute);
this.Icon = BitmapFrame.Create(iconUri);

' Set an icon using code
Dim iconUri As New Uri("pack://application:,,,/WPFIcon2.ico", UriKind.RelativeOrAbsolute)
Me.Icon = BitmapFrame.Create(iconUri)

注解

Windows Presentation Foundation (WPF) 独立应用程序有两种类型的图标：

• 一个程序集图标，该图标是使用 <ApplicationIcon> 应用程序项目生成文件中的属性指定的。 此图标用作程序集的桌面图标。

  备注

  在Visual Studio中进行调试时，由于托管过程，你的图标可能不会显示。 如果运行可执行文件，将显示该图标。 有关详细信息，请参阅托管进程 (vshost.exe)。

• 每个窗口通过设置 Icon指定的一个图标。 对于每个窗口，此图标用于标题栏、任务栏按钮以及 ALT-TAB 应用程序选择列表项。

WPF 窗口始终显示图标。 如果未通过设置 Icon提供一个图标，WPF 会根据以下规则选择要显示的图标：

1. 使用程序集图标（如果指定）。

2. 如果未指定程序集图标，请使用默认的 Microsoft Windows 图标。

如果使用 Icon 指定自定义窗口图标，可以通过设置 Icon 还原 null默认应用程序图标。

单个图标可用于Windows的各种方式，包括显示在窗口的标题栏中、窗口的任务栏、ALT+TAB 文件选择列表。 每个图标都显示使用不同的大小;16x16 像素图标显示在窗口和任务栏中的标题栏中，而 32x32 像素图标将显示在 Alt+TAB 文件选择列表中。 某些应用程序（如 Microsoft Windows Explorer）提供了一个 “视图”菜单，用于选择要查看的图标的大小。

为了适应各种显示大小，图标文件由一个或多个实际图标组成，其中每个图标表示面向特定大小和颜色深度的图标版本。 例如，一个图标可能只有一个 16x16 像素图标，其中 16 种颜色，另一个图标可能包含 16x16 像素和 32x32 像素图标，其中 16 种颜色和 256 种颜色。

如果图标文件中存在所有可能大小和颜色深度的图标， Window 将使用相应的图标。 如果图标文件仅包含所有可能图标的子集， Window 则按照减小大小和颜色深度的顺序使用下一个最合适的图标。

结果是，图标将始终由 Window使用，尽管使用的图标可能不面向所需的大小和颜色深度。 例如，具有 16 种颜色的 16x16 像素图标可用于显示为具有 256 种颜色的 32x32 像素图标。 这可能会导致不良的视觉效果，如 pixilation，但可以通过为所有目标大小和颜色深度创建图标来避免。

备注

在浏览器中托管窗口时，无法设置或获取此属性。

依赖项属性信息

标识符字段	IconProperty
元数据属性设置为 true	无