Creating an ApplicationSwitcher

To create an applicationSwitcher:

1. In the Design Structure Window of the desired file, expand the pageLayout node to locate the globalButtons node.

   If the pageLayout node is not visible, expand page | content | dataScope | document | body | form. The globalButtons node is under pageLayout Named Children in pageLayout.

2. In the Component Palette, select Navigation Components from the dropdown list, and then drag and drop the globalButtonBar component from the list to the globalButtons node.

   The globalButtonBar node is inserted under the expanded globalButtons node.

3. In the Component Palette, drag and drop the applicationSwitcher component from the Navigation Components list to the globalButtonBar node in the Design Structure Window.

   The applicationSwitcher node is inserted under the expanded globalButtonBar node.

4. In the Design Structure Window, right-click the new applicationSwitcher node and choose Insert inside applicationSwitcher | option.

   The new option node is inserted and highlighted in the Structure Window. The Property Inspector displays the properties of the new component.

5. In the Property Inspector, set the following attributes for the option:
   • text - Enter a short text description for the option.
   • value - Enter the value used to identify the option. If no value is specified for the item, the option's contents will be used as its value.
6. Repeat steps 4 and 5 add additional options for the switcher.

   The options display vertically in a dropdown list when the page is viewed in a browser. The first option is numbered 0; the second option is numbered 1, and so on.

7. In the Design Structure Window, select the applicationSwitcher node.

   The Property Inspector displays the properties of the application switcher component.

8. In the Property Inspector, set the following attributes for the application switcher:
   • name - Enter a name for the switcher. A name is required as it is used as the source parameter in the generated URL for the Go button.
   • destination - Enter a URL if form submission not used.
   • formSubmitted - If using Javascript form submission, click in the right column and select true. If no formName is specified, the parent form is used.
   • formName - Enter the name of the form to which events are submitted. Setting this attribute without setting formSubmitted also enables Javascript form submission.
   • unvalidated - By default, validation is used if form submission is enabled. Set this attribute to true if you don't want the values to be validated when the form is submitted.
   • title - Enter the label that displays either below or next to the options dropdown list box. If no title is specified, the default label is displayed as 'Switch Applications'.
   • selectedIndex - Enter the value of the option you want to be displayed in the dropdown list box when the page is first displayed in a browser. Use one of the following values:
   • 0 - display the first option
   • 1 - display the second option
   • 2 - display the third option, and so on

Notes:

• To use data binding, see Data Binding a Component Attribute.
• You must set an event handler for the application switcher to function properly when a user clicks the Go button.
• The application switcher must be used in a form for the option components to display properly in Netscape 4.x.

Example (UIX XML)

Example:

<?xml version="1.0" encoding="windows-1252"?>
<page xmlns="http://xmlns.oracle.com/uix/controller"
      xmlns:ui="http://xmlns.oracle.com/uix/ui"
      xmlns:ctrl="http://xmlns.oracle.com/uix/controller"
      xmlns:html="http://www.w3.org/TR/REC-html40"
      bindingLanguage="el">
  <content>
    <dataScope xmlns="http://xmlns.oracle.com/uix/ui">
      <provider>
        <!-- Add data sources here -->
        <data name="demo:appIs">
          <method class="oracle.cabo.doc.demo.ApplicationSwitcherData" method="getData"/>
        </data>
      </provider>
      <contents>
        <!-- Start page content here --> 
        <document>
          <metaContainer>
            <!-- Set the page title -->
            <head title=""/> 
          </metaContainer>
          <contents>
            <body>
              <contents>
                <form name="form0">
                  <contents> 
                    <pageLayout title=""> 
                      <contents>
                        <!-- Define the main content of the page here --> 
                      </contents>
                      <!-- Define the navigation elements here -->
                      <!-- Application Switcher -->
                      <globalButtons>
                        <globalButtonBar>
                          <contents>
                            <applicationSwitcher title="Select here"
                                                 name="mySwitcher"
                                                 selectedIndex="2"
                                                 formSubmitted="true">
                              <contents>
                                <option text="iReceivables" value="iReceivables"/>
                                <option text="Human Resources" value="HumanResources"/>
                                <option text="Finance" value="Finance"/>
                                <option text="iLearning" value="iLearning"/>
                              </contents>
                            </applicationSwitcher>
                          </contents>
                        </globalButtonBar>
                      </globalButtons> 

  <!-- REST OF PAGE LAYOUT--> 

                    </pageLayout> 
                  </contents>
                </form>
              </contents>
            </body>
          </contents>
        </document>
      </contents>
    </dataScope>
  </content>
  <handlers>
    <!-- Add event handlers here -->
    <event name="switchApp">
      <method class="oracle.cabo.doc.demo.ApplicationSwitcherData" method="appSwitchEventHandler"/>
    </event>
  </handlers>
</page>    

Related topics

About ApplicationSwitcher
About GlobalButton

Creating a GlobalButton
Working with Navigation Components

Copyright © 1997, 2004, Oracle. All rights reserved.