ThumbnailAttribute - класс

Статья
08/11/2011

Связывает значок с пользовательским элементом управления Windows Presentation Foundation (WPF) или Silverlight в панели элементов для Visual Studio или Expression Blend.

Иерархия наследования

System.Object
System.Attribute
Microsoft.Windows.Design.ThumbnailAttribute

Пространство имен: Microsoft.Windows.Design
Сборка: Microsoft.Windows.Design.Interaction (в Microsoft.Windows.Design.Interaction.dll)

Синтаксис

'Декларация
<AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple := True)> _
Public NotInheritable Class ThumbnailAttribute _
    Inherits Attribute

[AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple = true)]
public sealed class ThumbnailAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Class, AllowMultiple = true)]
public ref class ThumbnailAttribute sealed : public Attribute

[<Sealed>]
[<AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple = true)>]
type ThumbnailAttribute =  
    class
        inherit Attribute
    end

public final class ThumbnailAttribute extends Attribute

Тип ThumbnailAttribute предоставляет следующие члены.

Конструкторы

	Имя	Описание
	ThumbnailAttribute	Инициализирует новый экземпляр класса ThumbnailAttribute.

В начало страницы

Свойства

	Имя	Описание
	ResourceAssembly	Получает сборку, содержащую изображение значка.
	ResourceName	Получает имя изображения значка.
	TypeId	При реализации в производном классе возвращает уникальный идентификатор для этого Attribute. (Унаследовано от Attribute.)

В начало страницы

Методы

	Имя	Описание
	Equals	Инфраструктура. Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту. (Унаследовано от Attribute.)
	Finalize	Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как объект будет утилизирован в процессе сборки мусора. (Унаследовано от Object.)
	GetHashCode	Возвращает хеш-код данного экземпляра. (Унаследовано от Attribute.)
	GetType	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object.)
	IsDefaultAttribute	При переопределении в производном классе показывает, является ли значение данного экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute.)
	Match	При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту. (Унаследовано от Attribute.)
	MemberwiseClone	Создает неполную копию текущего объекта Object. (Унаследовано от Object.)
	ToString	Возвращение строки, представляющей текущий объект. (Унаследовано от Object.)

В начало страницы

Явные реализации интерфейса

	Имя	Описание
	_Attribute.GetIDsOfNames	Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации. (Унаследовано от Attribute.)
	_Attribute.GetTypeInfo	Возвращает сведения о типе объекта, которые могут использоваться для получения сведений о типе интерфейса. (Унаследовано от Attribute.)
	_Attribute.GetTypeInfoCount	Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1). (Унаследовано от Attribute.)
	_Attribute.Invoke	Предоставляет доступ к открытым свойствам и методам объекта. (Унаследовано от Attribute.)

В начало страницы

Заметки

Чтобы назначить значок панели элементов пользовательскому элементу управления WPF или Silverlight, следует использовать атрибут ThumbnailAttribute.

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

Создайте сборку метаданных времени разработки для пользовательского элемента управления. Дополнительные сведения см. в разделе Пошаговое руководство. Предоставление пользовательских метаданных времени разработки.
Добавьте изображение в той же иерархии папок, в которой находится тип, передаваемый в атрибут ThumbnailAttribute. Поддерживаются следующие расширения и типы файлов: BMP, GIF, JPG, JPEG и PNG.

В разных основных приложениях конструктора используются разные размеры изображения значка панели элементов. Можно задать разное изображение для сред. Конструктор WPF и Expression Blend, задав атрибут ThumbnailAttribute в сборках метаданных, зависящих от основного приложения (*.VisualStudio.Design.dll и *.Expression.Design.dll).

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

Примечание

Вложенные папки проекта влияют на пространство имен, в котором обнаруживаются внедренные ресурсы.
Реализуйте интерфейс IProvideAttributeTable, чтобы добавить ThumbnailAttribute в класс элемента управления. Одно и то же изображение можно повторно использовать в нескольких типах, применяя один и тот же атрибут ThumbnailAttribute для нескольких элементов управления.

Атрибут ThumbnailAttribute используется также для поиска значка по умолчанию для типов, добавленных в функцию "новый экземпляр" редактора коллекции или редактора субсвойств.

Потокобезопасность

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.