DataGridViewImageColumn.DefaultCellStyle プロパティ

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

DataGridViewImageColumn.DefaultCellStyle プロパティ

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

列の既定のセル スタイルを取得または設定します。

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

Visual Basic (宣言)

Public Overrides Property
 DefaultCellStyle As DataGridViewCellStyle

Visual Basic (使用法)

Dim instance As DataGridViewImageColumn
Dim value As DataGridViewCellStyle

value = instance.DefaultCellStyle

instance.DefaultCellStyle = value

C#

public override DataGridViewCellStyle DefaultCellStyle { get;
 set; }

C++

public:
virtual property DataGridViewCellStyle^ DefaultCellStyle {
    DataGridViewCellStyle^ get () override;
    void set (DataGridViewCellStyle^ value)
 override;
}

J#

/** @property */
public DataGridViewCellStyle get_DefaultCellStyle ()

/** @property */
public void set_DefaultCellStyle (DataGridViewCellStyle
 value)

JScript

public override function get
 DefaultCellStyle () : DataGridViewCellStyle

public override function set
 DefaultCellStyle (value : DataGridViewCellStyle)

プロパティ値
既定スタイルとして適用される DataGridViewCellStyle。

解説

このプロパティによって返される既定の DataGridViewCellStyle には、次の初期プロパティ値が設定されています。

DataGridViewCellStyle プロパティ	既定値
Alignment	DataGridViewContentAlignment.MiddleCenter
NullValue	ValuesAreIcons プロパティの初期値が true の場合は Icon 型の標準のエラー グラフィック。それ以外の場合は、Bitmap 型の標準のエラー グラフィック。

これらの値は、DataGridView コントロールの DefaultCellStyle プロパティで指定された値をオーバーライドしますが、他のセル スタイル プロパティでオーバーライドすることもできます。詳細については、「Windows フォーム DataGridView コントロールでのセルのスタイル」を参照してください。

セルの値が null 参照 (Visual Basic では Nothing) または DBNull.Value である場合に標準のエラー グラフィックが表示されないようにするには、コントロールに行を追加する前に、このセル スタイル オブジェクトの DataGridViewCellStyle.NullValue プロパティを null 参照 (Visual Basic では Nothing) に設定するか、独自のエラー グラフィックに設定します。ただし、この設定は新しいレコードの行には適用されません。コントロールの AllowUserToAddRows プロパティの値が true である場合に、新しいレコードの行にエラー グラフィックが表示されないようにするには、コントロールの RowsAdded イベントのハンドラ内でセルの値を明示的に null 参照 (Visual Basic では Nothing) (または独自のエラー グラフィック) に設定するか、DefaultNewRowValue プロパティをオーバーライドして null 参照 (Visual Basic では Nothing) (または独自のエラー グラフィック) を返すようにした DataGridViewImageCell の派生型のインスタンスを、列の CellTemplate プロパティに設定する必要があります。

DefaultCellStyle プロパティによって返されたオブジェクトの NullValue プロパティが、Bitmap 型の標準のエラー グラフィックと等しい値を持つ場合、ValuesAreIcons プロパティの値を true に変更すると、NullValue が Icon 型の標準のエラー グラフィックに自動的に設定されます。NullValue が Icon 型の標準のエラー グラフィックと等しい値を持つ場合、ValuesAreIcons プロパティの値を false に変更すると、NullValue が Bitmap 型の標準のエラー グラフィックに自動的に設定されます。

使用例

このプロパティの使用方法のコード例を次に示します。

Visual Basic

Private Sub ChangeColumnAlignment()
    songsDataGridView.Columns("Title").DefaultCellStyle.Alignment
 = DataGridViewContentAlignment.BottomCenter
    songsDataGridView.Columns("Title").Name = DataGridViewContentAlignment.BottomCenter.ToString()

    songsDataGridView.Columns("Artist").DefaultCellStyle.Alignment
 = DataGridViewContentAlignment.BottomLeft
    songsDataGridView.Columns("Artist").Name = DataGridViewContentAlignment.BottomLeft.ToString()

    songsDataGridView.Columns("Album").DefaultCellStyle.Alignment
 = DataGridViewContentAlignment.BottomRight
    songsDataGridView.Columns("Album").Name = DataGridViewContentAlignment.BottomRight.ToString()

    songsDataGridView.Columns("Release Date").DefaultCellStyle.Alignment
 = DataGridViewContentAlignment.MiddleCenter
    songsDataGridView.Columns("Release Date").Name
 = DataGridViewContentAlignment.MiddleCenter.ToString()

    songsDataGridView.Columns("Track").DefaultCellStyle.Alignment
 = DataGridViewContentAlignment.MiddleLeft
    songsDataGridView.Columns("Track").Name = DataGridViewContentAlignment.MiddleLeft.ToString()
End Sub

C#

private void ChangeColumnAlignment()
{
    songsDataGridView.Columns["Title"].DefaultCellStyle.Alignment = DataGridViewContentAlignment.BottomCenter;
    songsDataGridView.Columns["Title"].Name = DataGridViewContentAlignment.BottomCenter.ToString();

    songsDataGridView.Columns["Artist"].DefaultCellStyle.Alignment = DataGridViewContentAlignment.BottomLeft;
    songsDataGridView.Columns["Artist"].Name = DataGridViewContentAlignment.BottomLeft.ToString();

    songsDataGridView.Columns["Album"].DefaultCellStyle.Alignment = DataGridViewContentAlignment.BottomRight;
    songsDataGridView.Columns["Album"].Name = DataGridViewContentAlignment.BottomRight.ToString();

    songsDataGridView.Columns["Release Date"].DefaultCellStyle.Alignment
 = DataGridViewContentAlignment.MiddleCenter;
    songsDataGridView.Columns["Release Date"].Name = DataGridViewContentAlignment.MiddleCenter.ToString();

    songsDataGridView.Columns["Track"].DefaultCellStyle.Alignment = DataGridViewContentAlignment.MiddleLeft;
    songsDataGridView.Columns["Track"].Name = DataGridViewContentAlignment.MiddleLeft.ToString();
}

J#

private void ChangeColumnAlignment()
{
    songsDataGridView.get_Columns().get_Item("Title").get_DefaultCellStyle().
        set_Alignment(DataGridViewContentAlignment.BottomCenter);
    songsDataGridView.get_Columns().get_Item("Title").
        set_Name(DataGridViewContentAlignment.BottomCenter.ToString());

    songsDataGridView.get_Columns().get_Item("Artist").
        get_DefaultCellStyle().set_Alignment(DataGridViewContentAlignment.
        BottomLeft);
    songsDataGridView.get_Columns().get_Item("Artist").set_Name(
        DataGridViewContentAlignment.BottomLeft.ToString());

    songsDataGridView.get_Columns().get_Item("Album").
        get_DefaultCellStyle().set_Alignment(DataGridViewContentAlignment.
        BottomRight);
    songsDataGridView.get_Columns().get_Item("Album").set_Name(
        DataGridViewContentAlignment.BottomRight.ToString());

    songsDataGridView.get_Columns().get_Item("Release Date").
        get_DefaultCellStyle().set_Alignment(DataGridViewContentAlignment.
        MiddleCenter);
    songsDataGridView.get_Columns().get_Item("Release Date").set_Name(
        DataGridViewContentAlignment.MiddleCenter.ToString());

    songsDataGridView.get_Columns().get_Item("Track").
        get_DefaultCellStyle().set_Alignment(DataGridViewContentAlignment.
        MiddleLeft);
    songsDataGridView.get_Columns().get_Item("Track").set_Name(
        DataGridViewContentAlignment.MiddleLeft.ToString());
} //ChangeColumnAlignment

プラットフォーム

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 クラス
DataGridView.DefaultCellStyle プロパティ
DataGridViewCellStyle クラス
その他の技術情報
Windows フォーム DataGridView コントロールでのセルのスタイル