EditorGadget()

Syntax

Ergebnis = EditorGadget(#Gadget, x, y, Breite, Höhe [, Flags])

Erstellt ein Editor-Gadget innerhalb der aktuellen Gadgetliste.

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.
Flags (optional)	Gibt optionale Flags an, um das Gadget-Verhalten zu verändern. Dies kann folgender Wert sein: #PB_Editor_ReadOnly: Der Anwender kann den Text im Gadget nicht editieren (readonly = "nur lesen").

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.

Die folgenden Befehle können zum Bearbeiten des Editor-Inhalts verwendet werden:

- AddGadgetItem(): Fügt eine Textzeile hinzu.
- CountGadgetItems(): Gibt die Anzahl an Zeilen im Editor-Gadget zurück.
- GetGadgetItemText(): Ermittelt den Textinhalt der angegebenen Zeile.
- GetGadgetText(): Ermittelt den Textinhalt des Editor-Gadgets.
- RemoveGadgetItem(): Entfernt eine Zeile im Editor.
- ClearGadgetItems(): Löscht den Textinhalt.
- SetGadgetItemText(): (Über)Schreibt die angegebene Textzeile.
- SetGadgetText(): Ändert den Textinhalt des Editor-Gadgets.
- SetGadgetAttribute(): Mit den folgenden Attributen:

  #PB_Editor_ReadOnly: Setzt den 'ReadOnly' Status. (0 bedeutet editierbar, ungleich 0 bedeutet nur lesbar)

- GetGadgetAttribute(): Mit den folgenden Attributen:

  #PB_Editor_ReadOnly: Ermittelt den 'ReadOnly' Status. (0 bedeutet editierbar, ungleich 0 bedeutet nur lesbar)

Dieses Gadget unterstützt die SetGadgetColor() und GetGadgetColor() Befehle mit den folgenden Werten als 'FarbTyp':

  #PB_Gadget_BackColor      : Hintergrundfarbe
  #PB_Gadget_FrontColor     : Textfarbe

Beispiel

  If OpenWindow(0, 0, 0, 322, 150, "EditorGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    EditorGadget(0, 8, 8, 306, 133)
    For a = 0 To 5
      AddGadgetItem(0, a, "Zeile "+Str(a))
    Next
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Siehe auch

AddGadgetItem(), RemoveGadgetItem(), CountGadgetItems(), ClearGadgetItems(), GetGadgetText(), SetGadgetText(), GetGadgetItemText(), SetGadgetItemText(), GetGadgetAttribute(), SetGadgetAttribute(), GetGadgetColor(), SetGadgetColor(), StringGadget()

Unterstützte OS

Alle