Behaviors

ALSO SEE:


WHAT IS IT
FEATURES
UPDATE HISTORY
PRICING & LICENSING
SYSTEM REQUIREMENTS
ONLINE HELP
TUTORIALS & SAMPLES
BEHAVIORS
DOWNLOAD

QUICK BROWSER TARGET


	Quick Browser Target Drop this behavior on a WebXtra sprite to quickly configure default options for your browser. This behavior works in conjunction with the QuickBrowser Buttons and QuickBrowser Text Fields behaviors.

	--WebXtra Quick Browser Target behavior --You are free to use, modify and redistribute this code with your Director projects property pStartURL property pStartURLIsLocal property pOpenNewWindow property pDisplayScrollbars property pShowContextMenu property pFileDownload property pNavigateError property pSilent property pCloseWindowFlag property pInitialURLLoaded on getPropertyDescriptionList return [#pStartURL: [#default: "", #format:#string, #comment: "Initial page to load:"], #pStartURLIsLocal: [#default: FALSE, #format:#boolean, #comment: "Initial page is a local file?"],#pOpenNewWindow: [#default: #allow, #format:#symbol, #comment: "Response to request for new window:", #range:[#allow,#block]], #pDisplayScrollbars: [#default: TRUE, #format:#boolean, #comment: "Display scrollbars?"],#pShowContextMenu: [#default: TRUE, #format:#boolean, #comment: "Show right click context menu?"],#pFileDownload: [#default: #allow, format: #symbol, #range: [#allow,#block], #comment:"Allow file downloads?"],#pNavigateError: [#default: #DisplayStandardErrorPage, format: #symbol, #range: [#DisplayStandardErrorPage,#DisplayAlert, #ignore], #comment:"Response to navigation error:"],#pSilent: [#default: TRUE, format: #boolean, #comment:"Ignore JavaScript error messages:"]] end getPropertyDescriptionList on getBehaviorDescription return "WebXtra quick browser behavior" end on beginSprite me --The silent property is used to supress JavaScript error messages generated by the browser sprite(me.spritenum).silent = pSilent --set some internal flags that will be checked the next time exitFrame runs pCloseWindowFlag = FALSE pInitialURLLoaded = FALSE end on exitFrame me --Check if we have an initial URL to load, now that the browser has initialized completely if pInitialURLLoaded=FALSE then --reset the flag, we only want to do this check once pInitialURLLoaded = TRUE --now check if we really have something to load if pStartURL<>"" then if pStartURLIsLocal then sprite(me.spritenum).navigate(the moviePath&pStartURL) else sprite(me.spritenum).navigate(pStartURL) end if end if end if --At every frame, check if the window has been scheduled to be closed (see the closeWindowRequested event handler on this same behavior for more information) if pCloseWindowFlag=TRUE then if (the activeWindow)=(the stage) then quit else (the activeWindow).forget() end if pCloseWindowFlag = FALSE end if end on getBehaviorObject me --called by the WebXtra event handlers to get a pointer to this behavior object, in order to use its properties return me end on WebXtra_navigate me, targetURL --this message is sent by the #urlAddress text field to trigger a browser navigation action sprite(me.spriteNum).navigate(targetURL) end on WebXtra_buttonPressed me, buttonFunction --this message is sent by the interface buttons to trigger a browser function case buttonFunction of: #goBack: sprite(me.spriteNum).goBack() #goForward: sprite(me.spriteNum).goForward() #goHome: sprite(me.spriteNum).goHome() #goSearch: sprite(me.spriteNum).goSearch() #stop: sprite(me.spriteNum).stop() #refresh: sprite(me.spriteNum).refresh() end case end --IMPORTANT --Notice that the following handlers do not contain the me parameter, but a spriteref. These handlers are invoked directly by the WebXtra sprite, so the second parameter is a reference to the sprite object and NOT to this behavior. You can usually consider them to be equivalent in most situations, as it is possible to invoke other handlers directly, and access properties like the spriteNum. In order to access behavior parameters however you need to retrieve a pointer to the behavior object. See the implementaion of getBehaviorObject() above. on DisplayScrollbars spriteRef --Called by WebXtra when a window is created of refreshed, to control the display of outer scroll bars --Return FALSE here to disable scrollbars. The default behavior of the browser is to show them. return spriteRef.getBehaviorObject().pDisplayScrollbars end on ShowContextMenu spriteRef --Called by WebXtra when the user clicks with the right mouse button over the HTML area to display the context menu --Return TRUE here to allow the context menu to appear, or false to prevent the menu from showing return spriteRef.getBehaviorObject().pShowContextMenu end on OpenNewWindow spriteRef --This handler is called by WebXtra when the browser receives a request to create a new popup window --In this behavior we have two options: allow the popup window to be created or block the request case spriteRef.getBehaviorObject().pOpenNewWindow of: #block: return false #allow: return true end case end on CloseWindowRequested spriteRef --This handler is called by WebXtra when the browser receives a request to close a window, usually from Javascript code running on the embedded page --IMPORTANT: it is not recommended to quit the application or forget a MIAW directly from this handler, as this disrupts the messaging queue. Instead, we recommend scheduling the destruction of the window, maybe with a global flag or a timeout object. The Complete Browser sample at the WebXtra site shows a complete implementation of this functionality using timeout objects. --In this behavior we set a flag to close the window in the next exitFrame event spriteRef.pCloseWindowFlag = TRUE end on ProgressChange spriteRef, progress, progressmax --This handler is called by WebXtra to signalize a network operation in progress --Here we send a message that will be picked by any sprite interested in it SendAllSprites(#WebXtraEvent_ProgressChange, progress, progressmax) end on TitleChange spriteRef, wtext --Called by WebXtra when the title of the loaded document changes --Send a message that will be picked by any sprite interested in it SendAllSprites(#WebXtraEvent_TitleChange, wtext) end on StatusTextChange spriteRef, wtext --Called by WebXtra when the text of the status bar needs to change --Send a message that will be picked by any sprite interested in it SendAllSprites(#WebXtraEvent_StatusTextChange, wtext) end on StartNavigation spriteRef, wurl, wframe --This handler is called by WebXtra to request authorization to navigate to a certain page --This is a simple behavior, we are not interested in parsing URLs at this time, so allow all operations to proceed return true end on ExecDirectorScript spriteRef, wscript --This handler is called by WebXtra to execute a script called from the browser using window.external.execDirectorScript --Suppose we just wanted to execute it, and it is a Lingo script, we could use the do method: -- --do wscript -- --If we were passing a JS script, eval() could be used instead in a JS Director behavior end on NavigateError spriteRef, wurl, wframe --Called by WebXtra when an URL can not be reached --Do not display the default browser error message, just stay at the last valid page case spriteRef.getBehaviorObject().pNavigateError of: #ignore: return false #displayStandardErrorPage: return true #displayAlert: alert "An error occurred while trying to load the address "&wurl end case end on FileDownload spriteRef --Called by WebXtra when a local file is opened or a download operation is started case spriteRef.getBehaviorObject().pFileDownload of: #block: return false #allow: return true end case end on NavigateBackState spriteRef, enabled --Called by WebXtra to inform the current state of the BACK button of the browser --Send a message that will be picked by any sprite interested in it SendAllSprites(#WebXtraEvent_NavigateBackState, enabled) end on NavigateForwardState spriteRef, enabled --Called by WebXtra to inform the current state of the FORWARD button of the browser --Send a message that will be picked by any sprite interested in it SendAllSprites(#WebXtraEvent_NavigateForwardState, enabled) end on SecureLockState spriteRef, state --Called by WebXtra to inform the current state of the lock icon, which indicates that a secure connection is in place --Valid values are from 0 to 6. Values greater than 0 indicate that some sort of secure connection is in place. See the table below: -- 0 = Unsecure -- 1 = Mixed Environment (some elements are secure, others are not) -- 2 = Secure connection, unknown strenght -- 3 = Secure connection using 40 Bit encryption -- 4 = Secure connection using 56 Bit encryption -- 5 = Secure connection using Fortezza encryption -- 6 = Secure connection using 128 Bit encryption --Send a message that will be picked by any sprite interested in it SendAllSprites(#WebXtraEvent_SecureLockState, state) end
	DIRECTOR VERSIONS:		AUTHOR:		LAST UPDATED:
	8.5, MX, 2004, 11, 11.5		Tabuleiro		December 21, 2009