PropertyGrid.PropertySort Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá nebo nastaví typ řazení PropertyGrid použití k zobrazení vlastností.

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

Hodnota vlastnosti

PropertySort

Jedna z PropertySort hodnot. Výchozí hodnota je Categorized nebo Alphabetical.

Výjimky

InvalidEnumArgumentException

Přiřazená hodnota není jednou z PropertySort hodnot.

Příklady

Následující příklad kódu ukazuje inicializaci PropertyGrid ovládacího prvku pomocí PropertySortvlastnosti , ToolbarVisible . Kromě toho tento příklad nastaví PropertyGrid vlastnost ovládacího prvku Visible na false tak, aby při spuštění příkladu nebyla mřížka viditelná. Chcete-li spustit tento příklad, vložte do formuláře následující kód a zavolejte metodu InitializePropertyGrid z konstruktoru formuláře nebo Load metody zpracování událostí. Pokud chcete zobrazit mřížku vlastností, když je formulář spuštěný, změňte vlastnost mřížky Visible na true, rekompilujte a znovu spusťte formulář.

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

Poznámky

Když nastavíte PropertySort vlastnost, vzhled tlačítek pro řazení vlastností v mřížce se změní tak, aby odrážel aktuální stav vlastnosti. Nastavení PropertySort na PropertySort.NoSort způsobí, že se vlastnosti zobrazí v pořadí, v jakém byly načteny.

Nastavení PropertySort na obě Alphabetical hodnoty a Categorized je stejné jako nastavení PropertySort na Categorized samostatně. Zobrazení zařazené do kategorií se vždy zobrazuje podle abecedy.

Poznámka

Pokud chcete provést vlastní řazení, implementujte ICustomTypeDescriptor do komponenty, aby se vrátily vlastnosti v požadovaném pořadí.