ToolTip Klasse

Definition

public ref class ToolTip sealed : System::ComponentModel::Component, System::ComponentModel::IExtenderProvider

public ref class ToolTip : System::ComponentModel::Component, System::ComponentModel::IExtenderProvider

public sealed class ToolTip : System.ComponentModel.Component, System.ComponentModel.IExtenderProvider

public class ToolTip : System.ComponentModel.Component, System.ComponentModel.IExtenderProvider

type ToolTip = class
    inherit Component
    interface IExtenderProvider

Public NotInheritable Class ToolTip
Inherits Component
Implements IExtenderProvider

Public Class ToolTip
Inherits Component
Implements IExtenderProvider

Vererbung

Object

MarshalByRefObject

Component

ToolTip

Implementiert

IExtenderProvider

Beispiele

Im folgenden Codebeispiel wird eine Instanz der ToolTip Klasse erstellt und der Instanz zugeordnet, in der Form die Instanz erstellt wird. Der Code initialisiert dann die Verzögerungseigenschaften AutoPopDelay, InitialDelayund ReshowDelay. Darüber hinaus legt die Instanz der ToolTip Klasse die ShowAlways Eigenschaft so fest, dass true QuickInfo-Text immer angezeigt werden kann, unabhängig davon, ob das Formular aktiv ist. Schließlich ordnet das Beispiel QuickInfo-Text zwei Steuerelementen in einem Formular, einem Button und einem Steuerelement CheckBoxzu. Das Codebeispiel erfordert, dass sich die im Beispiel definierte Methode in einem Form Steuerelement befindet, das ein Button Steuerelement namens button1 und ein CheckBox Steuerelement mit dem Namen checkBox1enthält, und dass die Methode vom Konstruktor der .Form

// This example assumes that the Form_Load event handling method
// is connected to the Load event of the form.
void Form1_Load( Object^ sender, System::EventArgs^ e )
{
   // Create the ToolTip and associate with the Form container.
   ToolTip^ toolTip1 = gcnew ToolTip;
   
   // Set up the delays for the ToolTip.
   toolTip1->AutoPopDelay = 5000;
   toolTip1->InitialDelay = 1000;
   toolTip1->ReshowDelay = 500;
   // Force the ToolTip text to be displayed whether or not the form is active.
   toolTip1->ShowAlways = true;
   
   // Set up the ToolTip text for the Button and Checkbox.
   toolTip1->SetToolTip( this->button1, "My button1" );
   toolTip1->SetToolTip( this->checkBox1, "My checkBox1" );
}

// This example assumes that the Form_Load event handling method
// is connected to the Load event of the form.
private void Form1_Load(object sender, System.EventArgs e)
{
   // Create the ToolTip and associate with the Form container.
   ToolTip toolTip1 = new ToolTip();

   // Set up the delays for the ToolTip.
   toolTip1.AutoPopDelay = 5000;
   toolTip1.InitialDelay = 1000;
   toolTip1.ReshowDelay = 500;
   // Force the ToolTip text to be displayed whether or not the form is active.
   toolTip1.ShowAlways = true;
      
   // Set up the ToolTip text for the Button and Checkbox.
   toolTip1.SetToolTip(this.button1, "My button1");
   toolTip1.SetToolTip(this.checkBox1, "My checkBox1");
}

' This example assumes that the Form_Load event handling method
' is connected to the Load event of the form.
Private Sub Form1_Load(sender As Object, e As System.EventArgs) Handles MyBase.Load
   ' Create the ToolTip and associate with the Form container.
   Dim toolTip1 As New ToolTip()
   
   ' Set up the delays for the ToolTip.
   toolTip1.AutoPopDelay = 5000
   toolTip1.InitialDelay = 1000
   toolTip1.ReshowDelay = 500
   ' Force the ToolTip text to be displayed whether or not the form is active.
   toolTip1.ShowAlways = True
   
   ' Set up the ToolTip text for the Button and Checkbox.
   toolTip1.SetToolTip(Me.button1, "My button1")
   toolTip1.SetToolTip(Me.checkBox1, "My checkBox1")
End Sub

Hinweise

Mit der ToolTip Klasse können Sie einem Benutzer Hinweise bereitstellen, wenn der Benutzer den Zeiger auf ein Steuerelement platziert. Die ToolTip Klasse wird in der Regel verwendet, um Benutzer auf die beabsichtigte Verwendung eines Steuerelements hinzuweisen. Sie können z. B. QuickInfo-Text für ein TextBox Steuerelement angeben, das einen Namen akzeptiert, und das Format des Namens angeben, der in das Steuerelement eingegeben werden soll. Zusätzlich zum Bereitstellen von Hinweisen können Sie auch die ToolTip Klasse verwenden, um Laufzeitstatusinformationen bereitzustellen. Sie können z. B. die ToolTip Klasse verwenden, um Verbindungsgeschwindigkeits- und Zeilenqualitätsdaten anzuzeigen, wenn der Benutzer den Mauszeiger auf ein PictureBox Steuerelement verschiebt, das den Internetverbindungsstatus anzeigt.

Die ToolTip Klasse kann in jedem Container verwendet werden. Verwenden Sie den ToolTip(IContainer) Konstruktor, um einen Container explizit anzugeben. Eine einzelne ToolTip Komponente wird in der Regel verwendet, um QuickInfos für mehrere Steuerelemente in einem einzigen Formular zu erstellen. Verwenden Sie nach dem Erstellen eines ToolTipSteuerelements einen separaten Aufruf der SetToolTip Methode, um QuickInfo-Anzeigetext einem einzelnen Steuerelement zuzuordnen. Wenn der Benutzer dann den Mauszeiger auf ein Steuerelement verschiebt, wird die QuickInfo mit seinem Text angezeigt. Sie können mehrere Mal für dasselbe Steuerelement aufrufen SetToolTip , um den Text zu ändern, der dem Steuerelement zugeordnet ist. Verwenden Sie die Methode, um den Text abzurufen, der GetToolTip einem Steuerelement zugeordnet ist. Verwenden Sie die RemoveAll Methode, um alle QuickInfo-Textzuordnungen mit einer Instanz der ToolTip Klasse zu entfernen.

Die ToolTip Klasse stellt die folgenden Eigenschaften und Methoden bereit, um das Standardverhalten und die Darstellung einer QuickInfo zu ändern.

Wenn Sie den gesamten QuickInfo-Text deaktivieren möchten, damit er in Ihrer Anwendung nicht angezeigt werden kann, können Sie die Active Eigenschaft verwenden. Normalerweise wird die QuickInfo vom Betriebssystem gezeichnet, aber um die Darstellung der ToolTipEigenschaft anzupassen, können Sie die OwnerDraw Eigenschaft auf true das Draw Ereignis festlegen und behandeln.

Die ToolTipTitle Klasse implementiert die System.ComponentModel.IExtenderProvider Schnittstelle, die über eine einzelne Methode verfügt. CanExtend QuickInfos erweitern Steuerelemente auf demselben Formular zur Entwurfszeit und fügen eine ToolTip Eigenschaft hinzu. Weitere Informationen zu Extenderanbietern finden Sie unter Extender-Anbieter.

Weitere Informationen

• ToolTipIcon
• HelpProvider
• Extenderanbieter
• QuickInfo-Komponente (Windows Forms)