StringGadget3D()

Syntax

Result = StringGadget3D(#Gadget3D, x, y, Width, Height, Content$ [, Flags])

Creates a String gadget in the current GadgetList. If #PB_Any is used as '#Gadget3D' parameter, the new gadget number will be returned as 'Result'. #Gadget3D will be the number returned by EventGadget3D() function. 'Content$' specifies the initial content of this StringGadget. This gadget accepts only one line of text. To get multiline input, use the EditorGadget3D() function.

'Flags' are always optional and can be composed (using the '|' OR operator) of one of the following constants:

  #PB_String3D_Numeric    : Only (positive) integer numbers are accepted.
  #PB_String3D_Password   : Password mode, displaying only '*' instead of normal characters.
  #PB_String3D_ReadOnly   : Read only mode. No text can be entered.

Later the content can be changed with SetGadgetText3D() and received with GetGadgetText3D().

The following events are supported through EventType3D():

  #PB_EventType3D_Change    : The text has been modified by the user.
  #PB_EventType3D_Focus     : The StringGadget got the focus.
  #PB_EventType3D_LostFocus : The StringGadget lost the focus.

To add a 'mini help' to this gadget, use GadgetToolTip3D().

Supported OS

All