DataGridViewImageCell クラス

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

DataGridViewImageCell クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

DataGridView コントロール内にグラフィックを表示します。

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

Visual Basic (宣言)

Public Class DataGridViewImageCell
    Inherits DataGridViewCell

Visual Basic (使用法)

Dim instance As DataGridViewImageCell

C#

public class DataGridViewImageCell : DataGridViewCell

C++

public ref class DataGridViewImageCell : public
 DataGridViewCell

J#

public class DataGridViewImageCell extends
 DataGridViewCell

JScript

public class DataGridViewImageCell extends
 DataGridViewCell

解説

DataGridViewImageCell クラスは DataGridViewCell の特殊な型で、ValueIsIcon プロパティの値に応じて Image または Icon を表示するために使用されます。通常、DataGridViewImageCell の ReadOnly プロパティは true に設定されるため、ユーザーはセルの内容を編集できません。

DataGridViewImageColumn は、この種類のセルを保持するための特殊な列型です。既存の DataGridViewImageCell を列に含まれる他のセルのモデルにするには、そのセルを列の CellTemplate プロパティに設定します。既定では、CellTemplate は新しい DataGridViewImageCell に初期化されます。

列のセル関連プロパティは、テンプレート セルの類似した名前を持つプロパティのラッパーです。テンプレート セルのプロパティ値を変更すると、そのテンプレートをベースとするセルのうち、変更後に追加されたものにのみ変更が反映されます。一方、列のセル関連プロパティを変更すると、テンプレート セル、および列内の他のすべてのセルが更新され、必要に応じて列の表示が更新されます。

継承時の注意 DataGridViewImageCell からクラスを派生させて新しいプロパティを追加する場合は、Clone メソッドをオーバーライドして、クローン操作時に新しいプロパティをコピーする必要があります。また、基本クラスの Clone メソッドも呼び出して、基本クラスのプロパティが新しいセルにコピーされるようにする必要があります。

使用例

DataGridViewColumn のテンプレートとして DataGridViewCell を使用する方法のコード例を次に示します。列のセルのスタイルの変更は、その列のすべてのセルに影響します。このコード例は、DataGridViewColumn クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

Private Sub CustomizeCellsInThirdColumn()

    Dim thirdColumn As Integer
 = 2
    Dim column As DataGridViewColumn = _
        dataGridView.Columns(thirdColumn)
    Dim cell As DataGridViewCell = _
        New DataGridViewTextBoxCell()

    cell.Style.BackColor = Color.Wheat
    column.CellTemplate = cell
End Sub

C#

private void CustomizeCellsInThirdColumn()
{
    int thirdColumn = 2;
    DataGridViewColumn column =
        dataGridView.Columns[thirdColumn];
    DataGridViewCell cell = new DataGridViewTextBoxCell();

    cell.Style.BackColor = Color.Wheat;
    column.CellTemplate = cell;
}

継承階層

System.Object
   System.Windows.Forms.DataGridViewElement
     System.Windows.Forms.DataGridViewCell
      System.Windows.Forms.DataGridViewImageCell

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

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