TextGadget()

Syntax

Ergebnis = TextGadget(#Gadget, x, y, Breite, Höhe, Text$ [, Flags])
Beschreibung
Erstellt ein Text-Gadget innerhalb der Gadget-Liste. Ein Text-Gadget ist ein einfacher Textbereich zum Anzeigen eines (nicht editierbaren) Textes.

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 anzuzeigende Text.
Flags (optional) Flags zum Verändern des Gadget-Verhaltens. Dies kann eine Kombination (verknüpft mit dem bitweisen '|' OR-Operator) der folgenden Konstanten sein:
  #PB_Text_Center : Der Text wird im Gadget zentriert dargestellt.
  #PB_Text_Right  : Der Text wird rechtsbündig dargestellt.
  #PB_Text_Border : Ein vertiefter Rand wird rings um das Gadget gezeichnet.

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

Der Inhalt des Gadgets kann mit dem Befehl SetGadgetText() verändert werden und mit GetGadgetText() ermittelt werden. Den Zeichensatz eines TextGadget() können Sie mittels SetGadgetFont() ändern.

Dieses Gadget unterstützt die SetGadgetColor() und GetGadgetColor() Befehle mit den folgenden Werten als 'FarbTyp':
  #PB_Gadget_FrontColor: Textfarbe
  #PB_Gadget_BackColor : Hintergrundfarbe
Hinweis: Dieses Gadget empfängt keinerlei Anwendereingaben, auch GadgetToolTip() kann damit nicht verwendet werden.

Beispiel

  If OpenWindow(0, 0, 0, 270, 160, "TextGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    TextGadget(0, 10,  10, 250, 20, "TextGadget Standard (Left)")
    TextGadget(1, 10,  70, 250, 20, "TextGadget Center", #PB_Text_Center)
    TextGadget(2, 10,  40, 250, 20, "TextGadget Right", #PB_Text_Right)
    TextGadget(3, 10, 100, 250, 20, "TextGadget Border", #PB_Text_Border)
    TextGadget(4, 10, 130, 250, 20, "TextGadget Center + Border", #PB_Text_Center | #PB_Text_Border)
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Siehe auch

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

Unterstützte OS

Alle

<- StringGadget() - Gadget Inhaltsverzeichnis - TrackBarGadget() ->