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> свойства в файле сборки проекта приложения. Этот значок используется в качестве значка рабочего стола для сборки.

  Note

  При отладке в Visual Studio значок может не отображаться из-за процесса размещения. Если запустить исполняемый файл, появится значок.

• Один значок в окне, заданном параметром Icon. Для каждого окна этот значок используется в строке заголовка, кнопке панели задач и в записи списка выбора приложений ALT-TAB.

Окно WPF всегда отображает значок. Если он не указан параметром Icon, WPF выбирает значок для отображения в соответствии со следующими правилами:

1. При указании используйте значок сборки.
2. Если значок сборки не указан, используйте значок Microsoft Windows по умолчанию.

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

Один значок можно использовать различными способами в Windows, включая отображаемый в заголовке окна, панель задач для окна, список выбора ALT+TAB-файла. Каждый из них показывает значок с использованием другого размера; Значок пикселя 16x16 отображается в заголовке окна и на панели задач, а значок пикселя 32x32 отображается в списке выбора ФАЙЛА ALT+TAB. Некоторые приложения, такие как Microsoft Windows Explorer, предоставляют меню "Вид ", которое позволяет выбрать размер значка, который вы хотите просмотреть.

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

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

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

Note

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

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

Поле идентификатора	IconProperty
Свойства метаданных, равные свойству true	Нет