Значки панели элементов
В пользовательские элементы управления WPF и Silverlight в Visual Studio и Expression Blend можно включать значки панели элементов. В этом разделе рассказывается, как именовать значки панели элементов и как включать их как внедренные ресурсы.
Поддерживаемые типы файлов
В следующем списке перечислены поддерживаемые типы файлов для значков панели элементов в Конструктор WPF для Visual Studio.
BMP
GIF
JPG
JPEG
PNG
Примечание
Expression Blend поддерживает только файлы png.
Соглашение об именовании
Значок панели элементов связывается с пользовательским элементом управления в соответствии с соглашением об именовании. Средства разработки проверяют внедренные ресурсы в сборке элемента управления на предмет надлежащего имени файла изображения.
В простейшем случае файл изображения значка панели элементов добавляется в проект элемента управления в качестве внедренного ресурса. Назовите его ИмяЭлементаУправления.Расширение и в окне "Свойства" задайте его Действие при построении равным Внедренный ресурс. сред. Конструктор WPF ищет ресурс с именем файла, соответствующим имени типа элемента управления. Дополнительные сведения см. в разделе Пошаговое руководство. Создание пользовательского значка панели элементов для элемента управления.
Примечание
Для обратной совместимости Visual Studio 2010 поддерживает соглашение об именовании, использовавшееся Visual Studio 2008.Дополнительные сведения см. в разделе Значки панели инструментов в Visual Studio 2008.
Visual Studio 2010 поддерживает следующее соглашение об именовании значков панели элементов. Подстроки в квадратных скобках ([]) являются необязательными.
[ЛюбаяСтрока]ПространствоИмен.ИмяЭлементаУправления[.Продукт][.ЛюбаяСтрока].Расширение
В поиске значков панели элементов конструктор сопоставляет подстроки ПространствоИмен, ИмяЭлементаУправления и Продукт. Если ПространствоИмен и ИмяЭлементаУправления не соответствуют элементу управления, значок не отображается на панели элементов.
Подстрока Продукт может использоваться конструктором для исключения значков для других продуктов. Например, Visual Studio предпочитает значки, у которых подстрокой Продукт является "VisualStudio".
В следующем списке приведены примеры соглашений об именовании значков панели элементов, которые можно использовать для значков Visual Studio и Expression Blend.
ПространствоИмен.ИмяЭлементаУправления.VisualStudio.Расширение
ПространствоИмен.ИмяЭлементаУправления.VisualStudio.ЛюбаяСтрока.Расширение
ПространствоИмен.ИмяЭлементаУправления.Expression.png
ПространствоИмен.ИмяЭлементаУправления.Expression.ЛюбаяСтрока.png
Если не найдено ни одного значка, подходящего под указанные выше имена, ищутся следующие имена.
ПространствоИмен.ИмяЭлементаУправления.Расширение
ПространствоИмен.ИмяЭлементаУправления.ЛюбаяСтрока.Расширение
В следующем списке приведены примеры имен значков панели элементов для элемента управления с именем TailspinToysControl в пространстве имен TailspinToysControlLibrary. Дополнительные необязательные сведения о формате изображения добавляются, но не используются конструкторами.
TailspinToysControlLibrary.TailspinToysControl.VisualStudio.24bit.48x48.bmp
TailspinToysControlLibrary.TailspinToysControl.Expression.4bit.16x16.png
После того как конструктор находит значки панели элементов, значок, ближе всего подходящий по размеру, загружается для отображения. В следующем списке показан порядок применения критериев соответствия.
Значки, в имени которых указан конструктор, имеют приоритет перед теми, в которых он не указан. Например, сред. Конструктор WPF предпочитает значки, имеющие в имени "VisualStudio", а не "Expression".
Выбираются значки, наиболее близкие к размеру визуализации. Панель элементов Visual Studio загружает значок, наиболее близкий к 16x16 пикселей, и затем отображает этот значок на 24-разрядную глубину цвета.
Выбирается значок, найденный первым.
Переопределение используемых по умолчанию значков панели элементов
Инфраструктура расширяемости сред. Конструктор WPF может использоваться для переопределения значков панели элементов, внедренных в сборку элемента управления времени разработки. Дополнительные сведения см. в разделе Пошаговое руководство. Предоставление метаданных для значков панели инструментов.
См. также
Основные понятия
Значки панели инструментов в Visual Studio 2008
Другие ресурсы
Пошаговое руководство. Предоставление метаданных для значков панели инструментов