Syntax
SET-CALLBACK-PROCEDURE ( callback-name , internal-procedure
[ , procedure-context ] )
|
-
callback-name
- A quoted string or character expression representing the name of a
callback. The callback-name is not case-sensitive.
- For a ProDataSet buffer object handle, this can be "BEFORE-FILL", "AFTER-FILL", "BEFORE-ROW-FILL",
"AFTER-ROW-FILL", "ROW-CREATE", "ROW-DELETE", "ROW-UPDATE", "FIND-FAILED", or "SYNCHRONIZE".
- For a Procedure object handle, when calling a Web service, this
can be either "REQUEST-HEADER" or "RESPONSE-HEADER".
- For a ProDataSet object handle, this can be "BEFORE-FILL" or "AFTER-FILL".
- For a Query object handle, this can be "OFF-END".
You can also use the APPLY-CALLBACK( ) method to apply a callback
procedure for an object.
-
internal-procedure
- A quoted string or character expression representing the name of an
internal procedure that resides within procedure-context.
-
procedure-context
- A handle to a procedure that contains the internal procedure specified
by internal-procedure. If not specified,
THIS-PROCEDURE is used as the procedure context.
This method returns FALSE if the callback-name is not
valid or if procedure-context is not a valid handle;
returns TRUE otherwise. If this method is specified but cannot be invoked, or it fails, no
procedure will be executed as part of the callback event.
Notes
- If this method is called multiple times, the new values passed replace the previously
set values.
- To remove the callback procedure associated with a Web service procedure, invoke this
method with a valid callback-name and an empty string
("") for the internal-procedure. The AVM will not generate an error if an attempt is made
to remove a callback procedure and a callback is not associated with the callback.
- For more information on events, see the Handle-based Object Events Reference.
