EditorGadget()

Syntax

Result = EditorGadget(#Gadget, x, y, Width, Height [, Flags])

Creates an Editor gadget in the current GadgetList.

Parameters

#Gadget	A number to identify the new gadget. #PB_Any can be used to auto-generate this number.
x, y, Width, Height	The position and dimensions of the new gadget.
Flags (optional)	Flags to modify the gadget behavior. This can be the following value: #PB_Editor_ReadOnly: the user cannot edit the text in the gadget. #PB_Editor_WordWrap: the lines too long to be displayed will be wrapped still displayed completely

Return value

Returns nonzero on success and zero on failure. If #PB_Any was used as the #Gadget parameter then the return-value is the auto-generated gadget number on success.

Remarks

A 'mini help' can be added to this gadget using GadgetToolTip().

The following events are supported through EventType():

  #PB_EventType_Change   : the text has been modified by the user.
  #PB_EventType_Focus    : the editor has got the focus.
  #PB_EventType_LostFocus: the editor has lost the focus.

The following functions can be used to act on the editor content:

- GetGadgetText(): Get the text content of the editor gadget.
- SetGadgetText(): Change the text content of the editor gadget.
- SetGadgetAttribute(): With the following attribute:

  #PB_Editor_ReadOnly: set the read-only state (zero means editable, nonzero means read-only).
  #PB_Editor_WordWrap: set the word-wrap state

- GetGadgetAttribute(): With the following attribute:

  #PB_Editor_ReadOnly: get the read-only state (zero means editable, nonzero means read-only).
  #PB_Editor_WordWrap: get the word-wrap state

This gadget supports the SetGadgetColor() and GetGadgetColor() functions with the following values as 'ColorType':

  #PB_Gadget_BackColor      : backgroundcolor
  #PB_Gadget_FrontColor     : textcolor

Example

  If OpenWindow(0, 0, 0, 322, 150, "EditorGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    EditorGadget(0, 8, 8, 306, 133)
    SetGadgetText(0, "This is a multiline text to edit" + #LF$ +
                     "in the EditorGadget()." + #LF$ +
                     "Third line")
  EndIf

See Also

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

Supported OS

All