HyperLinkGadget

HyperLinkGadget()

Syntax

Ergebnis = HyperLinkGadget(#Gadget, x, y, Breite, Höhe, Text$, Farbe [, Flags])

Beschreibung

Erstellt ein HyperLink-Gadget innerhalb der aktuellen Gadgetliste. Ein HyperLink-Gadget ist ein Textbereich, welcher auf den Mauszeiger durch Veränderung seiner Farbe und der Cursorform reagiert.

Parameter

#Gadget Eine Nummer, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.

x, y, Breite, Höhe Die Position und die Abmessungen des neuen Gadgets.

Text$ Der Text, welcher als Link dargestellt werden soll.

Farbe Die Farbe des Textes, wenn sich die Maus über dem Gadget befindet. Die Farbe für den Status "nicht hervorgehoben" (englisch "non-highlighted") kann mittels SetGadgetColor() geändert werden.
Flags (optional)
Flags zum Verändern des Gadget-Verhaltens. Dies kann folgende Konstante sein:
  #PB_Hyperlink_Underline: Zeichnet eine Linie unter den Text, ohne die Notwendigkeit für einen unterstrichenen 
                                     Zeichensatz.

Rückgabewert

Gibt bei Erfolg einen Wert ungleich Null zurück, oder Null bei einem Fehler. Wenn #PB_Any als #Gadget Parameter verwendet wurde, dann beinhaltet der Rückgabewert bei Erfolg die automatisch generierte Gadget-Nummer.

Anmerkungen

Zu diesem Gadget kann mittels GadgetToolTip() eine 'Mini-Hilfe' hinzugefügt werden.

Dieses Gadget unterstützt die SetGadgetColor() und GetGadgetColor() Befehle mit den #PB_Gadget_FrontColor und #PB_Gadget_BackColor Typen, um die Farbe des Textes und des Hintergrundes (wenn der Fenster-Hintergrund verändert wurde) zu ändern.

Beispiel

  If OpenWindow(0, 0, 0, 270, 160, "HyperlinkGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    HyperLinkGadget(0, 10, 10, 250, 20, "Red HyperLink", RGB(255,0,0))
    HyperLinkGadget(1, 10, 30, 250, 40, "Arial Underlined Green HyperLink", RGB(0,255,0), #PB_HyperLink_Underline)
    SetGadgetFont(1, LoadFont(0, "Arial", 12))
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Siehe auch

GetGadgetText(), SetGadgetText(), GetGadgetColor(), SetGadgetColor()

Unterstützte OS

Alle

<- HideGadget() - Gadget Inhaltsverzeichnis - IPAddressGadget() ->

#Gadget	Eine Nummer, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
x, y, Breite, Höhe	Die Position und die Abmessungen des neuen Gadgets.
Text$	Der Text, welcher als Link dargestellt werden soll.
Farbe	Die Farbe des Textes, wenn sich die Maus über dem Gadget befindet. Die Farbe für den Status "nicht hervorgehoben" (englisch "non-highlighted") kann mittels SetGadgetColor() geändert werden.
Flags (optional)	Flags zum Verändern des Gadget-Verhaltens. Dies kann folgende Konstante sein: #PB_Hyperlink_Underline: Zeichnet eine Linie unter den Text, ohne die Notwendigkeit für einen unterstrichenen Zeichensatz.