DataGridViewImageCell Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Exibe um gráfico em um controle DataGridView.
public ref class DataGridViewImageCell : System::Windows::Forms::DataGridViewCellpublic class DataGridViewImageCell : System.Windows.Forms.DataGridViewCelltype DataGridViewImageCell = class
inherit DataGridViewCellPublic Class DataGridViewImageCell
Inherits DataGridViewCell- Herança
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) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| 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. |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| 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) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| 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) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| 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. |
