Questa documentazione è stata archiviata e non viene gestita.

Classe PropertyGrid

Fornisce un'interfaccia utente per visualizzare le proprietà di un oggetto.

Spazio dei nomi: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
[ComVisibleAttribute(true)] 
public class PropertyGrid : ContainerControl, IComPropertyBrowser
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
/** @attribute ComVisibleAttribute(true) */ 
public class PropertyGrid extends ContainerControl implements IComPropertyBrowser
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
ComVisibleAttribute(true) 
public class PropertyGrid extends ContainerControl implements IComPropertyBrowser

Per utilizzare la griglia delle proprietà, creare una nuova istanza della classe PropertyGrid in un controllo padre e impostare SelectedObject sull'oggetto di cui si intende visualizzare le proprietà.

Le informazioni visualizzate nella griglia sono uno snapshot delle proprietà nel momento in cui l'oggetto è stato assegnato. Se il valore di una proprietà dell'oggetto specificato da SelectedObject viene modificato nel codice in fase di esecuzione, il nuovo valore non viene visualizzato finché non viene aggiornata la griglia.

Le schede delle proprietà nella relativa griglia sono visualizzate come pulsanti sulla barra degli strumenti nella parte superiore dell'oggetto PropertyGrid e possono avere ambiti diversi a seconda di quanto definito nell'oggetto PropertyTabScope.

Il controllo PropertyGrid non viene inizialmente visualizzato nella casella degli strumenti dell'ambiente di sviluppo. È possibile aggiungere una griglia delle proprietà alla casella degli strumenti che consenta di trascinare un oggetto PropertyGrid nel form. È possibile, inoltre, definire un'istanza di PropertyGrid aggiungendo il codice appropriato nel proprio codice sorgente.

Nell'esempio di codice riportato di seguito viene illustrata la creazione di una griglia delle proprietà e l'impostazione della relativa posizione in un form. Per eseguire questo esempio è necessario che sia disponibile un form con un oggetto TextBox.

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

I membri statici pubblici (Shared in Visual Basic) di questo tipo sono validi per le operazioni multithreading. I membri di istanza non sono garantiti come thread safe.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

Supportato in: 2.0 1.1 1.0
Mostra: