DataGridViewTextBoxCell Klasa

Definicja

Namespace:

System.Windows.Forms

Montaż:

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ć elementu DataGridViewCell jako szablonu dla elementu DataGridViewColumn. Zmiany stylu wprowadzone w dowolnej komórce w kolumnie wpływają na wszystkie komórki kolumny. Ten przykład kodu jest częścią większego przykładu podanego DataGridViewColumn dla klasy.

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 używanym DataGridViewCell do wyświetlania pojedynczego ciągu edytowalnych informacji tekstowych. Aktualnie wybrane hosty DataGridViewTextBoxEditingControl kontrolki, w której użytkownik może edytować wartość komórki (przy założeniuReadOnly, że właściwość DataGridViewTextBoxCell jest ustawiona na false).DataGridViewTextBoxCell

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

Właściwości powiązane z komórką kolumny są otoki 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 powiązanej z komórką kolumny spowoduje jednak zaktualizowanie komórki szablonu i wszystkich innych komórek w kolumnie oraz odświeżenie wyświetlania kolumny w razie potrzeby.

Notatki dla spadkobierców

Podczas tworzenia DataGridViewTextBoxCell i dodawania nowych właściwości do klasy pochodnej należy zastąpić Clone() metodę w celu skopiowania nowych 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.

Konstruktorów

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

Właściwości

Nazwa	Opis
AccessibilityObject	Pobiera element DataGridViewCell.DataGridViewCellAccessibleObject przypisany do .DataGridViewCell (Dziedziczone od DataGridViewCell)
ColumnIndex	Pobiera indeks kolumn dla tej komórki. (Dziedziczone od DataGridViewCell)
ContentBounds	Pobiera prostokąt ograniczenia, który otacza obszar zawartości komórki. (Dziedziczone od DataGridViewCell)
ContextMenuStrip	Pobiera lub ustawia menu skrótów skojarzone z komórką. (Dziedziczone od DataGridViewCell)
DataGridView	DataGridView Pobiera formant skojarzony z tym elementem. (Dziedziczone od DataGridViewElement)
DefaultNewRowValue	Pobiera wartość domyślną komórki w wierszu dla nowych rekordów. (Dziedziczone od DataGridViewCell)
Displayed	Pobiera wartość wskazującą, czy komórka jest obecnie wyświetlana na ekranie. (Dziedziczone od 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. (Dziedziczone od DataGridViewCell)
EditType	Pobiera typ hostowanej kontrolki edycji komórki. (Dziedziczone od DataGridViewCell)
ErrorIconBounds	Pobiera granice ikony błędu dla komórki. (Dziedziczone od DataGridViewCell)
ErrorText	Pobiera lub ustawia tekst opisujący warunek błędu skojarzony z komórką. (Dziedziczone od DataGridViewCell)
FormattedValue	Pobiera wartość komórki w formacie sformatowanej do wyświetlenia. (Dziedziczone od DataGridViewCell)
FormattedValueType	Pobiera typ sformatowanej wartości skojarzonej z komórką.
Frozen	Pobiera wartość wskazującą, czy komórka jest zamrożona. (Dziedziczone od DataGridViewCell)
HasStyle	Pobiera wartość wskazującą Style , czy właściwość została ustawiona. (Dziedziczone od DataGridViewCell)
InheritedState	Pobiera bieżący stan komórki jako dziedziczony ze stanu wiersza i kolumny. (Dziedziczone od DataGridViewCell)
InheritedStyle	Pobiera styl aktualnie stosowany do komórki. (Dziedziczone od DataGridViewCell)
IsInEditMode	Pobiera wartość wskazującą, czy ta komórka jest obecnie edytowana. (Dziedziczone od 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ę. (Dziedziczone od DataGridViewCell)
OwningRow	Pobiera wiersz zawierający tę komórkę. (Dziedziczone od DataGridViewCell)
PreferredSize	Pobiera rozmiar w pikselach prostokątnego obszaru, do którego można dopasować komórkę. (Dziedziczone od DataGridViewCell)
ReadOnly	Pobiera lub ustawia wartość wskazującą, czy dane komórki można edytować. (Dziedziczone od DataGridViewCell)
Resizable	Pobiera wartość wskazującą, czy można zmienić rozmiar komórki. (Dziedziczone od DataGridViewCell)
RowIndex	Pobiera indeks wiersza nadrzędnego komórki. (Dziedziczone od DataGridViewCell)
Selected	Pobiera lub ustawia wartość wskazującą, czy komórka została zaznaczona. (Dziedziczone od DataGridViewCell)
Size	Pobiera rozmiar komórki. (Dziedziczone od DataGridViewCell)
State	Pobiera stan interfejsu użytkownika elementu. (Dziedziczone od DataGridViewElement)
Style	Pobiera lub ustawia styl komórki. (Dziedziczone od DataGridViewCell)
Tag	Pobiera lub ustawia obiekt zawierający dodatkowe dane dotyczące komórki. (Dziedziczone od DataGridViewCell)
ToolTipText	Pobiera lub ustawia tekst etykietki narzędzia skojarzony z tą komórką. (Dziedziczone od DataGridViewCell)
Value	Pobiera lub ustawia wartość skojarzona z tą komórką. (Dziedziczone od 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. (Dziedziczone od DataGridViewCell)

Metody

Nazwa	Opis
AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Modyfikuje styl obramowania komórki wejściowej zgodnie z określonymi kryteriami. (Dziedziczone od DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)	Zwraca obiekt Rectangle , który reprezentuje szerokość wszystkich marginesów komórek. (Dziedziczone od DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	Wskazuje, czy wiersz komórki zostanie anulowany po kliknięciu komórki. (Dziedziczone od DataGridViewCell)
Clone()	Tworzy dokładną kopię tej komórki.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Wskazuje, czy wiersz komórki zostanie anulowany po kliknięciu zawartości komórki. (Dziedziczone od DataGridViewCell)
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Wskazuje, czy wiersz komórki zostanie anulowany po dwukrotnym kliknięciu zawartości komórki. (Dziedziczone od DataGridViewCell)
CreateAccessibilityInstance()	Tworzy nowe AccessibleObject dla tego DataGridViewTextBoxCell wystąpienia.
DetachEditingControl()	Usuwa kontrolkę edycji komórki z elementu DataGridView.
Dispose()	Zwalnia wszelkie zasoby używane przez element DataGridViewCell. (Dziedziczone od DataGridViewCell)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element DataGridViewCell i opcjonalnie zwalnia zasoby zarządzane. (Dziedziczone od DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Wskazuje, czy wiersz komórki zostanie anulowany po dwukrotnym kliknięciu komórki. (Dziedziczone od DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	Wskazuje, czy wiersz nadrzędny będzie nieudostępniany, gdy fokus zostanie przeniesiony do komórki. (Dziedziczone od DataGridViewCell)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Pobiera sformatowaną wartość komórki w celu skopiowania do obiektu Clipboard. (Dziedziczone od 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 stylu komórki i komórki.
GetContentBounds(Int32)	Zwraca prostokąt ograniczenia, który otacza obszar zawartości komórki przy użyciu domyślnego Graphics stylu komórki i aktualnie obowiązującego stylu komórki. (Dziedziczone od 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. (Dziedziczone od DataGridViewCell)
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Zwraca prostokąt ograniczenia, który otacza ikonę błędu komórki, jeśli zostanie wyświetlony.
GetErrorText(Int32)	Zwraca ciąg reprezentujący błąd dla komórki. (Dziedziczone od DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Pobiera wartość komórki w formacie sformatowanej do wyświetlenia. (Dziedziczone od DataGridViewCell)
GetInheritedContextMenuStrip(Int32)	Pobiera dziedziczone menu skrótów dla bieżącej komórki. (Dziedziczone od DataGridViewCell)
GetInheritedState(Int32)	Zwraca wartość wskazującą bieżący stan komórki jako dziedziczony ze stanu wiersza i kolumny. (Dziedziczone od DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Pobiera styl zastosowany do komórki. (Dziedziczone od DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Oblicza preferowany rozmiar w pikselach komórki.
GetSize(Int32)	Pobiera rozmiar komórki. (Dziedziczone od DataGridViewCell)
GetValue(Int32)	Pobiera wartość komórki. (Dziedziczone od 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. (Dziedziczone od DataGridViewCell)
KeyEntersEditMode(KeyEventArgs)	Określa, czy tryb edycji powinien zostać uruchomiony 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. (Dziedziczone od DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)	Wskazuje, czy wiersz nadrzędny jest nieudostępniany, gdy użytkownik zwalnia klucz, gdy fokus znajduje się na komórce. (Dziedziczone od DataGridViewCell)
LeaveUnsharesRow(Int32, Boolean)	Wskazuje, czy wiersz będzie nieudostępniany, gdy fokus pozostawia komórkę w wierszu. (Dziedziczone od 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. (Dziedziczone od DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Wskazuje, czy wiersz będzie nieudostępniany, jeśli użytkownik dwukrotnie kliknie komórkę w wierszu. (Dziedziczone od 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. (Dziedziczone od DataGridViewCell)
MouseEnterUnsharesRow(Int32)	Wskazuje, czy wiersz będzie nieudostępniany, gdy wskaźnik myszy zostanie przeniesiony na komórkę w wierszu. (Dziedziczone od DataGridViewCell)
MouseLeaveUnsharesRow(Int32)	Wskazuje, czy wiersz będzie nieudostępniany, gdy wskaźnik myszy opuści wiersz. (Dziedziczone od DataGridViewCell)
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Wskazuje, czy wiersz będzie nieudostępniany, gdy wskaźnik myszy zostanie przeniesiony na komórkę w wierszu. (Dziedziczone od 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. (Dziedziczone od DataGridViewCell)
OnClick(DataGridViewCellEventArgs)	Wywoływana po kliknięciu komórki. (Dziedziczone od DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)	Wywoływana po kliknięciu zawartości komórki. (Dziedziczone od DataGridViewCell)
OnContentDoubleClick(DataGridViewCellEventArgs)	Wywoływana, gdy zawartość komórki jest klikana dwukrotnie. (Dziedziczone od DataGridViewCell)
OnDataGridViewChanged()	Wywoływana, DataGridView gdy zmienia się właściwość komórki. (Dziedziczone od DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)	Wywoływana po dwukrotnym kliknięciu komórki. (Dziedziczone od 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 naciśnięty, gdy fokus znajduje się w komórce. (Dziedziczone od DataGridViewCell)
OnKeyPress(KeyPressEventArgs, Int32)	Wywoływana, gdy klawisz jest naciśnięty, gdy fokus znajduje się na komórce. (Dziedziczone od DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)	Wywoływana, gdy klucz znaku jest zwalniany, gdy fokus znajduje się w komórce. (Dziedziczone od DataGridViewCell)
OnLeave(Int32, Boolean)	Wywoływane DataGridView przez, gdy mysz opuszcza komórkę.
OnMouseClick(DataGridViewCellMouseEventArgs)	Wywoływane 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. (Dziedziczone od DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)	Wywoływana, gdy użytkownik przytrzymuje przycisk myszy, gdy wskaźnik znajduje się w komórce. (Dziedziczone od DataGridViewCell)
OnMouseEnter(Int32)	Wywoływana, gdy wskaźnik myszy przesuwa się nad komórką. (Dziedziczone od DataGridViewCell)
OnMouseLeave(Int32)	Wywoływana, gdy wskaźnik myszy opuszcza komórkę. (Dziedziczone od DataGridViewCell)
OnMouseMove(DataGridViewCellMouseEventArgs)	Wywoływana, gdy wskaźnik myszy porusza się w komórce. (Dziedziczone od DataGridViewCell)
OnMouseUp(DataGridViewCellMouseEventArgs)	Wywoływana, gdy użytkownik zwalnia przycisk myszy, gdy wskaźnik znajduje się w komórce. (Dziedziczone od 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 .DataGridViewCell (Dziedziczone od DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Maluje ikonę błędu bieżącego DataGridViewCellelementu . (Dziedziczone od DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Konwertuje wartość sformatowaną do wyświetlania na rzeczywistą wartość komórki. (Dziedziczone od 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. (Dziedziczone od DataGridViewCell)
RaiseCellClick(DataGridViewCellEventArgs)	CellClick Zgłasza zdarzenie. (Dziedziczone od DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	CellContentClick Zgłasza zdarzenie. (Dziedziczone od DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	CellContentDoubleClick Zgłasza zdarzenie. (Dziedziczone od DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	CellValueChanged Zgłasza zdarzenie. (Dziedziczone od DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	DataError Zgłasza zdarzenie. (Dziedziczone od DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	MouseWheel Zgłasza zdarzenie. (Dziedziczone od DataGridViewElement)
SetValue(Int32, Object)	Ustawia wartość komórki. (Dziedziczone od DataGridViewCell)
ToString()	Zwraca ciąg opisujący bieżący obiekt.

Zobacz także

• DataGridView
• DataGridViewCell
• DataGridViewTextBoxColumn
• CellTemplate
• DataGridViewTextBoxEditingControl