choice.again()

Syntax

void choice.again()

Description

This cancels execution of a standard command and transfers control to the 4GL engine. Statements programmed after this function will never be executed. You can call this function during execution of a standard command. You can also call the function in field sections, as these are called indirectly during execution of some commands.

Context

4GL library function.

You can use this function only in 4GL scripts. You can use it in the following event subsections:

before.choice, on.choice, after.choice, before.field, before.input, on.input, after.input, when.field.changes, after.field

Example

 field.pctst999.item:
 after.input:
                 if pctst999.item = 99999 then
                                 mess("pctst.0001",1)
                                 choice.again()
                 endif

 | Modifying a record with item = zero is not allowed
 choice.modify.set:
 before.choice:
                 if pctst999.item = 0 then
                                 mess("pctst.0002",1)
                                 choice.again()
                 endif

Related topics

• Overview
• Synopsis