ThumbnailAttribute - класс

Статья
11/05/2008

Обновлен: Июль 2008

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

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

Синтаксис

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

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

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

public final class ThumbnailAttribute extends 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.

В окне свойств задайте для связанного с изображением свойства "Действие при построении" значение Внедренный ресурс.

Примечание.
Вложенные папки проекта влияют на пространство имен, в котором обнаруживаются внедренные ресурсы.

Для добавления атрибута ThumbnailAttribute в класс элемента управления используйте хранилище метаданных. Одно и то же изображение можно повторно использовать в нескольких типах, применяя один и тот же атрибут ThumbnailAttribute для нескольких элементов управления.

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

Примеры

В следующем примере кода показано, как добавить атрибут ThumbnailAttribute в пользовательский элемент управления Silverlight, используя хранилище MetadataStore.

public class Metadata : IRegisterMetadata
{
    public void Register()
    {
        AttributeTableBuilder builder = new AttributeTableBuilder();
        builder.AddCustomAttributes(typeof(Proseware.Core.Controls.ProseControl), 
        new ThumbnailAttribute(typeof(Metadata), "SLControlLibrary.Design. logo.gif"));
        MetadataStore.AddAttributeTable(builder.CreateTable());
    }
}

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

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

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

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

См. также

Ссылки

ThumbnailAttribute - члены

Microsoft.Windows.Design - пространство имен

ToolboxBrowsableAttribute

Журнал изменений

Дата	Изменения	Причина
Июль 2008	Добавлен раздел для нового класса.	Изменение функции SP1.

Поделиться через