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 de un control DataGridView.

public ref 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")>]
type DataGridViewLinkColumn = class
    inherit DataGridViewColumn

Public Class DataGridViewLinkColumn
Inherits DataGridViewColumn

Herencia

Object

DataGridViewElement

DataGridViewBand

DataGridViewColumn

DataGridViewLinkColumn

Atributos

ToolboxBitmapAttribute

Ejemplos

En el ejemplo de código siguiente se establecen las propiedades de un DataGridViewLinkColumnobjeto . 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 las 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 de vínculo deseado.

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

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

DataGridViewLinkColumn()

Inicializa una nueva instancia de la clase DataGridViewLinkColumn.

Propiedades

ActiveLinkColor	Obtiene o establece el color utilizado para mostrar un vínculo activo dentro de las celdas de la columna.
AutoSizeMode	Obtiene o establece el modo mediante el cual la columna ajusta automáticamente su tamaño. (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 para la columna. (Heredado de DataGridViewColumn)
DataGridView	Obtiene el control DataGridView asociado a este elemento. (Heredado de DataGridViewElement)
DataPropertyName	Obtiene o establece el nombre de la columna de base de datos o la propiedad del origen de datos a la que se enlaza DataGridViewColumn. (Heredado de DataGridViewColumn)
DefaultCellStyle	Obtiene o establece el estilo predeterminado de celda de la columna. (Heredado de DataGridViewColumn)
DefaultHeaderCellType	Obtiene o establece el tipo de la celda de encabezado predeterminada en tiempo de ejecución. (Heredado de DataGridViewBand)
Displayed	Obtiene un valor que indica si la banda se muestra actualmente en la pantalla. (Heredado de DataGridViewBand)
DisplayIndex	Obtiene o establece el orden de presentación de la columna respecto de las columnas actualmente mostradas. (Heredado de DataGridViewColumn)
DividerWidth	Obtiene o establece el ancho, en píxeles, del divisor de columna. (Heredado de DataGridViewColumn)
FillWeight	Obtiene o establece un valor que representa el ancho de la columna cuando se encuentra en modo de relleno, respecto del ancho de las demás columnas del control que estén en modo de relleno. (Heredado de DataGridViewColumn)
Frozen	Obtiene o establece un valor que indica si la columna se va a mover cuando el usuario se desplace horizontalmente por el control DataGridView. (Heredado de DataGridViewColumn)
HasDefaultCellStyle	Obtiene un valor que indica si se ha establecido la propiedad DefaultCellStyle. (Heredado de DataGridViewBand)
HeaderCell	Obtiene o establece el objeto DataGridViewColumnHeaderCell 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 de título en la celda de encabezado de columna. (Heredado de DataGridViewColumn)
Index	Obtiene la posición relativa de la banda dentro del control DataGridView. (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 utilizado 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 se puede cambiar el tamaño de la columna. (Heredado de DataGridViewColumn)
Selected	Obtiene o establece un valor que indica si la banda está en un estado seleccionado de la interfaz de usuario (UI). (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 del elemento. (Heredado de DataGridViewElement)
Tag	Obtiene o establece el objeto que contiene datos para asociar a la banda. (Heredado de DataGridViewBand)
Text	Obtiene o establece el texto del vínculo mostrado en las celdas de una columna si UseColumnTextForLinkValue es true.
ToolTipText	Obtiene o establece el texto que se utiliza como 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 la propiedad Text se muestra como el 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 utilizado 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

Clone()	Crea una copia exacta de esta columna.
Dispose()	Libera todos los recursos que usa DataGridViewBand. (Heredado de DataGridViewBand)
Dispose(Boolean)	Libera los recursos no administrados que usa DataGridViewBand y, de forma opcional, libera los recursos administrados. (Heredado de DataGridViewColumn)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)	Calcula el ancho ideal de la columna basándose en los criterios especificados. (Heredado de DataGridViewColumn)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnDataGridViewChanged()	Se llama cuando la banda está asociada a un DataGridView diferente. (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

Disposed

Se produce cuando se desecha DataGridViewColumn. (Heredado de DataGridViewColumn)

Consulte también

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