DataGridViewLinkColumn Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

DataGridViewLinkColumn.cs

Stellt eine Spalte mit Zellen dar, die Verknüpfungen in einem DataGridView Steuerelement enthalten.

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

Vererbung

Object

DataGridViewElement

DataGridViewBand

DataGridViewColumn

DataGridViewLinkColumn

Attribute

ToolboxBitmapAttribute DynamicallyAccessedMembersAttribute

Beispiele

Im folgenden Codebeispiel werden Eigenschaften für ein DataGridViewLinkColumn. Dieses Beispiel ist Teil eines größeren Beispiels, das DataGridViewComboBoxColumn im Thema "Klassenübersicht" verfügbar ist.

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

Hinweise

Die DataGridViewLinkColumn Klasse ist ein spezieller Typ der Klasse, die DataGridViewColumn zum logischen Hosten von Zellen verwendet wird, die auf Benutzerklicks reagieren. Die DataGridViewLinkColumn Klasse ähnelt der DataGridViewButtonColumn Klasse, bietet jedoch eine andere Benutzeroberfläche, die in bestimmten Situationen möglicherweise geeigneter ist, z. B. das Anzeigen einer in einer Datenbanktabelle gespeicherten URL.

Um denselben Verknüpfungstext für jede Zelle anzuzeigen, legen Sie die UseColumnTextForLinkValue Eigenschaft auf true den gewünschten Linktext fest, und legen Sie die Text Eigenschaft auf den gewünschten Linktext fest.

A DataGridViewLinkColumn weist eine zuordnungsbedingte DataGridViewLinkCell Verbindung auf DataGridViewRow , die sie überschneidet.

Der Standardsortierungsmodus für diesen Spaltentyp lautet NotSortable.

Um auf Benutzerlinkklicks zu reagieren, behandeln Sie das DataGridView.CellContentClick Ereignis. Sie können das DataGridView.CellClick Ereignis auch verwenden, um auf Klicks an einer beliebigen Stelle in der Zelle zu reagieren.

Hinweise für Vererber

Wenn Sie von der abgeleiteten Klasse abgeleitete Eigenschaften ableiten DataGridViewLinkColumn und neue Eigenschaften hinzufügen, müssen Sie die Clone() Methode überschreiben, um die neuen Eigenschaften während Klonvorgängen zu kopieren. Sie sollten auch die Methode der Basisklasse Clone() aufrufen, damit die Eigenschaften der Basisklasse in die neue Zelle kopiert werden.

Konstruktoren

Name	Beschreibung
DataGridViewLinkColumn()	Initialisiert eine neue Instanz der DataGridViewLinkColumn-Klasse.

Eigenschaften

Name	Beschreibung
ActiveLinkColor	Dient zum Abrufen oder Festlegen der Farbe, die zum Anzeigen einer aktiven Verknüpfung innerhalb von Zellen in der Spalte verwendet wird.
AutoSizeMode	Ruft den Modus ab, um den die Spalte automatisch die Breite anpasst, oder legt den Modus fest. (Geerbt von DataGridViewColumn)
CellTemplate	Ruft die Vorlage ab, die zum Erstellen neuer Zellen verwendet wird, oder legt sie fest.
CellType	Ruft den Laufzeittyp der Zellenvorlage ab. (Geerbt von DataGridViewColumn)
ContextMenuStrip	Ruft ab oder legt das Kontextmenü für die Spalte fest. (Geerbt von DataGridViewColumn)
DataGridView	Ruft das DataGridView diesem Element zugeordnete Steuerelement ab. (Geerbt von DataGridViewElement)
DataPropertyName	Dient zum Abrufen oder Festlegen des Namens der Datenquelleneigenschaft oder Datenbankspalte, an die die DataGridViewColumn Datenquelle gebunden ist. (Geerbt von DataGridViewColumn)
DefaultCellStyle	Ruft die Standardzellenformatvorlage der Spalte ab oder legt sie fest. (Geerbt von DataGridViewColumn)
DefaultHeaderCellType	Dient zum Abrufen oder Festlegen des Laufzeittyps der Standardkopfzeilenzelle. (Geerbt von DataGridViewBand)
Displayed	Ruft einen Wert ab, der angibt, ob das Band derzeit auf dem Bildschirm angezeigt wird. (Geerbt von DataGridViewBand)
DisplayIndex	Ruft die Anzeigereihenfolge der Spalte relativ zu den aktuell angezeigten Spalten ab oder legt sie fest. (Geerbt von DataGridViewColumn)
DividerWidth	Ruft die Breite der Spaltentrennlinie in Pixel ab oder legt sie fest. (Geerbt von DataGridViewColumn)
FillWeight	Dient zum Abrufen oder Festlegen eines Werts, der die Breite der Spalte darstellt, wenn sie sich im Füllmodus relativ zu den Breiten anderer Füllmodusspalten im Steuerelement befindet. (Geerbt von DataGridViewColumn)
Frozen	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob eine Spalte verschoben wird, wenn ein Benutzer das DataGridView Steuerelement horizontal scrollt. (Geerbt von DataGridViewColumn)
HasDefaultCellStyle	Ruft einen Wert ab, der angibt, ob die DefaultCellStyle Eigenschaft festgelegt wurde. (Geerbt von DataGridViewBand)
HeaderCell	Dient zum Abrufen oder Festlegen des Werts, der DataGridViewColumnHeaderCell die Spaltenüberschrift darstellt. (Geerbt von DataGridViewColumn)
HeaderCellCore	Ruft die Kopfzeilenzelle der DataGridViewBand. (Geerbt von DataGridViewBand)
HeaderText	Dient zum Abrufen oder Festlegen des Beschriftungstexts in der Kopfzeilenzelle der Spalte. (Geerbt von DataGridViewColumn)
Index	Ruft die relative Position des Bereichs innerhalb des DataGridView Steuerelements ab. (Geerbt von DataGridViewBand)
InheritedAutoSizeMode	Ruft den Größenmodus für die Spalte ab. (Geerbt von DataGridViewColumn)
InheritedStyle	Ruft die aktuell auf die Spalte angewendete Zellenformatvorlage ab. (Geerbt von DataGridViewColumn)
IsDataBound	Ruft einen Wert ab, der angibt, ob die Spalte an eine Datenquelle gebunden ist. (Geerbt von DataGridViewColumn)
IsRow	Ruft einen Wert ab, der angibt, ob das Band eine Zeile darstellt. (Geerbt von DataGridViewBand)
LinkBehavior	Dient zum Abrufen oder Festlegen eines Werts, der das Verhalten von Verknüpfungen innerhalb von Zellen in der Spalte darstellt.
LinkColor	Dient zum Abrufen oder Festlegen der Farbe, mit der eine nicht ausgewählte Verknüpfung in Zellen in der Spalte angezeigt wird.
MinimumWidth	Ruft die Mindestbreite der Spalte in Pixeln ab oder legt sie fest. (Geerbt von DataGridViewColumn)
Name	Dient zum Abrufen oder Festlegen des Namens der Spalte. (Geerbt von DataGridViewColumn)
ReadOnly	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Benutzer die Zellen der Spalte bearbeiten kann. (Geerbt von DataGridViewColumn)
Resizable	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Größe der Spalte geändert werden kann. (Geerbt von DataGridViewColumn)
Selected	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob sich das Band in einem ausgewählten Benutzeroberflächenzustand befindet. (Geerbt von DataGridViewBand)
Site	Dient zum Abrufen oder Festlegen der Website der Spalte. (Geerbt von DataGridViewColumn)
SortMode	Dient zum Abrufen oder Festlegen des Sortiermodus für die Spalte. (Geerbt von DataGridViewColumn)
State	Ruft den Benutzeroberflächenstatus des Elements ab. (Geerbt von DataGridViewElement)
Tag	Dient zum Abrufen oder Festlegen des Objekts, das Daten enthält, die dem Band zugeordnet werden sollen. (Geerbt von DataGridViewBand)
Text	Ruft den Linktext ab, der in den Zellen einer Spalte angezeigt wird, falls UseColumnTextForLinkValue vorhanden, oder legt den Linktext fest true.
ToolTipText	Dient zum Abrufen oder Festlegen des Texts, der für QuickInfos verwendet wird. (Geerbt von DataGridViewColumn)
TrackVisitedState	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Farbe der Verknüpfung geändert wird, wenn sie besucht wurde.
UseColumnTextForLinkValue	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Text Eigenschaftswert als Linktext angezeigt wird.
ValueType	Dient zum Abrufen oder Festlegen des Datentyps der Werte in den Zellen der Spalte. (Geerbt von DataGridViewColumn)
Visible	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Spalte sichtbar ist. (Geerbt von DataGridViewColumn)
VisitedLinkColor	Dient zum Abrufen oder Festlegen der Farbe, mit der ein Link angezeigt wird, der zuvor besucht wurde.
Width	Ruft die aktuelle Breite der Spalte ab oder legt sie fest. (Geerbt von DataGridViewColumn)

Methoden

Name	Beschreibung
Clone()	Erstellt eine genaue Kopie dieser Spalte.
Dispose()	Veröffentlicht alle ressourcen, die von der DataGridViewBand. (Geerbt von DataGridViewBand)
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die von den DataGridViewBand verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von DataGridViewColumn)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)	Berechnet die ideale Breite der Spalte basierend auf den angegebenen Kriterien. (Geerbt von DataGridViewColumn)
OnDataGridViewChanged()	Wird aufgerufen, wenn das Band einem anderen DataGridViewzugeordnet ist. (Geerbt von DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs)	Löst das CellClick-Ereignis aus. (Geerbt von DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Löst das CellContentClick-Ereignis aus. (Geerbt von DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Löst das CellContentDoubleClick-Ereignis aus. (Geerbt von DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Löst das CellValueChanged-Ereignis aus. (Geerbt von DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Löst das DataError-Ereignis aus. (Geerbt von DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Löst das MouseWheel-Ereignis aus. (Geerbt von DataGridViewElement)
ToString()	Ruft eine Zeichenfolge ab, die die Spalte beschreibt.

Ereignisse

Name	Beschreibung
Disposed	Tritt auf, wenn der DataGridViewColumn Verworfen wird. (Geerbt von DataGridViewColumn)

Weitere Informationen

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