Teilen über


ToolTip Klasse

Definition

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 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
Implementiert

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.

Dispose(Boolean)

Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.

(Geerbt von Component)
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()
Veraltet.

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()
Veraltet.

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.

Gilt für:

Weitere Informationen