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
public 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の2つの属性があります。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.

この例では、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)

注釈

Categorized モードに設定された PropertyGrid コントロール内のプロパティまたはイベントを一覧表示するときに、関連付けられているプロパティまたはイベントを関連付けるカテゴリを示す CategoryAttributeA 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()

Default というカテゴリ名を使用して、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

Action カテゴリを表す CategoryAttribute を取得します。Gets a CategoryAttribute representing the Action category.

Appearance

Appearance カテゴリを表す CategoryAttribute を取得します。Gets a CategoryAttribute representing the Appearance category.

Asynchronous

Asynchronous カテゴリを表す CategoryAttribute を取得します。Gets a CategoryAttribute representing the Asynchronous category.

Behavior

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

Data カテゴリを表す CategoryAttribute を取得します。Gets a CategoryAttribute representing the Data category.

Default

Default カテゴリを表す CategoryAttribute を取得します。Gets a CategoryAttribute representing the Default category.

Design

Design カテゴリを表す CategoryAttribute を取得します。Gets a CategoryAttribute representing the Design category.

DragDrop

DragDrop カテゴリを表す CategoryAttribute を取得します。Gets a CategoryAttribute representing the DragDrop category.

Focus

Focus カテゴリを表す CategoryAttribute を取得します。Gets a CategoryAttribute representing the Focus category.

Format

Format カテゴリを表す CategoryAttribute を取得します。Gets a CategoryAttribute representing the Format category.

Key

Key カテゴリを表す CategoryAttribute を取得します。Gets a CategoryAttribute representing the Key category.

Layout

Layout カテゴリを表す CategoryAttribute を取得します。Gets a CategoryAttribute representing the Layout category.

Mouse

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

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)

適用対象

こちらもご覧ください