DataGridViewLinkColumn Classe

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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: Object

DataGridViewElement

DataGridViewBand

DataGridViewColumn
DataGridViewLinkColumn

Atributos: ToolboxBitmapAttribute

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 é `true`.
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)

Aplica-se a

Compartilhar via