PropertyGrid.PropertySort プロパティ

.NET Framework クラス ライブラリ リファレンス

PropertyGrid.PropertySort プロパティ

プロパティを表示するために PropertyGrid が使用する並べ替えの種類を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property PropertySort As
 PropertySort

Visual Basic (使用法)

Dim instance As PropertyGrid
Dim value As PropertySort

value = instance.PropertySort

instance.PropertySort = value

C#

public PropertySort PropertySort { get; set;
 }

C++

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

J#

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

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

JScript

public function get PropertySort
 () : PropertySort

public function set PropertySort
 (value : PropertySort)

プロパティ値
PropertySort 値の 1 つ。既定値は PropertySort.Categorized または PropertySort.Alphabetical です。

例外

例外の種類	条件
InvalidEnumArgumentException	代入された値が、PropertySort 値ではありません。

解説

PropertySort プロパティを設定すると、グリッド上のプロパティの並べ替えボタンの外観が変わり、プロパティの現在の状態が反映されます。PropertySort を PropertySort.NoSort に設定すると、プロパティは取得された順序で表示されます。

PropertySort を、Alphabetical および Categorized の両方に設定することは、PropertySort を Categorized だけに設定することと同じです。カテゴリで分類されたビューは、必ずアルファベット順で表示されます。

メモ
カスタムの並べ替えを行うには、コンポーネントに ICustomTypeDescriptor を実装して、希望する順序でプロパティを返すようにします。

使用例

PropertySort プロパティと ToolBarVisible プロパティを使用して PropertyGrid コントロールを初期化する方法を次のコード例に示します。また、この例では、PropertyGrid コントロールの Visible プロパティを false に設定して、例を実行したときにグリッドが表示されないようにしています。この例を実行するには、次のコードをフォームに貼り付けて、フォームのコンストラクタまたは Load のイベント処理メソッドで InitializePropertyGrid メソッドを呼び出します。フォーム実行時にプロパティ グリッドを表示するには、グリッドの Visible プロパティを true に変更し、フォームを再コンパイルして実行します。

C#

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

}

C++

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

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
PropertyGrid クラス
PropertyGrid メンバ
System.Windows.Forms 名前空間