DataGridViewImageCell.ValueIsIcon プロパティ

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

DataGridViewImageCell.ValueIsIcon プロパティ

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

このセルに Icon 値を表示するかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property ValueIsIcon As
 Boolean

Visual Basic (使用法)

Dim instance As DataGridViewImageCell
Dim value As Boolean

value = instance.ValueIsIcon

instance.ValueIsIcon = value

C#

public bool ValueIsIcon { get;
 set; }

C++

public:
property bool ValueIsIcon {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_ValueIsIcon ()

/** @property */
public void set_ValueIsIcon (boolean value)

JScript

public function get ValueIsIcon
 () : boolean

public function set ValueIsIcon
 (value : boolean)

プロパティ値
このセルに Icon 値を表示する場合は true。それ以外の場合は false。

解説

Icon 値のアルファ チャネルが正確に描画されるようにするには、このプロパティを true に設定します。このプロパティを true に設定すると、FormattedValueType プロパティおよび ValueType プロパティは、Icon 型を表す Type オブジェクトを返します。

セルを所有している列の ValuesAreIcons プロパティを設定すると、その列に含まれるすべてのセルの ValueIsIcon プロパティも設定され、列の表示が更新されます。各セルの指定した値をオーバーライドするには、列の値を設定してからセルの値を設定します。

新しいレコードの行のセルについて、このプロパティの値が変更された場合、セルに表示されるイメージは、DefaultNewRowValue プロパティの現在の値に更新されます。

列の ValuesAreIcons プロパティとは異なり、セルの ValueIsIcon プロパティの場合、値を変更しても関連付けられたセル スタイルの NullValue プロパティが自動的には更新されることはありません。セルの ValueIsIcon プロパティ値を true に変更した場合は、Style プロパティから返されるオブジェクトの NullValue プロパティを、有効な Icon に設定する必要があります。ValueIsIcon プロパティ値を false に設定した場合は、NullValue プロパティを有効な Image に設定する必要があります。

プラットフォーム

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 クラス
DataGridViewImageCell メンバ
System.Windows.Forms 名前空間
DataGridView クラス
Icon
DataGridViewCell.Value プロパティ
DataGridViewImageCell.FormattedValueType プロパティ
ValueType
DataGridViewImageColumn.ValuesAreIcons