Значки панели инструментов в Visual Studio 2008

Статья
08/11/2011

В Visual Studio можно включать значки панели элементов в пользовательские элементы управления Windows Presentation Foundation (WPF). В этом разделе рассказывается, как именовать значки панели элементов и как включать их как внедренные ресурсы.

Примечание

Этот раздел сохранен для обратной совместимости с Visual Studio 2008.За сведениями по Visual Studio 2010 см. раздел Значки панели элементов.

Поддерживаемые типы файлов

В следующей таблице перечислены поддерживаемые типы файлов для значков панели элементов в Конструктор WPF для Visual Studio.

XAML
BMP
GIF
JPG
JPEG
PNG

Соглашение об именовании

Значок панели элементов связывается с пользовательским элементом управления в соответствии с соглашением об именовании. Конструктор WPF для Visual Studio проверяет внедренные ресурсы в сборке элемента управления на предмет надлежащего имени файла изображения.

В простейшем случае файл изображения значка панели элементов добавляется в проект элемента управления в качестве внедренного ресурса. Ему следует присвоить имя ControlName.Extension. сред. Конструктор WPF ищет ресурс с именем файла, соответствующим имени типа элемента управления. Дополнительные сведения см. в разделе Пошаговое руководство. Создание пользовательского значка панели элементов для элемента управления.

Примечание

Чтобы найти наилучший ресурс для значка панели элементов, сред. Конструктор WPF использует алгоритм сопоставления.Если файл ресурсов является недопустимым файлом XAML или недопустимым файлом изображения, используется следующее сопоставление, пока не будет обнаружен надлежащий файл. Изображения XAML не могут содержать ссылок на несистемные типы.

Полностью соответствующее имя

Соглашение об именовании значков панели элементов поддерживает полностью соответствующие имена ресурсов. Для полностью соответствующих имен в имя значка панели элементов включается пространство имен согласно следующему формату: Namespace.ControlName.Icon.Extension. Например, для элемента управления, называемого ProseControl и определяемого в пространстве имен Proseware.Core.Controls, полностью соответствующее имя значка панели элементов PNG будет Proseware.Core.Controls.ProseControl.Icon.png.

Для ресурсов Visual Studio автоматически преобразует папки в пространства имен. Поэтому в проекте можно создать структуру папок, совпадающую с пространством имен. Следует иметь в виду, что папки влияют на пространство имен, в котором обнаруживаются внедренные ресурсы. Если бы в предыдущем примере файл изображения находился во вложенной папке Icons, сред. Конструктор WPF искал бы значок панели элементов с именем Proseware.Core.Controls.Icons.ProseControl.Icon.png.

Если изображение не обнаруживается в том же пространстве имен, что и элемент управления, сред. Конструктор WPF ищет неточное соответствие.

Неточно соответствующее имя

Если сред. Конструктор WPF не находит полностью соответствующего ресурса, он ищет неточные соответствия во внедренных ресурсах сборки. В предыдущем примере сред. Конструктор WPF сначала ищет файл, имеющий полностью соответствующее имя Proseware.Core.Controls.ProseControl.Icon.Extension. Если этот поиск завершается неуспешно, сред. Конструктор WPF игнорирует пространство имен и ищет имя только на основе имени типа. В данном примере сред. Конструктор WPF ищет любые файлы в ресурсах с именем ProseControl.Icon.Extension. Если этот поиск завершается неуспешно, сред. Конструктор WPF начинает поиск из пространства имен по умолчанию. В данном примере сред. Конструктор WPF ищет файлы с именем Proseware.ProseControl.Icon.Extension.

Несколько размеров изображения

Имя файла изображения значка панели элементов может содержать необязательное поле "Icon". Эта подстрока позволяет задать несколько размеров изображения значка.

Для элемента управления ProseControl в предыдущем примере сред. Конструктор WPF находит в ресурсах следующие изображения и выбирает для размера наилучшее соответствие.

Proseware.Core.Controls.ProseControl.Icon.Large.png
Proseware.Core.Controls.ProseControl.Icon.Medium.png
Proseware.Core.Controls.ProseControl.Icon.ReallyLarge.png

Можно также опустить точку после "Icon", чтобы задать следующие имена файлов.

Proseware.Core.Controls.ProseControl.IconLarge.png
Proseware.Core.Controls.ProseControl.IconMedium.png
Proseware.Core.Controls.ProseControl.IconReallyLarge.png

сред. Конструктор WPF выбирает значок панели элементов согласно следующим правилам.

XAML векторного изображения.
Точное соответствие по размеру в обоих измерениях.
Ближайшее соответствие на основе размера и пропорций.

Рекомендуемый размер изображения для форматов файлов на основе растрового изображения — 64 x 64 точки.

сред. Конструктор WPF и Expression Blend используют для значка панели элементов разные размеры изображения. Expression Blend использует размер 24x24 в качестве размера большого значка и размер 12x12 в качестве размера мелкого значка. сред. Конструктор WPF использует только размер 16x16.

Если для основного приложения требуется размер 64x64 точки, и файл Proseware.Core.Controls.ProseControl.Icon.Large.png является наилучшим соответствием по размеру и пропорциям, используется этот файл. Проверяются все изображения в сборке. Если имеются два изображения с одинаковыми размером и пропорциями, решение о том, какое изображение использовать, принимается основным приложением.