vykonProNavigation - Geographic Nav Selector

The Geographic Nav Selector is a px widget that dynamically creates navigation links for a group of Niagara stations. The navigation is broken down by geographic location based on state, city and site.

Figure - Geographic Nav Selector Property Sheet

Properties

align - Alignment property for the group of drop down selectors and hyperlink button.
browser target - String property which is used to formulate the hyperlink and specifies the target used in the browser client.
- _self - loads in the window and frame that contains the applet.
- _parent - loads in the applet's parent frame. If the applet's frame has no parent frame, acts the same as "_self".
- _top - loads in the top-level frame of the applet's window. If the applet's frame is the top-level frame, acts the same as "_self".
- _blank - loads in a new, unnamed top-level window.
- name - loads in the frame or window named name. If a target named name does not already exist, a new top-level window with the specified name is created, and the document is shown there.
enabled - Boolean property which controls whether the px widget functions.
hgap - Integer property which configures the number of horizontal pixels between components.
layout - BLayout property which controls the size and location of the px widget in the view.
vgap - Integer property which configures the number of vertical pixels between components.
visible - Boolean property which controls the visiblity of the px widget in the view.
wb target - Enumerated selector for the BHyperlinkMode.
- Replace - Clicking the hyperlink will cause the content of the current view to be replaced with the new content of the configured hyperlink. This setting allows the user to also utilize the standard key functions such as 'ctrl' to override the replace mode by opening a new tab, or 'ctrl+shift' to override the replace mode by opening a new shell.
- New Tab - Clicking the hyperlink will cause the new content of the configured hyperlink to be loaded in a new workbench tab.
- New Shell - Clicking the hyperlink will cause the new content of the configured hyperlink to be loaded in a new workbench shell.

Note that the individual widgets such as the link button have their own px properties as well. Viewing the px properties allows customizing the items such as the font, text or icon of the link button.

Meta Tags

The Geographic Nav Selector builds an array of all stations defined in the Niagara network and then attempts to sort the list based on state and city properties. In order for the widget to be able to sort by state and city, properties must be added to the Niagara station components.

Figure - Niagara Station Slot Sheet

State - BString property used to configure the state in which the site is located such as CA or TX.
City - BString property used to configure the city in which the site is loated such as San Diego or Dallas.
Link Ord - BOrd property used to configure the hyperlink ord that will be followed when heyperlinking to this site. If the slot is not present or the ord is not configured then a default ord of the station is used.

For any stations without a "State" property or a null value, the station will be classified in the "State" drop down selector as "undefined". For any stations without a "City" property or a null value, the station will be classified in the "City" drop down selector as "undefined".

Geographic Nav Selector View

The Geographic Nav Selector view is made up of three drop down selectors and a button. Initially the only drop down selector which is enabled is the state selector. After selecting either "undefined" if available or one of the state items, the city drop down selector is enabled.

Figure - State Selector

The city drop down selector will only be populated with cities associated with the selected state item. After selecting either "undefined" if available or one of the city items, the site drop down selector is enabled.

Figure - City Selector

The site drop down selector will only be populated with sites associated with the selected sate and city. The display names of the Niagara stations are used to populate the site selector. After selecting a site, the hyperlink button is enabled.

Figure - Site Selector

Clicking the hyperlink button will direct the user to the configured hyperlink for the selected site.