ToolTip ToolTip ToolTip ToolTip Class

Definition

Stellt ein kleines Popupfenster dar, in dem eine kurze Beschreibung des Steuerelements angezeigt wird, wenn mit dem Mauszeiger auf das Steuerelement gezeigt wird.Represents a small rectangular pop-up window that displays a brief description of a control's purpose when the user rests the pointer on the control.

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
Implementiert

Beispiele

Im folgenden Codebeispiel wird eine Instanz der ToolTip -Klasse erstellt und die-Instanz mit der Form verknüpft, in der die Instanz erstellt wird.The following code example creates an instance of the ToolTip class and associates the instance with the Form that the instance is created within. Der Code initialisiert dann die Verzögerungs AutoPopDelayEigenschaften InitialDelay, und ReshowDelay.The code then initializes the delay properties AutoPopDelay, InitialDelay, and ReshowDelay. Außerdem legt die Instanz der ToolTip -Klasse die ShowAlways -Eigenschaft auf true fest, damit QuickInfo-Text immer angezeigt werden kann, unabhängig davon, ob das Formular aktiv ist.In addition the instance of the ToolTip class sets the ShowAlways property to true to enable ToolTip text to always be display regardless of whether the form is active. Schließlich ordnet das Beispiel QuickInfo Button CheckBox-Text zwei Steuerelementen in einem Formular zu: a und.Finally, the example associates ToolTip text with two controls on a form, a Button and a CheckBox. Das Codebeispiel setzt voraus, dass sich die im Beispiel definierte-Methode in Form einem befindet, Button das ein button1 -Steuerelement mit checkBox1dem Namen und ein CheckBox -Steuerelement mit dem Namen enthält, und dass die-Methode vom Konstruktor aufgerufen wird Formvon.The code example requires that the method defined in the example is located within a Form that contains a Button control named button1 and a CheckBox control named checkBox1, and that the method is called from the constructor of the 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 geben, wenn der Benutzer den Zeiger auf ein-Steuerelement platziert.With the ToolTip class, you can provide hints to a user when the user places the pointer on a control. Die ToolTip -Klasse wird in der Regel verwendet, um Benutzer auf die beabsichtigte Verwendung eines-Steuer Elements aufmerksam zu machen.The ToolTip class is typically used to alert users to the intended use of a control. Beispielsweise können Sie QuickInfo-Text für ein TextBox Steuerelement angeben, das einen Namen annimmt. dabei wird das Format des Namens angegeben, der in das Steuerelement eingegeben werden soll.For example, you can specify ToolTip text for a TextBox control that accepts a name, specifying the format of the name to be typed into the control. Zusätzlich zur Bereitstellung von hinweisen können Sie auch die ToolTip -Klasse verwenden, um Lauf Zeit Statusinformationen bereitzustellen.In addition to providing hints, you can also use the ToolTip class to provide run time status information. Beispielsweise können Sie die ToolTip -Klasse verwenden, um Verbindungsgeschwindigkeit und Zeilen Qualitätsdaten anzuzeigen, wenn der Benutzer den Zeiger auf ein PictureBox Steuerelement verschiebt, das den Internet Verbindungsstatus anzeigt.For example, you can use the ToolTip class to display connection speed and line quality data when the user moves the pointer onto a PictureBox control that displays Internet connection status.

Die ToolTip -Klasse kann in einem beliebigen Container verwendet werden.The ToolTip class can be used in any container. Um einen Container explizit anzugeben, verwenden Sie ToolTip(IContainer) den-Konstruktor.To explicitly specify a container, use the ToolTip(IContainer) constructor. Eine einzelne ToolTip Komponente wird in der Regel zum Erstellen von Quick Infos für mehrere Steuerelemente in einem einzelnen Formular verwendet.A single ToolTip component typically is used to create ToolTips for multiple controls on a single form. Nachdem Sie ein ToolTiperstellt haben, verwenden Sie einen separaten aufrufungspunkt SetToolTip , um QuickInfo-Anzeige Text einem einzelnen Steuerelement zuzuordnen.After you create a ToolTip, use a separate call to the SetToolTip method to associate ToolTip display text to an individual control. Wenn der Benutzer den Zeiger auf ein Steuerelement verschiebt, wird die QuickInfo mit dem zugehörigen Text angezeigt.Then when the user moves the pointer on a control, the ToolTip with its text is displayed. Sie können mehr SetToolTip als einmal für dasselbe Steuerelement aufgerufen werden, um den Text zu ändern, der dem Steuerelement zugeordnet ist.You can call SetToolTip more than once for the same control to change the text that is associated with the control. Verwenden Sie die GetToolTip -Methode, um den Text zu erhalten, der einem-Steuerelement zugeordnet ist.To get the text that is associated with a control, use the GetToolTip method. Um alle QuickInfo-Text Zuordnungen mit einer Instanz ToolTip der-Klasse zu RemoveAll entfernen, verwenden Sie die-Methode.To remove all ToolTip text associations with an instance of the ToolTip class, use the RemoveAll method.

Hinweis

QuickInfo-Text wird nicht für deaktivierte Steuerelemente angezeigt.ToolTip text is not displayed for controls that are disabled. Wenn die ShowAlways -Eigenschaft nicht auf truefestgelegt ist, werden Quick Infos nicht angezeigt, wenn Ihr Container inaktiv ist.Unless the ShowAlways property is set to true, ToolTips are not displayed when their container is inactive.

Die ToolTip -Klasse stellt die folgenden Eigenschaften und Methoden bereit, um das Standardverhalten und die Darstellung einer QuickInfo zu ändern.The ToolTip class provides the following properties and methods to modify the default behavior and appearance of a ToolTip.

KategorieCategory Zugeordnete MemberAssociated members
Manuelle AnzeigeManual display Active, Show, Hide, ShowAlways, Popup, StopTimerActive, Show, Hide, ShowAlways, Popup, StopTimer
Zeit Steuerungs ZeitangabeToolTip timing AutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimerAutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimer
InhaltContent SetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle, RemoveAllSetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle, RemoveAll
DarstellungAppearance BackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimation, UseFadingBackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimation, UseFading

Wenn Sie den gesamten QuickInfo-Text deaktivieren möchten, damit er nicht in der Anwendung angezeigt werden kann, können Active Sie die-Eigenschaft verwenden.If you want to disable all ToolTip text so that it cannot be displayed in your application, you can use the Active property. Normalerweise wird die QuickInfo vom Betriebs ToolTipSystem gezeichnet, aber um die Darstellung von anzupassen, können Sie die OwnerDraw -Eigenschaft auf true festlegen und das Draw -Ereignis behandeln.Usually the ToolTip is drawn by the operating system, but to customize the appearance of the ToolTip, you can set the OwnerDraw property to true and handle the Draw event.

Die ToolTipTitle -Klasse implementiert System.ComponentModel.IExtenderProvider die-Schnittstelle, die CanExtendüber eine einzige Methode verfügt.The ToolTipTitle class implements the System.ComponentModel.IExtenderProvider interface, which has a single method, CanExtend. Quick Infos erweitern Steuerelemente auf demselben Formular zur Entwurfszeit und fügen eine ToolTip Eigenschaft hinzu.ToolTips extend controls on the same form at design time, adding a ToolTip property. Weitere Informationen zu Extender-Anbietern finden Sie unter Extenderanbieter.For more information about extender providers, see Extender Providers.

Konstruktoren

ToolTip() ToolTip() ToolTip() ToolTip()

Initialisiert eine neue Instanz des ToolTip ohne einen angegebenen Container.Initializes a new instance of the ToolTip without a specified container.

ToolTip(IContainer) ToolTip(IContainer) ToolTip(IContainer) ToolTip(IContainer)

Initialisiert eine neue Instanz der ToolTip-Klasse mit einem angegebenen Container.Initializes a new instance of the ToolTip class with a specified container.

Eigenschaften

Active Active Active Active

Ruft einen Wert ab, der angibt, ob die QuickInfo gerade aktiv ist, oder legt diesen fest.Gets or sets a value indicating whether the ToolTip is currently active.

AutomaticDelay AutomaticDelay AutomaticDelay AutomaticDelay

Ruft die automatische Verzögerung für die QuickInfo ab oder legt diese fest.Gets or sets the automatic delay for the ToolTip.

AutoPopDelay AutoPopDelay AutoPopDelay 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 fest.Gets or sets the period of time the ToolTip remains visible if the pointer is stationary on a control with specified ToolTip text.

BackColor BackColor BackColor BackColor

Ruft die Hintergrundfarbe für die QuickInfo ab oder legt diese fest.Gets or sets the background color for the ToolTip.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Ruft den IContainer ab, der die Component enthält.Gets the IContainer that contains the Component.

(Inherited from Component)
CreateParams CreateParams CreateParams CreateParams

Ruft die Erstellungsparameter für das QuickInfo-Fenster ab.Gets the creation parameters for the ToolTip window.

DesignMode DesignMode DesignMode DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
ForeColor ForeColor ForeColor ForeColor

Ruft die Vordergrundfarbe für die QuickInfo ab oder legt diese fest.Gets or sets the foreground color for the ToolTip.

InitialDelay InitialDelay InitialDelay InitialDelay

Ruft die bis zum Anzeigen der QuickInfo verstreichende Zeit ab oder legt diese fest.Gets or sets the time that passes before the ToolTip appears.

IsBalloon IsBalloon IsBalloon IsBalloon

Ruft einen Wert ab, der angibt, ob für die QuickInfo ein Sprechblasenfenster verwenden werden soll, oder legt diesen fest.Gets or sets a value indicating whether the ToolTip should use a balloon window.

OwnerDraw OwnerDraw OwnerDraw OwnerDraw

Ruft einen Wert ab, der angibt, ob die QuickInfo vom Betriebssystem oder von Code, den Sie bereitstellen, gezeichnet wird, oder legt diesen fest.Gets or sets a value indicating whether the ToolTip is drawn by the operating system or by code that you provide.

ReshowDelay ReshowDelay ReshowDelay 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.Gets or sets the length of time that must transpire before subsequent ToolTip windows appear as the pointer moves from one control to another.

ShowAlways ShowAlways ShowAlways 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 fest.Gets or sets a value indicating whether a ToolTip window is displayed, even when its parent control is not active.

Site Site Site Site

Ruft den ISite von Component ab oder legt ihn fest.Gets or sets the ISite of the Component.

(Inherited from Component)
StripAmpersands StripAmpersands StripAmpersands StripAmpersands

Ruft einen Wert ab, der bestimmt, wie kaufmännische Und-Zeichen (&) behandelt werden, oder legt diesen fest.Gets or sets a value that determines how ampersand (&) characters are treated.

Tag Tag Tag Tag

Ruft das Objekt ab, das dem ToolTip zugeordnete, vom Programmierer bereitgestellte Daten enthält.Gets or sets the object that contains programmer-supplied data associated with the ToolTip.

ToolTipIcon ToolTipIcon ToolTipIcon ToolTipIcon

Ruft einen Wert ab, der den Typ des neben dem QuickInfo-Text anzuzeigenden Symbols definiert, oder legt diesen fest.Gets or sets a value that defines the type of icon to be displayed alongside the ToolTip text.

ToolTipTitle ToolTipTitle ToolTipTitle ToolTipTitle

Ruft einen Titel für das QuickInfo-Fenster ab oder legt diesen fest.Gets or sets a title for the ToolTip window.

UseAnimation UseAnimation UseAnimation UseAnimation

Ruft einen Wert ab, der bestimmt, ob beim Anzeigen der QuickInfo ein Animationseffekt verwendet werden soll, oder legt diesen fest.Gets or sets a value determining whether an animation effect should be used when displaying the ToolTip.

UseFading UseFading UseFading UseFading

Ruft einen Wert ab, der bestimmt, ob beim Anzeigen der QuickInfo ein Ausblendungseffekt verwendet werden soll, oder legt diesen fest.Gets or sets a value determining whether a fade effect should be used when displaying the ToolTip.

Methoden

CanExtend(Object) CanExtend(Object) CanExtend(Object) CanExtend(Object)

Gibt true zurück, wenn die QuickInfo eine Extendereigenschaft für die angegebene Zielkomponente anbieten kann.Returns true if the ToolTip can offer an extender property to the specified target component.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() 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.Releases the unmanaged resources and performs other cleanup operations before the Cursor is reclaimed by the garbage collector.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetToolTip(Control) GetToolTip(Control) GetToolTip(Control) GetToolTip(Control)

Ruft den QuickInfo-Text ab, der dem angegebenen Steuerelement zugeordnet ist.Retrieves the ToolTip text associated with the specified control.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
Hide(IWin32Window) Hide(IWin32Window) Hide(IWin32Window) Hide(IWin32Window)

Blendet das angegebene QuickInfo-Fenster aus.Hides the specified ToolTip window.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
RemoveAll() RemoveAll() RemoveAll() RemoveAll()

Entfernt den gesamten QuickInfo-Text, der derzeit der QuickInfo-Komponente zugeordnet ist.Removes all ToolTip text currently associated with the ToolTip component.

SetToolTip(Control, String) SetToolTip(Control, String) SetToolTip(Control, String) SetToolTip(Control, String)

Ordnet QuickInfo-Text dem angegebenen Steuerelement zu.Associates ToolTip text with the specified control.

Show(String, IWin32Window) Show(String, IWin32Window) Show(String, IWin32Window) Show(String, IWin32Window)

Legt den dem angegebenen Steuerelement zugeordneten QuickInfo-Text fest und zeigt die QuickInfo modal an.Sets the ToolTip text associated with the specified control, and displays the ToolTip modally.

Show(String, IWin32Window, Int32) Show(String, IWin32Window, Int32) Show(String, IWin32Window, Int32) Show(String, IWin32Window, Int32)

Legt den dem angegebenen Steuerelement zugeordneten QuickInfo-Text fest und zeigt die QuickInfo dann während einer angegebenen Zeitdauer an.Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration.

Show(String, IWin32Window, Int32, Int32) Show(String, IWin32Window, Int32, Int32) Show(String, IWin32Window, Int32, Int32) 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.Sets the ToolTip text associated with the specified control, and then displays the ToolTip modally at the specified relative position.

Show(String, IWin32Window, Int32, Int32, Int32) Show(String, IWin32Window, Int32, Int32, Int32) Show(String, IWin32Window, Int32, Int32, Int32) 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.Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration at the specified relative position.

Show(String, IWin32Window, Point) Show(String, IWin32Window, Point) Show(String, IWin32Window, Point) 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.Sets the ToolTip text associated with the specified control, and then displays the ToolTip modally at the specified relative position.

Show(String, IWin32Window, Point, Int32) Show(String, IWin32Window, Point, Int32) Show(String, IWin32Window, Point, Int32) 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.Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration at the specified relative position.

StopTimer() StopTimer() StopTimer() StopTimer()

Hält den Zeitgeber an, der angezeigte QuickInfos ausblendet.Stops the timer that hides displayed ToolTips.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolgendarstellung für dieses Steuerelement zurück.Returns a string representation for this control.

Ereignisse

Disposed Disposed Disposed Disposed

Tritt ein, wenn die Komponente durch einen Aufruf der Dispose()-Methode freigegeben wird.Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
Draw Draw Draw Draw

Tritt ein, wenn die QuickInfo gezeichnet wird und die OwnerDraw-Eigenschaft auf true und die IsBalloon-Eigenschaft auf false festgelegt ist.Occurs when the ToolTip is drawn and the OwnerDraw property is set to true and the IsBalloon property is false.

Popup Popup Popup Popup

Tritt ein, bevor eine QuickInfo anfänglich angezeigt wird.Occurs before a ToolTip is initially displayed. Dies ist das Standardereignis für die ToolTip-Klasse.This is the default event for the ToolTip class.

Gilt für:

Siehe auch