Microsoft.com
Bienvenido Iniciar sesión
Inicio de .NET Framework
 Versión imprimible       Enviar     
Evaluar y enviar comentarios

  Encender vista de ancho de banda bajo
Esta página es específica de
Microsoft Visual Studio 2005/.NET Framework 2.0

Hay además otras versiones disponibles para:
PropertyGrid (Clase)
Proporciona una interfaz de usuario para examinar las propiedades de un objeto.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

Visual Basic (Declaración)
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
<ComVisibleAttribute(True)> _
Public Class PropertyGrid
    Inherits ContainerControl
    Implements IComPropertyBrowser
Visual Basic (Uso)
Dim instance As PropertyGrid
C#
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
[ComVisibleAttribute(true)] 
public class PropertyGrid : ContainerControl, IComPropertyBrowser
C++
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] 
[ComVisibleAttribute(true)] 
public ref class PropertyGrid : public ContainerControl, IComPropertyBrowser
J#
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
/** @attribute ComVisibleAttribute(true) */ 
public class PropertyGrid extends ContainerControl implements IComPropertyBrowser
JScript
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
ComVisibleAttribute(true) 
public class PropertyGrid extends ContainerControl implements IComPropertyBrowser
XAML
No aplicable.

Para utilizar la cuadrícula de propiedades, cree una nueva instancia de la clase PropertyGrid en un control primario y establezca la propiedad SelectedObject en el objeto cuyas propiedades se van a mostrar.

La información que se muestra en la cuadrícula es una instantánea de las propiedades en el momento de asignar el objeto. Si el valor de una propiedad del objeto especificado por SelectedObject se modifica en el código en tiempo de ejecución, el nuevo valor no se mostrará hasta que se realice una acción en la cuadrícula que la actualice.

Las fichas de propiedades en la cuadrícula de propiedades aparecen como botones en la barra de herramientas situada en la parte superior del objeto PropertyGrid, y su ámbito puede variar en función de los datos definidos en PropertyTabScope.

El control PropertyGrid no se presenta inicialmente en el cuadro de herramientas en el entorno de desarrollo. Se puede agregar al cuadro de herramientas una cuadrícula de propiedades, lo que permitirá arrastrar y colocar un objeto PropertyGrid en el formulario. También se puede definir una instancia de PropertyGrid agregando el código apropiado al código fuente.

En el siguiente ejemplo de código se muestra cómo se crea una cuadrícula de propiedades y se establece su ubicación en un formulario. En este ejemplo se requiere que haya un formulario que incluya un objeto TextBox.

Visual Basic
Public Sub New()
       
    ' The initial constructor code goes here.
    
    Dim propertyGrid1 As New PropertyGrid()
    propertyGrid1.CommandsVisibleIfAvailable = True
    propertyGrid1.Location = New Point(10, 20)
    propertyGrid1.Size = New System.Drawing.Size(400, 300)
    propertyGrid1.TabIndex = 1
    propertyGrid1.Text = "Property Grid"
       
    Me.Controls.Add(propertyGrid1)
       
    propertyGrid1.SelectedObject = textBox1
End Sub
C#
public Form1() {

   // The initial constructor code goes here.
 
   PropertyGrid propertyGrid1 = new PropertyGrid();
   propertyGrid1.CommandsVisibleIfAvailable = true;
   propertyGrid1.Location = new Point(10, 20);
   propertyGrid1.Size = new System.Drawing.Size(400, 300);
   propertyGrid1.TabIndex = 1;
   propertyGrid1.Text = "Property Grid";

   this.Controls.Add(propertyGrid1);

   propertyGrid1.SelectedObject = textBox1;
}
C++
public:
   [PermissionSetAttribute(SecurityAction::Demand, Name="FullTrust")]
   Form1()
   {
      // The initial constructor code goes here.

      PropertyGrid^ propertyGrid1 = gcnew PropertyGrid;
      propertyGrid1->CommandsVisibleIfAvailable = true;
      propertyGrid1->Location = Point( 10, 20 );
      propertyGrid1->Size = System::Drawing::Size( 400, 300 );
      propertyGrid1->TabIndex = 1;
      propertyGrid1->Text = "Property Grid";

      this->Controls->Add( propertyGrid1 );

      propertyGrid1->SelectedObject = textBox1;
   }
System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.Control
         System.Windows.Forms.ScrollableControl
           System.Windows.Forms.ContainerControl
            System.Windows.Forms.PropertyGrid
Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0
© 2009 Microsoft Corporation. Reservados todos los derechos. Términos de uso  |  Marcas Registradas  |  Privacidad
Page view tracker