DataGridViewTextBoxCell Klasa

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Źródło:

DataGridViewTextBoxCell.cs

Wyświetla edytowalne informacje tekstowe w kontrolce 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

Dziedziczenie

Object

DataGridViewElement

DataGridViewCell

DataGridViewTextBoxCell

Przykłady

W poniższym przykładzie kodu pokazano, jak używać DataGridViewCell elementu jako szablonu dla elementu DataGridViewColumn. Zmiany stylu wprowadzone w dowolnej komórce w kolumnie mają wpływ na wszystkie komórki kolumny. Ten przykład kodu jest częścią większego przykładu udostępnionego dla klasy 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

Uwagi

Klasa DataGridViewTextBoxCell jest wyspecjalizowanym typem DataGridViewCell używanym do wyświetlania pojedynczego ciągu edytowalnych informacji tekstowych. Aktualnie wybrane DataGridViewTextBoxCell hosty kontrolki DataGridViewTextBoxEditingControl , w której użytkownik może edytować wartość komórki (przy założeniu ReadOnly , że właściwość DataGridViewTextBoxCell obiektu jest ustawiona na false).

Jest DataGridViewTextBoxColumn to typ kolumny wyspecjalizowany do przechowywania komórek tego typu. Domyślnie element DataGridViewTextBoxColumn.CellTemplate jest inicjowany do nowego DataGridViewTextBoxCellelementu . Aby wzór komórek w kolumnie po istniejącej DataGridViewTextBoxCellkolumnie, ustaw właściwość kolumny CellTemplate na komórkę, która będzie używana jako wzorzec.

Właściwości związane z komórkami kolumny są otokami dla podobnie nazwanych właściwości komórki szablonu. Zmiana wartości właściwości komórki szablonu będzie mieć wpływ tylko na komórki na podstawie szablonu dodanego po zmianie. Zmiana wartości właściwości związanych z komórkami w kolumnie spowoduje jednak zaktualizowanie komórki szablonu i wszystkich innych komórek w kolumnie oraz odświeżenie w razie potrzeby wyświetlania kolumny.

Notatki dotyczące dziedziczenia

Podczas tworzenia i DataGridViewTextBoxCell dodawania nowych właściwości do klasy pochodnej pamiętaj, aby zastąpić metodę Clone() , aby skopiować nowe właściwości podczas operacji klonowania. Należy również wywołać metodę klasy Clone() bazowej, aby właściwości klasy bazowej zostały skopiowane do nowej komórki.

Konstruktory

Nazwa	Opis
DataGridViewTextBoxCell()	Inicjuje nowe wystąpienie klasy DataGridViewTextBoxCell.

Właściwości

Nazwa	Opis
AccessibilityObject	Pobiera przypisaną DataGridViewCell.DataGridViewCellAccessibleObject wartość do .DataGridViewCell (Odziedziczone po DataGridViewCell)
ColumnIndex	Pobiera indeks kolumn dla tej komórki. (Odziedziczone po DataGridViewCell)
ContentBounds	Pobiera prostokąt ograniczenia, który otacza obszar zawartości komórki. (Odziedziczone po DataGridViewCell)
ContextMenuStrip	Pobiera lub ustawia menu skrótów skojarzone z komórką. (Odziedziczone po DataGridViewCell)
DataGridView	Pobiera kontrolkę DataGridView skojarzona z tym elementem. (Odziedziczone po DataGridViewElement)
DefaultNewRowValue	Pobiera wartość domyślną komórki w wierszu dla nowych rekordów. (Odziedziczone po DataGridViewCell)
Displayed	Pobiera wartość wskazującą, czy komórka jest obecnie wyświetlana na ekranie. (Odziedziczone po DataGridViewCell)
EditedFormattedValue	Pobiera bieżącą, sformatowaną wartość komórki, niezależnie od tego, czy komórka jest w trybie edycji, a wartość nie została zatwierdzona. (Odziedziczone po DataGridViewCell)
EditType	Pobiera typ hostowanej kontrolki edycji komórki. (Odziedziczone po DataGridViewCell)
ErrorIconBounds	Pobiera granice ikony błędu dla komórki. (Odziedziczone po DataGridViewCell)
ErrorText	Pobiera lub ustawia tekst opisujący warunek błędu skojarzony z komórką. (Odziedziczone po DataGridViewCell)
FormattedValue	Pobiera wartość komórki w formacie sformatowany na potrzeby wyświetlania. (Odziedziczone po DataGridViewCell)
FormattedValueType	Pobiera typ sformatowanej wartości skojarzonej z komórką.
Frozen	Pobiera wartość wskazującą, czy komórka jest zamrożona. (Odziedziczone po DataGridViewCell)
HasStyle	Pobiera wartość wskazującą Style , czy właściwość została ustawiona. (Odziedziczone po DataGridViewCell)
InheritedState	Pobiera bieżący stan komórki dziedziczony ze stanu wiersza i kolumny. (Odziedziczone po DataGridViewCell)
InheritedStyle	Pobiera styl aktualnie stosowany do komórki. (Odziedziczone po DataGridViewCell)
IsInEditMode	Pobiera wartość wskazującą, czy ta komórka jest obecnie edytowana. (Odziedziczone po DataGridViewCell)
MaxInputLength	Pobiera lub ustawia maksymalną liczbę znaków, które można wprowadzić w polu tekstowym.
OwningColumn	Pobiera kolumnę zawierającą tę komórkę. (Odziedziczone po DataGridViewCell)
OwningRow	Pobiera wiersz zawierający tę komórkę. (Odziedziczone po DataGridViewCell)
PreferredSize	Pobiera rozmiar w pikselach prostokątnego obszaru, do którego można dopasować komórkę. (Odziedziczone po DataGridViewCell)
ReadOnly	Pobiera lub ustawia wartość wskazującą, czy dane komórki można edytować. (Odziedziczone po DataGridViewCell)
Resizable	Pobiera wartość wskazującą, czy można zmienić rozmiar komórki. (Odziedziczone po DataGridViewCell)
RowIndex	Pobiera indeks wiersza nadrzędnego komórki. (Odziedziczone po DataGridViewCell)
Selected	Pobiera lub ustawia wartość wskazującą, czy komórka została wybrana. (Odziedziczone po DataGridViewCell)
Size	Pobiera rozmiar komórki. (Odziedziczone po DataGridViewCell)
State	Pobiera stan interfejsu użytkownika elementu. (Odziedziczone po DataGridViewElement)
Style	Pobiera lub ustawia styl komórki. (Odziedziczone po DataGridViewCell)
Tag	Pobiera lub ustawia obiekt zawierający dodatkowe dane dotyczące komórki. (Odziedziczone po DataGridViewCell)
ToolTipText	Pobiera lub ustawia tekst etykietki narzędzia skojarzony z tą komórką. (Odziedziczone po DataGridViewCell)
Value	Pobiera lub ustawia wartość skojarzona z tą komórką. (Odziedziczone po DataGridViewCell)
ValueType	Pobiera lub ustawia typ danych wartości w komórce.
Visible	Pobiera wartość wskazującą, czy komórka znajduje się w wierszu, czy w kolumnie, która została ukryta. (Odziedziczone po DataGridViewCell)

Metody

Nazwa	Opis
AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Modyfikuje styl obramowania komórki wejściowej zgodnie z określonymi kryteriami. (Odziedziczone po DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)	Zwraca obiekt Rectangle , który reprezentuje szerokość wszystkich marginesów komórek. (Odziedziczone po DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	Wskazuje, czy wiersz komórki będzie nieudostępniany po kliknięciu komórki. (Odziedziczone po DataGridViewCell)
Clone()	Tworzy dokładną kopię tej komórki.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Wskazuje, czy wiersz komórki będzie nieudostępniany po kliknięciu zawartości komórki. (Odziedziczone po DataGridViewCell)
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Wskazuje, czy wiersz komórki będzie nieudostępniany po dwukrotnym kliknięciu zawartości komórki. (Odziedziczone po DataGridViewCell)
CreateAccessibilityInstance()	Tworzy nowe AccessibleObject dla tego DataGridViewTextBoxCell wystąpienia.
DetachEditingControl()	Usuwa kontrolkę edycji komórki z obiektu DataGridView.
Dispose()	Zwalnia wszystkie zasoby używane przez program DataGridViewCell. (Odziedziczone po DataGridViewCell)
Dispose(Boolean)	Zwalnia niezarządzane zasoby używane przez DataGridViewCell program i opcjonalnie zwalnia zarządzane zasoby. (Odziedziczone po DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Wskazuje, czy wiersz komórki będzie nieudostępniany po dwukrotnym kliknięciu komórki. (Odziedziczone po DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	Wskazuje, czy wiersz nadrzędny będzie nieudostępniany, gdy fokus zostanie przeniesiony do komórki. (Odziedziczone po DataGridViewCell)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Pobiera sformatowaną wartość komórki w celu skopiowania do obiektu Clipboard. (Odziedziczone po DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Zwraca prostokąt ograniczenia, który otacza obszar zawartości komórki, który jest obliczany przy użyciu określonego Graphics i stylu komórki.
GetContentBounds(Int32)	Zwraca prostokąt ograniczenia, który otacza obszar zawartości komórki przy użyciu domyślnego i aktualnie Graphics obowiązującego stylu komórki dla komórki. (Odziedziczone po DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Zwraca bieżącą, sformatowaną wartość komórki, niezależnie od tego, czy komórka jest w trybie edycji, a wartość nie została zatwierdzona. (Odziedziczone po DataGridViewCell)
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Zwraca prostokąt ograniczenia, który otacza ikonę błędu komórki, jeśli jest wyświetlany.
GetErrorText(Int32)	Zwraca ciąg reprezentujący błąd komórki. (Odziedziczone po DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Pobiera wartość komórki w formacie sformatowany na potrzeby wyświetlania. (Odziedziczone po DataGridViewCell)
GetInheritedContextMenuStrip(Int32)	Pobiera dziedziczone menu skrótów dla bieżącej komórki. (Odziedziczone po DataGridViewCell)
GetInheritedState(Int32)	Zwraca wartość wskazującą bieżący stan komórki dziedziczone ze stanu wiersza i kolumny. (Odziedziczone po DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Pobiera styl zastosowany do komórki. (Odziedziczone po DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Oblicza preferowany rozmiar komórki w pikselach.
GetSize(Int32)	Pobiera rozmiar komórki. (Odziedziczone po DataGridViewCell)
GetValue(Int32)	Pobiera wartość komórki. (Odziedziczone po DataGridViewCell)
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Dołącza i inicjuje hostowaną kontrolkę edycji.
KeyDownUnsharesRow(KeyEventArgs, Int32)	Wskazuje, czy wiersz nadrzędny jest nieudostępniany, jeśli użytkownik naciska klawisz, gdy fokus znajduje się na komórce. (Odziedziczone po DataGridViewCell)
KeyEntersEditMode(KeyEventArgs)	Określa, czy tryb edycji powinien być uruchamiany na podstawie danego klucza.
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Wskazuje, czy wiersz będzie nieudostępniany w przypadku naciśnięcia klawisza, gdy komórka w wierszu ma fokus. (Odziedziczone po DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)	Wskazuje, czy wiersz nadrzędny jest nieudostępniany, gdy użytkownik zwalnia klucz, gdy fokus znajduje się na komórce. (Odziedziczone po DataGridViewCell)
LeaveUnsharesRow(Int32, Boolean)	Wskazuje, czy wiersz będzie nieudostępniany, gdy fokus pozostawia komórkę w wierszu. (Odziedziczone po DataGridViewCell)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Wskazuje, czy wiersz będzie nieudostępniany, jeśli użytkownik kliknie przycisk myszy, gdy wskaźnik znajduje się w komórce w wierszu. (Odziedziczone po DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Wskazuje, czy wiersz będzie nieudostępniany, jeśli użytkownik kliknie dwukrotnie komórkę w wierszu. (Odziedziczone po DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Wskazuje, czy wiersz będzie nieudostępniany, gdy użytkownik przytrzymuje przycisk myszy, gdy wskaźnik znajduje się w komórce w wierszu. (Odziedziczone po DataGridViewCell)
MouseEnterUnsharesRow(Int32)	Wskazuje, czy wiersz będzie nieudostępniany, gdy wskaźnik myszy zostanie przeniesiony na komórkę w wierszu. (Odziedziczone po DataGridViewCell)
MouseLeaveUnsharesRow(Int32)	Wskazuje, czy wiersz będzie nieudostępniany, gdy wskaźnik myszy opuszcza wiersz. (Odziedziczone po DataGridViewCell)
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Wskazuje, czy wiersz będzie nieudostępniany, gdy wskaźnik myszy zostanie przeniesiony na komórkę w wierszu. (Odziedziczone po DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Wskazuje, czy wiersz będzie nieudostępniany, gdy użytkownik zwolni przycisk myszy, gdy wskaźnik znajduje się w komórce w wierszu. (Odziedziczone po DataGridViewCell)
OnClick(DataGridViewCellEventArgs)	Wywoływana po kliknięciu komórki. (Odziedziczone po DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)	Wywoływana po kliknięciu zawartości komórki. (Odziedziczone po DataGridViewCell)
OnContentDoubleClick(DataGridViewCellEventArgs)	Wywoływana po dwukrotnym kliknięciu zawartości komórki. (Odziedziczone po DataGridViewCell)
OnDataGridViewChanged()	Wywoływana, DataGridView gdy zmienia się właściwość komórki. (Odziedziczone po DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)	Wywoływana po dwukrotnym kliknięciu komórki. (Odziedziczone po DataGridViewCell)
OnEnter(Int32, Boolean)	Wywoływane przez DataGridView po przesunięciu kursora zaznaczenia na komórkę.
OnKeyDown(KeyEventArgs, Int32)	Wywoływana, gdy klawisz znaku jest naciskany, gdy fokus znajduje się na komórce. (Odziedziczone po DataGridViewCell)
OnKeyPress(KeyPressEventArgs, Int32)	Wywoływana po naciśnięciu klawisza, gdy fokus znajduje się na komórce. (Odziedziczone po DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)	Wywoływana, gdy klucz znaku jest zwalniany, gdy fokus znajduje się na komórce. (Odziedziczone po DataGridViewCell)
OnLeave(Int32, Boolean)	Wywoływana DataGridView przez element , gdy mysz opuszcza komórkę.
OnMouseClick(DataGridViewCellMouseEventArgs)	Wywoływana przez DataGridView , gdy mysz opuszcza komórkę.
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Wywoływana, gdy użytkownik dwukrotnie klika przycisk myszy, gdy wskaźnik znajduje się w komórce. (Odziedziczone po DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)	Wywoływana, gdy użytkownik przytrzymuje przycisk myszy, gdy wskaźnik znajduje się w komórce. (Odziedziczone po DataGridViewCell)
OnMouseEnter(Int32)	Wywoływana, gdy wskaźnik myszy porusza się nad komórką. (Odziedziczone po DataGridViewCell)
OnMouseLeave(Int32)	Wywoływana, gdy wskaźnik myszy opuszcza komórkę. (Odziedziczone po DataGridViewCell)
OnMouseMove(DataGridViewCellMouseEventArgs)	Wywoływana, gdy wskaźnik myszy porusza się w komórce. (Odziedziczone po DataGridViewCell)
OnMouseUp(DataGridViewCellMouseEventArgs)	Wywoływana, gdy użytkownik zwalnia przycisk myszy, gdy wskaźnik znajduje się w komórce. (Odziedziczone po DataGridViewCell)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Maluje bieżący element DataGridViewCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Maluje obramowanie bieżącego DataGridViewCellobiektu . (Odziedziczone po DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Maluje ikonę błędu bieżącego DataGridViewCellelementu . (Odziedziczone po DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Konwertuje wartość sformatowaną do wyświetlania na rzeczywistą wartość komórki. (Odziedziczone po DataGridViewCell)
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Ustawia lokalizację i rozmiar kontrolki edycji hostowanej przez komórkę w kontrolce DataGridView.
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Ustawia lokalizację i rozmiar panelu edycji hostowanego przez komórkę i zwraca normalne granice kontrolki edycji w panelu edycji. (Odziedziczone po DataGridViewCell)
RaiseCellClick(DataGridViewCellEventArgs)	CellClick Wywołuje zdarzenie. (Odziedziczone po DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	CellContentClick Wywołuje zdarzenie. (Odziedziczone po DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	CellContentDoubleClick Wywołuje zdarzenie. (Odziedziczone po DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	CellValueChanged Wywołuje zdarzenie. (Odziedziczone po DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	DataError Wywołuje zdarzenie. (Odziedziczone po DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	MouseWheel Wywołuje zdarzenie. (Odziedziczone po DataGridViewElement)
SetValue(Int32, Object)	Ustawia wartość komórki. (Odziedziczone po DataGridViewCell)
ToString()	Zwraca ciąg opisujący bieżący obiekt.

Zobacz też

• DataGridView
• DataGridViewCell
• DataGridViewTextBoxColumn
• CellTemplate
• DataGridViewTextBoxEditingControl