browser class : LoadStart(class,string) method

Description

Assigns a handler to the "LoadStart" event.

instance.LoadStart(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 LSHandler(dictionary dic)
3:	browser sender = dic.Sender;
4:	switch sw = dic.Switch;
5:	bool ir = dic.IsRedirect
6:	bool iug = dic.IsUserGesture;
7:	string url = dic.Url;
8:	bool cancel = dic.Cancel;
9:	dic.Cancel = true; // It cancels the page loading.
10:	endmethod
11:	endclass

Handler assignment is as follows.

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

The handler for the "LoadStart" 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.
IsRedirect	bool	Whether the load was caused by a page redirect.
IsUserGesture	bool	Whether the load was caused by user action.
Url	string	URL.
Cancel	bool	Whether to cancel the event.

The handler runs in the UI thread.

None.