browser class : LoadCompleted(class,string) method

Description

Assigns a handler to the "LoadCompleted" event.

instance.LoadCompleted(class handleClass, string signature)

Class	Name	Description
class	handleClass	An instance with the handler as the member.
string	signature	Signature of the handler.

Class	Description
switch	An instance to control handler execution.

Suppose you have the following class definition.

1:	class handle
2:	open method void LCHandler(dictionary dic)
3:	browser sender = dic.Sender;
4:	switch sw = dic.Switch;
5:	bool succ = dic.IsSuccess
6:	string wes = dic.WebErrorStatus;
7:	endmethod
8:	endclass

Handler assignment is as follows.

1:	browser b; // Main-browser
2:	handle h = new handle();
3:	switch sw = b.LoadCompleted(h,"LCHandler(dictionary)");

The "LoadCompleted" event is fired when the page loading has finished.

The handler for the "LoadCompleted" event must be an open method with one argument of the dictionary class.

In other words, if the method name of the handler is "handlerName", the definition of the handler is as follows.

open method void handlerName(dictionary dic)

...

endmethod

In this case, the signature of the handler specify by the second argument is "handlerName(dictionary)".

The dictionary passed to the handler has the following key/value pairs.

key	value - class	value - description
Sender	browser	The origin of the event.
Switch	switch	The switch returned by the handler assignment.
IsSuccess	bool	Whether the page loaded successfully.
WebErrorStatus	string	The reason for the page load failure.

WebErrorStatus returns a string like the one below.

CannotConnect

CertificateCommonNameIsIncorrect

CertificateExpired

CertificateIsInvalid

CertificateRevoked

ClientCertificateContainsErrors

ConnectionAborted

ConnectionReset

Disconnected

ErrorHttpInvalidServerResponse

HostNameNotResolved

OperationCanceled

RedirectFailed

ServerUnreachable

Timeout

UnexpectedError

Unknown

Returns "Unknown" if the load was successful.

The handler runs in its own thread.

None.