DataGridViewLinkColumn Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Source:

DataGridViewLinkColumn.cs

Representa una columna de celdas que contienen vínculos en un DataGridView control .

public ref 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.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn")>]
type DataGridViewLinkColumn = class
    inherit DataGridViewColumn

Public Class DataGridViewLinkColumn
Inherits DataGridViewColumn

Herencia

Object

DataGridViewElement

DataGridViewBand

DataGridViewColumn

DataGridViewLinkColumn

Atributos

ToolboxBitmapAttribute DynamicallyAccessedMembersAttribute

Ejemplos

En el ejemplo de código siguiente se establecen las propiedades de un DataGridViewLinkColumn. Este ejemplo forma parte de un ejemplo más grande disponible en el tema de información general de la DataGridViewComboBoxColumn clase.

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

Comentarios

La DataGridViewLinkColumn clase es un tipo especializado de la DataGridViewColumn clase utilizada para hospedar lógicamente celdas que responden a los clics del usuario. La DataGridViewLinkColumn clase es similar a la DataGridViewButtonColumn clase , pero proporciona una experiencia de usuario diferente que puede ser más adecuada en determinadas situaciones, como mostrar una dirección URL almacenada en una tabla de base de datos.

Para mostrar el mismo texto de vínculo para cada celda, establezca la UseColumnTextForLinkValue propiedad true en y establezca la Text propiedad en el texto del vínculo deseado.

un DataGridViewLinkColumn objeto tiene asociado DataGridViewLinkCell en cada DataGridViewRow que lo interseca.

El modo de ordenación predeterminado para este tipo de columna es NotSortable.

Para responder a los clics del vínculo de usuario, controle el DataGridView.CellContentClick evento. También puede usar el DataGridView.CellClick evento para responder a clics en cualquier parte de la celda.

Notas a los desarrolladores de herederos

Cuando derive de DataGridViewLinkColumn y agregue nuevas propiedades a la clase derivada, asegúrese de invalidar el Clone() método para copiar las nuevas propiedades durante las operaciones de clonación. También debe llamar al método de Clone() la clase base para que las propiedades de la clase base se copien en la nueva celda.

Constructores

Nombre	Description
DataGridViewLinkColumn()	Inicializa una nueva instancia de la clase DataGridViewLinkColumn.

Propiedades

Nombre	Description
ActiveLinkColor	Obtiene o establece el color usado para mostrar un vínculo activo dentro de las celdas de la columna.
AutoSizeMode	Obtiene o establece el modo por el que la columna ajusta automáticamente su ancho. (Heredado de DataGridViewColumn)
CellTemplate	Obtiene o establece la plantilla utilizada para crear nuevas celdas.
CellType	Obtiene el tipo en tiempo de ejecución de la plantilla de celda. (Heredado de DataGridViewColumn)
ContextMenuStrip	Obtiene o establece el menú contextual de la columna. (Heredado de DataGridViewColumn)
DataGridView	Obtiene el DataGridView control asociado a este elemento. (Heredado de DataGridViewElement)
DataPropertyName	Obtiene o establece el nombre de la propiedad de origen de datos o la columna de base de datos a la DataGridViewColumn que está enlazado. (Heredado de DataGridViewColumn)
DefaultCellStyle	Obtiene o establece el estilo de celda predeterminado de la columna. (Heredado de DataGridViewColumn)
DefaultHeaderCellType	Obtiene o establece el tipo en tiempo de ejecución de la celda de encabezado predeterminada. (Heredado de DataGridViewBand)
Displayed	Obtiene un valor que indica si la banda se muestra actualmente en pantalla. (Heredado de DataGridViewBand)
DisplayIndex	Obtiene o establece el orden de presentación de la columna en relación con las columnas mostradas actualmente. (Heredado de DataGridViewColumn)
DividerWidth	Obtiene o establece el ancho, en píxeles, del divisor de columnas. (Heredado de DataGridViewColumn)
FillWeight	Obtiene o establece un valor que representa el ancho de la columna cuando está en modo de relleno en relación con los anchos de otras columnas en modo de relleno del control. (Heredado de DataGridViewColumn)
Frozen	Obtiene o establece un valor que indica si una columna se moverá cuando un usuario desplaza el DataGridView control horizontalmente. (Heredado de DataGridViewColumn)
HasDefaultCellStyle	Obtiene un valor que indica si se ha establecido la DefaultCellStyle propiedad . (Heredado de DataGridViewBand)
HeaderCell	Obtiene o establece el DataGridViewColumnHeaderCell objeto que representa el encabezado de columna. (Heredado de DataGridViewColumn)
HeaderCellCore	Obtiene o establece la celda de encabezado de .DataGridViewBand (Heredado de DataGridViewBand)
HeaderText	Obtiene o establece el texto del título en la celda de encabezado de la columna. (Heredado de DataGridViewColumn)
Index	Obtiene la posición relativa de la banda dentro del DataGridView control. (Heredado de DataGridViewBand)
InheritedAutoSizeMode	Obtiene el modo de ajuste de tamaño en vigor para la columna. (Heredado de DataGridViewColumn)
InheritedStyle	Obtiene el estilo de celda aplicado actualmente a la columna. (Heredado de DataGridViewColumn)
IsDataBound	Obtiene un valor que indica si la columna está enlazada a un origen de datos. (Heredado de DataGridViewColumn)
IsRow	Obtiene un valor que indica si la banda representa una fila. (Heredado de DataGridViewBand)
LinkBehavior	Obtiene o establece un valor que representa el comportamiento de los vínculos dentro de las celdas de la columna.
LinkColor	Obtiene o establece el color usado para mostrar un vínculo no seleccionado dentro de las celdas de la columna.
MinimumWidth	Obtiene o establece el ancho mínimo, en píxeles, de la columna. (Heredado de DataGridViewColumn)
Name	Obtiene o establece el nombre de la columna. (Heredado de DataGridViewColumn)
ReadOnly	Obtiene o establece un valor que indica si el usuario puede editar las celdas de la columna. (Heredado de DataGridViewColumn)
Resizable	Obtiene o establece un valor que indica si la columna se puede cambiar de tamaño. (Heredado de DataGridViewColumn)
Selected	Obtiene o establece un valor que indica si la banda está en estado de interfaz de usuario (UI) seleccionada. (Heredado de DataGridViewBand)
Site	Obtiene o establece el sitio de la columna. (Heredado de DataGridViewColumn)
SortMode	Obtiene o establece el modo de ordenación de la columna. (Heredado de DataGridViewColumn)
State	Obtiene el estado de la interfaz de usuario (UI) del elemento. (Heredado de DataGridViewElement)
Tag	Obtiene o establece el objeto que contiene los datos que se van a asociar a la banda. (Heredado de DataGridViewBand)
Text	Obtiene o establece el texto del vínculo que se muestra en las celdas de una columna si UseColumnTextForLinkValue es true.
ToolTipText	Obtiene o establece el texto usado para la información sobre herramientas. (Heredado de DataGridViewColumn)
TrackVisitedState	Obtiene o establece un valor que indica si el vínculo cambia de color si se ha visitado.
UseColumnTextForLinkValue	Obtiene o establece un valor que indica si el valor de propiedad Text se muestra como texto del vínculo.
ValueType	Obtiene o establece el tipo de datos de los valores de las celdas de la columna. (Heredado de DataGridViewColumn)
Visible	Obtiene o establece un valor que indica si la columna está visible. (Heredado de DataGridViewColumn)
VisitedLinkColor	Obtiene o establece el color usado para mostrar un vínculo que se ha visitado previamente.
Width	Obtiene o establece el ancho actual de la columna. (Heredado de DataGridViewColumn)

Métodos

Nombre	Description
Clone()	Crea una copia exacta de esta columna.
Dispose()	Libera todos los recursos usados por .DataGridViewBand (Heredado de DataGridViewBand)
Dispose(Boolean)	Libera los recursos no administrados usados por el DataGridViewBand y, opcionalmente, libera los recursos administrados. (Heredado de DataGridViewColumn)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)	Calcula el ancho ideal de la columna en función de los criterios especificados. (Heredado de DataGridViewColumn)
OnDataGridViewChanged()	Se llama cuando la banda está asociada a otro DataGridView. (Heredado de DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs)	Genera el evento CellClick. (Heredado de DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Genera el evento CellContentClick. (Heredado de DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Genera el evento CellContentDoubleClick. (Heredado de DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Genera el evento CellValueChanged. (Heredado de DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Genera el evento DataError. (Heredado de DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Genera el evento MouseWheel. (Heredado de DataGridViewElement)
ToString()	Obtiene una cadena que describe la columna.

Eventos

Nombre	Description
Disposed	Se produce cuando DataGridViewColumn se elimina . (Heredado de DataGridViewColumn)

Consulte también

• DataGridView
• DataGridViewColumn
• DataGridViewRow
• DataGridViewButtonColumn
• DataGridViewLinkCell
• SortMode
• CellContentClick
• CellClick
• UseColumnTextForLinkValue
• Text