DataGridViewImageColumn.ImageLayout プロパティ

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

DataGridViewImageColumn.ImageLayout プロパティ

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

この列のセルのイメージのレイアウトを取得または設定します。

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

Visual Basic (宣言)

Public Property ImageLayout As
 DataGridViewImageCellLayout

Visual Basic (使用法)

Dim instance As DataGridViewImageColumn
Dim value As DataGridViewImageCellLayout

value = instance.ImageLayout

instance.ImageLayout = value

C#

public DataGridViewImageCellLayout ImageLayout { get;
 set; }

C++

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

J#

/** @property */
public DataGridViewImageCellLayout get_ImageLayout ()

/** @property */
public void set_ImageLayout (DataGridViewImageCellLayout
 value)

JScript

public function get ImageLayout
 () : DataGridViewImageCellLayout

public function set ImageLayout
 (value : DataGridViewImageCellLayout)

プロパティ値
セルのレイアウトを指定する DataGridViewImageCellLayout。既定値は Normal です。

例外

例外の種類	条件
InvalidOperationException	CellTemplate プロパティの値が null 参照 (Visual Basic では Nothing) です。

解説

このプロパティを取得または設定すると、CellTemplate プロパティによって返されるオブジェクトの ImageLayout プロパティを取得または設定できます。このプロパティを設定すると、列に含まれるすべてのセルの ImageLayout プロパティも設定され、列の表示が更新されます。各セルの指定した値をオーバーライドするには、列の値を設定してからセルの値を設定します。

使用例

次のコード例は、イメージをセルに合わせて伸縮および拡大縮小する方法を示しています。次の例は「方法 : Windows フォーム DataGridView コントロールのイメージ列を操作する」で取り上げている例の一部です。

Visual Basic

Private Sub Stretch(ByVal
 sender As Object, _
    ByVal e As EventArgs) Handles
 Button3.Click

    For Each column As DataGridViewImageColumn
 _
        In dataGridView1.Columns
        column.ImageLayout = DataGridViewImageCellLayout.Stretch
        column.Description = "Stretched image layout"
    Next
End Sub

Private Sub ZoomToImage(ByVal
 sender As Object, _
    ByVal e As EventArgs) Handles
 Button4.Click

    For Each column As DataGridViewImageColumn
 _
        In dataGridView1.Columns
        column.ImageLayout = DataGridViewImageCellLayout.Zoom
        column.Description = "Zoomed image layout"
    Next
End Sub

Private Sub NormalImage(ByVal
 sender As Object, _
    ByVal e As EventArgs) Handles
 Button5.Click

    For Each column As DataGridViewImageColumn
 _
        In dataGridView1.Columns
        column.ImageLayout = DataGridViewImageCellLayout.Normal
        column.Description = "Normal image layout"
    Next
End Sub

C#

private void Stretch(object sender, EventArgs
 e)
{
    foreach (DataGridViewImageColumn column in
        dataGridView1.Columns)
    {
        column.ImageLayout = DataGridViewImageCellLayout.Stretch;
        column.Description = "Stretched";
    }
}

private void ZoomToImage(object sender, EventArgs
 e)
{

    foreach (DataGridViewImageColumn column in
        dataGridView1.Columns)
    {
        column.ImageLayout = DataGridViewImageCellLayout.Zoom;
        column.Description = "Zoomed";
    }
}

private void NormalImage(object sender, EventArgs
 e)
{

    foreach (DataGridViewImageColumn column in
        dataGridView1.Columns)
    {
        column.ImageLayout = DataGridViewImageCellLayout.Normal;
        column.Description = "Normal";
    }
}

プラットフォーム

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 クラス
DataGridViewImageCellLayout 列挙体
DataGridViewImageColumn.CellTemplate プロパティ
DataGridViewImageCell クラス
DataGridViewImageCell.ImageLayout プロパティ