Leer en inglés

Compartir vía


PropertyTabScope Enumeración

Definición

Define los identificadores que indican el ámbito de persistencia de una ficha en la ventana Propiedades.

C#
public enum PropertyTabScope
Herencia
PropertyTabScope

Campos

Nombre Valor Description
Component 3

Esta ficha es específica del componente actual. Esta ficha se agrega a la ventana Propiedades sólo para el actual componente y se quita cuando ya no está seleccionado el componente.

Document 2

Esta ficha es específica del documento actual. Esta ficha se agrega a la ventana Propiedades y se quita cuando cambia el documento actualmente seleccionado.

Global 1

Esta ficha se agrega a la ventana Propiedades y sólo la puede quitar explícitamente un componente principal.

Static 0

Esta ficha se agrega a la ventana Propiedades y no se puede quitar.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar PropertyTabScope para especificar el ámbito de una pestaña de propiedades.

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

Comentarios

PropertyTabScopeindica el ámbito de persistencia de una pestaña que se muestra en el ventana Propiedades cuando un componente de un documento de diseño tiene asociado PropertyTabAttribute.

Se aplica a

Producto Versiones
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Consulte también