The IDLitDataOperation::DoExecuteUI function method provides a way for the iTool developer to request user input before performing an operation. If the SHOW_EXECUTION_UI property is set, this method will be called before the operation's Execute method is called.
The DoExecuteUI method itself can present any interface. In practice, most iTool DoExecuteUI methods use the IDLitTool::DoUIService method to display a user interface requesting user input. User interfaces and UI Services are discussed in iTool User Interface Architecture.
Result = Obj->[IDLitDataOperation::]DoExecuteUI()
Returns a 1 if the displayed user interface code executed successfully, and the operation should be executed. If user interface code does not execute successfully, or if the user cancels the operation, this function returns a 0.
The following is an example of a DoExecuteUI method, taken from the iTools "Scale Factor" operation:
FUNCTION IDLitopScalefactor::DoExecuteUI oTool = self->GetTool() IF (oTool EQ OBJ_NEW()) THEN RETURN, 0 RETURN, oTool->DoUIService('ScaleFactor', self) END
This implementation of the DoExecuteUI method does the following: