Rich-UI-Widget 'Tooltip'
Ein Rich-UI-Widget 'Tooltip' definiert eine Kurzinfo (bzw. eine QuickInfo), das heißt, Texte oder Widgets, die angezeigt werden, wenn der Benutzer den Mauszeiger über ein Widget bewegt. Eine QuickInfo wird nur angezeigt, wenn Sie das Tooltip-Widget wie in diesem Abschnitt beschrieben aktivieren. Sie können dieselbe QuickInfo für mehrere Widgets verwenden und Sie können die QuickInfo für ein bestimmtes Widget als Antwort auf ein Laufzeitereignis aktivieren.
Das folgende Beispiel zeigt einen Rich-UI-Handler, der eine Schaltfläche anzeigt und eine QuickInfo
mit dem Text “To toggle the text, click the button!” zuordnet::
package myPkg;
import com.ibm.egl.rui.widgets.Box;
import com.ibm.egl.rui.widgets.Button;
import com.ibm.egl.rui.widgets.Tooltip;
import egl.ui.rui.Event;
Handler MyHandler Type RUIHandler { initialUI = [theButton],
onConstructionFunction= begin }
theButton Button { text = "Start", onClick ::= click };
theToolTip Tooltip { text = "To toggle the text, click the button!",
delay = 800 };
myBox Box{};
function begin()
theToolTip.enable(theButton);
end
Function click(e Event in)
if (theButton.text == "Start")
theButton.text = "Stop";
else
theButton.text = "Start";
end
end
end
Die folgenden Eigenschaften werden für das Tooltip-Widget unterstützt:
- text: Diese Eigenschaft enthält eine Zeichenfolge für die Anzeige. Wenn Sie hier eine Zeichenfolge angeben, wird die Eigenschaft provider nicht verwendet.
- delay: Diese Eigenschaft enthält eine Ganzzahl, die die Anzahl Millisekunden zwischen dem Beginn der Bewegung des Mauszeigers über dem Widget durch den Benutzer und der Anzeige der Kurzinfo (QuickInfo) darstellt.
- provider: Diese Eigenschaft gibt eine Funktion an, die ein Feld
für die Anzeige innerhalb der Kurzinfo zurückgibt. Nehmen Sie zum Beispiel an, dass Ihr Rich-UI-Handler
eine Schaltfläche mit der Bezeichnung "Start" anzeigt. Sie können eine QuickInfo (Tooltip) erstellen, die
für die Schaltfläche aktiviert ist und die einen Hypertext-Link in der Kurzinfo anzeigt:
Die folgende Providerfunktion macht die Ausgabe möglich:Function GoToWebsite(myWidget any in) returns(Box) myLink html{text = "You can rely on <a target = \"_blank\", href=\"http://www.ibm.com\">IBM</a>"; myBox.children = [mylink]; return(myBox); endEin Stellvertreterabschnitt mit dem Namen 'ToolTipTextProvider' beschreibt die Zugriffsmerkmale einer Funktion, die durch die Eigenschaft provider angegeben wird. Insbesondere gibt der Stellvertreterabschnitt an, dass die Providerfunktion einen Parametertyp hat und ein Feld ('Box') zurückgibt:Delegate TooltipTextProvider(widget any in) returns(Box) endBeachten Sie das Problem, das in “Rich-UI-Speicherverwaltung” beschrieben wird.
Die folgende Tooltip-Widgetfunktion wird unterstützt:
- enable(widget in): Diese Funktion aktiviert die QuickInfo für ein bestimmtes Widget, wie im ersten Beispiel gezeigt.
Zur Verwendung dieses Widgets ist die folgende Anweisung erforderlich:
import com.ibm.egl.rui.widgets.ToolTip;