PropertyTab Třída

Definice

Obor názvů:

System.Windows.Forms.Design

Sestavení:

System.Windows.Forms.dll

Zdroj:

PropertyTab.cs

Poskytuje základní třídu pro karty vlastností.

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

Dědičnost

Object

PropertyTab

Odvozené

System.Windows.Forms.Design.EventsTab

System.Windows.Forms.PropertyGridInternal.PropertiesTab

Implementuje

IExtenderProvider

Příklady

Následující příklad kódu poskytuje příklad PropertyTab , který obsahuje všechny vlastnosti komponenty uspořádané podle názvu 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.
[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);
}

Poznámky

Třída PropertyTab poskytuje chování základní třídy pro kartu vlastností. Karty vlastností se zobrazují na panelu nástrojů ovládacího prvku PropertyGrid okno Vlastnosti a umožňují komponentě zobrazit různá zobrazení vlastností nebo jiných dat.

Uživatelský kód obvykle nevytvoří instanci PropertyTab přímo. Místo toho může být typ karty vlastností nebo karet vlastností, které se mají zobrazit pro komponentu, PropertyTabAttribute přidruženy k vlastnostem nebo typům, pro které PropertyTab se má zobrazit.

Vytvoří PropertyGrid instanci PropertyTab typu určeného typem PropertyTabAttribute přidruženým k poli typu nebo vlastnosti komponenty, která se prochází.

Konstruktory

Name	Description
PropertyTab()	Inicializuje novou instanci PropertyTab třídy.

Vlastnosti

Name	Description
Bitmap	Získá rastrový obrázek, který je zobrazen pro PropertyTab.
Components	Získá nebo nastaví pole komponent, ke kterým je karta vlastnosti přidružena.
HelpKeyword	Získá klíčové slovo nápovědy, které má být přidruženo k této kartě.
TabName	Získá název karty vlastností.

Metody

Name	Description
CanExtend(Object)	Získá hodnotu určující, zda může zobrazit PropertyTab vlastnosti pro zadanou komponentu.
Dispose()	Uvolní všechny prostředky používané PropertyTab.
Dispose(Boolean)	Uvolní nespravované prostředky používané PropertyTab a volitelně uvolní spravované prostředky.
Finalize()	PropertyTab Umožňuje pokus o uvolnění prostředků a provádění dalších operací čištění před PropertyTab uvolněním paměti.
GetDefaultProperty(Object)	Získá výchozí vlastnost zadané komponenty.
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Získá vlastnosti zadané komponenty, které odpovídají zadaným atributům a kontextu.
GetProperties(Object, Attribute[])	Získá vlastnosti zadané komponenty, které odpovídají zadaným atributům.
GetProperties(Object)	Získá vlastnosti zadané komponenty.