PropertyTab Classe

Definizione

Spazio dei nomi:

System.Windows.Forms.Design

Assembly:

System.Windows.Forms.dll

Origine:

PropertyTab.cs

Fornisce una classe di base per le schede delle proprietà.

public ref class PropertyTab abstract : System::ComponentModel::IExtenderProvider

public abstract class PropertyTab : System.ComponentModel.IExtenderProvider

type PropertyTab = class
    interface IExtenderProvider

Public MustInherit Class PropertyTab
Implements IExtenderProvider

Ereditarietà

Object

PropertyTab

Derivato

System.Windows.Forms.Design.EventsTab

System.Windows.Forms.PropertyGridInternal.PropertiesTab

Implementazioni

IExtenderProvider

Esempio

Nell'esempio di codice seguente viene fornito un esempio PropertyTab che elenca le proprietà di un componente, disposte in base al nome del tipo.

#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.
[PropertyTab(typeof(TypeCategoryTab), PropertyTabScope.Document)]
public class TypeCategoryTabComponent : 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 PropertyDescriptorCollection GetProperties(object component, System.Attribute[] attributes)
    {
        PropertyDescriptorCollection props = attributes == null ? TypeDescriptor.GetProperties(component) : 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 PropertyDescriptorCollection GetProperties(object component) => GetProperties(component, null);

    // Provides the name for the property tab.
    public override string TabName => "Properties by Type";

    // Provides an image for the property tab.
    public override Bitmap Bitmap => new("myproperty.bmp", true);
}

Commenti

La classe fornisce il comportamento della classe di base per una scheda delle proprietà. Le schede delle proprietà vengono visualizzate sulla barra degli strumenti del controllo /> /< del Finestra Proprietà e consentono a un componente di visualizzare visualizzazioni diverse delle relative proprietà o altri dati.

Il codice utente in genere non crea un'istanza di un oggetto PropertyTab direttamente. Un oggetto PropertyTabAttribute che indica invece il tipo della scheda delle proprietà o delle schede delle proprietà da visualizzare per un componente può essere associato alle proprietà o ai tipi per cui deve essere visualizzato l'oggetto PropertyTab .

Verrà PropertyGrid creata un'istanza di un PropertyTab oggetto del tipo specificato da un PropertyTabAttribute oggetto associato al tipo o al campo della proprietà del componente in fase di esplorazione.

Costruttori

Nome	Descrizione
PropertyTab()	Inizializza una nuova istanza della classe PropertyTab.

Proprietà

Nome	Descrizione
Bitmap	Ottiene la bitmap visualizzata per l'oggetto PropertyTab.
Components	Ottiene o imposta la matrice di componenti a cui è associata la scheda delle proprietà.
HelpKeyword	Ottiene la parola chiave della Guida da associare a questa scheda.
TabName	Ottiene il nome della scheda delle proprietà.

Metodi

Nome	Descrizione
CanExtend(Object)	Ottiene un valore che indica se può PropertyTab visualizzare le proprietà per il componente specificato.
Dispose()	Rilascia tutte le risorse usate dal PropertyTab.
Dispose(Boolean)	Rilascia le risorse non gestite usate da PropertyTab e, facoltativamente, rilascia le risorse gestite.
Finalize()	Consente a un oggetto PropertyTab di tentare di liberare risorse ed eseguire altre operazioni di pulizia prima che venga PropertyTab recuperato da Garbage Collection.
GetDefaultProperty(Object)	Ottiene la proprietà predefinita del componente specificato.
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Ottiene le proprietà del componente specificato che corrispondono agli attributi e al contesto specificati.
GetProperties(Object, Attribute[])	Ottiene le proprietà del componente specificato che corrispondono agli attributi specificati.
GetProperties(Object)	Ottiene le proprietà del componente specificato.