Determines if the browser is active or inactive.

The default value for this property is true.

Get and set the background color.

Determines whether or not to enable the standard browser popup-blocking engine for generic window.open calls from Javascript. When this is enabled, only user requested popups will be allowed.

The default value for this property is true.

Retrieves the certificate information for the currently displayed page.

The rectangle that defines the size of the content of the web page after transformations due to user zoom.

Defines custom HTTP headers that are sent in addition to the standard headers.

The default value of this property is nul.

Default font size is applied.

This is used to override the default font size for the browser. The range is 1 to 120.

The default value is 16.

The default text encoding if the browser cannot auto-detect the encoding of the page.

The default value of this property is utf-8.

Sets a Boolean that determines if default dialogs will be displayed.

Determines whether or not cookies should be saved and sent back to pages.

The default value of this property is true.

Determines whether or not to allow cross site XHR (XMLHttpRequest).

The default value of this property is true.

Enable or disable downloadable binary fonts.

Determines whether or not geolocation APIs should be enabled.

The default value of this property is true.

Determines whether or not to execute Javascript.

The default value of this property is true.

Enable or disable access to cookies associated with file: and local: protocols.

Enable or disable pattern matching. By default this is disabled.

Determines whether or not plugins should be enabled.

The default value of this property is true.

Enables the following events on this webview.

• qnx.events.NetworkResourceDataReceivedEvent
• qnx.events.NetworkResourceDoneEvent
• qnx.events.NetworkResourceHeaderReceivedEvent
• qnx.events.NetworkResourceOpenedEvent
• qnx.events.NetworkResourceRequestedEvent

Enable or disable spatial navigation.

Determines whether or not web inspector should be enabled.

The default value of this property is false.

Determines whether or not web sockets should be available to pages.

The default value of this property is true.

Retrieves the encryption info for the currently displayed page.

Gets the favicon for the current page.

Forced text encoding is applied.

This is used to override a possibly incorrect decision by the browser about the encoding of a page. Set this value to nul to cancel forcedTextEncoding.

The default value is Nul.

The length of the history list.

Retrieves a copy of the history list. The history list is an Array of qnx.media.HistoryItem objects. Note that the 0th item is the earliest visited location.

The position of the currently active page in the history list. Note that 0 is the back of the list.

Determines whether there is a previous page in the browsing history.

Determines whether there is a next page in the browsing history.

Determines whether the QNXStageWebView class is supported on the current device.

Specifies the timeout period (in seconds) after which a long running piece of JavaScript is interrupted. When JavaScript is interrupted, a WebViewEvent.JAVASCRIPT_INTERRUPTED event is fired.

The default value for this property is 0 (milliseconds).

Determines whether or not to load images when the page is loading. If this value is set to false and you decide to to load images, then you must set this flag to true and then reload the page.

The default value for this property is true.

Retrieves the loading progress of the current page. If the page is fully loaded, this value will remain at 100.

The URL of the current location.

The URL of the originally entered location before any redirects.

Get and set the overscroll color.

The private browsing flag tells the QNXStageWebView object to enable private browsing mode. Existing cookies are not used and no browsing information is saved.

The default value of this property is false.

The current scroll position of the content. If you set a value that extends past the edge of the content, the value will be clamped to the proper value.

Retrieves the security type for the currently displayed page.

The stage on which this QNXStageWebView object is displayed.

Set stage to nul to hide this QNXStageWebView object, or change the visible property to false.

         mySwv = new QNXStageWebView("myBrowser");
         mySwv.stage = this.stage;
         

Gets the current status bar content.

The current text encoding of the content on the page.

If you have not set a forced text encoding, this value will be either the auto-detected text encoding, or the default text encoding. Otherwise, it is the forced text encoding.

Get and set the text reflow mode.

The HTML title value.

Gets the current tool-tip.

The user-agent that is currently reported by the browser to servers during HTTP requests and to web content in scripts.

The default value is system-dependant.

Specifies a user stylesheet which overrides the stylesheet that is set by the page. To specify the stylesheet inline, use a data:// URL. Set the url argument to nul to clear the user stylesheet.

The area on the stage in which the QNXStageWebView object is displayed.

         mySwv = new QNXStageWebView("myBrowser"); 
         mySwv.viewPort = new Rectangle(50,50,400,400);
         

Specifies the visibility property for this QNXStageWebView instance.

The default value for this property is false.

Get the web inspector port number.

The unique ID of the window.

This value can be used with the qnx.display.IowWindow class to retrieve the underlying window. While you can set any property on the window, you should not resize the viewport as this will cause the QNXStageWebView insatnce to fail. This value is constant through the life of a QNXStageWebView but will be regenerated every time you create a new one.

The current zoom factor of the web view.

The center point of the zoomed area. When this is non-null zooming is done by scaling the existing content without re-rendering. Setting to null causes the content to be rendered at the current zoom factor.

Determines if the browser will automatically zoom the page to fit the width of the viewport on load.

The default value for this property is true.

Specifies the z-order of the QNXStageWebView instance with respect to other windows that are children of the stage.

The stage always has a z-order of 0 with respect to children. Windows are painted by the window manager from lowest z-order (backmost) to highest z-order (frontmost). Thus, specifying a value less than 0 will move the QNXStageWebView instance behind the stage (and can be seen through the stage if the stage is not opaque where the QNXStageWebView instance is being displayed). Specifying a value greater than or equal to 0 will move the QNXStageWebView in front of the stage. You must manage the z-order of QNXStageWebView objects if you have more than one, or need to use a special case such as moving behind the stage.

The default value for this property is 0.

In the following listing, the zOrder property of a QNXStageWebView instance is set to -1 (hidden behind the stage) while the class is loading an external URL. When the external content is loaded, the onLoad function is called and the zOrder property is set to 0, which causes the QNXStageWebView to appear in front of the stage and visible to the user.

         mySwv = new QNXStageWebView("myBrowser");
         mySwv.stage = this.stage;
         mySwv.viewPort = new Rectangle(50,50,400,400);
         mySwv.addEventListener(WebViewEvent.DOCUMENT_LOAD_FINISHED, onLoad);
         mySwv.addEventListener(WebViewEvent.DOCUMENT_LOAD_FAILED, onFail);
         mySwv.loadURL("http://www.qnx.com/");
         mySwv.zOrder = -1;
         
         private function onLoad(e:WebViewEvent):void
         {
             mySwv.zOrder = 0;
         }
         

Creates a QNXStageWebView object.

The object is invisible until it is attached to a stage and until the viewPort is set.

Assigns focus to the content within this QNXStageWebView object.

Direction values are defined in FocusDirection class and include:

• bottom
• none
• top

Parameters

Clears browsing data.

The following types of data are cleared:

• Cookies
• Back-forward history
• Page-cache
• Authorizations
• Local Storage
• Password data
• Form data

Clears the browser cache.

Clears any cookie information.

Clears all browser history.

Clears any local storage.

Disposes of this QNXStageWebView object.

Calling dispose() is optional. If you do not maintain a reference to this QNXStageWebView instance it will be eligible for garbage collection. Calling dispose() can make garbage collection occur sooner, or at a more convenient time.

Used in conjunction with the Downloadevents. Call this function to cancel a download in the download manager. The download will remain in the download manager until removed.

Parameters

Used in conjunction with the Downloadevents. Call this function to pause a download in the download manager.

Parameters

Used in conjunction with the Downloadevents. Call this function to remove a download from the download manager. If the download is still in progress it will be cancelled.

Parameters

Used in conjunction with the Downloadevents. Call this function to resume a paused download in the download manager.

Parameters

Used in conjunction with the Downloadevents. Call this function to retry a download in the download manager. If the download is already running it will not be affected.

Parameters

Used in conjunction with the Downloadevents. Call this function to set the download action to take for a pending download.

Parameters

Draws the QNXStageWebView's view port to a bitmap.

Parameters

Executes the JavaScript code that is specified by script asynchronously.

This function will immediately return a unique identifier for this executeJavaScript() call and JavaScript code block/line. After the code has completed execution (successfully or otherwise) a JavaScriptResultEvent.JAVASCRIPT_RESULT event is fired containing the unique ID of the executeJavaScript() call and the result that was returned (which may be an empty string). Javascript is executed in the NORMAL WORLD

Parameters

See also

Executes the JavaScript code that is specified by script asynchronously.

This function will immediately return a unique identifier for this executeJavaScript() call and JavaScript code block/line. After the code has completed execution (successfully or otherwise) a JavaScriptResultEvent.JAVASCRIPT_RESULT event is fired containing the unique ID of the executeJavaScript() call and the result that was returned (which may be an empty string).

Parameters

Finds and selects the next/last string that is a case-insensitive match in the web page. It will wrap the web page if it reaches the end. An empty String will result in no match and no selection.

This event will fire a FindStringEvent event after the search iss complete.

Parameters

See also

Navigates to the previous page in the browsing history.

Navigates to the next page in the browsing history.

Loads the page at the specified file path. This function is very similar to calling loadURL with a file: URL, except an override content type can be specified.

Parameters

Loads and displays the specified HTML string.

When the loadString() method is used, the location is reported as "about:blank." Only standard URI schemes can be used in URLs within the HTML string. The AIR URI schemes, "app:" and "app-storage:" are not allowed.

The HTML content cannot load local resources, such as image files. XMLHttpRequests are not allowed.

Only the "text/html" and "application/xhtml+xml" MIME types are supported.

Parameters

Loads and displays the specified HTML string with the specified baseURL.

Parameters

Loads the page at the specified URL.

The URL can use the following URI schemes:

• http:
• https:
• file:
• data:
• javascript:

Content loaded with the file: scheme can load other local resources.

The following listing loads an external URL.

         mySwv = new QNXStageWebView("myBrowser");
         mySwv.stage = this.stage;
         mySwv.viewPort = new Rectangle(50,50,400,400);
         mySwv.addEventListener(WebViewEvent.DOCUMENT_LOAD_FINISHED, onLoad);
         mySwv.addEventListener(WebViewEvent.DOCUMENT_LOAD_FAILED, onFail);           
         mySwv.loadURL("http://www.qnx.com/");
         

Parameters

Used in conjunction with the NetworkResourceDataRequested event to substitute the network stream with custom data and headers. Send all data before notifyResourceDone, but after notifyResourceOpened and notifyResourceHeaderReceived. This function simulates data being received from the server.

Parameters

Used in conjunction with the NetworkResourceDataRequested event to substitue the network stream with custom data and headers. Should only be called last, after notifyResourceOpened notifyResourceHeaderReceived and notifyResourceDataReceived. After this function is called the streamId is no longer valid and should be discarded. This function simulates data being received from the server.

Parameters

Used in conjunction with the NetworkResourceDataRequested event to substitute the network stream with custom data and headers. Send all headers before notifyResourceDataReceived and notifyResourceDone, but after notifyResourceOpened. This function simulates the result response from the server.

Parameters

Used in conjunction with the NetworkResourceDataRequested event to substitute the network stream with a custom response code. Call this function first when substituting. This function simulates the result response from the server.

Parameters

Reloads the current page. You should only invoke reload() when you load your source HTML using loadURL() or loadFile(). The reload() method may throw an error if you loaded your source HTML using loadString() or loadStringWithBase().

Remove the geolocation filter associated with a url. This will cause the user to be prompted if the site requests geolocation information.

Parameters

Remove the WebGL filter associated with a url. This will cause the user to be prompted if the site uses WebGL.

Parameters

Request a web session to be saved. A WebSessionInfo event will be dispatched by WebKit to pass up information about the session, so that it can be restored later.

Request a web session to be restored.

Parameters

Scroll the content by the specified amount (in pixels).

You may pass negative amounts here. If the amount passed exceeds the edge of the content, the scroll will stop at the edge of the content automatically. This function does not animate the scroll, scroll is moved to the new position as soon as possible.

Parameters

Indicate that the web page is being scrolled or is no longer being scrolled. While being scrolled rendering is turned off to ensure it is smooth.

Parameters

Halts the current load operation.

Query the value of a current text attribute. The result of the query will come in the form of a TextAttributeQueryEvent.

Parameters

Set whether a url is allowed access to geolocation information. If a filter is not set for a site the user is prompted.

Parameters

Set whether a url is allowed to use WebGL. If a filter is not set for a site the user is prompted.

Parameters

The Event.COMPLETE constant defines the value of the type property of a complete event object.

Indicates that a network error has occurred.

Defines the value of the type property of a focusIn event object.

See also

Defines the value of the type property of a focusOut event object.

See also

The following listing shows a javascript function (in a web page) that calls the qnx.callExtensionMethod() function:

         <script type="text/javascript"> 
          function close(){ 
            qnx.callExtensionMethod("name","val1","val2");
            //must have a parameter or else the event is not thrown, no includes are needed 
          } 
         </script> 
        
         

Below, a callback function (in an actionscript class) is set up to capture the name and result of the javascript function.

         webview.addEventListener(JavaScriptCallbackEvent.JAVA_SCRIPT_CALLBACK,function(event:JavaScriptCallbackEvent):void{ 
              trace("callback complete"); 
              trace("js name: " + event.name);//first parameter that was given 
              trace("js result: " + event.result);//null for the moment 
              for each(var object:String in event.params){
                  //rest of the parameters 
                  trace(object); 
              }
         }
         
         

Indicates that the window location has changed, and returns information about what caused the window to change locations.

Indicates that the window location is changing, and returns information about what caused the window to change locations.

Specify the action you wish to take for this resource:

• NetworkResourceRequestedEvent.ACTION_ACCEPT: (Default) Load the resource.
• NetworkResourceRequestedEvent.ACTION_DENY: Abort loading this resource.
• NetworkResourceRequestedEvent.ACTION_FILTER: Filter the resource loading, further events will be received for each stage of the open and data can be substited or monitored at that time.
• NetworkResourceRequestedEvent.ACTION_SUBSTITUTE: Substitute the entire load with your own data. Must call NetworkResourceOpened, NetworkResourceDone, NetworkResourceHeaderReceived and NetworkResourceDataReceived with the m_streamId in this event.

Cancelling this event allows the stream to be filtered using the notifyResourcefunctions. Otherwise, the resource load operation will fail.

Execute javascript in an isolate world. Scripts execute in a special environment called an isolated world. They have access to the DOM of the page they are injected into, but not to any JavaScript variables or functions created by the page. It looks to each content script as if there is no other JavaScript executing on the page it is running on. The same is true in reverse: JavaScript running on the page cannot call any functions or access any variables defined by content scripts. Isolated worlds allow each content script to make changes to its JavaScript environment without worrying about conflicting with the page or with other content scripts. For example, a content script could include JQuery v1 and the page could include JQuery v2, and they wouldn't conflict with each other.

See also

Execute javascript with no world. The javascript will have no access to the DOM.

Execute javascript in the page context. Any variables or functions defined will be available to the page. This is the default behavior of the executeJavaScript call.

All certificates failed to be validated.

All page resources using valid certificates.

No page resources using security.

Some page resources using valid certificates. Some resources have invalid or no secure connection.