EditorGadget()

Syntax

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

Erstellt ein Editor-Gadget innerhalb der aktuellen Gadgetliste.

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.
Flags (optional)	Flags zum Verändern des Gadget-Verhaltens. Dies kann folgender Wert sein: #PB_Editor_ReadOnly: Der Anwender kann den Text im Gadget nicht editieren (readonly = "nur lesen"). #PB_Editor_WordWrap: Die Zeilen, welche zu lang zum Anzeigen sind, werden umgebrochen bis sie komplett angezeigt werden.

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 Ereignisse werden mittels EventType() unterstützt:

  #PB_EventType_Change   : der Text wurde durch den Anwender geändert.
  #PB_EventType_Focus    : der Editor hat den Fokus erhalten.
  #PB_EventType_LostFocus: der Editor hat den Fokus verloren.

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. Bitte dabei beachten, dass mehrere Textzeilen durch "Chr(13)+Chr(10)" auf Windows bzw. "Chr(10)" auf Linux und OS X voneinander getrennt werden.
- 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. (Null bedeutet editierbar, ungleich Null bedeutet nur lesbar)
  #PB_Editor_WordWrap: Setzt den Zeilenumbruch Status.

- GetGadgetAttribute(): Mit den folgenden Attributen:

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

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