PropertyTabAttribute Constructors

Reference

Definition

Namespace:: System.ComponentModel

Assembly:: System.ComponentModel.TypeConverter.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Initializes a new instance of the PropertyTabAttribute class.

Overloads

PropertyTabAttribute()	Initializes a new instance of the PropertyTabAttribute class.
PropertyTabAttribute(String)	Initializes a new instance of the PropertyTabAttribute class using the specified tab class name.
PropertyTabAttribute(Type)	Initializes a new instance of the PropertyTabAttribute class using the specified type of tab.
PropertyTabAttribute(String, PropertyTabScope)	Initializes a new instance of the PropertyTabAttribute class using the specified tab class name and tab scope.
PropertyTabAttribute(Type, PropertyTabScope)	Initializes a new instance of the PropertyTabAttribute class using the specified type of tab and tab scope.

PropertyTabAttribute()

Source:: PropertyTabAttribute.cs

Source:: PropertyTabAttribute.cs

Source:: PropertyTabAttribute.cs

Initializes a new instance of the PropertyTabAttribute class.

public:
 PropertyTabAttribute();

public PropertyTabAttribute ();

Public Sub New ()

Remarks

This is a parameterless constructor that creates an uninitialized PropertyTabAttribute. This constructor can be used to derive from this attribute and specify multiple tab types by calling InitializeArrays.

Applies to

PropertyTabAttribute(String)

Source:: PropertyTabAttribute.cs

Source:: PropertyTabAttribute.cs

Source:: PropertyTabAttribute.cs

Initializes a new instance of the PropertyTabAttribute class using the specified tab class name.

public:
 PropertyTabAttribute(System::String ^ tabClassName);

public PropertyTabAttribute (string tabClassName);

new System.ComponentModel.PropertyTabAttribute : string -> System.ComponentModel.PropertyTabAttribute

Public Sub New (tabClassName As String)

Parameters

tabClassName: String

The assembly qualified name of the type of tab to create. For an example of this format convention, see AssemblyQualifiedName.

Applies to

PropertyTabAttribute(Type)

Source:: PropertyTabAttribute.cs

Source:: PropertyTabAttribute.cs

Source:: PropertyTabAttribute.cs

Initializes a new instance of the PropertyTabAttribute class using the specified type of tab.

public:
 PropertyTabAttribute(Type ^ tabClass);

public PropertyTabAttribute (Type tabClass);

new System.ComponentModel.PropertyTabAttribute : Type -> System.ComponentModel.PropertyTabAttribute

Public Sub New (tabClass As Type)

Parameters

tabClass: Type

The type of tab to create.

Applies to

PropertyTabAttribute(String, PropertyTabScope)

Source:: PropertyTabAttribute.cs

Source:: PropertyTabAttribute.cs

Source:: PropertyTabAttribute.cs

Initializes a new instance of the PropertyTabAttribute class using the specified tab class name and tab scope.

public:
 PropertyTabAttribute(System::String ^ tabClassName, System::ComponentModel::PropertyTabScope tabScope);

public PropertyTabAttribute (string tabClassName, System.ComponentModel.PropertyTabScope tabScope);

new System.ComponentModel.PropertyTabAttribute : string * System.ComponentModel.PropertyTabScope -> System.ComponentModel.PropertyTabAttribute

Public Sub New (tabClassName As String, tabScope As PropertyTabScope)

Parameters

tabClassName: String

The assembly qualified name of the type of tab to create. For an example of this format convention, see AssemblyQualifiedName.

tabScope: PropertyTabScope

A PropertyTabScope that indicates the scope of this tab. If the scope is Component, it is shown only for components with the corresponding PropertyTabAttribute. If it is Document, it is shown for all components on the document.

Exceptions

ArgumentException

tabScope is not Document or Component.

Applies to

PropertyTabAttribute(Type, PropertyTabScope)

Source:: PropertyTabAttribute.cs

Source:: PropertyTabAttribute.cs

Source:: PropertyTabAttribute.cs

Initializes a new instance of the PropertyTabAttribute class using the specified type of tab and tab scope.

public:
 PropertyTabAttribute(Type ^ tabClass, System::ComponentModel::PropertyTabScope tabScope);

public PropertyTabAttribute (Type tabClass, System.ComponentModel.PropertyTabScope tabScope);

new System.ComponentModel.PropertyTabAttribute : Type * System.ComponentModel.PropertyTabScope -> System.ComponentModel.PropertyTabAttribute

Public Sub New (tabClass As Type, tabScope As PropertyTabScope)

Parameters

tabClass: Type

The type of tab to create.

tabScope: PropertyTabScope

Exceptions

ArgumentException

tabScope is not Document or Component.

Examples

The following code example demonstrates how to use the PropertyTabAttribute to specify a property tab.

#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";
         }
      }
   };
}

using System.ComponentModel;
using System.Drawing;
using System.Windows.Forms.Design;

namespace TypeCategoryTabExample
{
    // This component adds a TypeCategoryTab to the property 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.
    public class TypeCategoryTab : PropertyTab
    {
        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(@"myproperty.bmp", true);
                return bmp;
            }
        }
    }
}

Applies to

Κοινή χρήση μέσω

PropertyTabAttribute Constructors

Definition

Overloads

PropertyTabAttribute()

Remarks

See also

Applies to

PropertyTabAttribute(String)

Parameters

Applies to

PropertyTabAttribute(Type)

Parameters

Applies to

PropertyTabAttribute(String, PropertyTabScope)

Parameters

Exceptions

Applies to

PropertyTabAttribute(Type, PropertyTabScope)

Parameters

Exceptions

Examples

Applies to

Πρόσθετοι πόροι