PropertyTab クラス
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)


PropertyTab クラスは、プロパティ タブの基本クラス動作を提供します。プロパティ タブは、[プロパティ] ウィンドウの PropertyGrid コントロールのツール バーに表示されます。また、あるコンポーネントのプロパティまたはその他のデータの別のビューを、そのコンポーネントが表示できるようにします。
通常、PropertyTab のインスタンスをユーザー コードで直接作成することはありません。代わりに、コンポーネントに対して表示するプロパティ タブの種類を示す PropertyTabAttribute と、PropertyTab が表示されるプロパティまたは種類とを関連付けることができます。
PropertyGrid は、参照されているコンポーネントの種類またはプロパティのフィールドに関連付けらた PropertyTabAttribute によって指定されている種類の PropertyTab をインスタンス化します。

コンポーネントのプロパティの一覧を型の名前順に並べ替えて表示する PropertyTab のコード例を次に示します。
Imports System Imports System.ComponentModel Imports System.ComponentModel.Design Imports System.Drawing Imports System.IO Imports System.Reflection Imports System.Runtime.Serialization Imports System.Runtime.Serialization.Formatters.Binary Imports System.Windows.Forms Imports System.Windows.Forms.Design ' This component adds a TypeCategoryTab to the property browser ' that is available for any components in the current design mode document. <PropertyTabAttribute(GetType(TypeCategoryTab), PropertyTabScope.Document)> _ Public Class TypeCategoryTabComponent Inherits System.ComponentModel.Component Public Sub New() End Sub End Class ' A TypeCategoryTab property tab lists properties by the ' category of the type of each property. <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _ Public Class TypeCategoryTab Inherits PropertyTab ' This string contains a Base-64 encoded and serialized example property tab image. <BrowsableAttribute(True)> _ Private img As String = "AAEAAAD/////AQAAAAAAAAAMAgAAAFRTeXN0ZW0uRHJhd2luZywgVmVyc2lvbj0xLjAuMzMwMC4wLCBDdWx0dXJlPW5ldXRyYWwsIFB1YmxpY0tleVRva2VuPWIwM2Y1ZjdmMTFkNTBhM2EFAQAAABVTeXN0ZW0uRHJhd2luZy5CaXRtYXABAAAABERhdGEHAgIAAAAJAwAAAA8DAAAA9gAAAAJCTfYAAAAAAAAANgAAACgAAAAIAAAACAAAAAEAGAAAAAAAAAAAAMQOAADEDgAAAAAAAAAAAAD///////////////////////////////////9ZgABZgADzPz/zPz/zPz9AgP//////////gAD/gAD/AAD/AAD/AACKyub///////+AAACAAAAAAP8AAP8AAP9AgP////////9ZgABZgABz13hz13hz13hAgP//////////gAD/gACA/wCA/wCA/wAA//////////+AAACAAAAAAP8AAP8AAP9AgP////////////////////////////////////8L" Public Sub New() End Sub ' Returns the properties of the specified component extended with ' a CategoryAttribute reflecting the name of the type of the property. Public Overloads Overrides Function GetProperties(ByVal component As Object, ByVal attributes() As System.Attribute) As System.ComponentModel.PropertyDescriptorCollection Dim props As PropertyDescriptorCollection If attributes Is Nothing Then props = TypeDescriptor.GetProperties(component) Else props = TypeDescriptor.GetProperties(component, attributes) End If Dim propArray(props.Count - 1) As PropertyDescriptor Dim i As Integer For i = 0 To props.Count - 1 ' Create a new PropertyDescriptor from the old one, with ' a CategoryAttribute matching the name of the type. propArray(i) = TypeDescriptor.CreateProperty(props(i).ComponentType, props(i), New CategoryAttribute(props(i).PropertyType.Name)) Next i Return New PropertyDescriptorCollection(propArray) End Function Public Overloads Overrides Function GetProperties(ByVal component As Object) As System.ComponentModel.PropertyDescriptorCollection Return Me.GetProperties(component, Nothing) End Function ' Provides the name for the property tab. Public Overrides ReadOnly Property TabName() As String Get Return "Properties by Type" End Get End Property ' Provides an image for the property tab. Public Overrides ReadOnly Property Bitmap() As System.Drawing.Bitmap Get Dim bmp As New Bitmap(DeserializeFromBase64Text(img)) Return bmp End Get End Property ' This method can be used to retrieve an Image from a block of Base64-encoded text. Private Function DeserializeFromBase64Text(ByVal [text] As String) As Image Dim img As Image = Nothing Dim memBytes As Byte() = Convert.FromBase64String([text]) Dim formatter As New BinaryFormatter() Dim stream As New MemoryStream(memBytes) img = CType(formatter.Deserialize(stream), Image) stream.Close() Return img End Function End Class
using System; using System.ComponentModel; using System.ComponentModel.Design; using System.Drawing; using System.IO; using System.Reflection; using System.Runtime.Serialization; using System.Runtime.Serialization.Formatters.Binary; using System.Windows.Forms; using System.Windows.Forms.Design; namespace TypeCategoryTabExample { // This component adds a TypeCategoryTab to the propery browser // that is available for any components in the current design mode document. [PropertyTabAttribute(typeof(TypeCategoryTab), PropertyTabScope.Document)] public class TypeCategoryTabComponent : System.ComponentModel.Component { public TypeCategoryTabComponent() { } } // A TypeCategoryTab property tab lists properties by the // category of the type of each property. [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name = "FullTrust")] public class TypeCategoryTab : PropertyTab { [BrowsableAttribute(true)] // This string contains a Base-64 encoded and serialized example property tab image. private string img = "AAEAAAD/////AQAAAAAAAAAMAgAAAFRTeXN0ZW0uRHJhd2luZywgVmVyc2lvbj0xLjAuMzMwMC4wLCBDdWx0dXJlPW5ldXRyYWwsIFB1YmxpY0tleVRva2VuPWIwM2Y1ZjdmMTFkNTBhM2EFAQAAABVTeXN0ZW0uRHJhd2luZy5CaXRtYXABAAAABERhdGEHAgIAAAAJAwAAAA8DAAAA9gAAAAJCTfYAAAAAAAAANgAAACgAAAAIAAAACAAAAAEAGAAAAAAAAAAAAMQOAADEDgAAAAAAAAAAAAD///////////////////////////////////9ZgABZgADzPz/zPz/zPz9AgP//////////gAD/gAD/AAD/AAD/AACKyub///////+AAACAAAAAAP8AAP8AAP9AgP////////9ZgABZgABz13hz13hz13hAgP//////////gAD/gACA/wCA/wCA/wAA//////////+AAACAAAAAAP8AAP8AAP9AgP////////////////////////////////////8L"; public TypeCategoryTab() { } // Returns the properties of the specified component extended with // a CategoryAttribute reflecting the name of the type of the property. public override System.ComponentModel.PropertyDescriptorCollection GetProperties(object component, System.Attribute[] attributes) { PropertyDescriptorCollection props; if( attributes == null ) props = TypeDescriptor.GetProperties(component); else props = TypeDescriptor.GetProperties(component, attributes); PropertyDescriptor[] propArray = new PropertyDescriptor[props.Count]; for(int i=0; i<props.Count; i++) { // Create a new PropertyDescriptor from the old one, with // a CategoryAttribute matching the name of the type. propArray[i] = TypeDescriptor.CreateProperty(props[i].ComponentType, props[i], new CategoryAttribute(props[i].PropertyType.Name)); } return new PropertyDescriptorCollection( propArray ); } public override System.ComponentModel.PropertyDescriptorCollection GetProperties(object component) { return this.GetProperties(component, null); } // Provides the name for the property tab. public override string TabName { get { return "Properties by Type"; } } // Provides an image for the property tab. public override System.Drawing.Bitmap Bitmap { get { Bitmap bmp = new Bitmap(DeserializeFromBase64Text(img)); return bmp; } } // This method can be used to retrieve an Image from a block of Base64-encoded text. private Image DeserializeFromBase64Text(string text) { Image img = null; byte[] memBytes = Convert.FromBase64String(text); IFormatter formatter = new BinaryFormatter(); MemoryStream stream = new MemoryStream(memBytes); img = (Image)formatter.Deserialize(stream); stream.Close(); return img; } } }
#using <System.Windows.Forms.dll> #using <System.Drawing.dll> #using <System.dll> using namespace System; using namespace System::ComponentModel; using namespace System::ComponentModel::Design; using namespace System::Drawing; using namespace System::IO; using namespace System::Reflection; using namespace System::Runtime::Serialization; using namespace System::Runtime::Serialization::Formatters::Binary; using namespace System::Windows::Forms; using namespace System::Windows::Forms::Design; using namespace System::Security::Permissions; namespace TypeCategoryTabExample { ref class TypeCategoryTab; // forward declaration. // This component adds a TypeCategoryTab to the propery browser // that is available for any components in the current design mode document. [PropertyTabAttribute(TypeCategoryTabExample::TypeCategoryTab::typeid,PropertyTabScope::Document)] public ref class TypeCategoryTabComponent: public System::ComponentModel::Component { public: TypeCategoryTabComponent(){} }; // A TypeCategoryTab property tab lists properties by the // category of the type of each property. public ref class TypeCategoryTab: public PropertyTab { private: // This String^ contains a Base-64 encoded and serialized example property tab image. [BrowsableAttribute(true)] String^ img; public: TypeCategoryTab() { img = "AAEAAAD/////AQAAAAAAAAAMAgAAAFRTeXN0ZW0uRHJhd2luZywgVmVyc2lvbj0xLjAuMzMwMC4wLCBDdWx0dXJlPW5ldXRyYWwsIFB1YmxpY0tleVRva2VuPWIwM2Y1ZjdmMTFkNTBhM2EFAQAAABVTeXN0ZW0uRHJhd2luZy5CaXRtYXABAAAABERhdGEHAgIAAAAJAwAAAA8DAAAA9gAAAAJCTfYAAAAAAAAANgAAACgAAAAIAAAACAAAAAEAGAAAAAAAAAAAAMQOAADEDgAAAAAAAAAAAAD///////////////////////////////////9ZgABZgADzPz/zPz/zPz9AgP//////////gAD/gAD/AAD/AAD/AACKyub///////+AAACAAAAAAP8AAP8AAP9AgP////////9ZgABZgABz13hz13hz13hAgP//////////gAD/gACA/wCA/wCA/wAA//////////+AAACAAAAAAP8AAP8AAP9AgP////////////////////////////////////8L"; } // Returns the properties of the specified component extended with // a CategoryAttribute reflecting the name of the type of the property. [ReflectionPermission(SecurityAction::Demand, Flags=ReflectionPermissionFlag::MemberAccess)] virtual System::ComponentModel::PropertyDescriptorCollection^ GetProperties( Object^ component, array<System::Attribute^>^attributes ) override { PropertyDescriptorCollection^ props; if ( attributes == nullptr ) props = TypeDescriptor::GetProperties( component ); else props = TypeDescriptor::GetProperties( component, attributes ); array<PropertyDescriptor^>^propArray = gcnew array<PropertyDescriptor^>(props->Count); for ( int i = 0; i < props->Count; i++ ) { // Create a new PropertyDescriptor from the old one, with // a CategoryAttribute matching the name of the type. array<Attribute^>^temp0 = {gcnew CategoryAttribute( props[ i ]->PropertyType->Name )}; propArray[ i ] = TypeDescriptor::CreateProperty( props[ i ]->ComponentType, props[ i ], temp0 ); } return gcnew PropertyDescriptorCollection( propArray ); } virtual System::ComponentModel::PropertyDescriptorCollection^ GetProperties( Object^ component ) override { return this->GetProperties( component, nullptr ); } property String^ TabName { // Provides the name for the property tab. virtual String^ get() override { return "Properties by Type"; } } property System::Drawing::Bitmap^ Bitmap { // Provides an image for the property tab. virtual System::Drawing::Bitmap^ get() override { System::Drawing::Bitmap^ bmp = gcnew System::Drawing::Bitmap( DeserializeFromBase64Text( img ) ); return bmp; } } private: // This method can be used to retrieve an Image from a block of Base64-encoded text. Image^ DeserializeFromBase64Text( String^ text ) { Image^ img = nullptr; array<Byte>^memBytes = Convert::FromBase64String( text ); IFormatter^ formatter = gcnew BinaryFormatter; MemoryStream^ stream = gcnew MemoryStream( memBytes ); img = dynamic_cast<Image^>(formatter->Deserialize( stream )); stream->Close(); return img; } }; }


System.Windows.Forms.Design.PropertyTab
System.Windows.Forms.Design.EventsTab
System.Windows.Forms.PropertyGridInternal.PropertiesTab


Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


PropertyTab コンストラクタ
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)


Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


PropertyTab プロパティ

名前 | 説明 | |
---|---|---|
![]() | Bitmap | PropertyTab に表示されるビットマップを取得します。 |
![]() | Components | プロパティ タブが関連付けられているコンポーネントの配列を取得または設定します。 |
![]() | HelpKeyword | このタブに関連付けられるヘルプ キーワードを取得します。 |
![]() | TabName | プロパティ タブの名前を取得します。 |

PropertyTab メソッド

名前 | 説明 | |
---|---|---|
![]() | CanExtend | このPropertyTab が、指定したコンポーネントのプロパティを表示できるかどうかを示す値を取得します。 |
![]() | Dispose | オーバーロードされます。 PropertyTab によって使用されているすべてのリソースを解放します。 |
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
![]() | GetDefaultProperty | 指定したコンポーネントの既定のプロパティを取得します。 |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
![]() | GetProperties | オーバーロードされます。 指定したコンポーネントのプロパティを取得します。 |
![]() | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
![]() | ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | Dispose | オーバーロードされます。 PropertyTab によって使用されているすべてのリソースを解放します。 |
![]() | Finalize | オーバーライドされます。 PropertyTab がガベージ コレクションにより収集される前に、その PropertyTab がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |

PropertyTab メンバ
PropertyTab データ型で公開されるメンバを以下の表に示します。


名前 | 説明 | |
---|---|---|
![]() | Bitmap | PropertyTab に表示されるビットマップを取得します。 |
![]() | Components | プロパティ タブが関連付けられているコンポーネントの配列を取得または設定します。 |
![]() | HelpKeyword | このタブに関連付けられるヘルプ キーワードを取得します。 |
![]() | TabName | プロパティ タブの名前を取得します。 |

名前 | 説明 | |
---|---|---|
![]() | CanExtend | このPropertyTab が、指定したコンポーネントのプロパティを表示できるかどうかを示す値を取得します。 |
![]() | Dispose | オーバーロードされます。 PropertyTab によって使用されているすべてのリソースを解放します。 |
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
![]() | GetDefaultProperty | 指定したコンポーネントの既定のプロパティを取得します。 |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
![]() | GetProperties | オーバーロードされます。 指定したコンポーネントのプロパティを取得します。 |
![]() | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
![]() | ToString | 現在の Object を表す String を返します。 (Object から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | Dispose | オーバーロードされます。 PropertyTab によって使用されているすべてのリソースを解放します。 |
![]() | Finalize | オーバーライドされます。 PropertyTab がガベージ コレクションにより収集される前に、その PropertyTab がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |

- PropertyTabのページへのリンク