DataGridViewImageCell Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

DataGridViewImageCell.cs

Exibe um gráfico em um controle 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

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 como para true indicar que o usuário não pode editar o conteúdo da célula.

O DataGridViewImageColumn é o tipo de coluna especializado para armazenar células desse tipo. Por padrão, o DataGridViewImageColumn.CellTemplate é 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. A alteração dos valores de propriedade da célula de modelo afetará apenas as células com base no modelo adicionado após a alteração. No entanto, alterar os valores da propriedade relacionada à célula da coluna atualizará a célula de modelo e todas as outras células da coluna e atualizará a exibição da coluna, se necessário.

Notas aos Herdeiros

Ao derivar de DataGridViewImageCell e 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

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

Propriedades

AccessibilityObject	Obtém o DataGridViewCell.DataGridViewCellAccessibleObject atribuído ao DataGridViewCell. (Herdado de DataGridViewCell)
ColumnIndex	Obtém o índice da coluna para essa célula. (Herdado de DataGridViewCell)
ContentBounds	Obtém o retângulo delimitador que circunscreve 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 controle de DataGridView associado a esse elemento. (Herdado de DataGridViewElement)
DefaultNewRowValue	Obtém o valor padrão que é 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 na tela no momento. (Herdado de DataGridViewCell)
EditedFormattedValue	Obtém o valor atual, formatado da célula, independentemente se a célula estiver em modo de edição e o valor não tiver sido confirmado. (Herdado de DataGridViewCell)
EditType	Obtém o tipo de controle de edição hospedado da célula.
ErrorIconBounds	Obtém os limites do ícone de erro para a 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 propriedade Style 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 esta 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 o controle pode caber. (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 UI (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 de ToolTip associado à célula. (Herdado de DataGridViewCell)
Value	Obtém ou define o valor associado a esta célula. (Herdado de DataGridViewCell)
ValueIsIcon	Obtém ou define um valor que indica se essa célula exibe um valor Icon.
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 ocultada. (Herdado de DataGridViewCell)

Métodos

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 a largura de todas as margens da célula. (Herdado de DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	Indica se linha da célula será descompartilhada quando a célula é clicada. (Herdado de DataGridViewCell)
Clone()	Cria uma cópia exata desta célula.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Indica se linha da célula será descompartilhada quando o conteúdo da célula é clicado. (Herdado de DataGridViewCell)
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indica se linha da célula será descompartilhada quando o conteúdo da célula é 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 linha da célula será descompartilhada quando a célula é clicada duas vezes. (Herdado de DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	Indica se a linha pai será descompartilhada quando o foto se move 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 Graphics e o estilo da célula especificados.
GetContentBounds(Int32)	Retorna o retângulo delimitador que circunscreve a área de conteúdo da célula usando um estilo de Graphics e célula padrão em vigor atualmente para a célula. (Herdado de DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Retorna o valor atual formatado da célula, independentemente de se a célula está em modo de edição e 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 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 elemento gráfico como ela seria exibido na célula.
GetInheritedContextMenuStrip(Int32)	Obtém o menu de atalho herdado para a célula atual. (Herdado de DataGridViewCell)
GetInheritedState(Int32)	Retorna um valor que indica o estado atual da célula conforme herdado do estado da própria 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 preferido da célula em pixels.
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 é descompartilhada se o usuário pressionar 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 especificada. (Herdado de DataGridViewCell)
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Indica se uma linha será descompartilhada se uma tecla for pressionada enquanto uma célula na linha tem o foco. (Herdado de DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)	Indica se a linha pai é descompartilhada quando o usuário libera uma tecla enquanto o foco está na célula. (Herdado de DataGridViewCell)
LeaveUnsharesRow(Int32, Boolean)	Indica se uma linha será descompartilhada quando o foco sair de uma célula na linha. (Herdado de DataGridViewCell)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se uma linha será descompartilhada se o usuário clicar em um botão do mouse enquanto o ponteiro está em uma célula na linha. (Herdado de DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se uma linha será descompartilhada se o usuário clicar duas vezes em uma célula na linha. (Herdado de DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se uma linha será descompartilhada quando o usuário manter pressionado um botão do mouse enquanto o ponteiro está em uma célula na linha. (Herdado de DataGridViewCell)
MouseEnterUnsharesRow(Int32)	Indica se uma linha será descompartilhada quando o ponteiro do mouse passar sobre uma célula na linha. (Herdado de DataGridViewCell)
MouseLeaveUnsharesRow(Int32)	Indica se uma linha será descompartilhada quando o ponteiro do mouse sair da linha. (Herdado de DataGridViewCell)
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se uma linha será descompartilhada quando o ponteiro do mouse passar sobre uma célula na linha. (Herdado de DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se uma linha será descompartilhada quando o usuário liberar um botão do mouse enquanto o ponteiro está em uma célula na linha. (Herdado de DataGridViewCell)
OnClick(DataGridViewCellEventArgs)	Chamado quando se clica na célula. (Herdado de DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)	Chamado quando ocorre um clique no conteúdo da célula. (Herdado de DataGridViewCell)
OnContentDoubleClick(DataGridViewCellEventArgs)	Chamado quando ocorre um clique duplo no conteúdo da célula. (Herdado de DataGridViewCell)
OnDataGridViewChanged()	Chamado quando a propriedade DataGridView da célula é alterada. (Herdado de DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)	Chamado quando ocorre um clique duplo na célula. (Herdado de DataGridViewCell)
OnEnter(Int32, Boolean)	Chamado quando o foco chega a 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 tecla de caractere é liberada enquanto o foco está em uma célula. (Herdado de DataGridViewCell)
OnLeave(Int32, Boolean)	Chamado quando o foco sai 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 mantém o botão do mouse pressionado 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 deixa a 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 solta o 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 DataGridViewImageCell atual.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Pinta a borda do DataGridViewCell atual. (Herdado de DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Pinta o ícone de erro do DataGridViewCell atual. (Herdado de DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Converte um valor formatado para exibição no valor real da célula. (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 controle DataGridView. (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