User Tools

Site Tools


prop_acceptall.htm
Navigation:  Language Reference > App C - PROP: Runtime Properties > Complete Property List >====== PROP:AcceptAll ====== Previous pageReturn to chapter overviewNext page

Property of a WINDOW which returns one (1) if AcceptAll mode is active and zero (0) if it is not, and may also be used to toggle AcceptAll (non-stop) mode. SELECT with no parameters usually initiates AcceptAll mode. This is a field edit mode in which each control in the window is processed by generating EVENT:Accepted for each. This allows data entry validation code to execute for all controls, including those that the user has not touched. AcceptAll mode immediately terminates when any of the following conditions is met:

SELECT(?)

Window{PROP:AcceptAll} = 0

A REQ control is left blank or zero.

The SELECT(?) statement selects the same control for the user to edit. This code usually indicates the value it contains is invalid and the user must re-enter data. The Window{PROP:AcceptAll} = 0 statement toggles AcceptAll mode off. Assigning values to this property can be used to initiate and terminate AcceptAll mode. When a control with the REQ attribute is left blank or zero, AcceptAll mode terminates with the control highlighted for user entry, without processing any more fields in the TAB key sequence. EVENT:Completed is posted to the window when all controls have been successfully processed.

Controls with a USE variable get EVENT:Accepted, but not those with a USE field equate.

Example:

Window WINDOW,PRE(Scr)

       ENTRY(@N3),USE(Ctl:Code)

       ENTRY(@S30),USE(Ctl:Name),REQ

       BUTTON('OK'),USE(?OkButton),KEY(EnterKey)

       BUTTON('Cancel'),USE(?CanxButton),KEY(EscKey)

      END

CODE

OPEN(Window)

ACCEPT

 IF EVENT() = EVENT:Completed THEN BREAK.  ! AcceptAll mode terminated

 CASE ACCEPTED()

 OF ?Ctl:Code

  IF Ctl:Code > 150                        !If data entered is invalid

   BEEP                                    ! alert the user and

   SELECT(?)                               ! make them re-enter the data

  END

 OF ?OkButton

  Window{PROP:AcceptAll} = 1               !Initiate AcceptAll mode

 END

END                                        !Terminate ACCEPT and CASE ACCEPTED

See Also: SELECT

prop_acceptall.htm.txt · Last modified: 2021/04/15 15:57 by 127.0.0.1