Developing BlackBerry Tablet Applications : OS Interactions - StageWebView

The StageWebView allows for web (HTML and Flash, on supported devices) and video content to be loaded into a Flex application. StageWebView will utilize the native browser to load HTML into your application.

Let’s review the following code. First, you will notice that there is a private variable named stageWebView declared of type flash.media.StageWebView. Within applicationComplete of the application, an event handler function is called, which first checks to see if the device supports StageWebView by reading the static property of the StageWebView class. If this property returns as true, a new instance of StageWebView is created and a new Rectangle is created, sized to fill the remaining screen and set to the viewport property of the stageWebView.

There is a TextInput component with the ID of urlAddress—which holds the address that will be shown in the StageWebView—and a Button with the label “GO.”

Clicking on the GO button will call the button1_clickHander method. Within the button1_clickHander method, the loadURL method is called with the urlAddress.text property passed in. This triggers the StageWebView to load the URL.

The results are shown in Figure 1.

<?xml version="1.0" encoding="utf-8"?>
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
               xmlns:s="library://ns.adobe.com/flex/spark"
               applicationComplete="application1_applicationCompleteHandler(event)">
    <fx:Script>
        <![CDATA[
            import mx.events.FlexEvent;

            private var stageWebView:StageWebView;
            private var rect:Rectangle;

            protected function application1_applicationCompleteHandler
(event:FlexEvent):void
            {
                if(StageWebView.isSupported==true){
                    stageWebView = new StagewebView();
                    stageWebView.viewPort = new Rectangle(5,80,stage.width-10,
stage.height−90);
                    stageWebView.stage = this.stage;
                } else {
                    urlAddress.text = "StageWebView not supported";
                }
            }

            protected function button1_clickHandler(event:MouseEvent):void
            {
                stageWebView.loadURL(urlAddress.text);
            }

        ]]>
    </fx:Script>
    <fx:Declarations>
        <!-- Place non-visual elements (e.g., services, value objects) here -->
    </fx:Declarations>

    <s:TextInput id="urlAddress" left="5" right="80" top="15" 
text="http://www.google.com"/>
    <s:Button right="5" top="5" label="GO" click="button1_clickHandler(event)"/>

</s:Application>

					  

Figure 1. StageWebView with Google.com loaded