PropertyGrid.PropertySort Свойство

Определение

Возвращает или задает тип сортировки, используемой объектом PropertyGrid при отображении свойств.

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

Значение свойства

Одно из значений перечисления PropertySort. Значение по умолчанию — Categorized или Alphabetical.

Исключения

Присваиваемое значение не относится к значениям PropertySort.

Примеры

В следующем примере кода демонстрируется PropertyGrid инициализация элемента управления с помощью PropertySortсвойств , ToolbarVisible . Кроме того, в этом примере свойству PropertyGrid элемента управления Visible присваивается значение false , поэтому сетка не будет видна при выполнении примера. Чтобы выполнить этот пример, вставьте следующий код в форму и вызовите InitializePropertyGrid метод из конструктора формы или Load метода обработки событий. Чтобы просмотреть сетку свойств при выполнении формы, измените свойство сетки Visible на true, перекомпилируйте и повторно запустите форму.

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

Комментарии

При установке PropertySort свойства внешний вид кнопок сортировки свойств в сетке изменяется в соответствии с текущим состоянием свойства. Если задано значение PropertySort , PropertySort.NoSort свойства будут отображаться в том порядке, в котором они были извлечены.

Для параметра PropertySort и Alphabetical задано то же самое, что и Categorized для параметра PropertySort значение в одиночку Categorized . Представление с категорией всегда отображается в алфавитном порядке.

Примечание

Чтобы выполнить пользовательскую сортировку, реализуйте ICustomTypeDescriptor в компоненте , чтобы возвращать свойства в нужном порядке.

Применяется к