ToolTip Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Stellt ein kleines Popupfenster dar, in dem eine kurze Beschreibung des Steuerelements angezeigt wird, wenn mit dem Mauszeiger auf das Steuerelement gezeigt wird.

public ref 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 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.

Hinweis

QuickInfo-Text wird für deaktivierte Steuerelemente nicht angezeigt. Es sei denn, die ShowAlways Eigenschaft ist auf truefestgelegt, werden QuickInfos nicht angezeigt, wenn ihr Container inaktiv ist.

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

Category	Zugeordnete Elemente
Manuelle Anzeige	Active, Show, Hide, ShowAlways, Popup, StopTimer
QuickInfo-Zeitpunkt	AutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimer
Inhalt	SetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle, RemoveAll
Darstellung	BackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimation, UseFading

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

ToolTip()	Initialisiert eine neue Instanz des ToolTip ohne einen angegebenen Container.
ToolTip(IContainer)	Initialisiert eine neue Instanz der ToolTip-Klasse mit einem angegebenen Container.

Eigenschaften

Active	Ruft einen Wert ab, der angibt, ob die QuickInfo gerade aktiv ist, oder legt diesen fest.
AutomaticDelay	Ruft die automatische Verzögerung für die QuickInfo ab oder legt diese fest.
AutoPopDelay	Ruft die Zeitspanne ab, während der die QuickInfo sichtbar bleibt, wenn der Zeiger auf einem Steuerelement mit angegebenem QuickInfo-Text nicht bewegt wird, oder legt diese Zeitspanne fest.
BackColor	Ruft die Hintergrundfarbe für die QuickInfo ab oder legt diese fest.
CanRaiseEvents	Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component)
Container	Ruft die IContainer ab, die in der Component enthalten ist. (Geerbt von Component)
CreateParams	Ruft die Erstellungsparameter für das QuickInfo-Fenster ab.
DesignMode	Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Geerbt von Component)
Events	Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Geerbt von Component)
ForeColor	Ruft die Vordergrundfarbe für die QuickInfo ab oder legt diese fest.
InitialDelay	Ruft die bis zum Anzeigen der QuickInfo verstreichende Zeit ab oder legt diese fest.
IsBalloon	Ruft einen Wert ab, der angibt, ob für die QuickInfo ein Sprechblasenfenster verwenden werden soll, oder legt diesen fest.
OwnerDraw	Ruft einen Wert ab, der angibt, ob die QuickInfo vom Betriebssystem oder von dem Code, den Sie bereitstellen, gezeichnet wird, oder legt diesen Wert fest.
ReshowDelay	Ruft die Zeitspanne für das Anzeigen weiterer QuickInfo-Fenster ab, wenn der Zeiger von einem Steuerelement zu einem anderen bewegt wird, oder legt diese fest.
ShowAlways	Ruft einen Wert ab, der angibt, ob ein QuickInfo-Fenster auch dann angezeigt wird, wenn das übergeordnete Steuerelement nicht aktiv ist, oder legt diesen Wert fest.
Site	Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component)
StripAmpersands	Ruft einen Wert ab, der bestimmt, wie kaufmännische Und-Zeichen (&) behandelt werden, oder legt diesen fest.
Tag	Ruft das Objekt ab, das dem ToolTip zugeordnete, vom Programmierer bereitgestellte Daten enthält.
ToolTipIcon	Ruft einen Wert ab, der den Typ des neben dem QuickInfo-Text anzuzeigenden Symbols definiert, oder legt diesen fest.
ToolTipTitle	Ruft einen Titel für das QuickInfo-Fenster ab oder legt diesen fest.
UseAnimation	Ruft einen Wert ab, der bestimmt, ob beim Anzeigen der QuickInfo ein Animationseffekt verwendet werden soll, oder legt diesen fest.
UseFading	Ruft einen Wert ab, der bestimmt, ob beim Anzeigen der QuickInfo ein Ausblendungseffekt verwendet werden soll, oder legt diesen fest.

Methoden

CanExtend(Object)	Gibt true zurück, wenn die QuickInfo eine Extendereigenschaft für die angegebene Zielkomponente anbieten kann.
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle vom Component verwendeten Ressourcen frei. (Geerbt von Component)
Dispose(Boolean)	Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Finalize()	Gibt nicht verwaltete Ressourcen frei und führt andere Bereinigungsvorgänge durch, bevor der Cursor durch die Garbage Collection wieder zugänglich gemacht wird.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetService(Type)	Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Geerbt von Component)
GetToolTip(Control)	Ruft den QuickInfo-Text ab, der dem angegebenen Steuerelement zugeordnet ist.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Hide(IWin32Window)	Blendet das angegebene QuickInfo-Fenster aus.
InitializeLifetimeService()	Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
RemoveAll()	Entfernt den gesamten QuickInfo-Text, der derzeit der QuickInfo-Komponente zugeordnet ist.
SetToolTip(Control, String)	Ordnet QuickInfo-Text dem angegebenen Steuerelement zu.
Show(String, IWin32Window)	Legt den dem angegebenen Steuerelement zugeordneten QuickInfo-Text fest und zeigt die QuickInfo modal an.
Show(String, IWin32Window, Int32)	Legt den dem angegebenen Steuerelement zugeordneten QuickInfo-Text fest und zeigt die QuickInfo dann während einer angegebenen Zeitdauer an.
Show(String, IWin32Window, Int32, Int32)	Legt den dem angegebenen Steuerelement zugeordneten QuickInfo-Text fest und zeigt die QuickInfo dann modal an der angegebenen relativen Position an.
Show(String, IWin32Window, Int32, Int32, Int32)	Legt den dem angegebenen Steuerelement zugeordneten QuickInfo-Text fest und zeigt die QuickInfo dann während der angegebenen Zeitdauer an der angegebenen relativen Position an.
Show(String, IWin32Window, Point)	Legt den dem angegebenen Steuerelement zugeordneten QuickInfo-Text fest und zeigt die QuickInfo dann modal an der angegebenen relativen Position an.
Show(String, IWin32Window, Point, Int32)	Legt den dem angegebenen Steuerelement zugeordneten QuickInfo-Text fest und zeigt die QuickInfo dann während der angegebenen Zeitdauer an der angegebenen relativen Position an.
StopTimer()	Hält den Zeitgeber an, der angezeigte QuickInfos ausblendet.
ToString()	Gibt eine Zeichenfolgendarstellung für dieses Steuerelement zurück.

Ereignisse

Disposed	Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird. (Geerbt von Component)
Draw	Tritt ein, wenn die QuickInfo gezeichnet wird und die OwnerDraw-Eigenschaft auf true und die IsBalloon-Eigenschaft auf false festgelegt ist.
Popup	Tritt ein, bevor eine QuickInfo anfänglich angezeigt wird. Dies ist das Standardereignis für die ToolTip-Klasse.

Weitere Informationen

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