DataGridViewImageCell Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

DataGridViewImageCell.cs

Exibe um gráfico em um DataGridView controle.

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

Herança

Object

DataGridViewElement

DataGridViewCell

DataGridViewImageCell

Exemplos

O exemplo de código a seguir demonstra como alterar a imagem em uma célula de imagem usando DataGridViewCell. Este exemplo de código faz parte de um exemplo maior fornecido para o tópico How to: Work with Image Columns in the Windows Forms DataGridView Control.

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

Comentários

A DataGridViewImageCell classe é um tipo especializado de DataGridViewCell usado para exibir um Image ou um Icon, dependendo do valor da ValueIsIcon propriedade. Normalmente, a ReadOnly propriedade de um DataGridViewImageCell é definida para true indicar que o usuário não pode editar o conteúdo da célula.

É DataGridViewImageColumn o tipo de coluna especializado para armazenar células desse tipo. Por padrão, o DataGridViewImageColumn.CellTemplate valor é inicializado para um novo DataGridViewImageCell. Para padronizar as células dentro de uma coluna após um existente DataGridViewImageCell, defina a propriedade da CellTemplate coluna como a célula a ser usada como um padrão.

As propriedades relacionadas à célula da coluna são wrappers para as propriedades de nome semelhante da célula de modelo. Alterar os valores de propriedade da célula de modelo afetará apenas as células com base no modelo que são adicionados após a alteração. No entanto, a alteração dos valores da propriedade relacionada à célula da coluna atualizará a célula de modelo e todas as outras células na coluna e atualizará a exibição da coluna, se necessário.

Notas aos Herdeiros

Ao derivar e DataGridViewImageCell adicionar novas propriedades à classe derivada, substitua o Clone() método para copiar as novas propriedades durante as operações de clonagem. Você também deve chamar o método da Clone() classe base para que as propriedades da classe base sejam copiadas para a nova célula.

Construtores

Nome	Description
DataGridViewImageCell()	Inicializa uma nova instância da classe, configurando-a DataGridViewImageCell para uso com valores de célula diferentes de Icon objetos.
DataGridViewImageCell(Boolean)	Inicializa uma nova instância da classe, opcionalmente configurando-a DataGridViewImageCell para uso com Icon valores de célula.

Propriedades

Nome	Description
AccessibilityObject	Obtém o DataGridViewCell.DataGridViewCellAccessibleObject atribuído ao DataGridViewCell. (Herdado de DataGridViewCell)
ColumnIndex	Obtém o índice de coluna dessa célula. (Herdado de DataGridViewCell)
ContentBounds	Obtém o retângulo delimitador que inclui a área de conteúdo da célula. (Herdado de DataGridViewCell)
ContextMenuStrip	Obtém ou define o menu de atalho associado à célula. (Herdado de DataGridViewCell)
DataGridView	Obtém o DataGridView controle associado a esse elemento. (Herdado de DataGridViewElement)
DefaultNewRowValue	Obtém o valor padrão usado ao criar uma nova linha.
Description	Obtém ou define o texto associado à imagem.
Displayed	Obtém um valor que indica se a célula é exibida atualmente na tela. (Herdado de DataGridViewCell)
EditedFormattedValue	Obtém o valor atual formatado da célula, independentemente de a célula estar no modo de edição e se o valor não foi confirmado. (Herdado de DataGridViewCell)
EditType	Obtém o tipo do controle de edição hospedado da célula.
ErrorIconBounds	Obtém os limites do ícone de erro da célula. (Herdado de DataGridViewCell)
ErrorText	Obtém ou define o texto que descreve uma condição de erro associada à célula. (Herdado de DataGridViewCell)
FormattedValue	Obtém o valor da célula como formatado para exibição. (Herdado de DataGridViewCell)
FormattedValueType	Obtém o tipo do valor formatado associado à célula.
Frozen	Obtém um valor que indica se a célula está congelada. (Herdado de DataGridViewCell)
HasStyle	Obtém um valor que indica se a Style propriedade foi definida. (Herdado de DataGridViewCell)
ImageLayout	Obtém ou define o layout gráfico da célula.
InheritedState	Obtém o estado atual da célula, conforme herdado do estado de sua linha e coluna. (Herdado de DataGridViewCell)
InheritedStyle	Obtém o estilo atualmente aplicado à célula. (Herdado de DataGridViewCell)
IsInEditMode	Obtém um valor que indica se essa célula está sendo editada no momento. (Herdado de DataGridViewCell)
OwningColumn	Obtém a coluna que contém essa célula. (Herdado de DataGridViewCell)
OwningRow	Obtém a linha que contém essa célula. (Herdado de DataGridViewCell)
PreferredSize	Obtém o tamanho, em pixels, de uma área retangular na qual a célula pode se ajustar. (Herdado de DataGridViewCell)
ReadOnly	Obtém ou define um valor que indica se os dados da célula podem ser editados. (Herdado de DataGridViewCell)
Resizable	Obtém um valor que indica se a célula pode ser redimensionada. (Herdado de DataGridViewCell)
RowIndex	Obtém o índice da linha pai da célula. (Herdado de DataGridViewCell)
Selected	Obtém ou define um valor que indica se a célula foi selecionada. (Herdado de DataGridViewCell)
Size	Obtém o tamanho da célula. (Herdado de DataGridViewCell)
State	Obtém o estado da interface do usuário do elemento. (Herdado de DataGridViewElement)
Style	Obtém ou define o estilo da célula. (Herdado de DataGridViewCell)
Tag	Obtém ou define o objeto que contém dados complementares sobre a célula. (Herdado de DataGridViewCell)
ToolTipText	Obtém ou define o texto tooltip associado a essa célula. (Herdado de DataGridViewCell)
Value	Obtém ou define o valor associado a essa célula. (Herdado de DataGridViewCell)
ValueIsIcon	Obtém ou define um valor que indica se essa célula exibe um Icon valor.
ValueType	Obtém ou define o tipo de dados dos valores na célula.
Visible	Obtém um valor que indica se a célula está em uma linha ou coluna oculta. (Herdado de DataGridViewCell)

Métodos

Nome	Description
AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Modifica o estilo de borda da célula de entrada de acordo com os critérios especificados. (Herdado de DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)	Retorna um Rectangle que representa as larguras de todas as margens da célula. (Herdado de DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	Indica se a linha da célula será desarmada quando a célula for clicada. (Herdado de DataGridViewCell)
Clone()	Cria uma cópia exata dessa célula.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Indica se a linha da célula será desarmada quando o conteúdo da célula for clicado. (Herdado de DataGridViewCell)
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indica se a linha da célula será desarmada quando o conteúdo da célula for clicado duas vezes. (Herdado de DataGridViewCell)
CreateAccessibilityInstance()	Cria um novo objeto acessível para o DataGridViewImageCell.
DetachEditingControl()	Remove o controle de edição da célula do DataGridView. (Herdado de DataGridViewCell)
Dispose()	Libera todos os recursos usados pelo DataGridViewCell. (Herdado de DataGridViewCell)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo DataGridViewCell e, opcionalmente, libera os recursos gerenciados. (Herdado de DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indica se a linha da célula será desarmada quando a célula for clicada duas vezes. (Herdado de DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	Indica se a linha pai será desarmada quando o foco se mover para a célula. (Herdado de DataGridViewCell)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Recupera o valor formatado da célula a ser copiado para o Clipboard. (Herdado de DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Retorna o retângulo delimitador que inclui a área de conteúdo da célula, que é calculada usando o estilo de célula e especificado Graphics .
GetContentBounds(Int32)	Retorna o retângulo delimitador que inclui a área de conteúdo da célula usando um padrão Graphics e um estilo de célula atualmente em vigor para a célula. (Herdado de DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Retorna o valor atual formatado da célula, independentemente de a célula estar no modo de edição e se o valor não foi confirmado. (Herdado de DataGridViewCell)
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Retorna o retângulo delimitador que inclui o ícone de erro da célula, se um for exibido.
GetErrorText(Int32)	Retorna uma cadeia de caracteres que representa o erro da célula. (Herdado de DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Retorna um gráfico como seria exibido na célula.
GetInheritedContextMenuStrip(Int32)	Obtém o menu de atalho herdado da célula atual. (Herdado de DataGridViewCell)
GetInheritedState(Int32)	Retorna um valor que indica o estado atual da célula, conforme herdado do estado de sua linha e coluna. (Herdado de DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Obtém o estilo aplicado à célula. (Herdado de DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Calcula o tamanho preferencial, em pixels, da célula.
GetSize(Int32)	Obtém o tamanho da célula. (Herdado de DataGridViewCell)
GetValue(Int32)	Obtém o valor da célula.
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Inicializa o controle usado para editar a célula. (Herdado de DataGridViewCell)
KeyDownUnsharesRow(KeyEventArgs, Int32)	Indica se a linha pai está desarmada se o usuário pressiona uma tecla enquanto o foco está na célula. (Herdado de DataGridViewCell)
KeyEntersEditMode(KeyEventArgs)	Determina se o modo de edição deve ser iniciado com base na chave fornecida. (Herdado de DataGridViewCell)
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Indica se uma linha será desarmada se uma tecla for pressionada enquanto uma célula na linha tiver foco. (Herdado de DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)	Indica se a linha pai não é compartilhada quando o usuário libera uma chave enquanto o foco está na célula. (Herdado de DataGridViewCell)
LeaveUnsharesRow(Int32, Boolean)	Indica se uma linha será desarmada quando o foco deixar uma célula na linha. (Herdado de DataGridViewCell)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se uma linha será desarmada se o usuário clicar em um botão do mouse enquanto o ponteiro estiver em uma célula na linha. (Herdado de DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se uma linha será desarmada se o usuário clicar duas vezes em uma célula na linha. (Herdado de DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se uma linha será desarmada quando o usuário segurar um botão do mouse enquanto o ponteiro estiver em uma célula na linha. (Herdado de DataGridViewCell)
MouseEnterUnsharesRow(Int32)	Indica se uma linha será desarmada quando o ponteiro do mouse se mover sobre uma célula na linha. (Herdado de DataGridViewCell)
MouseLeaveUnsharesRow(Int32)	Indica se uma linha será desarmada quando o ponteiro do mouse sair da linha. (Herdado de DataGridViewCell)
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se uma linha será desarmada quando o ponteiro do mouse se mover sobre uma célula na linha. (Herdado de DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se uma linha será desarmada quando o usuário liberar um botão do mouse enquanto o ponteiro estiver em uma célula na linha. (Herdado de DataGridViewCell)
OnClick(DataGridViewCellEventArgs)	Chamado quando a célula é clicada. (Herdado de DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)	Chamado quando o conteúdo da célula é clicado. (Herdado de DataGridViewCell)
OnContentDoubleClick(DataGridViewCellEventArgs)	Chamado quando o conteúdo da célula é clicado duas vezes. (Herdado de DataGridViewCell)
OnDataGridViewChanged()	Chamado quando a DataGridView propriedade da célula é alterada. (Herdado de DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)	Chamado quando a célula é clicada duas vezes. (Herdado de DataGridViewCell)
OnEnter(Int32, Boolean)	Chamado quando o foco se move para uma célula. (Herdado de DataGridViewCell)
OnKeyDown(KeyEventArgs, Int32)	Chamado quando uma tecla de caractere é pressionada enquanto o foco está em uma célula. (Herdado de DataGridViewCell)
OnKeyPress(KeyPressEventArgs, Int32)	Chamado quando uma tecla é pressionada enquanto o foco está em uma célula. (Herdado de DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)	Chamado quando uma chave de caractere é liberada enquanto o foco está em uma célula. (Herdado de DataGridViewCell)
OnLeave(Int32, Boolean)	Chamado quando o foco se move de uma célula. (Herdado de DataGridViewCell)
OnMouseClick(DataGridViewCellMouseEventArgs)	Chamado quando o usuário clica em um botão do mouse enquanto o ponteiro está em uma célula. (Herdado de DataGridViewCell)
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Chamado quando o usuário clica duas vezes em um botão do mouse enquanto o ponteiro está em uma célula. (Herdado de DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)	Chamado quando o usuário segura um botão do mouse enquanto o ponteiro está em uma célula. (Herdado de DataGridViewCell)
OnMouseEnter(Int32)	Chamado quando o ponteiro do mouse se move sobre uma célula. (Herdado de DataGridViewCell)
OnMouseLeave(Int32)	Chamado quando o ponteiro do mouse sai da célula. (Herdado de DataGridViewCell)
OnMouseMove(DataGridViewCellMouseEventArgs)	Chamado quando o ponteiro do mouse se move dentro de uma célula. (Herdado de DataGridViewCell)
OnMouseUp(DataGridViewCellMouseEventArgs)	Chamado quando o usuário libera um botão do mouse enquanto o ponteiro está em uma célula. (Herdado de DataGridViewCell)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Pinta o atual DataGridViewImageCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Pinta a borda da corrente DataGridViewCell. (Herdado de DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Pinta o ícone de erro do atual DataGridViewCell. (Herdado de DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Converte um valor formatado para exibição em um valor de célula real. (Herdado de DataGridViewCell)
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Define o local e o tamanho do controle de edição hospedado por uma célula no DataGridView controle. (Herdado de DataGridViewCell)
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Define o local e o tamanho do painel de edição hospedado pela célula e retorna os limites normais do controle de edição dentro do painel de edição. (Herdado de DataGridViewCell)
RaiseCellClick(DataGridViewCellEventArgs)	Aciona o evento CellClick. (Herdado de DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Aciona o evento CellContentClick. (Herdado de DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Aciona o evento CellContentDoubleClick. (Herdado de DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Aciona o evento CellValueChanged. (Herdado de DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Aciona o evento DataError. (Herdado de DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Aciona o evento MouseWheel. (Herdado de DataGridViewElement)
SetValue(Int32, Object)	Define o valor da célula. (Herdado de DataGridViewCell)
ToString()	Retorna uma cadeia de caracteres que descreve o objeto atual.

Confira também

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