PropertyGrid.PropertySort PropertyGrid.PropertySort PropertyGrid.PropertySort PropertyGrid.PropertySort Property

Definición

Obtiene o establece el tipo de ordenación que utiliza PropertyGrid para mostrar propiedades.Gets or sets the type of sorting the PropertyGrid uses to display properties.

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

Valor de propiedad

Uno de los valores de PropertySort.One of the PropertySort values. El valor predeterminado es Categorized o Alphabetical.The default is Categorized or Alphabetical.

Excepciones

El valor asignado no es uno de los valores de PropertySort.The assigned value is not one of the PropertySort values.

Ejemplos

En el ejemplo de código siguiente se PropertyGrid muestra cómo inicializar ToolbarVisible un control mediante las PropertySortpropiedades,.The following code example demonstrates initializing a PropertyGrid control using the PropertySort, ToolbarVisible properties. Además, este ejemplo establece la PropertyGrid propiedad del Visible control en para false que la cuadrícula no sea visible cuando se ejecute el ejemplo.In addition, this example sets the PropertyGrid control's Visible property to false so the grid will not be visible when the example is run. Para ejecutar este ejemplo, pegue el siguiente código en un formulario y llame InitializePropertyGrid al método desde el constructor del formulario Load o el método de control de eventos.To run this example paste the following code in a form and call the InitializePropertyGrid method from the form's constructor or Load event-handling method. Para ver la cuadrícula de propiedades cuando se está ejecutando el formulario, cambie la Visible propiedad de truela cuadrícula a, vuelva a compilar y vuelva a ejecutar el formulario.To view the property grid when the form is running, change the grid's Visible property to true, recompile, and rerun the form.

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

Comentarios

Al establecer la PropertySort propiedad, la apariencia de los botones de ordenación de propiedades en la cuadrícula cambia para reflejar el estado actual de la propiedad.When you set the PropertySort property, the appearance of the property sort buttons on the grid changes to reflect the current state of the property. Si PropertySort se PropertySort.NoSort establece en, las propiedades se muestran en el orden en que se recuperan.Setting PropertySort to PropertySort.NoSort causes the properties to be displayed in the order they were retrieved.

Establecer PropertySort PropertySort Categorized en y esCategorized lo mismo que establecer en solo. AlphabeticalSetting PropertySort to both Alphabetical and Categorized is the same as setting PropertySort to Categorized alone. La vista por categorías siempre se muestra en orden alfabético.The categorized view is always shown as alphabetical.

Nota

Para realizar una ordenación personalizada, ICustomTypeDescriptor implemente en el componente para devolver las propiedades en el orden deseado.To do custom sorting, implement ICustomTypeDescriptor on the component to return the properties in the desired order.

Se aplica a