EditorGadget()

Syntax

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

Erstellt ein Editor-Gadget innerhalb der aktuellen Gadgetliste.

Parameters

#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.

Return value

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.

Remarks

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

Example

  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

See Also

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

Supported OS

All