PropertyTab Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms.Design

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Udostępnia klasę bazową dla kart właściwości.

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

Dziedziczenie: Object
PropertyTab

Pochodne: System.Windows.Forms.Design.EventsTab

System.Windows.Forms.PropertyGridInternal.PropertiesTab

Implementuje: IExtenderProvider

Przykłady

Poniższy przykład kodu zawiera przykład PropertyTab , który zawiera listę wszystkich właściwości składnika rozmieszczonych według nazwy typu.

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

Uwagi

Klasa PropertyTab zapewnia zachowanie klasy podstawowej dla karty właściwości. Karty właściwości są wyświetlane na pasku narzędzi PropertyGrid kontrolki okno Właściwości i umożliwiają składnikowi wyświetlanie różnych widoków jego właściwości lub innych danych.

Kod użytkownika zwykle nie tworzy wystąpienia PropertyTab bezpośrednio. PropertyTabAttribute Zamiast tego element wskazujący typ karty właściwości lub kart właściwości do wyświetlenia składnika może być skojarzony z właściwościami lub typami, dla których PropertyTab powinny być wyświetlane.

PropertyTab Wystąpienie PropertyGrid typu określonego przez skojarzony z typem PropertyTabAttribute lub polem właściwości składnika, który jest przeglądany.

Konstruktory

PropertyTab()

Inicjuje nowe wystąpienie klasy PropertyTab.

Właściwości

Bitmap	Pobiera mapę bitową wyświetlaną dla elementu PropertyTab.
Components	Pobiera lub ustawia tablicę składników, z których jest skojarzona karta właściwości.
HelpKeyword	Pobiera słowo kluczowe Pomoc, które ma być skojarzone z tą kartą.
TabName	Pobiera nazwę karty właściwości.

Metody

CanExtend(Object)	Pobiera wartość wskazującą, czy może to PropertyTab wyświetlać właściwości określonego składnika.
Dispose()	Zwalnia wszystkie zasoby używane przez usługę PropertyTab.
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element PropertyTab i opcjonalnie zwalnia zasoby zarządzane.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Finalize()	PropertyTab Umożliwia próbę zwolnienia zasobów i wykonania innych operacji oczyszczania przed PropertyTab odzyskaniem przez odzyskiwanie pamięci.
GetDefaultProperty(Object)	Pobiera właściwość domyślną określonego składnika.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Pobiera właściwości określonego składnika zgodnego z określonymi atrybutami i kontekstem.
GetProperties(Object)	Pobiera właściwości określonego składnika.
GetProperties(Object, Attribute[])	Pobiera właściwości określonego składnika zgodnego z określonymi atrybutami.
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Dotyczy