PropertyGrid.PropertySort-Eigenschaft

Ruft den Sortiertyp ab, den PropertyGrid für die Anzeige von Eigenschaften verwendet, oder legt diesen fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Property PropertySort As PropertySort
'Usage
Dim instance As PropertyGrid
Dim value As PropertySort

value = instance.PropertySort

instance.PropertySort = value

public PropertySort PropertySort { get; set; }

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

/** @property */
public PropertySort get_PropertySort ()

/** @property */
public void set_PropertySort (PropertySort value)

public function get PropertySort () : PropertySort

public function set PropertySort (value : PropertySort)

Eigenschaftenwert

Einer der PropertySort-Werte. Der Standardwert ist PropertySort.Categorized oder PropertySort.Alphabetical.

Ausnahmen

Hinweise

Wenn Sie die PropertySort-Eigenschaft festlegen, wird die Darstellung der Schaltflächen für die Eigenschaftensortierung im Datenblatt geändert, um den aktuellen Zustand der Eigenschaft widerzuspiegeln. Wenn PropertySort auf PropertySort.NoSort festgelegt wird, werden die Eigenschaften in der Reihenfolge angezeigt, in der sie abgerufen wurden.

Das Festlegen von PropertySort auf Alphabetical und auf Categorized ist gleichbedeutend mit dem Verfahren, PropertySort nur auf PropertySort.Categorized festzulegen. Die kategorisierte Ansicht wird immer alphabetisch angezeigt.

Beispiel

Im folgenden Codebeispiel wird das Initialisieren eines PropertyGrid-Steuerelements mithilfe der PropertySort-Eigenschaft und der ToolBarVisible-Eigenschaft veranschaulicht. Außerdem wird in diesem Beispiel die Visible-Eigenschaft des PropertyGrid-Steuerelements auf false festgelegt, sodass das Raster beim Ausführen des Beispiels nicht angezeigt wird. Zum Ausführen dieses Beispiels fügen Sie folgenden Code in ein Formular ein und rufen die InitializePropertyGrid-Methode im Konstruktor oder in der Load-Ereignisbehandlungsmethode des Formulars auf. Wenn Sie das Eigenschaftenraster beim Ausführen des Formulars anzeigen möchten, ändern Sie die Visible-Eigenschaft in true. Kompilieren Sie das Formular anschließend neu, und führen Sie es erneut aus.

// 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.
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 );
   }

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

PropertyGrid-Klasse
PropertyGrid-Member
System.Windows.Forms-Namespace