CategoryAttribute Класс

Определение

Задает имя категории, в которой при отображении в элементе управления PropertyGrid для группировки свойств или событий установлен режим "По категориям".

public ref class CategoryAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.All)]
public class CategoryAttribute : Attribute
public class CategoryAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.All)>]
type CategoryAttribute = class
    inherit Attribute
type CategoryAttribute = class
    inherit Attribute
Public Class CategoryAttribute
Inherits Attribute
Наследование
CategoryAttribute
Атрибуты

Примеры

В следующем примере создается MyImage свойство. Свойство имеет два атрибута: a DescriptionAttribute и a CategoryAttribute.

   [Description("The image associated with the control"),Category("Appearance")]
   System::Drawing::Image^ get()
   {
      // Insert code here.
      return m_Image1;
   }

   void set( System::Drawing::Image^ )
   {
      // Insert code here.
   }
}
[Description("The image associated with the control"),Category("Appearance")] 
 public Image MyImage {
    get {
       // Insert code here.
       return image1;
    }
    set {
       // Insert code here.
    }
 }
<Description("The image associated with the control"), _
    Category("Appearance")> _
Public Property MyImage() As Image
    
    Get
        ' Insert code here.
        Return image1
    End Get
    Set
        ' Insert code here.
    End Set 
End Property

В следующем примере возвращается категория для MyImage. Во-первых, код получает PropertyDescriptorCollection все свойства объекта. Затем индексирует код в получаемом объекте PropertyDescriptorCollection MyImage. Затем он возвращает атрибуты для этого свойства и сохраняет их в переменной attributes.

Затем этот пример выводит категорию, извлекая CategoryAttribute ее из AttributeCollectionконсоли и записывая ее на экран консоли.

// Gets the attributes for the property.
AttributeCollection^ attributes = TypeDescriptor::GetProperties( this )[ "MyImage" ]->Attributes;

// Prints the description by retrieving the CategoryAttribute.
// from the AttributeCollection.
CategoryAttribute^ myAttribute = static_cast<CategoryAttribute^>(attributes[ CategoryAttribute::typeid ]);
Console::WriteLine( myAttribute->Category );
// Gets the attributes for the property.
 AttributeCollection attributes = 
    TypeDescriptor.GetProperties(this)["MyImage"].Attributes;
 
 // Prints the description by retrieving the CategoryAttribute.
 // from the AttributeCollection.
 CategoryAttribute myAttribute = 
    (CategoryAttribute)attributes[typeof(CategoryAttribute)];
 Console.WriteLine(myAttribute.Category);
' Gets the attributes for the property.
Dim attributes As AttributeCollection = _
    TypeDescriptor.GetProperties(Me)("MyImage").Attributes

' Prints the description by retrieving the CategoryAttribute. 
' from the AttributeCollection.
Dim myAttribute As CategoryAttribute = _
    CType(attributes(GetType(CategoryAttribute)), CategoryAttribute)
    Console.WriteLine(myAttribute.Category)

Комментарии

Указывает CategoryAttribute категорию, с которой необходимо связать связанное свойство или событие при перечислении свойств или событий в наборе PropertyGrid Categorized элементов управления в режиме. Если объект CategoryAttribute не применен к свойству или событию, PropertyGrid он связывается с категорией Misc . Для любого имени можно создать новую категорию, указав имя категории в конструкторе.CategoryAttribute

Свойство Category указывает имя категории, которую представляет атрибут. Свойство Category также обеспечивает прозрачную локализацию имен категорий.

Примечания для тех, кто наследует этот метод

Если вы используете имена категорий, отличные от предопределенных, и вы хотите локализовать имена категорий, необходимо переопределить GetLocalizedString(String) метод.

Класс CategoryAttribute определяет следующие распространенные категории:

Категория Описание
Action Свойства, связанные с доступными действиями.
Appearance Свойства, связанные с способом отображения сущности.
Behavior Свойства, связанные с тем, как действует сущность.
Data Свойства, связанные с управлением данными и источником данных.
Default Свойства, сгруппированные в категорию по умолчанию.
Design Свойства, доступные только во время разработки.
DragDrop Свойства, связанные с операциями перетаскивания.
Focus Свойства, связанные с фокусом.
Format Свойства, связанные с форматированием.
Key Свойства, связанные с клавиатурой.
Layout Свойства, связанные с макетом.
Mouse Свойства, связанные с мышью.
WindowStyle Свойства, связанные со стилем окна форм верхнего уровня.

Дополнительные сведения см. в разделе Атрибуты.

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

CategoryAttribute()

Инициализирует новый экземпляр класса CategoryAttribute с использованием имени категории "По умолчанию".

CategoryAttribute(String)

Выполняет инициализацию нового экземпляра класса CategoryAttribute, используя заданное имя категории.

Свойства

Action

Возвращает атрибут CategoryAttribute, представляющий категорию "Действие".

Appearance

Возвращает атрибут CategoryAttribute, представляющий категорию "Внешний вид".

Asynchronous

Возвращает атрибут CategoryAttribute, представляющий категорию "Асинхронная".

Behavior

Возвращает атрибут CategoryAttribute, представляющий категорию "Поведение".

Category

Возвращает имя категории для свойства или события, к которым применяется этот атрибут.

Data

Возвращает атрибут CategoryAttribute, представляющий категорию "Данные".

Default

Возвращает атрибут CategoryAttribute, представляющий категорию "По умолчанию".

Design

Возвращает атрибут CategoryAttribute, представляющий категорию "Конструктор".

DragDrop

Возвращает атрибут CategoryAttribute, представляющий категорию "Перетаскивание".

Focus

Получает атрибут CategoryAttribute, представляющий категорию "Фокус".

Format

Возвращает атрибут CategoryAttribute, представляющий категорию "Формат".

Key

Получает атрибут CategoryAttribute, представляющий категорию "Клавиша".

Layout

Возвращает атрибут CategoryAttribute, представляющий категорию "Структура".

Mouse

Возвращает атрибут CategoryAttribute, представляющий категорию "Мышь".

TypeId

В случае реализации в производном классе возвращает уникальный идентификатор для этого атрибута Attribute.

(Унаследовано от Attribute)
WindowStyle

Возвращает атрибут CategoryAttribute, представляющий категорию "Стиль окна".

Методы

Equals(Object)

Возвращает значение, показывающее, равно ли значение данного объекта текущему атрибуту CategoryAttribute.

GetHashCode()

Возвращает хэш-код для данного атрибута.

GetLocalizedString(String)

Выполняет поиск локализованной версии имени заданной категории.

GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
IsDefaultAttribute()

Определяет, является ли этот атрибут используемым по умолчанию.

IsDefaultAttribute()

При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса.

(Унаследовано от Attribute)
Match(Object)

При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту.

(Унаследовано от Attribute)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

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

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.

(Унаследовано от Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Возвращает сведения о типе объекта, которые можно использовать для получения сведений о типе интерфейса.

(Унаследовано от Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1).

(Унаследовано от Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Предоставляет доступ к открытым свойствам и методам объекта.

(Унаследовано от Attribute)

Применяется к

См. также раздел