DataGridViewTextBoxCell 類別

參考

定義

命名空間:: System.Windows.Forms

組件:: System.Windows.Forms.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

顯示 DataGridView 控制項中可編輯的文字資訊。

public ref class DataGridViewTextBoxCell : System::Windows::Forms::DataGridViewCell

public class DataGridViewTextBoxCell : System.Windows.Forms.DataGridViewCell

type DataGridViewTextBoxCell = class
    inherit DataGridViewCell

Public Class DataGridViewTextBoxCell
Inherits DataGridViewCell

繼承: Object

DataGridViewElement

DataGridViewCell
DataGridViewTextBoxCell

範例

下列程式碼範例示範如何使用 DataGridViewCell 做為的 DataGridViewColumn 範本。對資料行中任何儲存格所做的樣式變更會影響所有資料行的儲存格。此程式碼範例是針對類別提供的較大範例的 DataGridViewColumn 一部分。

void CustomizeCellsInThirdColumn()
{
   int thirdColumn = 2;
   DataGridViewColumn^ column = dataGridView->Columns[ thirdColumn ];
   DataGridViewCell^ cell = gcnew DataGridViewTextBoxCell;
   cell->Style->BackColor = Color::Wheat;
   column->CellTemplate = cell;
}

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

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

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

備註

類別 DataGridViewTextBoxCell 是特製化的類型 DataGridViewCell ，用來顯示單一可編輯文字資訊字串。目前選取 DataGridViewTextBoxCell 的會裝載 DataGridViewTextBoxEditingControl 控制項，其中使用者可以編輯儲存格的值， (假設 ReadOnly 的 DataGridViewTextBoxCell 屬性設定為 false) 。

DataGridViewTextBoxColumn是特製化用來保存此類型儲存格的資料行類型。根據預設，會 DataGridViewTextBoxColumn.CellTemplate 初始化為新的 DataGridViewTextBoxCell 。若要在現有 DataGridViewTextBoxCell 之後建立資料行內儲存格的圖樣，請將資料 CellTemplate 行的屬性設定為要當做圖樣使用的儲存格。

資料行的儲存格相關屬性是樣板儲存格類似名稱屬性的包裝函式。變更範本儲存格的屬性值只會根據變更之後新增的範本影響儲存格。不過，變更資料行的資料格相關屬性值將會更新範本儲存格和資料行中的所有其他儲存格，並視需要重新整理資料行顯示。

給繼承者的注意事項

當您衍生自 DataGridViewTextBoxCell 並新增屬性至衍生類別時，請務必覆寫 Clone() 方法，以在複製作業期間複製新屬性。您也應該呼叫基類 Clone() 的方法，以便基類的屬性複製到新的儲存格。

建構函式

DataGridViewTextBoxCell()

初始化 DataGridViewTextBoxCell 類別的新執行個體。

屬性

AccessibilityObject	取得指定給 DataGridViewCell.DataGridViewCellAccessibleObject 的 DataGridViewCell。 (繼承來源 DataGridViewCell)
ColumnIndex	取得這個儲存格的資料行索引。 (繼承來源 DataGridViewCell)
ContentBounds	取得圍住儲存格內容區域的周框。 (繼承來源 DataGridViewCell)
ContextMenuStrip	取得或設定與儲存格相關聯的捷徑功能表。 (繼承來源 DataGridViewCell)
DataGridView	取得與這個項目有關聯的 DataGridView 控制項。 (繼承來源 DataGridViewElement)
DefaultNewRowValue	取得新資料錄之資料列中儲存格的預設值。 (繼承來源 DataGridViewCell)
Displayed	取得值，該值表示儲存格目前是否顯示於螢幕上。 (繼承來源 DataGridViewCell)
EditedFormattedValue	取得目前已格式化的儲存格值，不管儲存格是否處於編輯模式，而值是否尚未認可。 (繼承來源 DataGridViewCell)
EditType	取得儲存格的裝載編輯控制項型別。 (繼承來源 DataGridViewCell)
ErrorIconBounds	取得儲存格之錯誤圖示的界限。 (繼承來源 DataGridViewCell)
ErrorText	取得或設定文字，描述與儲存格相關聯的錯誤狀況。 (繼承來源 DataGridViewCell)
FormattedValue	取得儲存格的格式化值，以供顯示。 (繼承來源 DataGridViewCell)
FormattedValueType	取得與儲存格相關聯之格式化值的類型。
Frozen	取得指出是否已凍結此儲存格的值。 (繼承來源 DataGridViewCell)
HasStyle	取得指出是否已經設定 Style 屬性的值。 (繼承來源 DataGridViewCell)
InheritedState	取得儲存格的目前狀態，是繼承其資料列和資料行的狀態。 (繼承來源 DataGridViewCell)
InheritedStyle	取得目前套用至儲存格的樣式。 (繼承來源 DataGridViewCell)
IsInEditMode	取得指出目前是否正在編輯這個儲存格的值。 (繼承來源 DataGridViewCell)
MaxInputLength	取得或設定可輸入文字方塊中的最大字元數。
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)
ValueType	取得或設定儲存格中值的資料類型。
Visible	取得指出儲存格是在已隱藏資料列或是資料行中的值。 (繼承來源 DataGridViewCell)

方法

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	根據指定的準則，修改輸入儲存格框線樣式。 (繼承來源 DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)	傳回 Rectangle，表示所有儲存格邊界的寬度。 (繼承來源 DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	指出當按下儲存格時，儲存格的資料列是否會取消共用。 (繼承來源 DataGridViewCell)
Clone()	建立與這個儲存格完全相同的複本。
ContentClickUnsharesRow(DataGridViewCellEventArgs)	指出當按下儲存格內容時，儲存格的資料列是否會取消共用。 (繼承來源 DataGridViewCell)
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	指出當按兩下儲存格內容時，儲存格的資料列是否會取消共用。 (繼承來源 DataGridViewCell)
CreateAccessibilityInstance()	為此 DataGridViewTextBoxCell 執行個體建立新的 AccessibleObject。
CreateAccessibilityInstance()	為 DataGridViewCell 建立新的可存取物件。 (繼承來源 DataGridViewCell)
DetachEditingControl()	從 DataGridView 中移除儲存格的編輯控制項。
Dispose()	釋放 DataGridViewCell 所使用的所有資源。 (繼承來源 DataGridViewCell)
Dispose(Boolean)	釋放 DataGridViewCell 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	指出當按兩下儲存格時，儲存格的資料列是否會取消共用。 (繼承來源 DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	指出當焦點移至儲存格時，是否將取消共用父資料列。 (繼承來源 DataGridViewCell)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	擷取儲存格的已格式化的值，以複製到 Clipboard。 (繼承來源 DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	傳回圍住儲存格內容區域的週框，這個內容區域是使用指定的 Graphics 和儲存格樣式所計算。
GetContentBounds(Int32)	使用預設的 Graphics 和目前儲存格中所採用的儲存格樣式，傳回圍住儲存格內容區域的周框。 (繼承來源 DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	傳回目前已格式化的儲存格值，不管儲存格是否處於編輯模式，而值是否尚未認可。 (繼承來源 DataGridViewCell)
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	傳回圍住儲存格的錯誤圖示之週框 (如果有此圖示)。
GetErrorText(Int32)	傳回表示儲存格錯誤的字串。 (繼承來源 DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	取得儲存格的格式化值，以供顯示。 (繼承來源 DataGridViewCell)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetInheritedContextMenuStrip(Int32)	取得目前儲存格的繼承捷徑功能表。 (繼承來源 DataGridViewCell)
GetInheritedState(Int32)	傳回值，指出儲存格的目前狀態是從其資料列和資料行的狀態繼承而來。 (繼承來源 DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	取得套用到儲存格的樣式。 (繼承來源 DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	計算儲存格的慣用大小 (以像素為單位)。
GetSize(Int32)	取得儲存格的大小。 (繼承來源 DataGridViewCell)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
GetValue(Int32)	取得儲存格的值。 (繼承來源 DataGridViewCell)
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	附加及初始化裝載的編輯控制項。
KeyDownUnsharesRow(KeyEventArgs, Int32)	指出當焦點在儲存格上，而使用者按下按鍵時，是否取消共用父資料列。 (繼承來源 DataGridViewCell)
KeyEntersEditMode(KeyEventArgs)	判斷是否應該根據指定的按鍵啟動編輯模式。
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	指出如果當焦點在資料列中的儲存格時按下按鍵，是否會取消資料列的共用。 (繼承來源 DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)	指出當焦點在儲存格上，而使用者放開按鍵時，是否會取消父資料列的共用。 (繼承來源 DataGridViewCell)
LeaveUnsharesRow(Int32, Boolean)	指出當焦點移出資料列中的儲存格時，是否取消共用該資料列。 (繼承來源 DataGridViewCell)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	指出當指標在資料列的儲存格上，而使用者按一下滑鼠按鈕時，該資料列是否取消共用。 (繼承來源 DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	指出當使用者按兩下資料列中的儲存格時，是否取消共用該資料列。 (繼承來源 DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	指出當指標在資料列的儲存格上，而按住滑鼠按鈕時，該資料列是否取消共用。 (繼承來源 DataGridViewCell)
MouseEnterUnsharesRow(Int32)	指出當滑鼠指標移到某資料列的儲存格上方時，是否取消共用該資料列。 (繼承來源 DataGridViewCell)
MouseLeaveUnsharesRow(Int32)	指示當滑鼠指標離開某列時，該列是否共用。 (繼承來源 DataGridViewCell)
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	指出當滑鼠指標移到某資料列的儲存格上方時，是否取消共用該資料列。 (繼承來源 DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	指出當指標在資料列的儲存格上，而使用者釋放滑鼠按鈕時，該資料列是否取消共用。 (繼承來源 DataGridViewCell)
OnClick(DataGridViewCellEventArgs)	當按下儲存格時呼叫。 (繼承來源 DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)	當按下儲存格內容時呼叫。 (繼承來源 DataGridViewCell)
OnContentDoubleClick(DataGridViewCellEventArgs)	當按兩下儲存格內容時呼叫。 (繼承來源 DataGridViewCell)
OnDataGridViewChanged()	當儲存格的 DataGridView 屬性變更時呼叫。 (繼承來源 DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)	當按兩下儲存格時呼叫。 (繼承來源 DataGridViewCell)
OnEnter(Int32, Boolean)	當選取游標移到儲存格上時由 DataGridView 所呼叫。
OnKeyDown(KeyEventArgs, Int32)	當焦點在儲存格上，按下字元鍵時即會呼叫。 (繼承來源 DataGridViewCell)
OnKeyPress(KeyPressEventArgs, Int32)	當焦點在儲存格上，按下按鍵時呼叫。 (繼承來源 DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)	當焦點在儲存格上，放開字元鍵時呼叫。 (繼承來源 DataGridViewCell)
OnLeave(Int32, Boolean)	當滑鼠離開儲存格時由 DataGridView 所呼叫。
OnMouseClick(DataGridViewCellMouseEventArgs)	當滑鼠離開儲存格時由 DataGridView 所呼叫。
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	當滑鼠指標在儲存格上，使用者按兩下滑鼠按鈕時呼叫。 (繼承來源 DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)	當滑鼠指標在儲存格上，使用者按住滑鼠按鈕時呼叫。 (繼承來源 DataGridViewCell)
OnMouseEnter(Int32)	當滑鼠指標移到儲存格上方時呼叫。 (繼承來源 DataGridViewCell)
OnMouseLeave(Int32)	當滑鼠指標離開儲存格時呼叫。 (繼承來源 DataGridViewCell)
OnMouseMove(DataGridViewCellMouseEventArgs)	當滑鼠指標移到儲存格內時呼叫。 (繼承來源 DataGridViewCell)
OnMouseUp(DataGridViewCellMouseEventArgs)	當滑鼠指標在儲存格上，使用者放開滑鼠按鈕時呼叫。 (繼承來源 DataGridViewCell)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	繪製目前的 DataGridViewCell。
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	繪製目前 DataGridViewCell 的框線。 (繼承來源 DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	繪製目前 DataGridViewCell 的錯誤圖示。 (繼承來源 DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	將為了顯示而格式化的值轉換成實際的儲存格值。 (繼承來源 DataGridViewCell)
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	設定 DataGridView 控制項中的儲存格所裝載之編輯控制項的位置和大小。
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	設定由儲存格裝載之編輯面板的位置和大小，並傳回編輯面板中編輯控制項的標準界限。 (繼承來源 DataGridViewCell)
RaiseCellClick(DataGridViewCellEventArgs)	引發 CellClick 事件。 (繼承來源 DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	引發 CellContentClick 事件。 (繼承來源 DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	引發 CellContentDoubleClick 事件。 (繼承來源 DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	引發 CellValueChanged 事件。 (繼承來源 DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	引發 DataError 事件。 (繼承來源 DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	引發 MouseWheel 事件。 (繼承來源 DataGridViewElement)
SetValue(Int32, Object)	設定儲存格的值。 (繼承來源 DataGridViewCell)
ToString()	傳回描述目前物件的字串。

適用於

共用方式為

DataGridViewTextBoxCell 類別

定義

範例

備註

給繼承者的注意事項

建構函式

屬性

方法

適用於

另請參閱

其他資源