CategoryAttribute クラス

定義

名前空間:

System.ComponentModel

アセンブリ:

System.ComponentModel.Primitives.dll

ソース:

CategoryAttribute.cs

PropertyGrid コントロールが [項目別] モードに設定されているときに、コントロールに表示するプロパティまたはイベントを分類するカテゴリの名前を指定します。

public ref class CategoryAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.All)]
public class CategoryAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.All)>]
type CategoryAttribute = class
    inherit Attribute

Public Class CategoryAttribute
Inherits Attribute

継承

Object

Attribute

CategoryAttribute

属性

AttributeUsageAttribute

例

次の例では、 プロパティを作成します MyImage 。 プロパティには、 と の 2 つの属性がありますDescriptionAttributeCategoryAttribute。

   [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に保存します。

次に、 から AttributeCollectionを取得CategoryAttributeし、コンソール画面に書き込んでカテゴリを出力します。

// 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 、mode に設定されたコントロールのプロパティまたはイベントを一覧表示するときに、関連付けられたプロパティまたはイベントを PropertyGrid 関連付けるカテゴリを Categorized 示します。 CategoryAttributeがプロパティまたはイベントに適用されていない場合は、 によってPropertyGridそのプロパティが [その他] カテゴリに関連付けられます。 のコンストラクターでカテゴリの名前を指定することで、任意の名前に対して新しいカテゴリを CategoryAttribute作成できます。

プロパティは Category 、属性が表すカテゴリの名前を示します。 プロパティは Category 、カテゴリ名の透過的なローカライズも提供します。

注意 (継承者)

定義済みの名前以外のカテゴリ名を使用し、カテゴリ名をローカライズする場合は、 メソッドをオーバーライドする GetLocalizedString(String) 必要があります。

クラスは CategoryAttribute 、次の一般的なカテゴリを定義します。

カテゴリ	説明
Action	使用可能なアクションに関連するプロパティ。
Appearance	エンティティの表示方法に関連するプロパティ。
Behavior	エンティティの動作に関連するプロパティ。
Data	データとデータ ソースの管理に関連するプロパティ。
Default	既定のカテゴリにグループ化されたプロパティ。
Design	デザイン時にのみ使用できるプロパティ。
DragDrop	ドラッグ アンド ドロップ操作に関連するプロパティ。
Focus	フォーカスに関連するプロパティ。
Format	書式設定に関連するプロパティ。
Key	キーボードに関連するプロパティ。
Layout	レイアウトに関連するプロパティ。
Mouse	マウスに関連するプロパティ。
WindowStyle	最上位フォームのウィンドウ スタイルに関連するプロパティ。

詳細については、「属性」を参照してください。

コンストラクター

CategoryAttribute()	Default というカテゴリ名を使用して、CategoryAttribute クラスの新しいインスタンスを初期化します。
CategoryAttribute(String)	指定したカテゴリ名を使用して、CategoryAttribute クラスの新しいインスタンスを初期化します。

プロパティ

Action	Action カテゴリを表す CategoryAttribute を取得します。
Appearance	Appearance カテゴリを表す CategoryAttribute を取得します。
Asynchronous	Asynchronous カテゴリを表す CategoryAttribute を取得します。
Behavior	Behavior カテゴリを表す CategoryAttribute を取得します。
Category	この属性が適用されているプロパティまたはイベントのカテゴリ名を取得します。
Data	Data カテゴリを表す CategoryAttribute を取得します。
Default	Default カテゴリを表す CategoryAttribute を取得します。
Design	Design カテゴリを表す CategoryAttribute を取得します。
DragDrop	DragDrop カテゴリを表す CategoryAttribute を取得します。
Focus	Focus カテゴリを表す CategoryAttribute を取得します。
Format	Format カテゴリを表す CategoryAttribute を取得します。
Key	Key カテゴリを表す CategoryAttribute を取得します。
Layout	Layout カテゴリを表す CategoryAttribute を取得します。
Mouse	Mouse カテゴリを表す CategoryAttribute を取得します。
TypeId	派生クラスで実装されると、この Attribute の一意の識別子を取得します。 (継承元 Attribute)
WindowStyle	WindowStyle カテゴリを表す CategoryAttribute を取得します。

メソッド

Equals(Object)	指定したオブジェクトの値が現在の CategoryAttribute と等しいかどうかを示す値を返します。
GetHashCode()	この属性のハッシュ コードを返します。
GetLocalizedString(String)	指定したカテゴリのローカライズされた名前を検索します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
IsDefaultAttribute()	この属性が既定値かどうかを判断します。
Match(Object)	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (継承元 Attribute)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

こちらもご覧ください

• Attribute
• PropertyDescriptor
• EventDescriptor