BBjInputE::setMask

Description

Sets the mask for the BBjInputE control.

Syntax

Return Value

Method

void

setMask(string mask)

Parameters

Variable

Description

mask

Specifies the mask that provides character-type verification.

Return Value

None.

Remarks

None.

Example

rem 'Set the mask for an InputE control

rem 'Obtain the instance of the BBjAPI object
let myAPI! = BBjAPI()

rem 'Open the SysGui device
SYSGUI = UNT
OPEN (SYSGUI) "X0"

rem 'Obtain the instance of the BBjSysGui object
let mySysGui! = myAPI!.getSysGui()

rem 'Set addWindow param values
X = 10
Y = 10
WIDTH = 200
HEIGHT = 200
TITLE$="BBj Window"

rem 'Set the current context
mySysGui!.setContext(0)

rem 'Create a window
myWindow! = mySysGui!.addWindow(X,Y,WIDTH,HEIGHT,TITLE$)

rem 'Add an INPUTE control that limits input to 10 characters, and inserting
rem 'the value "STANDARD" when the user hits the restore key (normally ESCAPE)
myInputE! = myWindow!.addInputE(101,50,100,90,30,$0804$,"0000000000","",1,"STANDARD","BBjInputE")

rem 'Set the mask for the InputE control to accept only alphabetic
rem 'characters and converts all to upper case
myInputE!.setMask("AAAAAAAAAA")

rem 'Register the CALLBACK routines
CALLBACK(ON_CLOSE,APP_CLOSE,mySysGui!.getContext())

rem 'Process Events
process_events

rem 'Callback routine called when the user closes the application window
APP_CLOSE:
release

See Also

BBjAPI

BBjSysGui

BBjControl

BBjWindow

String Output Masking for mask options

See the BBj Object Diagram for an illustration of the relationship between BBj Objects.