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; set; }

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

Public Property Icon As ImageSource

Значение свойства

ImageSource

Объект ImageSource, представляющий значок.

Примеры

В следующем примере показано, как задать значок окна.

<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. Если значок сборки не указан, используйте значение по умолчанию Майкрософт значок Windows.

Если вы используете Icon для указания пользовательского значка окна, можно восстановить значок приложения по умолчанию, задав значение Iconnull.

Один значок можно использовать различными способами в Windows, включая отображения в заголовке окна, панели задач для окна, списке выбора файлов ALT+TAB. Каждый из них показывает значок с использованием разного размера; Значок 16x16 пикселей отображается в строке заголовка окна и на панели задач, а значок 32x32 пикселя — в списке выбора файлов ALT+TAB. Некоторые приложения, такие как Майкрософт проводнике Windows, предоставляют меню Вид, позволяющее выбрать размер значка, который вы хотите просмотреть.

Для отображения различных размеров файл значков состоит из одного или нескольких фактических значков, каждый из которых представляет версию значка, предназначенную для определенного размера и глубины цвета. Например, один значок может иметь только один значок 16x16 пикселей с 16 цветами, а другой может содержать значки 16x16 пикселей и 32 x 32 пикселя с 16 цветами и 256 цветами.

Если в файле значков существуют значки всех возможных размеров и глубины цвета, Window будет использоваться соответствующий значок. Если файл значков содержит только подмножество всех возможных значков, Window использует следующий наиболее подходящий значок в порядке уменьшения размеров и глубины цвета.

В результате значок всегда будет использоваться Window, хотя используемый значок может не указывать на требуемый размер и глубину цвета. Например, значок 16x16 пикселей с 16 цветами можно использовать для отображения в качестве значка 32x32 пикселей с 256 цветами. Это может привести к нежелательным визуальным эффектам, таким как пиксиляция, но его можно избежать, создав значки для всех целевых размеров и глубины цвета.

Примечание

Это свойство невозможно задать или получить, если окно размещено в браузере.

Сведения о свойстве зависимостей

Поле идентификатора	IconProperty
Для свойств метаданных задано значение true	Нет