AJAXCancelAsynchronousCall (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Web-specific functions

Ajax functions

AJAXCancelAsynchronousCall

Presentation

Example

Reminder

Older browsers

See also

AJAXCancelAsynchronousCall (Function)

In french: AJAXAnnuleAppelAsynchrone

Cancels the automatic execution of the browser procedure called by AJAXExecuteAsynchronous. The server procedure called by AJAXExecuteAsynchronous will continue to run.

Reminder: The browser procedure is used to process the result returned by the server procedure. When AJAXCancelAsynchronousCall is called, the result of the server procedure will not be processed

Example

// Is AJAX supported by the current browser?
IF AJAXAvailable() = True THEN
// Run the server procedure named "MyProc"
// As soon as the result of the "MyProc" server procedure
// will be available,
// the "ProcResult" browser procedure will be run
Res is int
Res = AJAXExecuteAsynchronous(MyProc, ProcResult)
// The following processes are run without waiting for the result
...
// Progress of the server procedure named "MyProc"
IF AJAXAsynchronousCallPending(Res) = True THEN
// Cancel the execution
// of the "ProcResult" browser procedure
// The result of the "MyProc" server procedure
// cannot be processed
AJAXCancelAsynchronousCall(Res)
END
ELSE
// Processes without using AJAX
...
END

Syntax

AJAXCancelAsynchronousCall(<Identifier of server procedure>)

<Identifier of server procedure>: Integer

Identifier of the server procedure whose result will not be processed. This identifier was defined by AJAXExecuteAsynchronous.

Remarks

Reminder

AJAXAsynchronousCallPending is used to find out whether a server procedure called by AJAXExecuteAsynchronous is currently run.

Older browsers

AJAXAvailable is used to determine if the current browser supports AJAX technology. If a process that uses AJAX is run on a browser that does not support this technology, the process is run "as if" it did not use AJAX (e.g., the entire page is refreshed).

Component: WDJS.DLL