CategoryAttribute 클래스

정의

항목별 모드로 설정된 PropertyGrid 컨트롤에 표시될 때 속성이나 이벤트를 그룹화할 범주 이름을 지정합니다.Specifies the name of the category in which to group the property or event when displayed in a PropertyGrid control set to Categorized mode.

public ref class CategoryAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.All)]
public class CategoryAttribute : Attribute
type CategoryAttribute = class
    inherit Attribute
Public Class CategoryAttribute
Inherits Attribute
상속
CategoryAttribute
특성

예제

다음 예에서는 MyImage 속성을 만듭니다.The following example creates the MyImage property. 속성에는 두 가지 특성인 DescriptionAttributeCategoryAttribute있습니다.The property has two attributes: a DescriptionAttribute and 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의 범주를 가져옵니다.The next example gets the category for MyImage. 첫째, 코드는 개체에 대 한 모든 속성이 포함 된 PropertyDescriptorCollection를 가져옵니다.First, the code gets a PropertyDescriptorCollection with all the properties for the object. 그런 다음 MyImage를 얻기 위해 PropertyDescriptorCollection로 인덱싱합니다.Next, the code indexes into the PropertyDescriptorCollection to get MyImage. 그런 다음이 속성의 특성을 반환 하 고 attributes변수에 저장 합니다.Then it returns the attributes for this property and saves them in the variable attributes.

그런 다음 AttributeCollection에서 CategoryAttribute을 검색 하 고 콘솔 화면에 기록 하 여 범주를 인쇄 합니다.The example then prints the category by retrieving CategoryAttribute from the AttributeCollection, and writing it to the console screen.

// 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)

설명

PropertyGrid 컨트롤의 속성 또는 이벤트를 Categorized 모드로 설정할 때 연결 된 속성이 나 이벤트를 연결할 범주를 나타내는 CategoryAttribute입니다.A CategoryAttribute indicates the category to associate the associated property or event with, when listing properties or events in a PropertyGrid control set to Categorized mode. 속성이 나 이벤트에 CategoryAttribute 적용 되지 않은 경우 PropertyGrid는이를 기타 범주와 연결 합니다.If a CategoryAttribute has not been applied to a property or event, the PropertyGrid associates it with the Misc category. CategoryAttribute생성자에서 범주의 이름을 지정 하 여 모든 이름에 대해 새 범주를 만들 수 있습니다.A new category can be created for any name by specifying the name of the category in the constructor for the CategoryAttribute.

Category 속성은 특성이 나타내는 범주의 이름을 나타냅니다.The Category property indicates the name of the category that the attribute represents. 또한 Category 속성은 범주 이름에 대 한 투명 한 지역화를 제공 합니다.The Category property also provides transparent localization of category names.

상속자 참고

미리 정의 된 이름 이외의 범주 이름을 사용 하는 경우 범주 이름을 지역화 하려면 GetLocalizedString(String) 메서드를 재정의 해야 합니다.If you use category names other than the predefined names, and you want to localize your category names, you must override the GetLocalizedString(String) method.

CategoryAttribute 클래스는 다음과 같은 일반 범주를 정의 합니다.The CategoryAttribute class defines the following common categories:

범주Category 설명Description
Action 사용 가능한 작업 관련 속성입니다.Properties related to available actions.
Appearance 엔터티 모양을 관련 속성입니다.Properties related to how an entity appears.
Behavior 엔터티 작업 방식 관련 속성입니다.Properties related to how an entity acts.
Data 데이터 및 데이터 원본 관리와 관련 된 속성입니다.Properties related to data and data source management.
Default 기본 범주에 그룹화 되는 속성입니다.Properties that are grouped in a default category.
Design 디자인 타임에만 사용할 수 있는 속성입니다.Properties that are available only at design time.
DragDrop 끌어서 놓기 작업과 관련 된 속성입니다.Properties related to drag-and-drop operations.
Focus 포커스 관련 속성입니다.Properties related to focus.
Format 서식 지정 관련 속성입니다.Properties related to formatting.
Key 키보드 관련 속성입니다.Properties related to the keyboard.
Layout 레이아웃 관련 속성입니다.Properties related to layout.
Mouse 마우스 관련 속성입니다.Properties related to the mouse.
WindowStyle 최상위 폼의 창 스타일 관련 속성입니다.Properties related to the window style of top-level forms.

자세한 내용은 특성을 참조하세요.For more information, see Attributes.

생성자

CategoryAttribute()

범주 이름 기본을 사용하여 CategoryAttribute 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the CategoryAttribute class using the category name Default.

CategoryAttribute(String)

지정된 범주 이름을 사용하여 CategoryAttribute 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the CategoryAttribute class using the specified category name.

속성

Action

작업 범주를 나타내는 CategoryAttribute를 가져옵니다.Gets a CategoryAttribute representing the Action category.

Appearance

모양 범주를 나타내는 CategoryAttribute를 가져옵니다.Gets a CategoryAttribute representing the Appearance category.

Asynchronous

비동기 범주를 나타내는 CategoryAttribute를 가져옵니다.Gets a CategoryAttribute representing the Asynchronous category.

Behavior

동작 범주를 나타내는 CategoryAttribute를 가져옵니다.Gets a CategoryAttribute representing the Behavior category.

Category

속성 또는이 특성이 적용 되는 이벤트에 대 한 범주의 이름을 가져옵니다.Gets the name of the category for the property or event that this attribute is applied to.

Data

데이터 범주를 나타내는 CategoryAttribute를 가져옵니다.Gets a CategoryAttribute representing the Data category.

Default

기본 범주를 나타내는 CategoryAttribute를 가져옵니다.Gets a CategoryAttribute representing the Default category.

Design

디자인 범주를 나타내는 CategoryAttribute를 가져옵니다.Gets a CategoryAttribute representing the Design category.

DragDrop

끌어서 놓기 범주를 나타내는 CategoryAttribute를 가져옵니다.Gets a CategoryAttribute representing the DragDrop category.

Focus

포커스 범주를 나타내는 CategoryAttribute를 가져옵니다.Gets a CategoryAttribute representing the Focus category.

Format

형식 범주를 나타내는 CategoryAttribute를 가져옵니다.Gets a CategoryAttribute representing the Format category.

Key

키 범주를 나타내는 CategoryAttribute를 가져옵니다.Gets a CategoryAttribute representing the Key category.

Layout

레이아웃 범주를 나타내는 CategoryAttribute를 가져옵니다.Gets a CategoryAttribute representing the Layout category.

Mouse

마우스 범주를 나타내는 CategoryAttribute를 가져옵니다.Gets a CategoryAttribute representing the Mouse category.

TypeId

파생 클래스에서 구현될 때 이 Attribute의 고유 식별자를 가져옵니다.When implemented in a derived class, gets a unique identifier for this Attribute.

(다음에서 상속됨 Attribute)
WindowStyle

창 스타일 범주를 나타내는 CategoryAttribute를 가져옵니다.Gets a CategoryAttribute representing the WindowStyle category.

메서드

Equals(Object)

주어진 개체의 값이 현재 CategoryAttribute와 같은지 여부를 반환합니다.Returns whether the value of the given object is equal to the current CategoryAttribute.

GetHashCode()

이 특성에 대 한 해시 코드를 반환합니다.Returns the hash code for this attribute.

GetLocalizedString(String)

지정 된 범주의 지역화 이름을 찾습니다.Looks up the localized name of the specified category.

GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
IsDefaultAttribute()

이 특성이 기본값인지 여부를 확인합니다.Determines if this attribute is the default.

Match(Object)

파생된 클래스에서 재정의할 경우,이 인스턴스가 지정된 된 개체와 같은지 여부를 나타내는 값을 반환 합니다.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(다음에서 상속됨 Attribute)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
ToString()

현재 개체를 나타내는 string을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)

명시적 인터페이스 구현

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

이름 집합을 해당하는 디스패치 식별자 집합에 매핑합니다.Maps a set of names to a corresponding set of dispatch identifiers.

(다음에서 상속됨 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

인터페이스의 형식 정보를 가져오는 데 사용할 수 있는 개체의 형식 정보를 검색합니다.Retrieves the type information for an object, which can be used to get the type information for an interface.

(다음에서 상속됨 Attribute)
_Attribute.GetTypeInfoCount(UInt32)

개체에서 제공하는 형식 정보 인터페이스의 수를 검색합니다(0 또는 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(다음에서 상속됨 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

개체에서 노출하는 메서드와 속성에 대한 액세스를 제공합니다.Provides access to properties and methods exposed by an object.

(다음에서 상속됨 Attribute)

적용 대상

추가 정보