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 Gibt eine Nummer an, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.

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

Text$ Gibt den Text an, welcher als Link dargestellt werden soll.

Farbe Gibt die Farbe für den Text an, 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)
Gibt optionale Flags an, um das Gadget-Verhalten zu verändern. 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 dem #PB_Gadget_FrontColor Typ, um die Textfarbe zu ändern. Die Hintergrundfarbe ist immer die Farbe des Fensters.

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,20,"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	Gibt eine Nummer an, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
x, y, Breite, Höhe	Geben die Position und die Abmessungen des neuen Gadgets an.
Text$	Gibt den Text an, welcher als Link dargestellt werden soll.
Farbe	Gibt die Farbe für den Text an, 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)	Gibt optionale Flags an, um das Gadget-Verhalten zu verändern. Dies kann folgende Konstante sein: #PB_Hyperlink_Underline: Zeichnet eine Linie unter den Text, ohne die Notwendigkeit für einen unterstrichenen Zeichensatz.