PropertyTab Sınıf

Tanım

Ad Alanı:

System.Windows.Forms.Design

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

PropertyTab.cs

Özellik sekmeleri için temel bir sınıf sağlar.

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

Devralma

Object

PropertyTab

Türetilmiş

System.Windows.Forms.Design.EventsTab

System.Windows.Forms.PropertyGridInternal.PropertiesTab

Uygulamalar

IExtenderProvider

Örnekler

Aşağıdaki kod örneği, tür adına göre düzenlenmiş bir bileşendeki özellikleri listeleyen bir örnek PropertyTab sağlar.

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

Açıklamalar

PropertyTab sınıfı, bir özellik sekmesi için temel sınıf davranışını sağlar. Özellik sekmeleri, Özellikler penceresi PropertyGrid denetiminin araç çubuğunda görüntülenir ve bileşenin özelliklerinin veya diğer verilerin farklı görünümlerini görüntülemesine izin verir.

Kullanıcı kodu genellikle doğrudan bir PropertyTab örneğini oluşturmaz. Bunun yerine, PropertyTabAttribute bir bileşen için görüntülenecek özellik sekmesinin veya özellik sekmelerinin türünü gösteren bir, görüntülenmesi gereken özellikler veya türler PropertyTab ile ilişkilendirilebilir.

, PropertyGrid gözatılmakta olan bileşenin tür veya özellik alanıyla ilişkilendirilmiş bir PropertyTab tarafından belirtilen türde bir PropertyTabAttribute örneği oluşturur.

Oluşturucular

Name	Description
PropertyTab()	PropertyTab sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
Bitmap	için PropertyTabgörüntülenen bit eşlemi alır.
Components	Özellik sekmesinin ilişkili olduğu bileşen dizisini alır veya ayarlar.
HelpKeyword	Bu sekmeyle ilişkilendirilecek Yardım anahtar sözcüğünü alır.
TabName	Özellik sekmesinin adını alır.

Yöntemler

Name	Description
CanExtend(Object)	Bunun PropertyTab belirtilen bileşen için özellikleri görüntüleyip görüntüleyemeyeceğini belirten bir değer alır.
Dispose()	PropertyTabtarafından kullanılan tüm kaynakları serbest bırakır.
Dispose(Boolean)	tarafından PropertyTab kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.
Finalize()	PropertyTab, atık toplama tarafından geri kazanılmadan önce kaynakları boşaltmaya ve diğer temizleme işlemlerini gerçekleştirmeye PropertyTab çalışmasına izin verir.
GetDefaultProperty(Object)	Belirtilen bileşenin varsayılan özelliğini alır.
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Belirtilen öznitelikler ve bağlamla eşleşen belirtilen bileşenin özelliklerini alır.
GetProperties(Object, Attribute[])	Belirtilen özniteliklerle eşleşen belirtilen bileşenin özelliklerini alır.
GetProperties(Object)	Belirtilen bileşenin özelliklerini alır.