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 Form zugeordnet, in der 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 auf fest true , damit 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 zu, einem Button und einem CheckBox. Das Codebeispiel erfordert, dass sich die im Beispiel definierte Methode in einem Form befindet, das ein Button Steuerelement mit dem Namen button1 und ein CheckBox Steuerelement mit dem Namen enthält checkBox1, und dass die -Methode vom Konstruktor des Formaufgerufen wird.

// 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 geben, wenn der Benutzer den Zeiger auf ein Steuerelement platziert. Die ToolTip -Klasse wird in der Regel verwendet, um Benutzer über die beabsichtigte Verwendung eines Steuerelements zu warnen. Sie können beispielsweise 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 die ToolTip -Klasse auch verwenden, um Laufzeitstatusinformationen bereitzustellen. Beispielsweise können Sie die ToolTip -Klasse verwenden, um Daten zur Verbindungsgeschwindigkeit und Leitungsqualität anzuzeigen, wenn der Benutzer den Zeiger auf ein PictureBox Steuerelement verschiebt, das den Internetverbindungsstatus anzeigt.

Die ToolTip -Klasse kann in jedem Container verwendet werden. Um einen Container explizit anzugeben, verwenden Sie den ToolTip(IContainer) Konstruktor. Eine einzelne ToolTip Komponente wird in der Regel verwendet, um QuickInfos für mehrere Steuerelemente in einem einzigen Formular zu erstellen. Nachdem Sie einen ToolTiperstellt haben, verwenden Sie einen separaten Aufruf der SetToolTip -Methode, um QuickInfo-Anzeigetext einem einzelnen Steuerelement zuzuordnen. Wenn der Benutzer dann den Zeiger auf ein Steuerelement verschiebt, wird die QuickInfo mit seinem Text angezeigt. Sie können mehrere Aufrufe für dasselbe Steuerelement ausführen 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, sodass er nicht in Ihrer Anwendung angezeigt werden kann, können Sie die Active -Eigenschaft verwenden. Normalerweise wird die QuickInfo vom Betriebssystem gezeichnet, aber um die Darstellung von ToolTipanzupassen, können Sie die OwnerDraw -Eigenschaft auf true festlegen und das Draw Ereignis behandeln.

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

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Gilt für:

Weitere Informationen

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