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
RETURN

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.