DataGridViewCell Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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: Object

DataGridViewElement
DataGridViewCell

Pochodne: System.Windows.Forms.DataGridViewButtonCell

System.Windows.Forms.DataGridViewCheckBoxCell

System.Windows.Forms.DataGridViewComboBoxCell

System.Windows.Forms.DataGridViewHeaderCell

System.Windows.Forms.DataGridViewImageCell

Więcej…

Atrybuty: TypeConverterAttribute

Implementuje: ICloneable IDisposable

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

Udostępnij za pośrednictwem