(0) exportieren Drucken
Alle erweitern

DataGridViewCellToolTipTextNeededEventArgs-Klasse

Aktualisiert: November 2007

Stellt Daten für das CellToolTipTextNeeded-Ereignis bereit.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public class DataGridViewCellToolTipTextNeededEventArgs : DataGridViewCellEventArgs
public class DataGridViewCellToolTipTextNeededEventArgs extends DataGridViewCellEventArgs
public class DataGridViewCellToolTipTextNeededEventArgs extends DataGridViewCellEventArgs

Das CellToolTipTextNeeded-Ereignis tritt nur auf, wenn die DataSource-Eigenschaft für das DataGridView-Steuerelement festgelegt ist oder seine VirtualMode-Eigenschaft true ist.

Wenn Sie das CellToolTipTextNeeded-Ereignis behandeln, wird der im Handler angegebene QuickInfo-Text immer dann angezeigt, wenn sich der Mauszeiger über einer Zelle befindet und der ShowCellToolTips-Eigenschaftenwert des Steuerelements true ist. Das CellToolTipTextNeeded-Ereignis ist hilfreich, wenn Sie QuickInfos anzeigen möchten, die durch den aktuellen Zustand oder den Wert einer Zelle bestimmt werden.

Das CellToolTipTextNeeded-Ereignis tritt auch immer dann ein, wenn der Wert der DataGridViewCell.ToolTipText-Eigenschaft abgerufen wird, sei es programmgesteuert oder wenn der Mauszeiger in eine Zelle gesetzt wird.

Sie können mithilfe der ColumnIndex-Eigenschaft und der RowIndex-Eigenschaft den Zustand bzw. Wert einer Zelle bestimmen und anhand dieser Information die ToolTipText-Eigenschaft festlegen. Diese Eigenschaft wird mit dem Wert der ToolTipText-Eigenschaft der Zelle initialisiert, die vom Ereigniswert überschrieben wird.

Behandeln Sie das CellToolTipTextNeeded-Ereignis, wenn Sie mit großen Datenmengen arbeiten, um beim Festlegen des ToolTipText-Zellenwerts für mehrere Zellen Leistungseinbußen zu verhindern. Weitere Informationen finden Sie unter Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms.

Weitere Informationen über die Behandlung von Ereignissen finden Sie unter Behandeln von Ereignissen.

Im folgenden Codebeispiel wird ToolTipText mit Informationen aus ausgeblendeten Zellen in DataGridView gefüllt.

void dataGridView1_CellToolTipTextNeeded(object sender,
    DataGridViewCellToolTipTextNeededEventArgs e)
{
    string newLine = Environment.NewLine;
    if (e.RowIndex > -1)
    {
        DataGridViewRow dataGridViewRow1 = dataGridView1.Rows[e.RowIndex];

        // Add the employee's ID to the ToolTipText.
        e.ToolTipText = String.Format("EmployeeID {0}:{1}",
            dataGridViewRow1.Cells["EmployeeID"].Value, newLine);

        // Add the employee's name to the ToolTipText.
        e.ToolTipText += String.Format("{0} {1} {2}{3}",
            dataGridViewRow1.Cells["TitleOfCourtesy"].Value.ToString(),
            dataGridViewRow1.Cells["FirstName"].Value.ToString(),
            dataGridViewRow1.Cells["LastName"].Value.ToString(),
            newLine);

        // Add the employee's title to the ToolTipText.
        e.ToolTipText += String.Format("{0}{1}{2}",
            dataGridViewRow1.Cells["Title"].Value.ToString(),
            newLine, newLine);

        // Add the employee's contact information to the ToolTipText.
        e.ToolTipText += String.Format("{0}{1}{2}, ",
            dataGridViewRow1.Cells["Address"].Value.ToString(), newLine,
            dataGridViewRow1.Cells["City"].Value.ToString());
        if (!String.IsNullOrEmpty(
            dataGridViewRow1.Cells["Region"].Value.ToString()))
        {
            e.ToolTipText += String.Format("{0}, ",
                dataGridViewRow1.Cells["Region"].Value.ToString());
        }
        e.ToolTipText += String.Format("{0}, {1}{2}{3} EXT:{4}{5}{6}",
            dataGridViewRow1.Cells["Country"].Value.ToString(),
            dataGridViewRow1.Cells["PostalCode"].Value.ToString(),
            newLine, dataGridViewRow1.Cells["HomePhone"].Value.ToString(),
            dataGridViewRow1.Cells["Extension"].Value.ToString(),
            newLine, newLine);

        // Add employee information to the ToolTipText.
        DateTime HireDate =
            (DateTime)dataGridViewRow1.Cells["HireDate"].Value;
        e.ToolTipText +=
            String.Format("Employee since: {0}/{1}/{2}{3}Manager: {4}",
            HireDate.Month.ToString(), HireDate.Day.ToString(),
            HireDate.Year.ToString(), newLine,
            dataGridViewRow1.Cells["Manager"].Value.ToString());
    }
}


System.Object
  System.EventArgs
    System.Windows.Forms.DataGridViewCellEventArgs
      System.Windows.Forms.DataGridViewCellToolTipTextNeededEventArgs

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft