DataGridViewLinkColumn 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.
Representa uma coluna de células que contêm links em um controle de DataGridView.
public ref class DataGridViewLinkColumn : System::Windows::Forms::DataGridViewColumn
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn.bmp")]
public class DataGridViewLinkColumn : System.Windows.Forms.DataGridViewColumn
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn")]
public class DataGridViewLinkColumn : System.Windows.Forms.DataGridViewColumn
[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn.bmp")>]
type DataGridViewLinkColumn = class
inherit DataGridViewColumn
[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn")>]
type DataGridViewLinkColumn = class
inherit DataGridViewColumn
Public Class DataGridViewLinkColumn
Inherits DataGridViewColumn
- Herança
- Atributos
Exemplos
O exemplo de código a seguir define propriedades em um DataGridViewLinkColumn. Este exemplo faz parte de um exemplo maior disponível no tópico de visão geral da DataGridViewComboBoxColumn classe.
private:
void AddLinkColumn()
{
DataGridViewLinkColumn^ links = gcnew DataGridViewLinkColumn();
links->UseColumnTextForLinkValue = true;
links->HeaderText = ColumnName::ReportsTo.ToString();
links->DataPropertyName = ColumnName::ReportsTo.ToString();
links->ActiveLinkColor = Color::White;
links->LinkBehavior = LinkBehavior::SystemDefault;
links->LinkColor = Color::Blue;
links->TrackVisitedState = true;
links->VisitedLinkColor = Color::YellowGreen;
DataGridView1->Columns->Add(links);
}
private void AddLinkColumn()
{
DataGridViewLinkColumn links = new DataGridViewLinkColumn();
links.UseColumnTextForLinkValue = true;
links.HeaderText = ColumnName.ReportsTo.ToString();
links.DataPropertyName = ColumnName.ReportsTo.ToString();
links.ActiveLinkColor = Color.White;
links.LinkBehavior = LinkBehavior.SystemDefault;
links.LinkColor = Color.Blue;
links.TrackVisitedState = true;
links.VisitedLinkColor = Color.YellowGreen;
DataGridView1.Columns.Add(links);
}
Private Sub AddLinkColumn()
Dim links As New DataGridViewLinkColumn()
With links
.UseColumnTextForLinkValue = True
.HeaderText = ColumnName.ReportsTo.ToString()
.DataPropertyName = ColumnName.ReportsTo.ToString()
.ActiveLinkColor = Color.White
.LinkBehavior = LinkBehavior.SystemDefault
.LinkColor = Color.Blue
.TrackVisitedState = True
.VisitedLinkColor = Color.YellowGreen
End With
DataGridView1.Columns.Add(links)
End Sub
Comentários
A DataGridViewLinkColumn classe é um tipo especializado da DataGridViewColumn classe usada para hospedar logicamente células que respondem a cliques do usuário. A DataGridViewLinkColumn classe é semelhante à DataGridViewButtonColumn classe , mas fornece uma experiência de usuário diferente que pode ser mais apropriada em determinadas situações, como exibir uma URL armazenada em uma tabela de banco de dados.
Para exibir o mesmo texto de link para cada célula, defina a UseColumnTextForLinkValue propriedade true como e defina a Text propriedade como o texto do link desejado.
Um DataGridViewLinkColumn tem um associado DataGridViewLinkCell em cada DataGridViewRow que o intersecciona.
O modo de classificação padrão para esse tipo de coluna é NotSortable.
Para responder a cliques de link do usuário, manipule o DataGridView.CellContentClick evento. Você também pode usar o DataGridView.CellClick evento para responder a cliques em qualquer lugar da célula.
Notas aos Herdeiros
Ao derivar de DataGridViewLinkColumn 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
| DataGridViewLinkColumn() |
Inicializa uma nova instância da classe DataGridViewLinkColumn. |
Propriedades
| ActiveLinkColor |
Obtém ou define a cor usada para exibir um link ativo dentro das células na coluna. |
| AutoSizeMode |
Obtém ou define o modo pelo qual a coluna ajusta a largura automaticamente. (Herdado de DataGridViewColumn) |
| CellTemplate |
Obtém ou define o modelo usado para criar novas células. |
| CellType |
Obtém o tipo de tempo de execução do modelo de célula. (Herdado de DataGridViewColumn) |
| ContextMenuStrip |
Obtém ou define o menu de atalho da coluna. (Herdado de DataGridViewColumn) |
| DataGridView |
Obtém o controle de DataGridView associado a esse elemento. (Herdado de DataGridViewElement) |
| DataPropertyName |
Obtém ou define o nome da propriedade da fonte de dados ou da coluna de banco de dados à qual DataGridViewColumn está associado. (Herdado de DataGridViewColumn) |
| DefaultCellStyle |
Obtém ou define o estilo da célula padrão da coluna. (Herdado de DataGridViewColumn) |
| DefaultHeaderCellType |
Obtém ou define o tipo de tempo de execução da célula de cabeçalho padrão. (Herdado de DataGridViewBand) |
| Displayed |
Obtém um valor que indica se a banda é exibida na tela no momento. (Herdado de DataGridViewBand) |
| DisplayIndex |
Obtém ou define a ordem de exibição da coluna em relação às colunas exibidas no momento. (Herdado de DataGridViewColumn) |
| DividerWidth |
Obtém ou define a largura mínima, em pixels, do divisor de coluna. (Herdado de DataGridViewColumn) |
| FillWeight |
Obtém ou define um valor que representa a largura da coluna quando ela está no modo de preenchimento em relação à largura das outras colunas de modo de preenchimento no controle. (Herdado de DataGridViewColumn) |
| Frozen |
Obtém ou define um valor que indica se uma coluna será movida quando um usuário rolar o controle DataGridView horizontalmente. (Herdado de DataGridViewColumn) |
| HasDefaultCellStyle |
Obtém um valor que indica se a propriedade DefaultCellStyle foi definida. (Herdado de DataGridViewBand) |
| HeaderCell |
Obtém ou define o DataGridViewColumnHeaderCell que representa o cabeçalho da coluna. (Herdado de DataGridViewColumn) |
| HeaderCellCore |
Obtém ou define a célula de cabeçalho do DataGridViewBand. (Herdado de DataGridViewBand) |
| HeaderText |
Obtém ou define o texto de legenda na célula do cabeçalho da coluna. (Herdado de DataGridViewColumn) |
| Index |
Obtém a posição relativa da faixa dentro do controle DataGridView. (Herdado de DataGridViewBand) |
| InheritedAutoSizeMode |
Obtém o modo de redimensionamento em vigor para a coluna. (Herdado de DataGridViewColumn) |
| InheritedStyle |
Obtém o estilo aplicado atualmente à coluna. (Herdado de DataGridViewColumn) |
| IsDataBound |
Obtém um valor que indica se a coluna está associada a uma fonte de dados. (Herdado de DataGridViewColumn) |
| IsRow |
Obtém um valor que indica se a banda representa uma linha. (Herdado de DataGridViewBand) |
| LinkBehavior |
Obtém ou define um valor que representa o comportamento dos links nas células da coluna. |
| LinkColor |
Obtém ou define a cor usada para exibir um link não selecionado dentro das células na coluna. |
| MinimumWidth |
Obtém ou define a largura mínima, em pixels, da coluna. (Herdado de DataGridViewColumn) |
| Name |
Obtém ou define o nome da coluna. (Herdado de DataGridViewColumn) |
| ReadOnly |
Obtém ou define um valor que indica se o usuário pode editar as células da coluna. (Herdado de DataGridViewColumn) |
| Resizable |
Obtém ou define um valor que indica se a coluna é redimensionável. (Herdado de DataGridViewColumn) |
| Selected |
Obtém ou define um valor que indica se a banda está em um estado de interface do usuário selecionado. (Herdado de DataGridViewBand) |
| Site |
Obtém ou define o site da coluna. (Herdado de DataGridViewColumn) |
| SortMode |
Obtém ou define o modo de classificação da coluna. (Herdado de DataGridViewColumn) |
| State |
Obtém o estado da UI (interface do usuário) do elemento. (Herdado de DataGridViewElement) |
| Tag |
Obtém ou define o objeto que contém os dados associados à banda. (Herdado de DataGridViewBand) |
| Text |
Obtém ou define o texto do link exibido nas células de uma coluna se UseColumnTextForLinkValue é |
| ToolTipText |
Obtém ou define o texto usado para Dicas de Ferramentas. (Herdado de DataGridViewColumn) |
| TrackVisitedState |
Obtém ou define um valor que indica se o link mudará de cor caso seja visitado. |
| UseColumnTextForLinkValue |
Obtém ou define um valor que indica se o valor da propriedade Text será exibido como o texto do link. |
| ValueType |
Obtém ou define o tipo de dados dos valores nas células da coluna. (Herdado de DataGridViewColumn) |
| Visible |
Obtém ou define um valor que indica se a coluna está visível. (Herdado de DataGridViewColumn) |
| VisitedLinkColor |
Obtém ou define a cor usada para exibir um link visitado anteriormente. |
| Width |
Obtém ou define a largura atual da coluna. (Herdado de DataGridViewColumn) |
Métodos
| Clone() |
Cria uma cópia exata desta coluna. |
| Dispose() |
Libera todos os recursos usados pelo DataGridViewBand. (Herdado de DataGridViewBand) |
| Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo DataGridViewBand e opcionalmente libera os recursos gerenciados. (Herdado de DataGridViewColumn) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean) |
Calcula a largura ideal da coluna com base nos critérios especificados. (Herdado de DataGridViewColumn) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| OnDataGridViewChanged() |
Chamado quando a faixa está associada a um DataGridView diferente. (Herdado de DataGridViewBand) |
| 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) |
| ToString() |
Obtém uma cadeia de caracteres que descreve a coluna. |
Eventos
| Disposed |
Ocorre quando o DataGridViewColumn é descartado. (Herdado de DataGridViewColumn) |