DataGridViewLinkColumn Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

DataGridViewLinkColumn.cs

Rappresenta una colonna di celle che contengono collegamenti in un DataGridView controllo .

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

Ereditarietà

Object

DataGridViewElement

DataGridViewBand

DataGridViewColumn

DataGridViewLinkColumn

Attributi

ToolboxBitmapAttribute DynamicallyAccessedMembersAttribute

Esempio

Nell'esempio di codice seguente vengono impostate le proprietà di un oggetto DataGridViewLinkColumn. Questo esempio fa parte di un esempio più ampio disponibile nell'argomento di panoramica della 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

Commenti

La DataGridViewLinkColumn classe è un tipo specializzato della DataGridViewColumn classe usata per ospitare logicamente le celle che rispondono ai clic dell'utente. La DataGridViewLinkColumn classe è simile alla DataGridViewButtonColumn classe , ma offre un'esperienza utente diversa che può essere più appropriata in determinate situazioni, ad esempio la visualizzazione di un URL archiviato in una tabella di database.

Per visualizzare lo stesso testo del collegamento per ogni cella, impostare la UseColumnTextForLinkValue proprietà su true e impostare la Text proprietà sul testo del collegamento desiderato.

A DataGridViewLinkColumn un oggetto è associato DataGridViewLinkCell in ogni DataGridViewRow oggetto che lo interseca.

La modalità di ordinamento predefinita per questo tipo di colonna è NotSortable.

Per rispondere ai clic del collegamento dell'utente, gestire l'evento DataGridView.CellContentClick . È anche possibile usare l'evento DataGridView.CellClick per rispondere ai clic in qualsiasi punto della cella.

Note per gli eredi

Quando si deriva da DataGridViewLinkColumn e si aggiungono nuove proprietà alla classe derivata, assicurarsi di eseguire l'override del Clone() metodo per copiare le nuove proprietà durante le operazioni di clonazione. È anche necessario chiamare il metodo della classe base Clone() in modo che le proprietà della classe di base vengano copiate nella nuova cella.

Costruttori

Nome	Descrizione
DataGridViewLinkColumn()	Inizializza una nuova istanza della classe DataGridViewLinkColumn.

Proprietà

Nome	Descrizione
ActiveLinkColor	Ottiene o imposta il colore utilizzato per visualizzare un collegamento attivo all'interno delle celle della colonna.
AutoSizeMode	Ottiene o imposta la modalità in base alla quale la colonna regola automaticamente la larghezza. (Ereditato da DataGridViewColumn)
CellTemplate	Ottiene o imposta il modello utilizzato per creare nuove celle.
CellType	Ottiene il tipo di runtime del modello di cella. (Ereditato da DataGridViewColumn)
ContextMenuStrip	Ottiene o imposta il menu di scelta rapida per la colonna. (Ereditato da DataGridViewColumn)
DataGridView	Ottiene il DataGridView controllo associato a questo elemento. (Ereditato da DataGridViewElement)
DataPropertyName	Ottiene o imposta il nome della proprietà dell'origine dati o della colonna di database a cui è associato .DataGridViewColumn (Ereditato da DataGridViewColumn)
DefaultCellStyle	Ottiene o imposta lo stile predefinito della cella della colonna. (Ereditato da DataGridViewColumn)
DefaultHeaderCellType	Ottiene o imposta il tipo di runtime della cella di intestazione predefinita. (Ereditato da DataGridViewBand)
Displayed	Ottiene un valore che indica se la banda è attualmente visualizzata sullo schermo. (Ereditato da DataGridViewBand)
DisplayIndex	Ottiene o imposta l'ordine di visualizzazione della colonna rispetto alle colonne attualmente visualizzate. (Ereditato da DataGridViewColumn)
DividerWidth	Ottiene o imposta la larghezza, espressa in pixel, del divisore di colonna. (Ereditato da DataGridViewColumn)
FillWeight	Ottiene o imposta un valore che rappresenta la larghezza della colonna quando è in modalità di riempimento rispetto alle larghezze di altre colonne in modalità riempimento nel controllo . (Ereditato da DataGridViewColumn)
Frozen	Ottiene o imposta un valore che indica se una colonna verrà spostata quando un utente scorre il DataGridView controllo orizzontalmente. (Ereditato da DataGridViewColumn)
HasDefaultCellStyle	Ottiene un valore che indica se la DefaultCellStyle proprietà è stata impostata. (Ereditato da DataGridViewBand)
HeaderCell	Ottiene o imposta l'oggetto DataGridViewColumnHeaderCell che rappresenta l'intestazione di colonna. (Ereditato da DataGridViewColumn)
HeaderCellCore	Ottiene o imposta la cella di intestazione dell'oggetto DataGridViewBand. (Ereditato da DataGridViewBand)
HeaderText	Ottiene o imposta il testo della didascalia nella cella di intestazione della colonna. (Ereditato da DataGridViewColumn)
Index	Ottiene la posizione relativa della banda all'interno del DataGridView controllo . (Ereditato da DataGridViewBand)
InheritedAutoSizeMode	Ottiene la modalità di ridimensionamento attiva per la colonna. (Ereditato da DataGridViewColumn)
InheritedStyle	Ottiene lo stile della cella attualmente applicato alla colonna. (Ereditato da DataGridViewColumn)
IsDataBound	Ottiene un valore che indica se la colonna è associata a un'origine dati. (Ereditato da DataGridViewColumn)
IsRow	Ottiene un valore che indica se la banda rappresenta una riga. (Ereditato da DataGridViewBand)
LinkBehavior	Ottiene o imposta un valore che rappresenta il comportamento dei collegamenti all'interno delle celle della colonna.
LinkColor	Ottiene o imposta il colore utilizzato per visualizzare un collegamento non selezionato all'interno delle celle della colonna.
MinimumWidth	Ottiene o imposta la larghezza minima, espressa in pixel, della colonna. (Ereditato da DataGridViewColumn)
Name	Ottiene o imposta il nome della colonna. (Ereditato da DataGridViewColumn)
ReadOnly	Ottiene o imposta un valore che indica se l'utente può modificare le celle della colonna. (Ereditato da DataGridViewColumn)
Resizable	Ottiene o imposta un valore che indica se la colonna è ridimensionabile. (Ereditato da DataGridViewColumn)
Selected	Ottiene o imposta un valore che indica se la banda si trova in uno stato dell'interfaccia utente selezionato. (Ereditato da DataGridViewBand)
Site	Ottiene o imposta il sito della colonna. (Ereditato da DataGridViewColumn)
SortMode	Ottiene o imposta la modalità di ordinamento per la colonna. (Ereditato da DataGridViewColumn)
State	Ottiene lo stato dell'interfaccia utente dell'elemento. (Ereditato da DataGridViewElement)
Tag	Ottiene o imposta l'oggetto che contiene dati da associare alla banda. (Ereditato da DataGridViewBand)
Text	Ottiene o imposta il testo del collegamento visualizzato nelle celle di una colonna se UseColumnTextForLinkValue è true.
ToolTipText	Ottiene o imposta il testo utilizzato per le descrizioni comandi. (Ereditato da DataGridViewColumn)
TrackVisitedState	Ottiene o imposta un valore che indica se il collegamento cambia colore se è stato visitato.
UseColumnTextForLinkValue	Ottiene o imposta un valore che indica se il valore della Text proprietà viene visualizzato come testo del collegamento.
ValueType	Ottiene o imposta il tipo di dati dei valori nelle celle della colonna. (Ereditato da DataGridViewColumn)
Visible	Ottiene o imposta un valore che indica se la colonna è visibile. (Ereditato da DataGridViewColumn)
VisitedLinkColor	Ottiene o imposta il colore utilizzato per visualizzare un collegamento visitato in precedenza.
Width	Ottiene o imposta la larghezza corrente della colonna. (Ereditato da DataGridViewColumn)

Metodi

Nome	Descrizione
Clone()	Crea una copia esatta di questa colonna.
Dispose()	Rilascia tutte le risorse usate da DataGridViewBand. (Ereditato da DataGridViewBand)
Dispose(Boolean)	Rilascia le risorse non gestite usate da DataGridViewBand e, facoltativamente, rilascia le risorse gestite. (Ereditato da DataGridViewColumn)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)	Calcola la larghezza ideale della colonna in base ai criteri specificati. (Ereditato da DataGridViewColumn)
OnDataGridViewChanged()	Chiamato quando la banda è associata a un oggetto diverso DataGridView. (Ereditato da DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs)	Genera l'evento CellClick. (Ereditato da DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Genera l'evento CellContentClick. (Ereditato da DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Genera l'evento CellContentDoubleClick. (Ereditato da DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Genera l'evento CellValueChanged. (Ereditato da DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Genera l'evento DataError. (Ereditato da DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Genera l'evento MouseWheel. (Ereditato da DataGridViewElement)
ToString()	Ottiene una stringa che descrive la colonna.

Eventi

Nome	Descrizione
Disposed	Si verifica quando l'oggetto DataGridViewColumn viene eliminato. (Ereditato da DataGridViewColumn)

Vedi anche

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