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 в компоненте , чтобы возвращать свойства в нужном порядке.