DataGridViewImageCell Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataGridViewImageCell.cs

Zobrazí grafiku v ovládacím DataGridView prvku.

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

Dědičnost

Object

DataGridViewElement

DataGridViewCell

DataGridViewImageCell

Příklady

Následující příklad kódu ukazuje, jak změnit obrázek v buňce obrázku pomocí DataGridViewCell. Tento příklad kódu je součástí rozsáhlejšího příkladu uvedeného v tématu Postupy: Práce se sloupci obrázků v ovládacím prvku Windows Forms 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

Poznámky

Třída DataGridViewImageCell je specializovaný typ DataGridViewCell použitý k zobrazení Image nebo nebo Icon, v závislosti na hodnotě ValueIsIcon vlastnosti. Vlastnost objektu je DataGridViewImageCell obvykle nastavena tak, aby true označí, ReadOnly že uživatel nemůže upravovat obsah buňky.

Jedná se DataGridViewImageColumn o typ sloupce, který se specializuje na uložení buněk tohoto typu. Ve výchozím nastavení DataGridViewImageColumn.CellTemplate se inicializuje na nový DataGridViewImageCell. Pokud chcete vytěsnit buňky ve sloupci za existujícím DataGridViewImageCellsloupcem, nastavte vlastnost sloupce CellTemplate na buňku tak, aby se používala jako vzor.

Vlastnosti sloupce související s buňkou jsou obálky pro podobně pojmenované vlastnosti buňky šablony. Změna hodnot vlastností buňky šablony ovlivní pouze buňky na základě šablony přidané po změně. Změna hodnot vlastností souvisejících s buňkou ve sloupci však aktualizuje buňku šablony a všechny ostatní buňky ve sloupci a v případě potřeby sloupec aktualizuje.

Poznámky pro dědice

Při odvozené DataGridViewImageCell třídě a přidání nových vlastností do odvozené třídy nezapomeňte přepsat metodu Clone() kopírování nových vlastností během operací klonování. Měli byste také volat metodu základní třídy Clone() tak, aby vlastnosti základní třídy byly zkopírovány do nové buňky.

Konstruktory

Name	Description
DataGridViewImageCell()	Inicializuje novou instanci DataGridViewImageCell třídy a nakonfiguruje ji pro použití s jinými hodnotami buněk než Icon objekty.
DataGridViewImageCell(Boolean)	Inicializuje novou instanci DataGridViewImageCell třídy, volitelně ji nakonfiguruje pro použití s Icon hodnotami buněk.

Vlastnosti

Name	Description
AccessibilityObject	DataGridViewCell.DataGridViewCellAccessibleObject Získá přiřazeno DataGridViewCell. (Zděděno od DataGridViewCell)
ColumnIndex	Získá index sloupce pro tuto buňku. (Zděděno od DataGridViewCell)
ContentBounds	Získá ohraničující obdélník, který ohraničuje oblast obsahu buňky. (Zděděno od DataGridViewCell)
ContextMenuStrip	Získá nebo nastaví místní nabídku přidruženou k buňce. (Zděděno od DataGridViewCell)
DataGridView	Získá ovládací prvek DataGridView přidružený k tomuto prvku. (Zděděno od DataGridViewElement)
DefaultNewRowValue	Získá výchozí hodnotu, která se používá při vytváření nového řádku.
Description	Získá nebo nastaví text přidružený k obrázku.
Displayed	Získá hodnotu, která označuje, zda je buňka aktuálně zobrazena na obrazovce. (Zděděno od DataGridViewCell)
EditedFormattedValue	Získá aktuální formátovanou hodnotu buňky bez ohledu na to, zda je buňka v režimu úprav a hodnota nebyla potvrzena. (Zděděno od DataGridViewCell)
EditType	Získá typ hostovaného ovládacího prvku pro úpravy buňky.
ErrorIconBounds	Získá hranice ikony chyby pro buňku. (Zděděno od DataGridViewCell)
ErrorText	Získá nebo nastaví text popisující chybový stav přidružený k buňce. (Zděděno od DataGridViewCell)
FormattedValue	Získá hodnotu buňky jako formát pro zobrazení. (Zděděno od DataGridViewCell)
FormattedValueType	Získá typ formátované hodnoty přidružené k buňce.
Frozen	Získá hodnotu označující, zda je buňka zmrazena. (Zděděno od DataGridViewCell)
HasStyle	Získá hodnotu určující, zda Style byla vlastnost nastavena. (Zděděno od DataGridViewCell)
ImageLayout	Získá nebo nastaví rozložení grafiky pro buňku.
InheritedState	Získá aktuální stav buňky zděděný ze stavu jeho řádku a sloupce. (Zděděno od DataGridViewCell)
InheritedStyle	Získá styl, který je aktuálně použit pro buňku. (Zděděno od DataGridViewCell)
IsInEditMode	Získá hodnotu označující, zda se tato buňka právě upravuje. (Zděděno od DataGridViewCell)
OwningColumn	Získá sloupec, který obsahuje tuto buňku. (Zděděno od DataGridViewCell)
OwningRow	Získá řádek, který obsahuje tuto buňku. (Zděděno od DataGridViewCell)
PreferredSize	Získá velikost vpixelch (Zděděno od DataGridViewCell)
ReadOnly	Získá nebo nastaví hodnotu určující, zda lze upravit data buňky. (Zděděno od DataGridViewCell)
Resizable	Získá hodnotu označující, zda je možné změnit velikost buňky. (Zděděno od DataGridViewCell)
RowIndex	Získá index nadřazeného řádku buňky. (Zděděno od DataGridViewCell)
Selected	Získá nebo nastaví hodnotu označující, zda je buňka vybrána. (Zděděno od DataGridViewCell)
Size	Získá velikost buňky. (Zděděno od DataGridViewCell)
State	Získá stav uživatelského rozhraní prvku. (Zděděno od DataGridViewElement)
Style	Získá nebo nastaví styl buňky. (Zděděno od DataGridViewCell)
Tag	Získá nebo nastaví objekt, který obsahuje doplňující data o buňce. (Zděděno od DataGridViewCell)
ToolTipText	Získá nebo nastaví text popisu přidružený k této buňce. (Zděděno od DataGridViewCell)
Value	Získá nebo nastaví hodnotu přidruženou k této buňce. (Zděděno od DataGridViewCell)
ValueIsIcon	Získá nebo nastaví hodnotu označující, zda tato buňka zobrazuje Icon hodnotu.
ValueType	Získá nebo nastaví datový typ hodnot v buňce.
Visible	Získá hodnotu označující, zda je buňka v řádku nebo sloupci, který byl skrytý. (Zděděno od DataGridViewCell)

Metody

Name	Description
AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Upraví styl ohraničení vstupní buňky podle zadaných kritérií. (Zděděno od DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)	Vrátí hodnotu Rectangle , která představuje šířky všech okrajů buňky. (Zděděno od DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	Určuje, jestli se řádek buňky při kliknutí na buňku nesdílí. (Zděděno od DataGridViewCell)
Clone()	Vytvoří přesnou kopii této buňky.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Určuje, jestli se řádek buňky při kliknutí na obsah buňky nesdílí. (Zděděno od DataGridViewCell)
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Určuje, jestli se řádek buňky při dvojitém kliknutí na obsah buňky nesdílí. (Zděděno od DataGridViewCell)
CreateAccessibilityInstance()	Vytvoří nový přístupný objekt pro objekt DataGridViewImageCell.
DetachEditingControl()	Odebere ovládací prvek pro úpravy buňky z ovládacího DataGridViewprvku . (Zděděno od DataGridViewCell)
Dispose()	Uvolní všechny prostředky používané nástrojem DataGridViewCell. (Zděděno od DataGridViewCell)
Dispose(Boolean)	Uvolní nespravované prostředky používané DataGridViewCell a volitelně uvolní spravované prostředky. (Zděděno od DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Určuje, jestli se řádek buňky při dvojitém kliknutí na buňku nesdílí. (Zděděno od DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	Určuje, jestli se nadřazený řádek při přesunutí fokusu na buňku zruší. (Zděděno od DataGridViewCell)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Načte formátovanou hodnotu buňky, která se má zkopírovat do Clipboardbuňky . (Zděděno od DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Vrátí ohraničující obdélník, který ohraničuje oblast obsahu buňky, která se vypočítá pomocí zadaného Graphics stylu a stylu buňky.
GetContentBounds(Int32)	Vrátí ohraničující obdélník ohraničující oblast obsahu buňky pomocí výchozího Graphics stylu buňky, který je aktuálně pro buňku v platnosti. (Zděděno od DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Vrátí aktuální formátovanou hodnotu buňky bez ohledu na to, jestli je buňka v režimu úprav a hodnota nebyla potvrzena. (Zděděno od DataGridViewCell)
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Vrátí ohraničující obdélník, který ohraničuje ikonu chyby buňky, pokud se zobrazí.
GetErrorText(Int32)	Vrátí řetězec, který představuje chybu buňky. (Zděděno od DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Vrátí grafiku tak, jak by se zobrazila v buňce.
GetInheritedContextMenuStrip(Int32)	Získá zděděnou místní nabídku pro aktuální buňku. (Zděděno od DataGridViewCell)
GetInheritedState(Int32)	Vrátí hodnotu označující aktuální stav buňky zděděný ze stavu řádku a sloupce. (Zděděno od DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Získá styl použitý na buňku. (Zděděno od DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Vypočítá upřednostňovanou velikost buňky v pixelech.
GetSize(Int32)	Získá velikost buňky. (Zděděno od DataGridViewCell)
GetValue(Int32)	Získá hodnotu buňky.
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Inicializuje ovládací prvek použitý k úpravě buňky. (Zděděno od DataGridViewCell)
KeyDownUnsharesRow(KeyEventArgs, Int32)	Určuje, jestli je nadřazený řádek nesdílený, pokud uživatel stiskne klávesu, když je fokus na buňce. (Zděděno od DataGridViewCell)
KeyEntersEditMode(KeyEventArgs)	Určuje, jestli se má režim úprav spustit na základě daného klíče. (Zděděno od DataGridViewCell)
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Určuje, jestli se řádek nesdílí, pokud je stisknutá klávesa, když je fokus na buňce v řádku. (Zděděno od DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)	Určuje, jestli se nadřazený řádek nesdílí, když uživatel uvolní klíč, když je fokus na buňce. (Zděděno od DataGridViewCell)
LeaveUnsharesRow(Int32, Boolean)	Určuje, jestli se řádek nesdílí, když fokus opustí buňku v řádku. (Zděděno od DataGridViewCell)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, jestli se řádek nesdílí, pokud uživatel klikne na tlačítko myši, zatímco ukazatel je na buňce v řádku. (Zděděno od DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, jestli se řádek nesdílí, pokud uživatel dvakrát klikne na buňku v řádku. (Zděděno od DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, jestli se řádek nesdílí, když uživatel podrží tlačítko myši, zatímco ukazatel je na buňce v řádku. (Zděděno od DataGridViewCell)
MouseEnterUnsharesRow(Int32)	Určuje, jestli se řádek nebude sdílet, když se ukazatel myši přesune na buňku v řádku. (Zděděno od DataGridViewCell)
MouseLeaveUnsharesRow(Int32)	Určuje, jestli se řádek nesdílí, když ukazatel myši opustí řádek. (Zděděno od DataGridViewCell)
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, jestli se řádek nebude sdílet, když se ukazatel myši přesune na buňku v řádku. (Zděděno od DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, jestli se řádek nesdílí, když uživatel uvolní tlačítko myši, když je ukazatel na buňce v řádku. (Zděděno od DataGridViewCell)
OnClick(DataGridViewCellEventArgs)	Volá se při kliknutí na buňku. (Zděděno od DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)	Volá se při kliknutí na obsah buňky. (Zděděno od DataGridViewCell)
OnContentDoubleClick(DataGridViewCellEventArgs)	Volá se, když je obsah buňky poklikaný. (Zděděno od DataGridViewCell)
OnDataGridViewChanged()	Volá se při DataGridView změně vlastnosti buňky. (Zděděno od DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)	Volá se při poklikání na buňku. (Zděděno od DataGridViewCell)
OnEnter(Int32, Boolean)	Volá se, když se fokus přesune do buňky. (Zděděno od DataGridViewCell)
OnKeyDown(KeyEventArgs, Int32)	Volá se při stisknutí znakové klávesy, když je fokus na buňce. (Zděděno od DataGridViewCell)
OnKeyPress(KeyPressEventArgs, Int32)	Volá se při stisknutí klávesy, když je fokus na buňce. (Zděděno od DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)	Volá se při uvolnění znakového klíče, když je fokus na buňce. (Zděděno od DataGridViewCell)
OnLeave(Int32, Boolean)	Volá se, když se fokus přesune z buňky. (Zděděno od DataGridViewCell)
OnMouseClick(DataGridViewCellMouseEventArgs)	Volá se, když uživatel klikne na tlačítko myši, když je ukazatel na buňce. (Zděděno od DataGridViewCell)
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Volá se, když uživatel dvakrát klikne na tlačítko myši, když je ukazatel na buňce. (Zděděno od DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)	Volá se, když uživatel drží tlačítko myši, když je ukazatel na buňce. (Zděděno od DataGridViewCell)
OnMouseEnter(Int32)	Volá se, když se ukazatel myši přesune přes buňku. (Zděděno od DataGridViewCell)
OnMouseLeave(Int32)	Volá se, když ukazatel myši opustí buňku. (Zděděno od DataGridViewCell)
OnMouseMove(DataGridViewCellMouseEventArgs)	Volá se, když se ukazatel myši přesune v buňce. (Zděděno od DataGridViewCell)
OnMouseUp(DataGridViewCellMouseEventArgs)	Volá se, když uživatel uvolní tlačítko myši, když je ukazatel na buňce. (Zděděno od DataGridViewCell)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Maluje aktuální DataGridViewImageCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Nakreslí okraj aktuálního DataGridViewCell. (Zděděno od DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Vykreslí ikonu chyby aktuálního DataGridViewCell. (Zděděno od DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Převede hodnotu formátovanou pro zobrazení na skutečnou hodnotu buňky. (Zděděno od DataGridViewCell)
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Nastaví umístění a velikost ovládacího prvku pro úpravy hostované buňkou v ovládacím DataGridView prvku. (Zděděno od DataGridViewCell)
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Nastaví umístění a velikost panelu pro úpravy hostovaného buňkou a vrátí normální hranice ovládacího prvku pro úpravy v panelu pro úpravy. (Zděděno od DataGridViewCell)
RaiseCellClick(DataGridViewCellEventArgs)	CellClick Vyvolá událost. (Zděděno od DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	CellContentClick Vyvolá událost. (Zděděno od DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	CellContentDoubleClick Vyvolá událost. (Zděděno od DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	CellValueChanged Vyvolá událost. (Zděděno od DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	DataError Vyvolá událost. (Zděděno od DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	MouseWheel Vyvolá událost. (Zděděno od DataGridViewElement)
SetValue(Int32, Object)	Nastaví hodnotu buňky. (Zděděno od DataGridViewCell)
ToString()	Vrátí řetězec, který popisuje aktuální objekt.

Viz také

• DataGridView
• DataGridViewCell
• DataGridViewImageColumn
• CellTemplate
• Image
• Icon
• ValueIsIcon