DataGridViewCell Klasa

Definicja

Reprezentuje pojedynczą komórkę w kontrolce DataGridView .

public ref class DataGridViewCell abstract : System::Windows::Forms::DataGridViewElement, ICloneable, IDisposable
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellConverter))]
public abstract class DataGridViewCell : System.Windows.Forms.DataGridViewElement, ICloneable, IDisposable
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellConverter))>]
type DataGridViewCell = class
    inherit DataGridViewElement
    interface ICloneable
    interface IDisposable
Public MustInherit Class DataGridViewCell
Inherits DataGridViewElement
Implements ICloneable, IDisposable
Dziedziczenie
DataGridViewCell
Pochodne
Atrybuty
Implementuje

Przykłady

Poniższy przykład kodu ilustruje użycie tego typu. Aby uzyskać więcej informacji na temat tego przykładu, zobacz How to: Add ToolTips to Individual Cells in a Windows Forms DataGridView Control (Instrukcje: dodawanie etykietek narzędzi do poszczególnych komórek w kontrolce DataGridView) Windows Forms.

// Sets the ToolTip text for cells in the Rating column.
void dataGridView1_CellFormatting(Object^ /*sender*/, 
    DataGridViewCellFormattingEventArgs^ e)
{
    if ( (e->ColumnIndex == this->dataGridView1->Columns["Rating"]->Index)
        && e->Value != nullptr )
    {
        DataGridViewCell^ cell = 
            this->dataGridView1->Rows[e->RowIndex]->Cells[e->ColumnIndex];
        if (e->Value->Equals("*"))
        {                
            cell->ToolTipText = "very bad";
        }
        else if (e->Value->Equals("**"))
        {
            cell->ToolTipText = "bad";
        }
        else if (e->Value->Equals("***"))
        {
            cell->ToolTipText = "good";
        }
        else if (e->Value->Equals("****"))
        {
            cell->ToolTipText = "very good";
        }
    }
}
// Sets the ToolTip text for cells in the Rating column.
void dataGridView1_CellFormatting(object sender, 
    DataGridViewCellFormattingEventArgs e)
{
    if ( (e.ColumnIndex == this.dataGridView1.Columns["Rating"].Index)
        && e.Value != null )
    {
        DataGridViewCell cell = 
            this.dataGridView1.Rows[e.RowIndex].Cells[e.ColumnIndex];
        if (e.Value.Equals("*"))
        {                
            cell.ToolTipText = "very bad";
        }
        else if (e.Value.Equals("**"))
        {
            cell.ToolTipText = "bad";
        }
        else if (e.Value.Equals("***"))
        {
            cell.ToolTipText = "good";
        }
        else if (e.Value.Equals("****"))
        {
            cell.ToolTipText = "very good";
        }
    }
}
' Sets the ToolTip text for cells in the Rating column.
Sub dataGridView1_CellFormatting(ByVal sender As Object, _
    ByVal e As DataGridViewCellFormattingEventArgs) _
    Handles dataGridView1.CellFormatting

    If e.ColumnIndex = Me.dataGridView1.Columns("Rating").Index _
        AndAlso (e.Value IsNot Nothing) Then

        With Me.dataGridView1.Rows(e.RowIndex).Cells(e.ColumnIndex)

            If e.Value.Equals("*") Then
                .ToolTipText = "very bad"
            ElseIf e.Value.Equals("**") Then
                .ToolTipText = "bad"
            ElseIf e.Value.Equals("***") Then
                .ToolTipText = "good"
            ElseIf e.Value.Equals("****") Then
                .ToolTipText = "very good"
            End If

        End With

    End If

End Sub

Uwagi

Klasa DataGridViewCell reprezentuje pojedynczą komórkę w kontrolce DataGridView . Komórki można pobrać za pomocą Cells kolekcji obiektu DataGridViewRow.

Wiersz i kolumna identyfikujące DataGridViewCell lokalizację komórki w obiekcie DataGridView. Typowa komórka zawiera dane specyficzne dla wiersza i kolumny, w której jest zawarta. Komórkę można dostosować na wiele sposobów, ustawiając jej właściwości i obsługując skojarzone z nią zdarzenia.

Uwagi dotyczące implementowania

Po utworzeniu i DataGridViewCell dodaniu 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

DataGridViewCell()

Inicjuje nowe wystąpienie klasy DataGridViewCell.

Właściwości

AccessibilityObject

Pobiera element DataGridViewCell.DataGridViewCellAccessibleObject przypisany do .DataGridViewCell

ColumnIndex

Pobiera indeks kolumn dla tej komórki.

ContentBounds

Pobiera prostokąt ograniczenia, który otacza obszar zawartości komórki.

ContextMenuStrip

Pobiera lub ustawia menu skrótów skojarzone z komórką.

DataGridView

DataGridView Pobiera formant skojarzony z tym elementem.

(Odziedziczone po DataGridViewElement)
DefaultNewRowValue

Pobiera wartość domyślną komórki w wierszu dla nowych rekordów.

Displayed

Pobiera wartość wskazującą, czy komórka jest obecnie wyświetlana na ekranie.

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.

EditType

Pobiera typ hostowanej kontrolki edycji komórki.

ErrorIconBounds

Pobiera granice ikony błędu dla komórki.

ErrorText

Pobiera lub ustawia tekst opisujący warunek błędu skojarzony z komórką.

FormattedValue

Pobiera wartość komórki w formacie sformatowanej do wyświetlenia.

FormattedValueType

Pobiera typ sformatowanej wartości skojarzonej z komórką.

Frozen

Pobiera wartość wskazującą, czy komórka jest zamrożona.

HasStyle

Pobiera wartość wskazującą Style , czy właściwość została ustawiona.

InheritedState

Pobiera bieżący stan komórki jako dziedziczony ze stanu wiersza i kolumny.

InheritedStyle

Pobiera styl aktualnie stosowany do komórki.

IsInEditMode

Pobiera wartość wskazującą, czy ta komórka jest obecnie edytowana.

OwningColumn

Pobiera kolumnę zawierającą tę komórkę.

OwningRow

Pobiera wiersz zawierający tę komórkę.

PreferredSize

Pobiera rozmiar w pikselach prostokątnego obszaru, do którego można dopasować komórkę.

ReadOnly

Pobiera lub ustawia wartość wskazującą, czy dane komórki można edytować.

Resizable

Pobiera wartość wskazującą, czy można zmienić rozmiar komórki.

RowIndex

Pobiera indeks wiersza nadrzędnego komórki.

Selected

Pobiera lub ustawia wartość wskazującą, czy komórka została zaznaczona.

Size

Pobiera rozmiar komórki.

State

Pobiera stan interfejsu użytkownika elementu.

(Odziedziczone po DataGridViewElement)
Style

Pobiera lub ustawia styl komórki.

Tag

Pobiera lub ustawia obiekt zawierający dodatkowe dane dotyczące komórki.

ToolTipText

Pobiera lub ustawia tekst etykietki narzędzia skojarzony z tą komórką.

Value

Pobiera lub ustawia wartość skojarzona z tą komórką.

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.

Metody

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)

Modyfikuje styl obramowania komórki wejściowej zgodnie z określonymi kryteriami.

BorderWidths(DataGridViewAdvancedBorderStyle)

Zwraca obiekt Rectangle , który reprezentuje szerokość wszystkich marginesów komórek.

ClickUnsharesRow(DataGridViewCellEventArgs)

Wskazuje, czy wiersz komórki zostanie anulowany po kliknięciu komórki.

Clone()

Tworzy dokładną kopię tej komórki.

ContentClickUnsharesRow(DataGridViewCellEventArgs)

Wskazuje, czy wiersz komórki zostanie anulowany po kliknięciu zawartości komórki.

ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)

Wskazuje, czy wiersz komórki zostanie anulowany po dwukrotnym kliknięciu zawartości komórki.

CreateAccessibilityInstance()

Tworzy nowy dostępny obiekt dla obiektu DataGridViewCell.

DetachEditingControl()

Usuwa kontrolkę edycji komórki z obiektu DataGridView.

Dispose()

Zwalnia wszelkie zasoby używane przez element DataGridViewCell.

Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element DataGridViewCell i opcjonalnie zwalnia zasoby zarządzane.

DoubleClickUnsharesRow(DataGridViewCellEventArgs)

Wskazuje, czy wiersz komórki zostanie anulowany po dwukrotnym kliknięciu komórki.

EnterUnsharesRow(Int32, Boolean)

Wskazuje, czy wiersz nadrzędny będzie nieudostępniany, gdy fokus zostanie przeniesiony do komórki.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
Finalize()

Zwalnia niezarządzane zasoby i wykonuje inne operacje czyszczenia przed odzyskaniem DataGridViewCell pamięci przez odzyskiwanie pamięci.

GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)

Pobiera sformatowaną wartość komórki w celu skopiowania do obiektu Clipboard.

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 Graphics stylu komórki i aktualnie obowiązującego stylu komórki.

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.

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 dla komórki.

GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)

Pobiera wartość komórki w formacie sformatowanej do wyświetlenia.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetInheritedContextMenuStrip(Int32)

Pobiera dziedziczone menu skrótów dla bieżącej komórki.

GetInheritedState(Int32)

Zwraca wartość wskazującą bieżący stan komórki jako dziedziczony ze stanu wiersza i kolumny.

GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)

Pobiera styl zastosowany do komórki.

GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)

Oblicza preferowany rozmiar komórki w pikselach.

GetSize(Int32)

Pobiera rozmiar komórki.

GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
GetValue(Int32)

Pobiera wartość komórki.

InitializeEditingControl(Int32, Object, DataGridViewCellStyle)

Inicjuje kontrolkę używaną do edytowania komórki.

KeyDownUnsharesRow(KeyEventArgs, Int32)

Wskazuje, czy wiersz nadrzędny jest nieudostępniany, jeśli użytkownik naciska klawisz, gdy fokus znajduje się na komórce.

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.

KeyUpUnsharesRow(KeyEventArgs, Int32)

Wskazuje, czy wiersz nadrzędny jest nieudostępniany, gdy użytkownik zwalnia klucz, gdy fokus znajduje się na komórce.

LeaveUnsharesRow(Int32, Boolean)

Wskazuje, czy wiersz będzie nieudostępniany, gdy fokus pozostawia komórkę w wierszu.

MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags)

Pobiera wysokość w pikselach określonego tekstu, biorąc pod uwagę określone cechy.

MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags, Boolean)

Pobiera wysokość w pikselach określonego tekstu, biorąc pod uwagę określone cechy. Wskazuje również, czy wymagana szerokość jest większa niż określona maksymalna szerokość.

MeasureTextPreferredSize(Graphics, String, Font, Single, TextFormatFlags)

Pobiera idealną wysokość i szerokość określonego tekstu, biorąc pod uwagę określone cechy.

MeasureTextSize(Graphics, String, Font, TextFormatFlags)

Pobiera wysokość i szerokość określonego tekstu, biorąc pod uwagę określone cechy.

MeasureTextWidth(Graphics, String, Font, Int32, TextFormatFlags)

Pobiera szerokość określonego tekstu w pikselach, biorąc pod uwagę określone cechy.

MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
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.

MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)

Wskazuje, czy wiersz będzie nieudostępniany, jeśli użytkownik dwukrotnie kliknie komórkę w wierszu.

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.

MouseEnterUnsharesRow(Int32)

Wskazuje, czy wiersz będzie nieudostępniany, gdy wskaźnik myszy zostanie przeniesiony na komórkę w wierszu.

MouseLeaveUnsharesRow(Int32)

Wskazuje, czy wiersz będzie nieudostępniany, gdy wskaźnik myszy opuści wiersz.

MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)

Wskazuje, czy wiersz będzie nieudostępniany, gdy wskaźnik myszy zostanie przeniesiony na komórkę w wierszu.

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.

OnClick(DataGridViewCellEventArgs)

Wywoływana po kliknięciu komórki.

OnContentClick(DataGridViewCellEventArgs)

Wywoływana po kliknięciu zawartości komórki.

OnContentDoubleClick(DataGridViewCellEventArgs)

Wywoływana, gdy zawartość komórki jest klikana dwukrotnie.

OnDataGridViewChanged()

Wywoływana, DataGridView gdy zmienia się właściwość komórki.

OnDoubleClick(DataGridViewCellEventArgs)

Wywoływana po dwukrotnym kliknięciu komórki.

OnEnter(Int32, Boolean)

Wywoływana, gdy fokus zostanie przeniesiony do komórki.

OnKeyDown(KeyEventArgs, Int32)

Wywoływana, gdy klawisz znaku jest naciśnięty, gdy fokus znajduje się w komórce.

OnKeyPress(KeyPressEventArgs, Int32)

Wywoływana, gdy klawisz jest naciśnięty, gdy fokus znajduje się na komórce.

OnKeyUp(KeyEventArgs, Int32)

Wywoływana, gdy klucz znaku jest zwalniany, gdy fokus znajduje się w komórce.

OnLeave(Int32, Boolean)

Wywoływana, gdy fokus przechodzi z komórki.

OnMouseClick(DataGridViewCellMouseEventArgs)

Wywoływana, gdy użytkownik klika przycisk myszy, gdy wskaźnik znajduje się w komórce.

OnMouseDoubleClick(DataGridViewCellMouseEventArgs)

Wywoływana, gdy użytkownik dwukrotnie klika przycisk myszy, gdy wskaźnik znajduje się w komórce.

OnMouseDown(DataGridViewCellMouseEventArgs)

Wywoływana, gdy użytkownik przytrzymuje przycisk myszy, gdy wskaźnik znajduje się w komórce.

OnMouseEnter(Int32)

Wywoływana, gdy wskaźnik myszy przesuwa się nad komórką.

OnMouseLeave(Int32)

Wywoływana, gdy wskaźnik myszy opuszcza komórkę.

OnMouseMove(DataGridViewCellMouseEventArgs)

Wywoływana, gdy wskaźnik myszy porusza się w komórce.

OnMouseUp(DataGridViewCellMouseEventArgs)

Wywoływana, gdy użytkownik zwalnia przycisk myszy, gdy wskaźnik znajduje się w komórce.

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

PaintErrorIcon(Graphics, Rectangle, Rectangle, String)

Maluje ikonę błędu bieżącego DataGridViewCellelementu .

ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)

Konwertuje wartość sformatowaną do wyświetlania na rzeczywistą wartość komórki.

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.

RaiseCellClick(DataGridViewCellEventArgs)

CellClick Zgłasza zdarzenie.

(Odziedziczone po DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

CellContentClick Zgłasza zdarzenie.

(Odziedziczone po DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

CellContentDoubleClick Zgłasza zdarzenie.

(Odziedziczone po DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

CellValueChanged Zgłasza zdarzenie.

(Odziedziczone po DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

DataError Zgłasza zdarzenie.

(Odziedziczone po DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

MouseWheel Zgłasza zdarzenie.

(Odziedziczone po DataGridViewElement)
SetValue(Int32, Object)

Ustawia wartość komórki.

ToString()

Zwraca ciąg opisujący bieżący obiekt.

Dotyczy

Zobacz też