DataGridViewImageCell 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.

Wyświetla grafikę w kontrolce DataGridView .

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

public class DataGridViewImageCell : System.Windows.Forms.DataGridViewCell

type DataGridViewImageCell = class
    inherit DataGridViewCell

Public Class DataGridViewImageCell
Inherits DataGridViewCell

Dziedziczenie: Object

DataGridViewElement

DataGridViewCell
DataGridViewImageCell

Przykłady

W poniższym przykładzie kodu pokazano, jak zmienić obraz w komórce obrazu przy użyciu polecenia DataGridViewCell. Ten przykład kodu jest częścią większego przykładu przedstawionego w temacie How to: Work with Image Columns in the Windows Forms DataGridView Control (Instrukcje: praca z kolumnami obrazów w kontrolce DataGridView).

void dataGridView1_CellClick( Object^ sender, DataGridViewCellEventArgs^ e )
{
   if ( turn->Equals( gameOverString ) )
   {
      return;
   }

   DataGridViewImageCell^ cell = dynamic_cast<DataGridViewImageCell^>(dataGridView1->Rows[ e->RowIndex ]->Cells[ e->ColumnIndex ]);
   if ( cell->Value == blank )
   {
      if ( IsOsTurn() )
      {
         cell->Value = o;
      }
      else
      {
         cell->Value = x;
      }

      ToggleTurn();
   }

   if ( IsAWin( cell ) )
   {
      turn->Text = gameOverString;
   }
}

private void dataGridView1_CellClick(object sender,
    DataGridViewCellEventArgs e)
{

    if (turn.Text.Equals(gameOverString)) { return; }

    DataGridViewImageCell cell = (DataGridViewImageCell)
        dataGridView1.Rows[e.RowIndex].Cells[e.ColumnIndex];

    if (cell.Value == blank)
    {
        if (IsOsTurn())
        {
            cell.Value = o;
        }
        else
        {
            cell.Value = x;
        }
        ToggleTurn();
    }
    if (IsAWin())
    {
        turn.Text = gameOverString;
    }
}

Private Sub dataGridView1_CellClick(ByVal sender As Object, _
    ByVal e As DataGridViewCellEventArgs) _
    Handles dataGridView1.CellClick

    If turn.Text.Equals(gameOverString) Then Return

    Dim cell As DataGridViewImageCell = _
        CType(dataGridView1.Rows(e.RowIndex). _
            Cells(e.ColumnIndex), DataGridViewImageCell)
    If (cell.Value Is blank) Then
        If IsOsTurn() Then
            cell.Value = o
        Else
            cell.Value = x
        End If
        ToggleTurn()
        ToolTip(e)
    End If
    If IsAWin() Then
        turn.Text = gameOverString
    End If
End Sub

Uwagi

Klasa DataGridViewImageCell jest wyspecjalizowanym typem DataGridViewCell używanym do wyświetlania elementu Image lub Icon, w zależności od wartości ValueIsIcon właściwości. Zazwyczaj właściwość obiektu DataGridViewImageCell jest ustawiona na wartość , aby wskazaćtrue, ReadOnly że użytkownik nie może edytować zawartości komórki.

Jest DataGridViewImageColumn to typ kolumny wyspecjalizowany do przechowywania komórek tego typu. Domyślnie element DataGridViewImageColumn.CellTemplate jest inicjowany do nowego DataGridViewImageCellelementu . Aby utworzyć wzorzec komórek w kolumnie po istniejącej DataGridViewImageCellkolumnie, ustaw właściwość kolumny CellTemplate na komórkę do użycia 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 wpłynie 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.

Uwagi dotyczące dziedziczenia

Po utworzeniu i DataGridViewImageCell 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

DataGridViewImageCell()	Inicjuje DataGridViewImageCell nowe wystąpienie klasy, konfigurując je do użycia z wartościami komórek innych niż Icon obiekty.
DataGridViewImageCell(Boolean)	Inicjuje DataGridViewImageCell nowe wystąpienie klasy, opcjonalnie konfigurując je do użycia z wartościami Icon komórek.

Właściwości

AccessibilityObject	Pobiera element DataGridViewCell.DataGridViewCellAccessibleObject przypisany 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	DataGridView Pobiera formant skojarzony z tym elementem. (Odziedziczone po DataGridViewElement)
DefaultNewRowValue	Pobiera wartość domyślną używaną podczas tworzenia nowego wiersza.
Description	Pobiera lub ustawia tekst skojarzony z obrazem.
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.
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 sformatowanej do wyświetlenia. (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)
ImageLayout	Pobiera lub ustawia układ graficzny komórki.
InheritedState	Pobiera bieżący stan komórki jako 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)
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 zaznaczona. (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)
ValueIsIcon	Pobiera lub ustawia wartość wskazującą Icon , czy ta komórka wyświetla wartość.
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

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 zostanie anulowany po kliknięciu komórki. (Odziedziczone po 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. (Odziedziczone po DataGridViewCell)
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Wskazuje, czy wiersz komórki zostanie anulowany po dwukrotnym kliknięciu zawartości komórki. (Odziedziczone po DataGridViewCell)
CreateAccessibilityInstance()	Tworzy nowy dostępny obiekt dla obiektu DataGridViewImageCell.
DetachEditingControl()	Usuwa kontrolkę edycji komórki z obiektu DataGridView. (Odziedziczone po DataGridViewCell)
Dispose()	Zwalnia wszelkie zasoby używane przez element DataGridViewCell. (Odziedziczone po DataGridViewCell)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element DataGridViewCell i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Wskazuje, czy wiersz komórki zostanie anulowany 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)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
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 Graphics stylu komórki i aktualnie obowiązującego stylu 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 dla komórki. (Odziedziczone po DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Zwraca grafikę, która będzie wyświetlana w komórce.
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. (Odziedziczone po DataGridViewCell)
GetInheritedState(Int32)	Zwraca wartość wskazującą bieżący stan komórki jako dziedziczony 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)
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. (Odziedziczone po DataGridViewCell)
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 zostać uruchomiony na podstawie danego klucza. (Odziedziczone po DataGridViewCell)
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)
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. (Odziedziczone po DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Wskazuje, czy wiersz będzie nieudostępniany, jeśli użytkownik dwukrotnie kliknie 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 opuści 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, gdy zawartość komórki jest klikana dwukrotnie. (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ływana, gdy fokus zostanie przeniesiony do komórki. (Odziedziczone po DataGridViewCell)
OnKeyDown(KeyEventArgs, Int32)	Wywoływana, gdy klawisz znaku jest naciśnięty, gdy fokus znajduje się w komórce. (Odziedziczone po DataGridViewCell)
OnKeyPress(KeyPressEventArgs, Int32)	Wywoływana, gdy klawisz jest naciśnięty, gdy fokus znajduje się na komórce. (Odziedziczone po DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)	Wywoływana, gdy klucz znaku jest zwalniany, gdy fokus znajduje się w komórce. (Odziedziczone po DataGridViewCell)
OnLeave(Int32, Boolean)	Wywoływana, gdy fokus przechodzi z komórki. (Odziedziczone po DataGridViewCell)
OnMouseClick(DataGridViewCellMouseEventArgs)	Wywoływana, gdy użytkownik klika przycisk myszy, gdy wskaźnik znajduje się w komórce. (Odziedziczone po DataGridViewCell)
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 przesuwa 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 DataGridViewImageCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Maluje obramowanie bieżącego .DataGridViewCell (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 . (Odziedziczone po DataGridViewCell)
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 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. (Odziedziczone po DataGridViewCell)
ToString()	Zwraca ciąg opisujący bieżący obiekt.

Dotyczy