ListView.ColumnHeaderCollection.Insert メソッド (Int32, String, Int32, HorizontalAlignment)

新しい列ヘッダーを作成し、コレクション内の指定したインデックス位置に挿入します。

Overloads Public Sub Insert( _
   ByVal index As Integer, _   ByVal str As String, _   ByVal width As Integer, _   ByVal textAlign As HorizontalAlignment _)
[C#]
public void Insert(intindex,stringstr,intwidth,HorizontalAlignmenttextAlign);
[C++]
public: void Insert(intindex,String* str,intwidth,HorizontalAlignmenttextAlign);
[JScript]
public function Insert(
   index : int,str : String,width : int,textAlign : HorizontalAlignment);

パラメータ

  • index
    列ヘッダーが挿入される、0 から始まるインデックス番号の位置。
  • str
    列ヘッダーに表示されるテキスト。
  • width
    列ヘッダーの初期の幅。この値を -1 に設定すると、列ヘッダーのサイズは列の最も大きいサブ項目のテキストのサイズに自動的に変更されます。-2 に設定すると、列ヘッダーのサイズは列ヘッダーのテキストのサイズに自動的に変更されます。
  • textAlign
    HorizontalAlignment 値の 1 つ。

例外

例外の種類 条件
ArgumentOutOfRangeException index パラメータの値が、0 未満または ListView.ColumnHeaderCollectionCount プロパティの値以上です。

解説

このバージョンの Insert メソッドを使用すると、特定の列ヘッダーのテキスト、幅、およびテキストの配置の設定を使用して新しい ColumnHeader を作成し、 ListView.ColumnHeaderCollection 内の特定の位置に挿入できます。新しい列ヘッダーを列ヘッダーの既存のコレクションに挿入する場合は、このメソッドを使用できます。既存の ColumnHeader オブジェクトを使用して、コレクションの特定の位置に挿入する場合は、他のバージョンの Insert メソッドを使用します。コレクションの特定の位置を指定せずに列ヘッダーを追加するには、 Add メソッドを使用します。列ヘッダーの配列をコレクションに追加する場合は、 AddRange メソッドを使用します。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

ListView.ColumnHeaderCollection クラス | ListView.ColumnHeaderCollection メンバ | System.Windows.Forms 名前空間 | ListView.ColumnHeaderCollection.Insert オーバーロードの一覧 | Add | AddRange