DataGridViewImageColumn.Image プロパティ

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

DataGridViewImageColumn.Image プロパティ

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

セルの Value プロパティが設定されておらず、セルの ValueIsIcon プロパティが false に設定されている場合に、この列のセルに表示されるイメージを取得または設定します。

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

Visual Basic (宣言)

Public Property Image As
 Image

Visual Basic (使用法)

Dim instance As DataGridViewImageColumn
Dim value As Image

value = instance.Image

instance.Image = value

C#

public Image Image { get; set;
 }

C++

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

J#

/** @property */
public Image get_Image ()

/** @property */
public void set_Image (Image value)

JScript

public function get Image
 () : Image

public function set Image
 (value : Image)

プロパティ値
表示する Image。既定値は null 参照 (Visual Basic では Nothing) です。

解説

Image プロパティは、列がデータにバインドされておらず、セルの ValueIsIcon プロパティが false に設定されている場合に、値を持たないセルに表示されるイメージを指定します。セルにイメージが関連付けられていないデータ バインド列には、標準のエラー グラフィックが表示されます。

Image ではなく Icon を表示する場合は、Icon プロパティを設定し、ValuesAreIcons プロパティを true に設定します。これにより、Icon のアルファ チャネルが正確に描画されます。また、各セルの ValueIsIcon プロパティを設定すると、セル値が存在しない場合に、セルに Image と Icon のどちらのプロパティ値を表示するかを指定できます。

使用例

既定のイメージを設定する方法を次のコード例に示します。次の例は「方法 : Windows フォーム DataGridView コントロールのイメージ列を操作する」で取り上げている例の一部です。

Visual Basic

Private Sub CreateColumns()

    Dim imageColumn As DataGridViewImageColumn
    Dim columnCount As Integer
 = 0
    Do
        Dim unMarked As Bitmap = blank
        imageColumn = New DataGridViewImageColumn()

        ' Add twice the padding for the left and 
        ' right sides of the cell.
        imageColumn.Width = x.Width + 2 * bitmapPadding + 1

        imageColumn.Image = unMarked
        imageColumn.ImageLayout = DataGridViewImageCellLayout.NotSet
        imageColumn.Description = "default image layout"
        dataGridView1.Columns.Add(imageColumn)
        columnCount = columnCount + 1
    Loop While columnCount < 3
End Sub

C#

private void CreateColumns()
{
    DataGridViewImageColumn imageColumn;
    int columnCount = 0;
    do
    {
        Bitmap unMarked = blank;
        imageColumn = new DataGridViewImageColumn();

        //Add twice the padding for the left and 
        //right sides of the cell.
        imageColumn.Width = x.Width + 2 * bitmapPadding + 1;

        imageColumn.Image = unMarked;
        dataGridView1.Columns.Add(imageColumn);
        columnCount = columnCount + 1;
    }
    while (columnCount < 3);
}

プラットフォーム

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

参照

関連項目
DataGridViewImageColumn クラス
DataGridViewImageColumn メンバ
System.Windows.Forms 名前空間
DataGridView クラス
Image
Icon
Icon
ValuesAreIcons
DataGridViewImageCell.ValueIsIcon