ColumnHeader.ImageIndex プロパティ

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

ColumnHeader.ImageIndex プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ColumnHeader に表示されるイメージのインデックスを取得または設定します。

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

Visual Basic (宣言)

Public Property ImageIndex As
 Integer

Visual Basic (使用法)

Dim instance As ColumnHeader
Dim value As Integer

value = instance.ImageIndex

instance.ImageIndex = value

C#

public int ImageIndex { get;
 set; }

C++

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

J#

/** @property */
public int get_ImageIndex ()

/** @property */
public void set_ImageIndex (int
 value)

JScript

public function get ImageIndex
 () : int

public function set ImageIndex
 (value : int)

プロパティ値
ColumnHeader に表示されるイメージのインデックス。

例外

例外の種類	条件
ArgumentOutOfRangeException	ImageIndex が -1 未満です。

解説

ImageIndex プロパティは、ColumnHeader を含む ListView の SmallImageList プロパティで指定されたイメージのインデックスを参照します。コンテナである ListView に SmallImageList が設定されていない場合、ImageIndex プロパティは -1 を返します。列内に表示されるイメージは、通常、列内の項目の状態を示すために使用されます。

ImageKey と ImageIndex は、同時に指定できません。つまり、一方が設定されると、もう一方は無効な値に設定され、無視されます。

ColumnHeader に関連付けられたイメージは、通常、状態情報を示すために使用されます。ImageIndex を、関連付けられたイメージのリストにおける最後の項目のインデックスよりも大きい値に設定すると、ImageIndex は、イメージ リストにおける最後の項目のインデックスに設定されます。

使用例

ColumnHeader の ImageIndex、ImageKey、および DisplayIndex の各プロパティを設定する方法を、次のコード例に示します。この例を実行するには、コードを Windows フォームに貼り付け、フォームのコンストラクタまたは Load のイベント処理メソッドから、InitializeListViewColumns を呼び出します。

プラットフォーム

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

参照

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