Partilhar via


DataGridViewLinkColumn Classe

Definição

Representa uma coluna de células que contêm links em um DataGridView controle.

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.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
[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")]
public class DataGridViewLinkColumn : System.Windows.Forms.DataGridViewColumn
[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn.bmp")>]
type DataGridViewLinkColumn = class
    inherit DataGridViewColumn
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn")>]
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 e defina a Text propriedade como o texto de link desejado.

A DataGridViewLinkColumn tem um associado DataGridViewLinkCell em cada DataGridViewRow um que o cruza.

O modo de classificação padrão para esse tipo de coluna é NotSortable.

Para responder aos 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 e DataGridViewLinkColumn 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
DataGridViewLinkColumn()

Inicializa uma nova instância da classe DataGridViewLinkColumn.

Propriedades

Nome Description
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 automaticamente sua largura.

(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 DataGridView controle associado a esse elemento.

(Herdado de DataGridViewElement)
DataPropertyName

Obtém ou define o nome da propriedade de fonte de dados ou coluna de banco de dados à qual o DataGridViewColumn limite está associado.

(Herdado de DataGridViewColumn)
DefaultCellStyle

Obtém ou define o estilo de 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 atualmente na tela.

(Herdado de DataGridViewBand)
DisplayIndex

Obtém ou define a ordem de exibição da coluna relativa às colunas exibidas no momento.

(Herdado de DataGridViewColumn)
DividerWidth

Obtém ou define a largura, em pixels, do divisor de colunas.

(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 às larguras de 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 DataGridView controle horizontalmente.

(Herdado de DataGridViewColumn)
HasDefaultCellStyle

Obtém um valor que indica se a DefaultCellStyle propriedade 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 da legenda na célula de cabeçalho da coluna.

(Herdado de DataGridViewColumn)
Index

Obtém a posição relativa da banda dentro do DataGridView controle.

(Herdado de DataGridViewBand)
InheritedAutoSizeMode

Obtém o modo de dimensionamento em vigor para a coluna.

(Herdado de DataGridViewColumn)
InheritedStyle

Obtém o estilo de célula atualmente aplicado à 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 de links dentro das células na 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 (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 interface do usuário do elemento.

(Herdado de DataGridViewElement)
Tag

Obtém ou define o objeto que contém dados a serem associados à banda.

(Herdado de DataGridViewBand)
Text

Obtém ou define o texto do link exibido nas células de uma coluna se UseColumnTextForLinkValue for 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 muda de cor se tiver sido visitado.

UseColumnTextForLinkValue

Obtém ou define um valor que indica se o valor da Text propriedade é 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 que foi visitado anteriormente.

Width

Obtém ou define a largura atual da coluna.

(Herdado de DataGridViewColumn)

Métodos

Nome Description
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 Objectatual.

(Herdado de Object)
OnDataGridViewChanged()

Chamado quando a banda está associada a outro DataGridView.

(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

Nome Description
Disposed

Ocorre quando o DataGridViewColumn é descartado.

(Herdado de DataGridViewColumn)

Aplica-se a

Confira também