DesignerCategoryAttribute DesignerCategoryAttribute DesignerCategoryAttribute DesignerCategoryAttribute Class

정의

클래스의 디자이너가 특정 범주에 속하도록 지정합니다.Specifies that the designer for a class belongs to a certain category.

public ref class DesignerCategoryAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=true)]
public sealed class DesignerCategoryAttribute : Attribute
type DesignerCategoryAttribute = class
    inherit Attribute
Public NotInheritable Class DesignerCategoryAttribute
Inherits Attribute
상속
DesignerCategoryAttributeDesignerCategoryAttributeDesignerCategoryAttributeDesignerCategoryAttribute
특성

예제

다음 예제에서는 라는 클래스를 만듭니다 MyForm합니다.The following example creates a class called MyForm. MyForm 두 개의 특성이 DesignerAttribute 사용 하 여이 클래스를 지정 하는 DocumentDesigner, 및 DesignerCategoryAttribute 지정 하는 Form 범주.MyForm has two attributes, a DesignerAttribute that specifies this class uses the DocumentDesigner, and a DesignerCategoryAttribute that specifies the Form category.

[Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design",
IRootDesigner::typeid),
DesignerCategory("Form")]
ref class MyForm: public ContainerControl{
   // Insert code here.
};
[Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design", 
    typeof(IRootDesigner)),
    DesignerCategory("Form")]
    
 public class MyForm : ContainerControl {
    // Insert code here.
 }
<Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design", _
    GetType(IRootDesigner)), DesignerCategory("Form")> _
Public Class MyForm
    
    Inherits ContainerControl
    ' Insert code here.
End Class 'MyForm

다음 예제에서는의 인스턴스를 만들고 MyForm합니다.The next example creates an instance of MyForm. 그런 다음 추출 된 클래스에 대해 특성을 가져오고는 DesignerCategoryAttribute, 디자이너의 이름을 출력 합니다.Then it gets the attributes for the class, extracts the DesignerCategoryAttribute, and prints the name of the designer.

int main()
{
   // Creates a new form.
   MyForm^ myNewForm = gcnew MyForm;

   // Gets the attributes for the collection.
   AttributeCollection^ attributes = TypeDescriptor::GetAttributes( myNewForm );

   /* Prints the name of the designer by retrieving the 
       * DesignerCategoryAttribute from the AttributeCollection. */
   DesignerCategoryAttribute^ myAttribute = dynamic_cast<DesignerCategoryAttribute^>(attributes[ DesignerCategoryAttribute::typeid ]);
   Console::WriteLine( "The category of the designer for this class is: {0}", myAttribute->Category );
   return 0;
}
public static int Main() {
    // Creates a new form.
    MyForm myNewForm = new MyForm();
 
    // Gets the attributes for the collection.
    AttributeCollection attributes = TypeDescriptor.GetAttributes(myNewForm);
 
    /* Prints the name of the designer by retrieving the 
     * DesignerCategoryAttribute from the AttributeCollection. */
    DesignerCategoryAttribute myAttribute = 
       (DesignerCategoryAttribute)attributes[typeof(DesignerCategoryAttribute)];
    Console.WriteLine("The category of the designer for this class is: " + myAttribute.Category);
  
    return 0;
}
Public Shared Function Main() As Integer
    ' Creates a new form.
    Dim myNewForm As New MyForm()
    
    ' Gets the attributes for the collection.
    Dim attributes As AttributeCollection = TypeDescriptor.GetAttributes(myNewForm)
    
    ' Prints the name of the designer by retrieving the
    ' DesignerCategoryAttribute from the AttributeCollection. 
    Dim myAttribute As DesignerCategoryAttribute = _
        CType(attributes(GetType(DesignerCategoryAttribute)), DesignerCategoryAttribute)
    Console.WriteLine(("The category of the designer for this class is: " + myAttribute.Category))
    Return 0
End Function 'Main

설명

비주얼 디자이너는 디자이너 범주를 사용 하 여 구현 될 디자이너 형식의 개발 환경에 알림을 보내야 수 있습니다.A visual designer can use a designer category to inform a development environment of the type of designer that will be implemented. 디자이너 범주가 없는 클래스에 제공 된 경우 개발 환경 수도 클래스 디자인을 사용할 수 없습니다.If no designer category is provided on a class, a development environment may or may not allow the class to be designed. 모든 이름에 대 한 범주를 만들 수 있습니다.A category can be created for any name.

이 특성이 있는 클래스를 표시 하면 상수 멤버에 설정 됩니다.When you mark a class with this attribute, it is set to a constant member. 코드에서이 특성의 값을 확인 하려는 경우에 상수 멤버를 지정 해야 합니다.When you want to check the value of this attribute in your code, you must specify the constant member. 아래 표에 설명 열의 각 값으로 설정 된 상수 멤버를 나열 합니다.The Description column in the table below lists the constant member that each value is set to.

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

범주Category 설명Description
구성 요소Component 구성 요소를 사용 하 여 사용 되는 디자이너입니다.Designers that are used with components. 상수 멤버 특성이 설정 되어 DesignerCategoryAttribute.Component입니다.The attribute is set to the constant member DesignerCategoryAttribute.Component.
FormForm 폼에 사용 되는 디자이너입니다.Designers that are used with forms. 상수 멤버 특성이 설정 되어 DesignerCategoryAttribute.Form입니다.The attribute is set to the constant member DesignerCategoryAttribute.Form.
DesignerDesigner 디자이너와 함께 사용 되는 디자이너입니다.Designers that are used with designers. 상수 멤버 특성이 설정 되어 DesignerCategoryAttribute.Generic입니다.The attribute is set to the constant member DesignerCategoryAttribute.Generic.
빈 문자열 ("")Empty String ("") 기본 범주입니다.This is the default category.

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

생성자

DesignerCategoryAttribute() DesignerCategoryAttribute() DesignerCategoryAttribute() DesignerCategoryAttribute()

빈 문자열("")로 DesignerCategoryAttribute 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DesignerCategoryAttribute class with an empty string ("").

DesignerCategoryAttribute(String) DesignerCategoryAttribute(String) DesignerCategoryAttribute(String) DesignerCategoryAttribute(String)

주어진 범주 이름을 사용하여 DesignerCategoryAttribute 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DesignerCategoryAttribute class with the given category name.

필드

Component Component Component Component

이 범주로 표시된 구성 요소에서 구성 요소 디자이너를 사용함을 지정합니다.Specifies that a component marked with this category use a component designer. 이 필드는 읽기 전용입니다.This field is read-only.

Default Default Default Default

이 범주로 표시된 구성 요소에서 비주얼 디자이너를 사용할 수 없음을 지정합니다.Specifies that a component marked with this category cannot use a visual designer. static 필드는 읽기 전용입니다.This static field is read-only.

Form Form Form Form

이 범주로 표시된 구성 요소에서 폼 디자이너를 사용함을 지정합니다.Specifies that a component marked with this category use a form designer. static 필드는 읽기 전용입니다.This static field is read-only.

Generic Generic Generic Generic

이 범주로 표시된 구성 요소에서 일반 디자이너를 사용함을 지정합니다.Specifies that a component marked with this category use a generic designer. static 필드는 읽기 전용입니다.This static field is read-only.

속성

Category Category Category Category

범주 이름을 가져옵니다.Gets the name of the category.

TypeId TypeId TypeId TypeId

이 특성에 대한 고유 식별자를 가져옵니다.Gets a unique identifier for this attribute.

메서드

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

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

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

이 인스턴스의 해시 코드를 반환합니다.Returns the hash code for this instance.

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)

적용 대상

추가 정보