DataGridViewLinkColumn Classe

Definição

Espaço de Nomes:: System.Windows.Forms

Assemblagem:: System.Windows.Forms.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa uma coluna de células que contêm ligações num DataGridView controlo.

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.bmp")>]
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 seguinte estabelece propriedades em um DataGridViewLinkColumn. Este exemplo faz parte de um exemplo mais amplo disponível no DataGridViewComboBoxColumn tópico de visão geral da aula.

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

Observações

A DataGridViewLinkColumn classe é um tipo especializado da DataGridViewColumn classe usada para alojar logicamente células que respondem a cliques do utilizador. A DataGridViewLinkColumn classe é semelhante à DataGridViewButtonColumn classe, mas oferece uma experiência de utilizador diferente que pode ser mais apropriada em certas situações, como a apresentação de uma URL armazenada numa tabela de base de dados.

Para mostrar o mesmo texto de ligação para cada célula, defina a UseColumnTextForLinkValue propriedade para true e defina a Text propriedade para o texto de ligação desejado.

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

O modo de ordenação por defeito para este tipo de coluna é NotSortable.

Para responder aos cliques dos links dos utilizadores, gere o DataGridView.CellContentClick evento. Também pode usar o DataGridView.CellClick evento para responder a cliques em qualquer parte da célula.

Notas para Herdeiros

Quando derivar e DataGridViewLinkColumn adicionar novas propriedades à classe derivada, certifique-se de sobrepor o Clone() método para copiar as novas propriedades durante as operações de clonagem. Deves também chamar o método da Clone() classe base para que as propriedades da classe base sejam copiadas para a nova célula.

Construtores

Name	Description
DataGridViewLinkColumn()	Inicializa uma nova instância da DataGridViewLinkColumn classe.

Propriedades

Name	Description
ActiveLinkColor	Obtém ou define a cor usada para exibir uma ligação ativa dentro das células da coluna.
AutoSizeMode	Obtém ou define o modo pelo qual a coluna ajusta automaticamente a sua largura. (Herdado de DataGridViewColumn)
CellTemplate	Obtém ou define o modelo usado para criar novas células.
CellType	Obtém o tipo de execução do template da célula. (Herdado de DataGridViewColumn)
ContextMenuStrip	Recebe ou define o menu de atalhos para a coluna. (Herdado de DataGridViewColumn)
DataGridView	Obtém o DataGridView controlo associado a este elemento. (Herdado de DataGridViewElement)
DataPropertyName	Obtém ou define o nome da propriedade da fonte de dados ou da coluna da base de dados à qual está vinculado DataGridViewColumn . (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 execução da célula de cabeçalho padrão. (Herdado de DataGridViewBand)
Displayed	Recebe um valor que indica se a banda está atualmente exibida no ecrã. (Herdado de DataGridViewBand)
DisplayIndex	Obtém ou define a ordem de exibição da coluna em relação às colunas atualmente apresentadas. (Herdado de DataGridViewColumn)
DividerWidth	Obtém ou define a largura, em píxeis, do divisor de colunas. (Herdado de DataGridViewColumn)
FillWeight	Obtém ou define um valor que representa a largura da coluna quando esta está em modo de preenchimento relativamente às larguras de outras colunas em modo de preenchimento no controlo. (Herdado de DataGridViewColumn)
Frozen	Recebe ou define um valor que indica se uma coluna se move quando o utilizador desliza o DataGridView controlo horizontalmente. (Herdado de DataGridViewColumn)
HasDefaultCellStyle	Recebe 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	Recebe ou define o texto da legenda na célula do cabeçalho da coluna. (Herdado de DataGridViewColumn)
Index	Obtém a posição relativa da banda dentro do DataGridView controlo. (Herdado de DataGridViewBand)
InheritedAutoSizeMode	Assim entra em funcionamento o modo de dimensionamento para a coluna. (Herdado de DataGridViewColumn)
InheritedStyle	Recebe o estilo de célula atualmente aplicado à coluna. (Herdado de DataGridViewColumn)
IsDataBound	Obtém um valor que indica se a coluna está ligada a uma fonte de dados. (Herdado de DataGridViewColumn)
IsRow	Recebe um valor que indica se a banda representa uma linha. (Herdado de DataGridViewBand)
LinkBehavior	Obtém ou define um valor que representa o comportamento das ligações dentro das células da coluna.
LinkColor	Obtém ou define a cor usada para mostrar uma ligação não selecionada dentro das células da coluna.
MinimumWidth	Obtém ou define a largura mínima, em pixels, da coluna. (Herdado de DataGridViewColumn)
Name	Recebe ou define o nome da coluna. (Herdado de DataGridViewColumn)
ReadOnly	Recebe ou define um valor que indica se o utilizador pode editar as células da coluna. (Herdado de DataGridViewColumn)
Resizable	Recebe ou define um valor que indica se a coluna é redimensionável. (Herdado de DataGridViewColumn)
Selected	Recebe ou define um valor que indica se a banda está num estado selecionado de interface de utilizador (UI). (Herdado de DataGridViewBand)
Site	Obtém ou define o local da coluna. (Herdado de DataGridViewColumn)
SortMode	Obtém ou define o modo de ordenação para a coluna. (Herdado de DataGridViewColumn)
State	Obtém o estado da interface de utilizador (UI) do elemento. (Herdado de DataGridViewElement)
Tag	Obtém ou define o objeto que contém dados para associar à banda. (Herdado de DataGridViewBand)
Text	Obtém ou define o texto de ligação exibido nas células de uma coluna se UseColumnTextForLinkValue for `true`.
ToolTipText	Obtém ou define o texto usado para as dicas de ferramenta. (Herdado de DataGridViewColumn)
TrackVisitedState	Recebe ou define um valor que indica se o link muda de cor se já foi visitado.
UseColumnTextForLinkValue	Recebe ou define um valor que indica se o valor da Text propriedade é apresentado como texto de ligação.
ValueType	Obtém ou define o tipo de dados dos valores nas células da coluna. (Herdado de DataGridViewColumn)
Visible	Recebe ou define um valor que indica se a coluna é visível. (Herdado de DataGridViewColumn)
VisitedLinkColor	Obtém ou define a cor usada para mostrar um link que já foi visitado.
Width	Obtém ou define a largura atual da coluna. (Herdado de DataGridViewColumn)

Métodos

Name	Description
Clone()	Cria uma cópia exata desta coluna.
Dispose()	Liberta todos os recursos utilizados pelo DataGridViewBand. (Herdado de DataGridViewBand)
Dispose(Boolean)	Liberta os recursos não geridos usados pelo DataGridViewBand e opcionalmente liberta os recursos geridos. (Herdado de DataGridViewColumn)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como função de hash predefinida. (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 atual Object. (Herdado de Object)
OnDataGridViewChanged()	Chamado quando a banda está associada a um .DataGridView (Herdado de DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs)	Eleva o CellClick evento. (Herdado de DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Eleva o CellContentClick evento. (Herdado de DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Eleva o CellContentDoubleClick evento. (Herdado de DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Eleva o CellValueChanged evento. (Herdado de DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Eleva o DataError evento. (Herdado de DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Eleva o MouseWheel evento. (Herdado de DataGridViewElement)
ToString()	Recebe uma cadeia que descreve a coluna.

evento

Name	Description
Disposed	Ocorre quando é DataGridViewColumn descartado. (Herdado de DataGridViewColumn)

Aplica-se a

Ver também

Comentários

Esta página foi útil?