PropertyGrid.PropertySort Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta il tipo di ordinamento utilizzato da PropertyGrid per visualizzare le proprietà.

public:
 property System::Windows::Forms::PropertySort PropertySort { System::Windows::Forms::PropertySort get(); void set(System::Windows::Forms::PropertySort value); };

public System.Windows.Forms.PropertySort PropertySort { get; set; }

member this.PropertySort : System.Windows.Forms.PropertySort with get, set

Public Property PropertySort As PropertySort

Valore della proprietà

PropertySort

Uno dei valori di PropertySort. Il valore predefinito è Categorized o Alphabetical.

Eccezioni

InvalidEnumArgumentException

Il valore assegnato non è uno dei valori di PropertySort.

Esempio

Nell'esempio di codice seguente viene illustrata l'inizializzazione di un PropertyGrid controllo usando le PropertySortproprietà , ToolbarVisible . Inoltre, in questo esempio la PropertyGrid proprietà del Visible controllo viene impostata su false in modo che la griglia non sia visibile quando viene eseguito l'esempio. Per eseguire questo esempio, incollare il codice seguente in una maschera e chiamare il InitializePropertyGrid metodo dal costruttore o Load dal metodo di gestione degli eventi del modulo. Per visualizzare la griglia delle proprietà quando il modulo è in esecuzione, modificare la proprietà della Visible griglia in true, ricompilare ed eseguire di nuovo il modulo.

   // Declare a propertyGrid.
internal:
   PropertyGrid^ propertyGrid1;

private:

   // Initialize propertyGrid1.
   [PermissionSetAttribute(SecurityAction::Demand, Name="FullTrust")]
   void InitializePropertyGrid()
   {
      propertyGrid1 = gcnew PropertyGrid;
      propertyGrid1->Name = "PropertyGrid1";
      propertyGrid1->Location = System::Drawing::Point( 185, 20 );
      propertyGrid1->Size = System::Drawing::Size( 150, 300 );
      propertyGrid1->TabIndex = 5;
      
      // Set the sort to alphabetical and set Toolbar visible
      // to false, so the user cannot change the sort.
      propertyGrid1->PropertySort = PropertySort::Alphabetical;
      propertyGrid1->ToolbarVisible = false;
      propertyGrid1->Text = "Property Grid";
      
      // Add the PropertyGrid to the form, but set its
      // visibility to False so it will not appear when the form loads.
      propertyGrid1->Visible = false;
      this->Controls->Add( propertyGrid1 );
   }

// Declare a propertyGrid.
internal PropertyGrid propertyGrid1;

// Initialize propertyGrid1.
private void InitializePropertyGrid()
{
    propertyGrid1 = new PropertyGrid();
    propertyGrid1.Name = "PropertyGrid1";
    propertyGrid1.Location = new System.Drawing.Point(185, 20);
    propertyGrid1.Size = new System.Drawing.Size(150, 300);
    propertyGrid1.TabIndex = 5;

    // Set the sort to alphabetical and set Toolbar visible
    // to false, so the user cannot change the sort.
    propertyGrid1.PropertySort = PropertySort.Alphabetical;
    propertyGrid1.ToolbarVisible = false;
    propertyGrid1.Text = "Property Grid";

    // Add the PropertyGrid to the form, but set its
    // visibility to False so it will not appear when the form loads.
    propertyGrid1.Visible = false;
    this.Controls.Add(propertyGrid1);
}

'Declare a propertyGrid.
Friend WithEvents propertyGrid1 As PropertyGrid

'Initialize propertyGrid1.
Private Sub InitializePropertyGrid()
    propertyGrid1 = New PropertyGrid
    propertyGrid1.Name = "PropertyGrid1"
    propertyGrid1.Location = New Point(185, 20)
    propertyGrid1.Size = New System.Drawing.Size(150, 300)
    propertyGrid1.TabIndex = 5

    'Set the sort to alphabetical and set Toolbar visible
    'to false, so the user cannot change the sort.
    propertyGrid1.PropertySort = PropertySort.Alphabetical
    propertyGrid1.ToolbarVisible = False
    propertyGrid1.Text = "Property Grid"

    ' Add the PropertyGrid to the form, but set its
    ' visibility to False so it will not appear when the form loads.
    propertyGrid1.Visible = False
    Me.Controls.Add(propertyGrid1)

End Sub

Commenti

Quando si imposta la PropertySort proprietà, l'aspetto dei pulsanti di ordinamento delle proprietà nella griglia cambia in modo da riflettere lo stato corrente della proprietà. Se si imposta PropertySort su PropertySort.NoSort , le proprietà verranno visualizzate nell'ordine in cui sono state recuperate.

L'impostazione PropertySort su e AlphabeticalCategorized equivale all'impostazione PropertySortCategorized su sola. La visualizzazione categorizzata viene sempre visualizzata in ordine alfabetico.

Nota

Per eseguire l'ordinamento personalizzato, implementare ICustomTypeDescriptor nel componente per restituire le proprietà nell'ordine desiderato.