AJAXCancelAsynchronousCall (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Functions specific to WEB

Ajax functions

AJAXCancelAsynchronousCall

Presentation

Example

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. Therefore, when using AJAXCancelAsynchronousCall, the result of the server procedure will not be processed

Note: The former browsers do not support the AJAX technology (Internet Explorer 5.5 and later, FireFox 1.0 and later, Netscape 7 and later, Opera 8 and later, Safari 1.2 and later, ...). AJAXAvailable is used to find out whether the AJAX technology is supported by the current browser. If a process that is using the AJAX technology is run on a browser that does not support this technology, the process is run "as if" it did not use the AJAX technology (the entire page is refreshed for example).

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

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

Component : WDJS.DLL