CategoryAttribute CategoryAttribute CategoryAttribute CategoryAttribute Class

정의

항목별 모드로 설정된 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
상속
CategoryAttributeCategoryAttributeCategoryAttributeCategoryAttribute
특성

예제

다음 예제에서는 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. 코드에 인덱스는 다음으로 PropertyDescriptorCollection 가져오려고 MyImage합니다.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.

예제는 다음 범주를 검색 하 여 인쇄 CategoryAttribute 에서 AttributeCollection, 콘솔 화면에 작성 합니다.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)

설명

A CategoryAttribute 연결된 속성 또는 이벤트와 연결 하려면 범주를 나타내는 속성이 나 이벤트를 나열 하는 경우는 PropertyGrid 컨트롤을 설정할 Categorized 모드입니다.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() CategoryAttribute() CategoryAttribute()

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

CategoryAttribute(String) CategoryAttribute(String) CategoryAttribute(String) CategoryAttribute(String)

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

속성

Action Action Action Action

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

Appearance Appearance Appearance Appearance

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

Asynchronous Asynchronous Asynchronous Asynchronous

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

Behavior Behavior Behavior Behavior

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

Category Category Category Category

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

Data Data Data Data

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

Default Default Default Default

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

Design Design Design Design

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

DragDrop DragDrop DragDrop DragDrop

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

Focus Focus Focus Focus

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

Format Format Format Format

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

Key Key Key Key

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

Layout Layout Layout Layout

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

Mouse Mouse Mouse Mouse

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

TypeId TypeId TypeId TypeId

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

(Inherited from Attribute)
WindowStyle WindowStyle WindowStyle WindowStyle

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

메서드

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

해당 특성의 해시 코드를 반환합니다.Returns the hash code for this attribute.

GetLocalizedString(String) GetLocalizedString(String) GetLocalizedString(String) GetLocalizedString(String)

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

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

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

Match(Object) Match(Object) Match(Object) Match(Object)

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

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)

명시적 인터페이스 구현

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

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

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

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

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

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

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

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

(Inherited from Attribute)

적용 대상

추가 정보