Download Safari Books Online apps: Apple iOS | Android

Entire Site

Safari Books Online

    Free Trial

    Safari Books Online is a digital library providing on-demand subscription access to thousands of learning resources.


    • Create BookmarkCreate Bookmark
    • Create Note or TagCreate Note or Tag
    • PrintPrint
    Share this Page URL
    Help

    Steuerelemente zur Benutzerunterstützung > Das ToolTip-Steuerelement

    Das ToolTip-Steuerelement

    Das ToolTip-Steuerelement ist wohl das klassische passive Unterstützungselement schlechthin. Es erlaubt die Darstellung von kurzen Texten in einem automatisch erscheinenden, knapp bemessenen Fenster.

    Viele Steuerelemente wie das ListView-Steuerelement, das TreeView-Steuerelement oder die Symbolleiste unterstützen Tooltipps direkt. Allerdings müssen Sie die Verwendung in der Regel über eine Eigenschaft einschalten oder den anzuzeigenden Text in der vorgesehenen Eigenschaft ToolTipText definieren. Insbesondere ist es im Zusammenhang mit diesen Steuerelementen nicht notwendig, das ToolTip-Steuerelement zu verwenden.

    Alle über die gerade beschriebenen Standardmöglichkeiten hinausgehenden Anwendungen von Tooltipps erfordern den Einsatz des ToolTip-Steuerelements. Das Steuerelement ist so aufgebaut, dass eigentlich anwendungsweit nur eine Instanz erforderlich wäre. Sie werden es aber leichter haben, wenn Sie ein Element pro Fenster verwenden.

    Sobald Sie das ToolTip-Steuerelement aus der Toolbox von Visual Studio in den Dialogfeldeditor gezogen haben, werden sämtliche Steuerelemente des Dialogfelds mit einer zusätzlichen Eigenschaft ToolTip für die Definition des Tooltipptexts versehen. Daraus ergibt sich eine geteilte Konfiguration der Tooltipps. Mit den Eigenschaften des ToolTip-Steuerelements definieren Sie das technische Verhalten und die Optik des Tooltipps, der angezeigte Text des Tooltipps wird hingegen auf dem Steuerelement definiert, das einen Text anzeigen soll.

    Abbildung 4.44 zeigt diesen Umstand im Editor. Sie sehen darin das Dialogfeld der Demo für das Thema dieses Abschnitts. Die Demo verwendet zwei verschiedene ToolTip-Steuerelemente, weil die optische Konfiguration unterschiedlich ist. Die Namen der beiden Steuerelemente lauten toolTip und toolTipBalloon. In der gezeigten Situation in Abbildung 4.44 ist das linke Panel-Steuerelement ausgewählt und demzufolge sind im Eigenschaftseditor seine Eigenschaften dargestellt. Sie erkennen nun darin die beiden generierten Einträge der ToolTip-Steuerelemente, die mit der Bezeichnung ToolTip on Elementname versehen sind.

    Achtung

    Wenn Sie in der in Abbildung 4.44 gezeigten Situation in beiden möglichen ToolTip-Eigenschaften einen Text definieren, werden zur Laufzeit auch beide Tooltipps angezeigt. Das entspricht wiederum nicht den Gepflogenheiten der Oberflächengestaltung! Sie benutzen also besser nur ein ToolTip-Steuerelement pro Fenster.

    Situation im Dialogfeldeditor für die Definition der Tooltipptexte

    Abbildung 4.44 Situation im Dialogfeldeditor für die Definition der Tooltipptexte

    Wie oben angedeutet, ist das ToolTip-Steuerelement für die Definition der Optik, aber auch für das eigentliche funktionelle Verhalten verantwortlich. Dazu dienen die in Tabelle 4.42 vorgestellten wichtigen Elemente der Klasse.

    Tabelle 4.42 Wichtige Elemente der Klasse ToolTip

    Member

    Name

    Beschreibung

    Active

    Liefert oder definiert true, wenn das ToolTip-Steuerelement aktiv ist. Aktiv heißt in diesem Fall, dass der Tooltipp beim Überstreichen von Elementen die registrierten Texte anzeigt.

    AutomaticDelay

    Liefert oder definiert die Verzögerung der Aktivität des Tooltipps. Das Definieren dieser Eigenschaft hat zur Folge, dass die drei Eigenschaften AutoPopDelay, InitialDelay und ReshowDelay mit dem gleichen Wert definiert werden. Die drei Eigenschaften können anschließend individuell eingestellt werden.

    AutoPopDelay, InitialDelay, ReshowDelay

    Liefert oder definiert die Verzögerungen der Darstellung in Millisekunden

    IsBalloon

    Liefert oder definiert true, wenn der Tooltipp als Sprechblase dargestellt werden soll

    ShowAlways

    Liefert oder definiert true, wenn der Tooltipp die Texte anzeigt, auch wenn das Elternfenster nicht aktiv ist

    StripAmpersands

    Liefert oder definiert true, wenn das &-Zeichen in einem Text eliminiert werden soll. Diese Option kann Ihnen behilflich sein, wenn Sie Texte aus Ressourcen, die Sie auch für Menüs benutzen, wieder verwenden wollen

    ToolTipIcon

    Liefert oder definiert das Symbol, das zusammen mit dem Text angezeigt werden soll. Die möglichen Werte sind None, Error, Info, Warning.

    ToolTipTitle

    Liefert oder definiert den Text, der als Titel zum Tooltipp angezeigt wird. Der Titel kann maximal 99 Zeichen umfassen.

    UseAnimation

    Liefert oder definiert true, wenn beim Ein- und Ausblenden des Tooltipps die Windows-Animation verwendet wird. Diese Eigenschaft wirkt erst ab Windows XP und nur, wenn sie im System eingeschaltet ist.

    UseFading

    Liefert oder definiert true, wenn beim Ein- und Ausblenden der Tooltipps sanft auf- und abgeblendet wird. Diese Eigenschaft wirkt erst ab Windows XP und nur, wenn sie im System eingeschaltet ist.

    GetToolTip()

    Liefert den Text, der einem bestimmten Element zugeordnet ist

    Hide()

    Löscht das definierte Tooltippfenster

    RemoveAll()

    Löscht alle Texte, die dem ToolTip-Steuerelement zugeordnet sind

    SetToolTip()

    Definiert für ein bestimmtes Steuerelement einen Text im ToolTip-Steuerelement

    Show()

    Definiert einen Text und zeigt diesen an

    Popup

    Wird ausgelöst, wenn das Tooltippfenster gezeichnet wird

    Das Beispiel des Kapitels zeigt in der Abbildung 4.45 die beiden optischen Möglichkeiten eines Tooltipps.

    Optik des ToolTip-Steuerelements

    Abbildung 4.45 Optik des ToolTip-Steuerelements

    Der linke Tooltipp zeigt lediglich den Text und dient in der Regel als Kurzhilfe, die darüber informiert, was mit einem Element gemacht werden kann. Das rechte Element zeigt eine Sprechblase, die mit einem Titel und einem Symbol veredelt werden kann. Diese Art von Tooltipps verwenden wir, um einen Benutzer auf einen möglichen Bedienfehler oder anderen Umstand aufmerksam zu machen, der zu einem Fehler führen könnte. Beachten Sie, dass eine Sprechblase nicht ein Meldungsfeld ersetzt, das nach dem Eintreten eines Fehlers zum Einsatz kommt.