PropertyGrid.PropertySort Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia typ sortowania używanych do wyświetlania PropertyGrid właściwości.

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

Wartość właściwości

PropertySort

PropertySort Jedna z wartości. Wartość domyślna to Categorized lub Alphabetical.

Wyjątki

InvalidEnumArgumentException

Przypisana wartość nie jest jedną z PropertySort wartości.

Przykłady

W poniższym przykładzie kodu pokazano inicjowanie kontrolki PropertyGrid przy użyciu PropertySortwłaściwości , ToolbarVisible . Ponadto w tym przykładzie ustawiono PropertyGrid właściwość kontrolki Visible na false , aby siatka nie będzie widoczna po uruchomieniu przykładu. Aby uruchomić ten przykład, wklej następujący kod w formularzu i wywołaj InitializePropertyGrid metodę z konstruktora formularza lub Load metody obsługi zdarzeń. Aby wyświetlić siatkę właściwości po uruchomieniu formularza, zmień właściwość siatki Visible na true, ponownie skompiluj i uruchom ponownie formularz.

   // 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

Uwagi

Po ustawieniu PropertySort właściwości wygląd przycisków sortowania właściwości w siatce zmienia się w celu odzwierciedlenia bieżącego stanu właściwości. Ustawienie PropertySort powoduje PropertySort.NoSort wyświetlanie właściwości w kolejności, w której zostały pobrane.

Ustawienie PropertySort wartości i AlphabeticalCategorized jest takie samo jak ustawienie PropertySort dla Categorized samego ustawienia. Widok podzielony na kategorie jest zawsze wyświetlany jako alfabetyczny.

Uwaga

Aby przeprowadzić sortowanie niestandardowe, zaimplementuj ICustomTypeDescriptor na składniku, aby zwrócić właściwości w żądanej kolejności.