DataGridViewImageCell 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
顯示 DataGridView 控制項中的圖形。
public ref class DataGridViewImageCell : System::Windows::Forms::DataGridViewCellpublic class DataGridViewImageCell : System.Windows.Forms.DataGridViewCelltype DataGridViewImageCell = class
inherit DataGridViewCellPublic Class DataGridViewImageCell
Inherits DataGridViewCell- 繼承
範例
下列程式碼範例示範如何使用 來變更影像資料格 DataGridViewCell 中的影像。 此程式碼範例是針對如何：在 DataGridView 控制項 Windows Forms中使用影像資料行主題所提供的較大範例的一部分。
void dataGridView1_CellClick( Object^ sender, DataGridViewCellEventArgs^ e )
{
if ( turn->Equals( gameOverString ) )
{
return;
}
DataGridViewImageCell^ cell = dynamic_cast<DataGridViewImageCell^>(dataGridView1->Rows[ e->RowIndex ]->Cells[ e->ColumnIndex ]);
if ( cell->Value == blank )
{
if ( IsOsTurn() )
{
cell->Value = o;
}
else
{
cell->Value = x;
}
ToggleTurn();
}
if ( IsAWin( cell ) )
{
turn->Text = gameOverString;
}
}
private void dataGridView1_CellClick(object sender,
DataGridViewCellEventArgs e)
{
if (turn.Text.Equals(gameOverString)) { return; }
DataGridViewImageCell cell = (DataGridViewImageCell)
dataGridView1.Rows[e.RowIndex].Cells[e.ColumnIndex];
if (cell.Value == blank)
{
if (IsOsTurn())
{
cell.Value = o;
}
else
{
cell.Value = x;
}
ToggleTurn();
}
if (IsAWin())
{
turn.Text = gameOverString;
}
}
Private Sub dataGridView1_CellClick(ByVal sender As Object, _
ByVal e As DataGridViewCellEventArgs) _
Handles dataGridView1.CellClick
If turn.Text.Equals(gameOverString) Then Return
Dim cell As DataGridViewImageCell = _
CType(dataGridView1.Rows(e.RowIndex). _
Cells(e.ColumnIndex), DataGridViewImageCell)
If (cell.Value Is blank) Then
If IsOsTurn() Then
cell.Value = o
Else
cell.Value = x
End If
ToggleTurn()
ToolTip(e)
End If
If IsAWin() Then
turn.Text = gameOverString
End If
End Sub
備註
類別 DataGridViewImageCell 是特製化型別， DataGridViewCell 用來顯示 Image 或 Icon ，視 屬性的值 ValueIsIcon 而定。 一般而言， ReadOnly 的 DataGridViewImageCell 屬性設定為 true ，表示使用者無法編輯儲存格內容。
DataGridViewImageColumn是特製化用來保存此類型儲存格的資料行類型。 根據預設，會將 DataGridViewImageColumn.CellTemplate 初始化為新的 DataGridViewImageCell 。 若要在現有 DataGridViewImageCell 之後建立資料行內儲存格的圖樣，請將資料行的 CellTemplate 屬性設定為要當做圖樣使用的儲存格。
資料行的儲存格相關屬性是樣板儲存格之類似名稱屬性的包裝函式。 變更範本儲存格的屬性值只會根據變更之後新增的範本，影響儲存格。 不過，變更資料行的儲存格相關屬性值將會更新範本儲存格和資料行中的所有其他儲存格，並視需要重新整理資料行顯示。
給繼承者的注意事項
當您衍生自 DataGridViewImageCell 並將新屬性新增至衍生類別時，請務必覆寫 Clone() 方法，以在複製作業期間複製新屬性。 您也應該呼叫基類的 Clone() 方法，以便基類的屬性複製到新的儲存格。
建構函式
| DataGridViewImageCell() |
初始化 DataGridViewImageCell 類別的新執行個體，將它設定為要與 Icon 物件之外的儲存格值一起使用。 |
| DataGridViewImageCell(Boolean) |
初始化 DataGridViewImageCell 類別的新執行個體，選擇性地將它設定為要與 Icon 儲存格值一起使用。 |
屬性
| AccessibilityObject |
取得指定給 DataGridViewCell.DataGridViewCellAccessibleObject 的 DataGridViewCell。 (繼承來源 DataGridViewCell) |
| ColumnIndex |
取得這個儲存格的資料行索引。 (繼承來源 DataGridViewCell) |
| ContentBounds |
取得圍住儲存格內容區域的周框。 (繼承來源 DataGridViewCell) |
| ContextMenuStrip |
取得或設定與儲存格相關聯的捷徑功能表。 (繼承來源 DataGridViewCell) |
| DataGridView |
取得與這個項目有關聯的 DataGridView 控制項。 (繼承來源 DataGridViewElement) |
| DefaultNewRowValue |
取得建立新資料列時所用的預設值。 |
| Description |
取得或設定與影像相關的文字。 |
| Displayed |
取得值，該值表示儲存格目前是否顯示於螢幕上。 (繼承來源 DataGridViewCell) |
| EditedFormattedValue |
取得目前已格式化的儲存格值，不管儲存格是否處於編輯模式，而值是否尚未認可。 (繼承來源 DataGridViewCell) |
| EditType |
取得儲存格的裝載編輯控制項型別。 |
| ErrorIconBounds |
取得儲存格之錯誤圖示的界限。 (繼承來源 DataGridViewCell) |
| ErrorText |
取得或設定文字，描述與儲存格相關聯的錯誤狀況。 (繼承來源 DataGridViewCell) |
| FormattedValue |
取得儲存格的格式化值，以供顯示。 (繼承來源 DataGridViewCell) |
| FormattedValueType |
取得與儲存格相關聯之格式化值的類型。 |
| Frozen |
取得指出是否已凍結此儲存格的值。 (繼承來源 DataGridViewCell) |
| HasStyle |
取得指出是否已經設定 Style 屬性的值。 (繼承來源 DataGridViewCell) |
| ImageLayout |
取得或設定儲存格的圖形配置。 |
| InheritedState |
取得儲存格的目前狀態，是繼承其資料列和資料行的狀態。 (繼承來源 DataGridViewCell) |
| InheritedStyle |
取得目前套用至儲存格的樣式。 (繼承來源 DataGridViewCell) |
| IsInEditMode |
取得指出目前是否正在編輯這個儲存格的值。 (繼承來源 DataGridViewCell) |
| OwningColumn |
取得包含這個儲存格的資料行。 (繼承來源 DataGridViewCell) |
| OwningRow |
取得包含這個儲存格的資料列。 (繼承來源 DataGridViewCell) |
| PreferredSize |
取得能夠容納儲存格的矩形區域大小 (以像素為單位)。 (繼承來源 DataGridViewCell) |
| ReadOnly |
取得或設定值，指出是否可以編輯儲存格的資料。 (繼承來源 DataGridViewCell) |
| Resizable |
取得指出儲存格是否可以調整大小的值。 (繼承來源 DataGridViewCell) |
| RowIndex |
取得儲存格的父資料列索引。 (繼承來源 DataGridViewCell) |
| Selected |
取得或設定值，指出是否已選取此儲存格。 (繼承來源 DataGridViewCell) |
| Size |
取得儲存格的大小。 (繼承來源 DataGridViewCell) |
| State |
取得此項目的使用者介面 (UI) 狀態。 (繼承來源 DataGridViewElement) |
| Style |
取得或設定儲存格的樣式。 (繼承來源 DataGridViewCell) |
| Tag |
取得或設定物件，其中包含儲存格的相關補充資料。 (繼承來源 DataGridViewCell) |
| ToolTipText |
取得或設定與這個儲存格相關聯的工具提示文字。 (繼承來源 DataGridViewCell) |
| Value |
取得或設定與這個儲存格相關聯的值。 (繼承來源 DataGridViewCell) |
| ValueIsIcon |
取得或設定值，指出這個儲存格是否顯示 Icon 值。 |
| ValueType |
取得或設定儲存格中值的資料類型。 |
| Visible |
取得指出儲存格是在已隱藏資料列或是資料行中的值。 (繼承來源 DataGridViewCell) |
