///////////////////////////////////////////////////////////
// ekFlexMenu Javascript file (ek_flexmenu.js):
// Client side support for the Ektron SmartMenu server control.


///////////////////////////////////////////////////////////
// CSS Style Class Name Enumertion:
function ekFlexMenu_classNames() {}
ekFlexMenu_classNames.button = "ekflexmenu_button";
ekFlexMenu_classNames.buttonHover = "ekflexmenu_button_hover";
ekFlexMenu_classNames.buttonSelected = "ekflexmenu_button_selected";
ekFlexMenu_classNames.buttonSelectedHover = "ekflexmenu_button_selected_hover";
ekFlexMenu_classNames.submenuItems = "ekflexmenu_submenu_items";
ekFlexMenu_classNames.submenuItemsHidden = "ekflexmenu_submenu_items_hidden";
ekFlexMenu_classNames.submenu = "ekflexmenu_submenu";
ekFlexMenu_classNames.submenuHover = "ekflexmenu_submenu_hover";
ekFlexMenu_classNames.submenuParent = "ekflexmenu_submenu_parent";
ekFlexMenu_classNames.submenuParentHover = "ekflexmenu_submenu_parent_hover";
ekFlexMenu_classNames.btnLink = "ekflexmenu_accessible_submenu_btnlink";
ekFlexMenu_classNames.link = "ekflexmenu_link";
ekFlexMenu_classNames.linkSelected = "ekflexmenu_link_selected";
ekFlexMenu_classNames.slaveBranchSelected = "ekflexmenu_slave_branch_sel";
ekFlexMenu_classNames.slaveContainer = "ekflexmenu_slavecontainer";

///////////////////////////////////////////////////////////////////////////////
///////////////////////////////////////////////////////////////////////////////
// Class ekFlexMenu:
var ekFlexMenu = function (menuObjectIdString) {

	/////////////////////////
	// public members:

		this.menuId = __ekFlexMenu_returnMenuId;
			// Returns the root menu id for this object.
			// Parameters: 
			//	None.
			
		this.hashCode = __ekFlexMenu_returnHashCode;
			// Returns the hash-code of the server control.
			// Parameters: 
			//	None.

		this.isSubmenuSelected = __ekFlexMenu_isSubmenuSelected;
			// Returns selected-status (and thereby the visibility of the 
			// associated submenu contents) of the identified submenu.
			// Parameters: 
			//	1 - The standard menu-submenu-id string (extra characters discarded).
			
		this.selectSubmenu = __ekFlexMenu_selectSubmenu;
			// Selects the designated submenu, setting the menu-button to a 'selected' 
			// state, and making any associated submenu content items visible.
			// Parameters: 
			//	1 - The standard menu-submenu-id string (extra characters discarded).

		this.unSelectSubmenu = __ekFlexMenu_unSelectSubmenu;
			// De-Selects the designated submenu, setting the menu-button to a non-selected
			// state, and making any associated submenu content items invisible.
			// Parameters: 
			//	1 - The standard menu-submenu-id string (extra characters discarded).
		
		this.hoverButton = __ekFlexMenu_hoverButton;
			// Sets the designated submenu-button to a hovered or non-hovered state.
			// Parameters: 
			//	1 - The standard menu-submenu-id string (extra characters discarded).
			//	2 - Hover flag (boolean; true to set state to hovered).

		this.selectMenuItem = __ekFlexMenu_ekFlexMenu_selectMenuItem;
			// Called when a menu-item (such as a link) is clicked, before
			// the page is submitted to the server.
			// Parameters: 
			//	1 - The element-object that is being selected.
		
		this.initializeWithServerVariables = __ekFlexMenu_initializeWithServerVariables;
			// Called by page-load initialization code, to initialize this object
			// with values passed from the server.
			// Parameters: 
			//	None.
		
		this.showRootMenu = __ekFlexMenu_showRootMenu;
			// Makes the contents of the root-menu visible, selects it's button if it exists.
			// Parameters: 
			//	None.


	/////////////////////////
	// private member functions:
	
		this.buildMenuSubmenuId = __ekFlexMenu_buildMenuSubmenuId;
			// Returns the standard menu-submenu-id string.
			// Parameters: 
			//	1 - The targetted submenu-id number (or string containing only numbers).
			
		this.getFolderButtonObject = __ekFlexMenu_getFolderButtonObject;
			// Returns the folder-button-object for the specified submenu.
			// Parameters: 
			//	1 - The targetted submenu-id (standard menu-submenu-id string).
			
		this.getSubmenuItemsObject = __ekFlexMenu_getSubmenuItemsObject;
			// Returns the folder-item-object for the specified submenu.
			// This may contain menu items such as links and nested submenus.
			// Parameters: 
			//	1 - The targetted submenu-id (standard menu-submenu-id string).

		this.getSubmenuObject = __ekFlexMenu_getSubmenuObject;
			// Returns the corresponding submenu object, 
			// for a given Submenu-Id (or Menu-Submenu-Id):
			// Parameters: 
			//	1 - The targetted submenu-id (standard menu-submenu-id string).
			
		this.getParentLevelSubmenuId = __ekFlexMenu_getParentLevelSubmenuId;
			// Returns the parent-levels menu-submenu-id for the given Submenu,
			// returns zero if the parent (or thismenu) is the root menu.
			// Parameters: 
			//	1 - The targetted submenu-id (standard menu-submenu-id string).
			
		this.getMenuLevel = __ekFlexMenu_getMenuLevel;
			// Returns the integer value of the menu level for
			// the menu identified by the given submenu-id string.
			// Parameters: 
			//	1 - The submenu-id (standard menu-submenu-id string).
			
		this.getEkFlexMenuContainerElement = __ekFlexMenu_getEkFlexMenuContainerElement;
			// Returns the outermost container element (DIV) that 
			// holds this entire ekFlexMenu object.
			// Parameters: 
			//	None.
		
		this.selectSubmenuHelper = __ekFlexMenu_selectSubmenuHelper;
			// Helper funtion for __ekFlexMenu_selectSubmenu, uses 
			// recursionSelects to ensure selected submenus are visible
			// even if they are buried with muliple nesting levels.
			// Parameters: 
			//	1 - The targetted submenu-id (standard menu-submenu-id string).
		
		this.collapseSiblingSubmenus = __ekFlexMenu_collapseSiblingSubmenus;
			// Hide sibling submenus of the designated submenu.
			// Parameters: 
			//	1 - The targetted submenu-id (standard menu-submenu-id string).
		
		this.collapseAllOpenSubmenus = __ekFlexMenu_collapseAllOpenSubmenus;
			// Closes all currently open submenus, to prevent overlap & visual clutter.
			// Parameters: 
			//	1 - Show root flag (boolean; true to make the root menu contents visible).
			
	    this.collapseUnselectedStartLevelSubmenus = __ekFlexMenu_collapseUnselectedStartLevelSubmenus;
	        // Used for slave menu; Closes all unselected submenus:
			// Parameters: 
			//	None.

		this.markParentSubmenu = __ekFlexMenu_markParentSubmenu;
			// Sets the parent folders' style to be a parent (optionally 
			// used in CSS to style parents & children differently):
			// Parameters: 
			//	1 - The submenu-id whose parent to mark (standard menu-submenu-id string).

		this.unMarkParentSubmenu = __ekFlexMenu_unMarkParentSubmenu;
			// Sets the parent folders' style to be a normal non-parent (optionally 
			// used in CSS to style parents & children differently):
			// Parameters: 
			//	1 - The submenu-id whose parent to unmark (standard menu-submenu-id string).
			
		this.hoverSubmenu = __ekFlexMenu_hoverSubmenu;
			// Sets the menus' container style to be hovered,
			// (optionally used in CSS to style contents & children differently):
			// Parameters: 
			//	1 - The submenu-id whose parent to hover (standard menu-submenu-id string).
			
		this.unHoverSubmenu = __ekFlexMenu_unHoverSubmenu;
			// Sets the menus' container style to be unhovered,
			// (optionally used in CSS to style contents & children differently):
			// Parameters: 
			//	1 - The submenu-id whose parent to unhover (standard menu-submenu-id string).
			
			
		this.getEkFlexMenuElementsByTagName = __ekFlexMenu_getEkFlexMenuElementsByTagName;
			// Returns an array of the ekflexmenu-elements with the specified tag-name.
			// Parameters: 
			//	1 - the element tag-name to search for.
			
		this.getElementsByClassName = __ekFlexMenu_getElementsByClassName;
			// Returns an array of the menu-elements, whose className 
			// attributes match the supplied name.
			// Parameters: 
			//	1 - the className to search for.
			
		this.getElementsByClassNameAndTagName = __ekFlexMenu_getElementsByClassNameAndTagName;
			// Returns an array of the menu-elements, whose className 
			// attributes match the supplied name.
			// Parameters: 
			//	1 - the className to search for.
			//  2 - the tag-name of the elements to include in the search.
			
		this.getEkFlexMenuElementsByName =  __ekFlexMenu_getEkFlexMenuElementsByName;
			// Returns an array of the menu-elements, whose name attribute
			// match the supplied name.
			// Parameters: 
			//	1 - the name to search for.

		this.getDirectChildIds = __ekFlexMenu_getDirectChildIds;
			// Returns an array of all direct child-submenu-ids (length = 0 if none).
			// Parameters: 
			//	1 - The targetted submenu-id (standard menu-submenu-id string).
			
		this.mouseIn = __ekFlexMenu_mouseIn;
			// Called by external (non-object-instance) code, to prepare for 
			// delayed opening of identified submenu.
			// Parameters: 
			//	1 - the event object.
			//	2 - the element-object that triggered the event.
		
		this.mouseInHelper = __ekFlexMenu_mouseInHelper;
			// Shows/selects the appropriate submenu.
			// Parameters: 
			//	None.

		this.mouseOut = __ekFlexMenu_mouseOut;
			// Called by external (non-object-instance) code, to prepare for 
			// delayed opening of identified submenu.
			// Parameters: 
			//	1 - the event object.
			//	2 - the element-object that triggered the event.

		this.mouseOutHelper = __ekFlexMenu_mouseOutHelper;
			// Hides/unselects the appropriate submenu (possibly all but root).
			// Parameters: 
			//	None.

		this.disableAllEventHandlers =  __ekFlexMenu_disableAllEventHandlers;
			// Disables all event handlers for elements of this menu object:
			// Parameters: 
			//	None.

		this.disableElementEventHandlers = __ekFlexMenu_disableElementEventHandlers;
			// Disables all event handlers for the given element:
			// Parameters: 
			//	1 - the element to disable events on.

		this.updateNoScriptLinks = __ekFlexMenu_updateNoScriptLinks;
			// When server (XSLT) builds HTML to create the menu,
			// it sets the hrefs of the menu-buttons to signal
			// the server that Javascript is disabled, and the page
			// needs to display a submenu. This way the menu will 
			// still funtion if Javascript is disabled/not supported
			// (required for 508 compliance), this also simplifies Ajax
			// related issues. This function modifies all these to eliminate 
			// page refreshes (not needed if Javascript is enabled).
			// Parameters: 
			//	None.
			
		this.initializeMouseOverPopUp = __ekFlexMenu_initializeMouseOverPopUp;
		    // Determine if MouseOverPopUp is enabled, and 
            // perform related initialization if it is.
			// Parameters: 
			//	None.

		
		///////////////////////////////////////////////////////
		// Master/Slave related functions:
		this.getSlaveControlObject = __ekFlexMenu_getSlaveControlObject;
		this.convertIdToSlaveControlId = __ekFlexMenu_convertIdToSlaveControlId;
		this.callSlave__showSubmenuBranch = __ekFlexMenu_callSlave__showSubmenuBranch;
		this.showSubmenuBranch = __ekFlexMenu_showSubmenuBranch;
		this.unSelectSubmenuList = __ekFlexMenu_unSelectSubmenuList;
		this.initializeSlaveMenu = __ekFlexMenu_initializeSlaveMenu;
		this.initializeMasterMenu = __ekFlexMenu_initializeMasterMenu;
		this.isTopLevelUI = __ekFlexMenu_isTopLevelUI;
		this.recordLastSlaveStartLevelMenu = __ekFlexMenu_recordLastSlaveStartLevelMenu;
		this.getLastSlaveStartLevelMenu = __ekFlexMenu_getLastSlaveStartLevelMenu;
		this.unHideSlaveMenu = __ekFlexMenu_unHideSlaveMenu;
		// Master/Slave related variables:
		this.topLevelUI = null;
		this.lastSelectedStartLevelSlaveMenuId = null;
		this.ekFlexMenu_defaultMenuIdString = false; // Slave menu default submenu-id.
		this.ekFlexMenu_slaveStartLevelIds = null; // slave menu start level ids.
		this.ekFlexMenu_slaveStartLevel = null; // slave menu start level.


		///////////////////////////////////////////////////////
		// Member Ajax releated members:
		this.loadXMLDoc = __ekFlexMenu_ajax_loadXMLDoc;
		this.DecodeHTML = __ekFlexMenu_ajax_DecodeHTML;
		this.getPayload = __ekFlexMenu_ajax_getPayload;
		this.appendText = __ekFlexMenu_ajax_appendText;
		this.appendXml = __ekFlexMenu_ajax_appendXml;
		this.removeMenuFragmentContainer = __ekFlexMenu_ajax_removeMenuFragmentContainer;
		this.callService = __ekFlexMenu_ajax_callService;
		this.callAjaxForUserClick = __ekFlexMenu_ajax_callAjaxForUserClick;
		// Ajax related variables:
		//this.userAjaxXmlHttp1 = null;
		this.userAjaxParentId1 = ""


	/////////////////////////
	// private variables:
	
		this.private_menuIdString = __ekFlexMenu_parseMenuId(menuObjectIdString);
			// holds the root menu id.

		this.private_serverControlHash = __ekFlexMenu_static_parseServerControlHash(menuObjectIdString);
			// holds the server controls' hash-code.

		this.private_autoCollapseSubmenus = true;
			// Controls action on select-submenu; will 
			// collapse all other submenus - if this is true.

		this.private_startWithRootFolderCollapsed = false;
			// If set, will hide the root menu contents when all submenus 
			// are collapsed, otherwise will always leave root contents visible.

		this.private_startCollapsed = true;
			// If set, menu is initially rendered with all submenus closed.
			
		this.private_ajaxEnabled = true;
			// If set, will attempt to make Ajax calls to load submenus.
		
		this.ekFlexMenu_ajaxWSPath = "";
			// The Ajax-WebService base path.
			
		this.ekFlexMenu_displayXslt = "";
			// value to call web-service with for Ajax, to select server-side XSLT to process XML.
			
		this.ekFlexMenu_cacheInterval = "";
			// value to call web-service with for Ajax, to select period to hold server-side to cache data.
			
		this.private_masterControlIdHash = "";
			// If this is a slave control, then this variable holds the 
			// hash-code of the master source controls id.
			
		this.private_subscriberList = "";
			// If this a master control, then this comma delited list (string)
			// holds the hash-codes of each subscribing control.
			
		this.private_slaveControl = "";
			// If this a master control, then this variable
			// holds the hash-code of the slave control.
		
		this.private_isMasterControl = false;
			// True if this control is synchronized to another (slave) control.

		this.private_isSlaveControl = false;
			// True if this control is synchronized to another (master) control.
			
		this.private_lastSelectedMenuItemObj = null;
			// Holds previously selected menu-item-link, used to set old 
			// selection to a non-selected state when a new one is selected.
			
		this.private_selectionChanged = false;
			// Flag to indicate that user activity has changed state from
			// that which was rendered from the server.
			
		this.private_selectedMenuList = "";
			// Holds previously selected menu, used to set the old button
			// selection to a non-selected state when a new one is selected.
		
		this.private_swRevision = "0";
			// The software revision of the server control.
			
		this.enableMouseOverPopUp = false;
		    // True to indicate that a submenu should open when moused over,
		    // False inidcates that a click is required to oen submenus.
			
		// Mouse related variables; only used for pop-up menus (via mouse over):
			this.private_enableMouseOverSubmenuActivation = false;
				// If true, then mouseIn and mouseOut events will be used to 
				// open and close submenus (must be wired by server code).
				
			this.private_mouseEventTimer = null;
				// Used to hold the count-down timer object, to delay show/hide action.
				
			this.private_mouseEventEnteringElementId = null;
				// Holds the ID of the element-id that triggered the mouseIn event.
				
			this.private_mouseEventExitingElementId = null;
				// Holds the ID of the element-id that triggered the mouseOut event.

}
///////////////////////////////////////////////////////////////////////////////

///////////////////////////////////////////////////////////////////////////////
// Initialize Public Static Members:

	ekFlexMenu.getMenuObj = __ekFlexMenu_static_getMenuObj;
		// Returns the Menu-Object for a given ekflexmenu element ID,
		// creates a new ekFlexMenu object if needed (stores these in
		// an array as a property to the indow object - making it 
		// available/shared with all SmartMenus (this was multple menus 
		// can exist on a page, and have different objects that 
		// are avaiable anywhere - given given an ekflexmenu element ID).
		// Parameters: 
		//	1 - The standard menu-submenu-id string (extra characters discarded).


	ekFlexMenu.parseMenuSubmenuIdString = __ekFlexMenu_static_parseMenuSubmenuIdString;
		// Returns the MenuSubmenuID string, for a given ekflexmenu element-ID
		// (ex. given "e1234567_1_submenu_2_button" returns
		// "e1234567_1_submenu_2" for root-menu 1, submenu 2):
		// Parameters: 
		//	1 - The standard menu-submenu-id string (extra characters discarded).

	ekFlexMenu.parseServerControlHash = __ekFlexMenu_static_parseServerControlHash;
		// Returns the server controls' hash-code of the supplied string (or
		// whatever was supplied if not a valid menu-submenu id string):
		// Parameters: 
		//	1 - The standard menu-submenu-id string (extra characters discarded).

	// Menu Folder-Button event handlers:
		ekFlexMenu.menuBtnClickHdlr = __ekFlexMenu_static_menuButtonClickEventHandler;
			// Handler for Menu-Button-Click events
			// Parameters: 
			//	1 - the event-object.
			
		ekFlexMenu.menuBtnKeyHdlr = __ekFlexMenu_static_menuButtonKeyDownEventHandler;
			// Handler for Menu-Button-Keydown events.
			// Parameters: 
			//	1 - the event-object.

		ekFlexMenu.menuBtnMouseOverHdlr = __ekFlexMenu_static_menuButtonMouseOverEventHandler;
			// Handler for Menu-Button-MouseOver events.
			// Parameters: 
			//	1 - the event-object.

		ekFlexMenu.menuBtnMouseOutHdlr = __ekFlexMenu_static_menuButtonMouseOutEventHandler;
			// Handler for Menu-Button-MouseOut events.
			// Parameters: 
			//	1 - the event-object.

		ekFlexMenu.menuBtnFocusHdlr = __ekFlexMenu_static_menuButtonFocusEventHandler;
			// Handler for Menu-Button-Focus events.
			// Parameters: 
			//	1 - the event-object.

		ekFlexMenu.menuBtnBlurHdlr = __ekFlexMenu_static_menuButtonBlurEventHandler;
			// Handler for Menu-Button-Blur events.
			// Parameters: 
			//	1 - the event-object.

		ekFlexMenu.menuBtnLinkFocusHdlr = __ekFlexMenu_static_menuButtonLinkFocusEventHandler;
			// Handler for Menu-Button-Link-onFocus events.
			// Parameters: 
			//	1 - the event-object.

		ekFlexMenu.menuBtnLinkBlurHdlr = __ekFlexMenu_static_menuButtonLinkBlurEventHandler;
			// Handler for Menu-Button-Link-onBlur events.
			// Parameters: 
			//	1 - the event-object.


	// Menu Item-Link event handlers:
		ekFlexMenu.itemLinkClickHdlr = __ekFlexMenu_static_menuItemLinkClickEventHandler;
			// Handler for Menu-Item-Link-Click events.
			// Parameters: 
			//	1 - the event-object.
		
		// Not Needed (key translated by browser, others handled by link pseudo classes):
			//ekFlexMenu.itemLinkKeyHdlr = __ekFlexMenu_static_menuItemLinkKeyDownEventHandler;
			//ekFlexMenu.itemLinkMouseOverHdlr = __ekFlexMenu_static_menuItemLinkMouseOverEventHandler;
			//ekFlexMenu.itemLinkMouseOutHdlr = __ekFlexMenu_static_menuItemLinkMouseOutEventHandler;
			//ekFlexMenu.itemLinkFocusHdlr = __ekFlexMenu_static_menuItemLinkFocusEventHandler;
			//ekFlexMenu.itemLinkBlurHdlr = __ekFlexMenu_static_menuItemLinkBlurEventHandler;


	// mouseIn and mouseOut event handlers:
		ekFlexMenu.mouseIn = __ekFlexMenu_static_mouseIn;
			// Prepare for delayed opening of the submenu related to the event-triggering element.
			// Parameters: 
			//	1 - the event-object.
		
		ekFlexMenu.mouseOut = __ekFlexMenu_static_mouseOut;
			// Prepare for delayed closing of the submenu related to the event-triggering element.
			// Parameters: 
			//	1 - the event-object.

		ekFlexMenu.mouseIn_empty = function (event) {return (true);} // bubble event...

///////////////////////////////////////////////////////////////////////////////
// Initialize Private Static Members:
	ekFlexMenu.private_isValidMenuSubmenuIdString = __ekFlexMenu_static_isValidMenuSubmenuIdString
		// Verifies that the supplied element-ID string is a valid 
		// MenuSubmenuID string (ex. "e1234567_1_submenu_2_button...")
		// Note: it may be more than this, but as long as the submitted string
		// begins with a valid and usable standard menu-submenu-id string, then
		// the results are positive (any extra appended characters are ignored).
		// Parameters: 
		//	1 - the id-string to test (may be an element-objects' Id).

	ekFlexMenu.private_serverHelper_initialize = __ekFlexMenu_static_serverHelper_initialize;
		// Calls initialization code, to configure and pre-open select menus.
		// Attempts to obtain a ekFlexMenu object, and then calls its' 
		// initializeWithServerVariables() method...
		// Parameters: 
		//	1 - The standard menu-submenu-id string (submenu-id and extra characters discarded).
	
	ekFlexMenu.private_startupAllSmartMenus = __ekFlexMenu_static_serverHelper_startupAllSmartMenus;
		// Ensures that all ekFlexMenu objects have been initialized.
		// Parameters: 
		//	None.
		
	ekFlexMenu.private_shutdownAllSmartMenus = __ekFlexMenu_static_serverHelper_shutdownAllSmartMenus;
		// Ensures that all ekFlexMenu objects have been un-initialized (allows clean-up, if needed).
		// Parameters: 
		//	None.
		
	ekFlexMenu.private_getMenuId = __ekFlexMenu_static_getMenuId;
		// Returns the base (root) Menu-ID number, for a given ekflexmenu element ID.
		// Parameters: 
		//	1 - the elements' full Id (shuold contain the standard menu-submenu-id string).
	
	ekFlexMenu.private_getMenuIdString = __ekFlexMenu_static_getMenuIdString;
		// Returns the base (root) Menu-ID String, for a given ekflexmenu element ID.
		// Parameters: 
		//	1 - the elements' full Id (shuold contain the standard menu-submenu-id string).
		
	ekFlexMenu.private_getSubmenuId = __ekFlexMenu_static_getSubmenuId;
		// Returns the Submenu-ID number, for a given ekflexmenu element ID.
		// Parameters: 
		//	1 - the elements' full Id (shuold contain the standard menu-submenu-id string).
		
	ekFlexMenu.private_getSubmenuIdString = __ekFlexMenu_static_getSubmenuIdString;
		// Returns the Submenu-ID String, for a given ekflexmenu element ID.
		// Parameters: 
		//	1 - the elements' full Id (shuold contain the standard menu-submenu-id string).
		
	ekFlexMenu.private_getEvent = __ekFlexMenu_static_getEvent;
		// Returns the event object.
		// Parameters: 
		
	ekFlexMenu.private_getEventElement = __ekFlexMenu_static_getEventElement;
		// Returns the element object that triggered the event.
		// Parameters: 
		//	1 - the event (may be null if browser is IE).
		
	ekFlexMenu.private_getIntNumber = __ekFlexMenu_static_getIntNumber;
		// Returns the decimal equivelent of the given string value, 
		// or zero (0) if supplied string value is not a number.
		// Parameters: 
		//	1 - the string to convert to a number.

	ekFlexMenu.private_isValidSubmenuObj = __ekFlexMenu_static_isValidSubmenuObj;
		// Verifies that element is a valid submenu object.
		// Parameters: 
		//	1 - the submenu object to test.
		//	2 - the class-name to compare (may be a fragment, which 
		//	    is useful if the class name can vary - such as 
		//	    "ekflexmenu_button" and "ekflexmenu_button_selected").
		
	ekFlexMenu.private_isValidSubmenuButton = __ekFlexMenu_static_isValidSubmenuButton;
		// Verifies that element object is a valid submenu button.
		// Parameters: 
		//	1 - the button object to test.
		
	ekFlexMenu.private_isValidSubmenuItems = __ekFlexMenu_static_isValidSubmenuItems;
		// Verifies that element object is a valid submenu submenu_items.
		// Parameters: 
		//	1 - the submenu-items object to test.
		
	ekFlexMenu.private_isValidSubmenu = __ekFlexMenu_static_isValidSubmenu;
		// Verifies that element object is a valid submenu submenu.
		// Parameters: 
		//	1 - the submenu object to test.
		
	ekFlexMenu.private_isValidSubmenuLink = __ekFlexMenu_static_isValidSubmenuLink;
		// Verifies that element object is a valid submenu link.
		// Parameters: 
		//	1 - the submenu-link object to test.
		
	ekFlexMenu.private_isValidEKMenu = __ekFlexMenu_static_isValidEKMenu;
		// Verifies that element object is a valid main ekflexmenu object.
		// Parameters: 
		//	1 - the main-ekflexmenu-object to test.

	ekFlexMenu.private_isDefined = __ekFlexMenu_static_isDefined;
		// Verifies that the passed in object is not undefined.
		// Parameters: 
		//	1 - the object to test.

	ekFlexMenu.isDefinedNotNull = __ekFlexMenu_static_isDefinedNotNull;
		// Verifies that the passed in object is not undefined, and is not null.
		// Parameters: 
		//	1 - the main-ekflexmenu-object to test.

	ekFlexMenu.hasClassName = __ekFlexMenu_static_hasClassName;
		// Tests for the presence of a specified classname in the supplied object.
		// Parameters: 
		//	1 - the object to test.
		//  2 - the classname to search for.
		
	ekFlexMenu.addClassName = __ekFlexMenu_static_addClassName;
		// Ensures that the given object has the specified classname.
		// Parameters: 
		//	1 - the object to update.
		//  2 - the classname to add.
		
	ekFlexMenu.removeClassName = __ekFlexMenu_static_removeClassName;
		// Ensures that the given object does not have the specified classname.
		// Parameters: 
		//	1 - the object to update.
		//  2 - the classname to remove.

	ekFlexMenu.submenuIsTopLevel = __ekFlexMenu_static_submenuIsTopLevel;
		// Returns true if the string points to the top level.
		// Parameters: 
		//	1 - A standard menu-submenu-id string (extra characters are discarded).
		
	ekFlexMenu.clearSiblingButtons = __ekFlexMenu_clearSiblingButtons;
        // Called when mouseover menu-links to unselect sibling-submenus.
        // ...Only wired-up when enableMouseOverPopUp is true:
		// Parameters: 
		//	1 - the calling element.

	// Ajax static functions:
	ekFlexMenu.ajaxCallBack_stateChange = __ekFlexMenu_ajaxCallBack_stateChange;
	ekFlexMenu.ajaxGetMenuObj = __ekFlexMenu_ajaxGetMenuObj
	ekFlexMenu.ajaxCancelServerCall  = __ekFlexMenu_static_ajaxCancelServerCall;


	// Static variables:
	ekFlexMenu.static_userAjaxXmlHttp1 = null;
		
	// Constants:
		ekFlexMenu.private_menuPrefix = "e"; // ekFlexMenu.private_menuPrefix = "ekfxmensel_";
		ekFlexMenu.private_hashLength = 9; /* Eight character hexadecimal hash code, prefixed with "e" */
		ekFlexMenu.private_namePrefix = "ekmengrp_";
		//Update: no longer used: ekFlexMenu.private_submenuDelimiter = "_submenu_";
		ekFlexMenu.private_buttonElementIdPostFix = "_button";
		ekFlexMenu.private_submenuItemsElementIdPostFix = "_submenu_items";
		ekFlexMenu.private_parentIdElementIdPostFix = "_parentid";
		ekFlexMenu.private_ekflexmenuContainerElementIdPostFix = "_ekflexmenu"


//*********************************************************
// ekFlexMenu Static Member Definitions Begin:
//*********************************************************

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function
// Returns the Menu-Object for a given ekflexmenu element ID,
// creates a new ekFlexMenu object if needed (stores these in
// an array as a property to the window object - making it 
// available/shared with all SmartMenus (this way multiple menus 
// can exist on a page, and have different objects that 
// are available anywhere - given an ekflexmenu element ID).
function __ekFlexMenu_static_getMenuObj(elementId) {
	var menuObj = null;
	var menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(elementId);
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(menuSubmenuId)) {
		//var menuIdString = ekFlexMenu.private_getMenuIdString(menuSubmenuId);
		var menuHashCode = ekFlexMenu.parseServerControlHash(menuSubmenuId);
		
		if (("undefined" == typeof window.ekFlexMenu_MenuObjArray)
			|| (null == window.ekFlexMenu_MenuObjArray)) {
			var MenuObjArray = new Array;
			menuObj = new ekFlexMenu(menuSubmenuId);
			MenuObjArray[menuHashCode] = menuObj;
			window.ekFlexMenu_MenuObjArray = MenuObjArray;
		} 
		else if (null == window.ekFlexMenu_MenuObjArray[menuHashCode]) {
			window.ekFlexMenu_MenuObjArray[menuHashCode] = menuObj = new ekFlexMenu(menuSubmenuId);
		}
		else {
			menuObj = window.ekFlexMenu_MenuObjArray[menuHashCode];
		}
	}
	return (menuObj);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Returns the MenuSubmenuID string, for a given ekflexmenu element-ID
// (ex. given "e1234567_1_submenu_2_button" returns
// "e1234567_1_submenu_2" for root-menu 1, submenu 2):
//
// Update:
// Now prefixed with server-control IDs' hexidecimal hash-code:
// (ex. given "c580fa7b_1_2_button" returns
// "c580fa7b_1_2" for root-menu 1, submenu 2):
function __ekFlexMenu_static_parseMenuSubmenuIdString(elementId) {
	var result = "";
	if (elementId 
		&& ("undefined" != typeof elementId)
		&& ("undefined" != typeof elementId.length)
		&& (elementId.length > 0)
		&& ("undefined" != typeof elementId.indexOf)) {

		var frag = elementId.split("_");
		if (frag[0] && (ekFlexMenu.private_hashLength == frag[0].length) && frag[1] && frag[2]) {
			result = frag[0] + "_" + frag[1] + "_" + frag[2];
		}
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Returns the server controls' hash-code of the supplied string (or
// whatever was supplied if not a valid menu-submenu id string):
function __ekFlexMenu_static_parseServerControlHash(id) {
	var result = "";
	if (id && id.split) {
		var frag = id.split("_");
		if (frag[0] && (ekFlexMenu.private_hashLength == frag[0].length)) {
			result = frag[0];
		}
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Returns the event object:
function __ekFlexMenu_static_getEvent(e) {
	if (e) return (e);
	else return (window.event);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Returns the element object that triggered the event:
function __ekFlexMenu_static_getEventElement(e) {
	if (e) return ((e.srcElement) ? e.srcElement : e.target);
	else return (null);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Handler for Menu-Button-Click events:
function __ekFlexMenu_static_menuButtonClickEventHandler(e) {
	var ev = ekFlexMenu.private_getEvent(e);
	var result = true;
	if (ev) {
		var el = ekFlexMenu.private_getEventElement(ev);
		if (el && ("undefined" != el.id)) {
			var menuObj = ekFlexMenu.getMenuObj(el.id);
			if (menuObj) {
				var prevState = menuObj.isSubmenuSelected(el.id);
				if (prevState) {
					menuObj.unSelectSubmenu(el.id);
					result = false; // event consumed.
				}
				else {
					menuObj.selectSubmenu(el.id);
					result = false; // event consumed.
					
					// Attempt to call ajax if enabled, refresh the page 
					// the with desired submenu open, if the call fails:
					if (menuObj.private_ajaxEnabled) {
						if (menuObj.callAjaxForUserClick(el.id)) {
							// Prevent the "noscript" link from refreshing the page:
							ev.returnValue = false;
							//ev.cancelBubble = true;
							result = false; // event consumed.
						}
						else {
							result = true; // event not consumed; fire href link.
						}
					}
				}
			}
		}
		// Test to see if browser should follow link:
		if (ekFlexMenu.isDefinedNotNull(el)) {
			if (ekFlexMenu.isDefinedNotNull(el.href)) {
				if (ekFlexMenu.isDefinedNotNull(el.href.indexOf)) {
					if (0 > el.href.indexOf("ekfxmen_noscript=1")) {
						// This is a valid user link: 
						//   signal event not consumed, and fire href link.
						result = true;
					}
				}
			}
		}
	}
	return (result);	
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Handler for Menu-Button-Keydown events:
// Note: Typically called by a submenu-folder-button when 
//   a key is pressed, and 508-Compliance is disabled. 
function __ekFlexMenu_static_menuButtonKeyDownEventHandler(e) {
	var ev = ekFlexMenu.private_getEvent(e);
	if (ev) {
		var el = ekFlexMenu.private_getEventElement(ev);
		if (el && ("undefined" != el.id)) {

			var key = ev.keyCode;
			if (key && ((key == 32))) { // select submenu on space-bar press...

				// Prevent screen from scrolling, due to internal 
				// link-click (anchor-tag, with href="#"):
				if (ev.preventDefault && ev.stopPropagation) {
					ev.preventDefault();
					ev.stopPropagation();
				}
				else {
					ev.returnValue = false;
				}
				
				// Now toggle the state of the menu:
				ekFlexMenu.menuBtnClickHdlr(ev);
				
				return (false); // event consumed.
			}
		}
	}
	return (true);	
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Handler for Menu-Button-MouseOver events:
function __ekFlexMenu_static_menuButtonMouseOverEventHandler(e) {
	var ev = ekFlexMenu.private_getEvent(e);
	if (ev) {
		var el = ekFlexMenu.private_getEventElement(ev);
		if (el && ("undefined" != el.id)) {
			var menuObj = ekFlexMenu.getMenuObj(el.id);
			if (menuObj) {
				menuObj.hoverButton(el.id, true);
				menuObj.hoverSubmenu(el.id);
				return (false); // event consumed.
			}
		}
	}
	return (true);	
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Handler for Menu-Button-MouseOut events:
function __ekFlexMenu_static_menuButtonMouseOutEventHandler(e) {
	var ev = ekFlexMenu.private_getEvent(e);
	if (ev) {
		var el = ekFlexMenu.private_getEventElement(ev);
		if (el && ("undefined" != el.id)) {
			var menuObj = ekFlexMenu.getMenuObj(el.id);
			if (menuObj) {
				menuObj.hoverButton(el.id, false);
				menuObj.unHoverSubmenu(el.id);
				return (false); // event consumed.
			}
		}
	}
	return (true);	
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Handler for Menu-Button-Focus events:
function __ekFlexMenu_static_menuButtonFocusEventHandler(e) {
	var ev = ekFlexMenu.private_getEvent(e);
	if (ev) {
		var el = ekFlexMenu.private_getEventElement(ev);
		if (el && ("undefined" != el.id)) {
			var menuObj = ekFlexMenu.getMenuObj(el.id);
			if (menuObj) {
				menuObj.hoverButton(el.id, true);
				menuObj.hoverSubmenu(el.id);
				return (false); // event consumed.
			}
		}
	}
	return (true);	
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Handler for Menu-Button-Blur events:
function __ekFlexMenu_static_menuButtonBlurEventHandler(e) {
	var ev = ekFlexMenu.private_getEvent(e);
	if (ev) {
		var el = ekFlexMenu.private_getEventElement(ev);
		if (el && ("undefined" != el.id)) {
			var menuObj = ekFlexMenu.getMenuObj(el.id);
			if (menuObj) {
				menuObj.hoverButton(el.id, false);
				menuObj.unHoverSubmenu(el.id);
				return (false); // event consumed.
			}
		}
	}
	return (true);	
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Handler for Menu-Button-Link-onFocus events:
function __ekFlexMenu_static_menuButtonLinkFocusEventHandler(e) {
	var ev = ekFlexMenu.private_getEvent(e);
	if (ev) {
		var el = ekFlexMenu.private_getEventElement(ev);
		if (el && ("undefined" != el.id)) {
			var menuObj = ekFlexMenu.getMenuObj(el.id);
			if (menuObj) {
				menuObj.hoverButton(el.id, true);
				menuObj.hoverSubmenu(el.id);
				return (false); // event consumed.
			}
		}
	}
	return (true);	
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Handler for Menu-Button-Link-onBlur events:
function __ekFlexMenu_static_menuButtonLinkBlurEventHandler(e) {
	var ev = ekFlexMenu.private_getEvent(e);
	if (ev) {
		var el = ekFlexMenu.private_getEventElement(ev);
		if (el && ("undefined" != el.id)) {
			var menuObj = ekFlexMenu.getMenuObj(el.id);
			if (menuObj) {
				menuObj.hoverButton(el.id, false);
				menuObj.unHoverSubmenu(el.id);
				return (false); // event consumed.
			}
		}
	}
	return (true);	
}

///////////////////////////////////////////////////////////
function __ekFlexMenu_static_getValidParentId(el) {
	var topContainer = "_ekflexmenu";
	var len = topContainer.length;
	
	while(el 
		&& (el.parentNode)) {
		
		if (el.id && (el.id.length)) {
			if (ekFlexMenu.private_isValidMenuSubmenuIdString(el.id)) {
				return (el.id);
			}
		}
		el = el.parentNode;
	}

	return ("");
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// mouseIn event handler; prepares for delayed opening of 
// the submenu related to the event-triggering element.
// Parameters: 
//	1 - the event-object.
function __ekFlexMenu_static_mouseIn(e) {
	var ev = ekFlexMenu.private_getEvent(e);
	if (ev) {
		var el = ekFlexMenu.private_getEventElement(ev);
		if (el && ("undefined" != el.id)) {
		    var elmtId = el.id;
			if (0 == elmtId.length) {
				elmtId = __ekFlexMenu_static_getValidParentId(el);
			}
			var menuObj = ekFlexMenu.getMenuObj(elmtId);
			if (menuObj) {
				menuObj.mouseIn(e, el);
				return (true); // event not-consumed (allow bubbling).
			}
		}
	}
	return (true);	
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// mouseOut event handler; prepares for delayed closing of 
// the submenu related to the event-triggering element.
// Parameters: 
//	1 - the event-object.
function __ekFlexMenu_static_mouseOut(e) {
	var ev = ekFlexMenu.private_getEvent(e);
	if (ev) {
		var el = ekFlexMenu.private_getEventElement(ev);
		if (el && ("undefined" != el.id)) {
		    var elmtId = el.id;
			if (0 == elmtId.length) {
				elmtId = __ekFlexMenu_static_getValidParentId(el);
			}
			var menuObj = ekFlexMenu.getMenuObj(elmtId);
			if (menuObj) {
				menuObj.mouseOut(e, el);
				return (true); // event not-consumed (allow bubbling).
			}
		}
	}
	return (true);	
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Handler for Menu-Item-Link-Click events:
function __ekFlexMenu_static_menuItemLinkClickEventHandler(e) {
	var linkIsAButton = false;
	var ev = ekFlexMenu.private_getEvent(e);
	if (ev) {
		var el = ekFlexMenu.private_getEventElement(ev);
		if (el && ("undefined" != el.id)) {

			if (ekFlexMenu.isDefinedNotNull(el)
				&& ekFlexMenu.isDefinedNotNull(el.tagName)
				&& ("IMG" == el.tagName)) 
			{
				// The element is an image, attempt to pass
				// -off the event to the wrapping element: 
				if (ekFlexMenu.isDefinedNotNull(el.parentNode) 
					&& ekFlexMenu.private_isValidSubmenuButton(el.parentNode))
				{
					el = el.parentNode;
					if (ekFlexMenu.isDefinedNotNull(el.click)) {
						el.click(ev);
						return (false);
					}
					linkIsAButton = true;
				}
				else {
					return (true); 
				}
			}
			else if (ekFlexMenu.private_isValidSubmenuButton(el)) {
				linkIsAButton = true;
			}

			var menuObj = ekFlexMenu.getMenuObj(el.id);
			if (menuObj) {
				// may need to toggle menu state if the link is a menu button:				
				if (linkIsAButton) {
					var prevState = menuObj.isSubmenuSelected(el.id);
					if (prevState) {
						menuObj.unSelectSubmenu(el.id);
					}
					else {
						menuObj.selectSubmenu(el.id);
					}
				}
				menuObj.selectMenuItem(el);
				return (false); // event consumed.
			}
		}
	}
	return (true);	
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Returns the decimal equivelent of the given string value, 
// or zero (0) if supplied string value is not a number:
function __ekFlexMenu_static_getIntNumber(val) {
	var result = 0;
	var tempResult = parseInt(val, 10);
	if (NaN != tempResult) {
		result = tempResult;
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Returns the Menu-ID number, for a given ekflexmenu element ID:
function __ekFlexMenu_static_getMenuId(elementId) {
	var result = 0;
	var idString = ekFlexMenu.private_getMenuIdString(elementId);
	if (idString.length) {
		result = ekFlexMenu.private_getIntNumber(idString);
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Returns the Menu-ID String, for a given ekflexmenu element ID:
function __ekFlexMenu_static_getMenuIdString(elementId) {
	var result = "";
	var menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(elementId);
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(menuSubmenuId)) {
		var frag = elementId.split("_");
		if (frag[0] && (ekFlexMenu.private_hashLength == frag[0].length) && frag[1] && frag[2]) {
			result = frag[1];
		}
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Returns the Submenu-ID number, for a given ekflexmenu element ID:
function __ekFlexMenu_static_getSubmenuId(elementId) {
	var result = 0;
	var idString = ekFlexMenu.private_getSubmenuIdString(elementId);
	if (idString.length) {
		result = ekFlexMenu.private_getIntNumber(idString);
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Returns the Submenu-ID String, for a given ekflexmenu element ID:
function __ekFlexMenu_static_getSubmenuIdString(elementId) {
	var result = "";
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(elementId)) {
		var frag = elementId.split("_");
		if (frag[0] && (ekFlexMenu.private_hashLength == frag[0].length) && frag[1] && frag[2]) {
			result = frag[2];
		}
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Verifies that the supplied element-ID string is a valid 
// MenuSubmenuID string (ex. "e1234567_1_submenu_2_button")
function __ekFlexMenu_static_isValidMenuSubmenuIdString(elementId) {
	var result = false;
	if (elementId 
		&& ("undefined" != typeof elementId)
		&& ("undefined" != typeof elementId.length)
		&& (elementId.length > 0)
		&& ("undefined" != typeof elementId.indexOf)) {
		var frag = elementId.split("_");
		if (frag[0] && (ekFlexMenu.private_hashLength == frag[0].length) && frag[1] && frag[2]) {
					result = true;
		}
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Verifies that element is a valid submenu object:
function __ekFlexMenu_static_isValidSubmenuObj(obj, classNameFrag) {
	var result = false;
	if (obj 
		&& ("undefined" != typeof obj.id)
		&& ("undefined" != typeof obj.className)
		&& ("undefined" != typeof obj.className.indexOf)
		&& (0 <= obj.className.indexOf(classNameFrag))) {
		result = true;
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Verifies that element object is a valid submenu button:
function __ekFlexMenu_static_isValidSubmenuButton(obj) {
	return (ekFlexMenu.private_isValidSubmenuObj(obj, ekFlexMenu_classNames.button));
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Verifies that element object is a valid submenu submenu_items:
function __ekFlexMenu_static_isValidSubmenuItems(obj) {
	return (ekFlexMenu.private_isValidSubmenuObj(obj, "submenu_items"));
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Verifies that element object is a valid submenu submenu:
function __ekFlexMenu_static_isValidSubmenu(obj) {
	return (ekFlexMenu.private_isValidSubmenuObj(obj, "submenu"));
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Verifies that element object is a valid submenu link:
function __ekFlexMenu_static_isValidSubmenuLink(obj) {
	return (ekFlexMenu.private_isValidSubmenuObj(obj, "link"));
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Verifies that element object is a valid main ekflexmenu object:
function __ekFlexMenu_static_isValidEKMenu(obj) {
	return (ekFlexMenu.private_isValidSubmenuObj(obj, "ekflexmenu"));
}

///////////////////////////////////////////////////////////
// Verifies that the passed in object is not undefined.
// Parameters: 
//	1 - the main-ekflexmenu-object to test.
function __ekFlexMenu_static_isDefined(obj) {
	return ("undefined" != typeof obj);
}

///////////////////////////////////////////////////////////
// Verifies that the passed in object is not 
// undefined, and is not null.
// Parameters: 
//	1 - the main-ekflexmenu-object to test.
function __ekFlexMenu_static_isDefinedNotNull(obj) {
	return (ekFlexMenu.private_isDefined(obj) && (null != obj));
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Calls initialization code, to configure and pre-open select menus:
function __ekFlexMenu_static_serverHelper_initialize(id) {
	var menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(id);
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(menuSubmenuId)) {
		//var menuHashCode = ekFlexMenu.parseServerControlHash(menuSubmenuId);
		var menuObj = ekFlexMenu.getMenuObj(menuSubmenuId);
		if (menuObj) {
			menuObj.initializeWithServerVariables();
		}
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Ensures that all ekFlexMenu objects have been initialized:
function __ekFlexMenu_static_serverHelper_startupAllSmartMenus() {
	if (("undefined" != typeof window.ekFlexMenu_ekflexmenuArray)
		&& (null != window.ekFlexMenu_ekflexmenuArray)
		&& ("undefined" != typeof window.ekFlexMenu_ekflexmenuArray.length)
		&& (null != window.ekFlexMenu_ekflexmenuArray.length)) {
		
		for (var idx = 0; idx < window.ekFlexMenu_ekflexmenuArray.length; idx++) {
			var startMenu = window.ekFlexMenu_ekflexmenuArray[idx];
			if (startMenu.length) 
				ekFlexMenu.private_serverHelper_initialize(startMenu);
		}
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Ensures that all ekFlexMenu objects have been initialized:
function __ekFlexMenu_static_serverHelper_shutdownAllSmartMenus() {
	ekFlexMenu.ajaxCancelServerCall();
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Terminates any outstanding Ajax calls:
function __ekFlexMenu_static_ajaxCancelServerCall()
{
	if (ekFlexMenu.static_userAjaxXmlHttp1 != null) {
		ekFlexMenu.static_userAjaxXmlHttp1.abort();
		ekFlexMenu.static_userAjaxXmlHttp1 = null;
	}
}



///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Tests for the presence of a specified classname in the supplied object.
function __ekFlexMenu_static_hasClassName(obj, className) {
	var idx, names;
	if (obj && ("undefined" != typeof obj.className)
		&& ("undefined" != typeof obj.className.split)) {
		names = obj.className.split(" ");
		for (idx = 0; idx < names.length; idx++) {
			if (names[idx] == className)
				return true;
		}
	} 
	return false;
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Ensures that the given object has the specified classname.
function __ekFlexMenu_static_addClassName(obj, className) {
	if (ekFlexMenu.hasClassName(obj, className))
		return;
	
	if (obj && ("undefined" != typeof obj.className)
		&& ("undefined" != typeof obj.className.length)) {
		if (0 == obj.className.length) {
			obj.className = className;
		}
		else {
			obj.className += " " + className;
		}
	} 
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Ensures that the given object does not have the specified classname.
function __ekFlexMenu_static_removeClassName(obj, className) {
	var idx, matchId, names, result;
	if (obj && ("undefined" != typeof obj.className)
		&& ("undefined" != typeof obj.className.split)) {
		names = obj.className.split(" ");
		obj.className = "";
		for (idx = 0; idx < names.length; idx++) {
			if (names[idx] != className) {
				if (idx > 0)
					obj.className += " " + names[idx];
				else
					obj.className += names[idx];
			}
		}
	} 
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Returns true if the string points to the top level.
function __ekFlexMenu_static_submenuIsTopLevel(elementId) {
	var result = false;
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(elementId)) {
		var sub = ekFlexMenu.private_getSubmenuIdString(elementId);
		var ancestorId = ekFlexMenu.private_getMenuIdString(elementId);
		result = ((0 == sub) || (ancestorId == sub));
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Handle Ajax callback:
function __ekFlexMenu_ajaxCallBack_stateChange()
{
	if (ekFlexMenu.static_userAjaxXmlHttp1.readyState == 4) {
		if (ekFlexMenu.isDefinedNotNull(ekFlexMenu.static_userAjaxXmlHttp1.status)) {
			if (200 <= ekFlexMenu.static_userAjaxXmlHttp1.status < 300) {
				var menuObj = ekFlexMenu.ajaxGetMenuObj(ekFlexMenu.static_userAjaxXmlHttp1.responseText);
				if (menuObj) {
					var resType = ekFlexMenu.static_userAjaxXmlHttp1.getResponseHeader('Content-Type');
					if (0 > resType.indexOf("text/xml")) {
						menuObj.appendText(menuObj.userAjaxParentId1);
					}
					else {
						menuObj.appendXml(menuObj.userAjaxParentId1);
					}
				}
			}
			else {
				// TODO: flag failure, and use links' href paramter as fallback...
			}
		}
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// Ajax helper function:
function __ekFlexMenu_ajaxGetMenuObj(reqStr)
{
	var result = null;
	var idx = reqStr.indexOf("ekflexmenu");
	if (idx >= 0) {
		var tempStr = reqStr.substr(idx);
		var matchStr = " id=";
		idx = tempStr.indexOf(matchStr);
		if (idx >= 0) {
			tempStr = tempStr.substr(idx + matchStr.length);
			idx = tempStr.indexOf(ekFlexMenu.private_menuPrefix);
			if (idx >= 0) {
				tempStr = tempStr.substr(idx);
				tempStr = ekFlexMenu.parseMenuSubmenuIdString(tempStr);
				result = ekFlexMenu.getMenuObj(tempStr);
			}
		}
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Static Member Helper Function.
// clearSiblingButtons:
// Called when mouseover menu-links to unselect sibling-submenus.
// ...Only wired-up when enableMouseOverPopUp is true:
function __ekFlexMenu_clearSiblingButtons(obj) {
    // find sibling-submenus, set them to unselected and hide their children:
    if (obj && obj.parentNode && obj.parentNode.parentNode && obj.parentNode.parentNode.id)
        $ektron("#" + obj.parentNode.parentNode.id + " > li.ekflexmenu_submenu").find(" > ul").removeClass("ekflexmenu_submenu_items").addClass("ekflexmenu_submenu_items_hidden").end().find(" > a.ekflexmenu_button_selected").removeClass("ekflexmenu_button_selected").addClass("ekflexmenu_button")
    return (true);
}


//*********************************************************
// ekFlexMenu Instance Member Definitions Begin:
//*********************************************************

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Returns the root-menu id string.
function __ekFlexMenu_returnMenuId() {
	return (this.private_menuIdString);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Returns the hash-code of the server control.
function __ekFlexMenu_returnHashCode() {
	return (this.private_serverControlHash);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Returns the root-menu id string of the supplied string (or
// whatever was supplied if not a valid menu-submenu id string):
function __ekFlexMenu_parseMenuId(id) {
	var menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(id);
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(menuSubmenuId)) {
		return (ekFlexMenu.private_getMenuIdString(menuSubmenuId));
	}
	else {
		return (id);
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Returns boolean, indicating if identified button is 
// currently selected (and therefore, then the associated
// visibility state of the identified submenu items):
function __ekFlexMenu_isSubmenuSelected(idString) {
	var menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(idString);
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(menuSubmenuId)) {
		var btnObj = this.getFolderButtonObject(menuSubmenuId);
		if (ekFlexMenu.private_isValidSubmenuButton(btnObj)) {
			return (ekFlexMenu.hasClassName(btnObj, ekFlexMenu_classNames.buttonSelected)
				|| ekFlexMenu.hasClassName(btnObj, ekFlexMenu_classNames.buttonSelectedHover));
		}
	}
	return (false);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Selects the identified menu; if there is a folder-button, 
// then the class is updated to selected state. Then shows 
// the associated submenu items:
function __ekFlexMenu_selectSubmenu(idString, optional_fromMouseIn) {
	var defaultFromMouseIn = false;
	if (ekFlexMenu.isDefinedNotNull(optional_fromMouseIn)) {
		defaultFromMouseIn = optional_fromMouseIn;
	}

	var menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(idString);
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(menuSubmenuId)) {
		if (this.private_autoCollapseSubmenus) {
		    if (this.private_isSlaveControl && defaultFromMouseIn){
		        this.collapseUnselectedStartLevelSubmenus();
		    }
		    else{
			    this.collapseAllOpenSubmenus(false);
			}
		}
		this.private_selectedMenuList = menuSubmenuId;
		this.selectSubmenuHelper(menuSubmenuId);
	
		if (!defaultFromMouseIn){
			this.callSlave__showSubmenuBranch(idString);
		}
		
		this.private_selectionChanged = true;
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
function __ekFlexMenu_getSlaveControlObject() {
	var result = null;
	if (this.private_isMasterControl
		&& ekFlexMenu.isDefinedNotNull(this.private_slaveControl) 
		&& ekFlexMenu.isDefinedNotNull(this.private_slaveControl.length)
		&& (this.private_slaveControl.length > 0)) {
		var slaveId = this.private_slaveControl + "_" + this.menuId() + "_0";
		var slaveObj = ekFlexMenu.getMenuObj(slaveId);
		if (slaveObj) {
			result = slaveObj;
		}
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
function __ekFlexMenu_callSlave__showSubmenuBranch(idString) {
	var slaveObj = this.getSlaveControlObject();
	var btnContainer;
	if (slaveObj) {
		if (slaveObj.showSubmenuBranch(this.convertIdToSlaveControlId(slaveObj, idString))) {
			// slave menu succesfully activated, mark top button properly,
			// after ensuring all other top-level-buttons are un-marked:
			for (var ui in this.topLevelUI) {
				//btnContainer = document.getElementById(ui);
				btnContainer = document.getElementById(ui);
				if (btnContainer) {
					if (ekFlexMenu.hasClassName(btnContainer, ekFlexMenu_classNames.slaveBranchSelected)) {
						ekFlexMenu.removeClassName(btnContainer, ekFlexMenu_classNames.slaveBranchSelected);
					}
				}
			}

			var menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(idString);
			var parentId = this.getParentLevelSubmenuId(menuSubmenuId);
			while ((parentId != menuSubmenuId) && (0 != ekFlexMenu.private_getSubmenuId(parentId))) {
				if (this.isTopLevelUI(parentId)) {
					btnContainer = document.getElementById(parentId);
					if (btnContainer) {
						if (!ekFlexMenu.hasClassName(btnContainer, ekFlexMenu_classNames.slaveBranchSelected)) {
							ekFlexMenu.addClassName(btnContainer, ekFlexMenu_classNames.slaveBranchSelected);
						}
					}
					break;
				}
				parentId = this.getParentLevelSubmenuId(parentId);
			}
		}
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
function __ekFlexMenu_initializeSlaveMenu() {
	var isVisible = false;
	var firstObj = null;
	var menuSubmenuId;
	var inAr = this.getEkFlexMenuElementsByTagName("INPUT");
	for (var idx=0; idx < inAr.length; idx++) {
		if (inAr[idx].value.indexOf(this.private_masterControlIdHash) == 0) {
			var localId = inAr[idx].id;
			var obj;
			if (localId.length >= ekFlexMenu.private_hashLength) {
				localId = this.buildMenuSubmenuId(ekFlexMenu.private_getSubmenuIdString(localId)) + ekFlexMenu.private_submenuItemsElementIdPostFix;
				obj = document.getElementById(localId);
				if (obj) {
					if (null == firstObj) {
						firstObj = obj;
					}

					if (ekFlexMenu.hasClassName(obj, ekFlexMenu_classNames.submenuItems)) {
						isVisible = true;
					}
					
					if (null == this.topLevelUI) {
						this.topLevelUI = new Array;
					}
					menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(localId);
					if (!this.topLevelUI[menuSubmenuId]) {
						this.topLevelUI[menuSubmenuId] = true;
					}
				}
			}
		}
	}

	if ((!isVisible) && firstObj) {
		ekFlexMenu.removeClassName(firstObj, ekFlexMenu_classNames.submenuItemsHidden);
		ekFlexMenu.addClassName(firstObj, ekFlexMenu_classNames.submenuItems);
		//this.selectSubmenu(firstSubmenu);
	}
	
	if (this.ekFlexMenu_defaultMenuIdString){
	    this.ekFlexMenu_slaveStartLevel = this.getMenuLevel(this.ekFlexMenu_defaultMenuIdString);
	}
	else if (this.ekFlexMenu_slaveStartLevelIds && this.ekFlexMenu_slaveStartLevelIds.length > 0){
	    this.ekFlexMenu_slaveStartLevel = this.getMenuLevel(this.ekFlexMenu_slaveStartLevelIds[0]);
	}
	else if (this.topLevelUI){
	    this.ekFlexMenu_slaveStartLevel = this.getMenuLevel(this.topLevelUI[0]);
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
function __ekFlexMenu_initializeMasterMenu() {
	var menuSubmenuId = this.buildMenuSubmenuId(0) + ekFlexMenu.private_submenuItemsElementIdPostFix;
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(menuSubmenuId)) {
		var node = document.getElementById(menuSubmenuId);
		if (node) {
			var nodes = node.childNodes;
			for (var idx = 0; idx < nodes.length; idx++) {
				if (null == this.topLevelUI) {
					this.topLevelUI = new Array;
				}
				menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(nodes[idx].id);
				if (!this.topLevelUI[menuSubmenuId]) {
					this.topLevelUI[menuSubmenuId] = true;
				}
			}
		}
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Called from master to select slave submenu.
function __ekFlexMenu_showSubmenuBranch(idString) {
	var result = false;
	var menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(idString);
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(menuSubmenuId)) {
		var id = menuSubmenuId;
		var obj = document.getElementById(id);
		if (obj) {
			//if (this.private_autoCollapseSubmenus) {
			//	this.collapseAllOpenSubmenus(false);
			//}

			for (var ui in this.topLevelUI) {
				this.unSelectSubmenu(ui, true);
			}
			
			var lastId = this.getLastSlaveStartLevelMenu();
			if (lastId && lastId.length > 0){
				this.unSelectSubmenu(lastId, true);
			}
			else if (this.private_isSlaveControl && this.ekFlexMenu_defaultMenuIdString) {
				this.unSelectSubmenu(this.ekFlexMenu_defaultMenuIdString);
			}
			else if (this.private_isSlaveControl) {
				// unknown current submenu; hide all at start level:
				this.collapseAllOpenSubmenus();
			}
			
			this.selectSubmenuHelper(menuSubmenuId);
			this.recordLastSlaveStartLevelMenu(menuSubmenuId);
			result = true;
		}
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
function __ekFlexMenu_unHideSlaveMenu() {
return; // DO NOT DO USE THIS METHOD!!!
	var targId = this.getLastSlaveStartLevelMenu();
	if (targId && (targId.length > 0)) {
		this.selectSubmenuHelper(targId);
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
function __ekFlexMenu_recordLastSlaveStartLevelMenu(id) {
	if (id && this.ekFlexMenu_slaveStartLevelIds[id]) {
		this.lastSelectedStartLevelSlaveMenuId = id;
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
function __ekFlexMenu_getLastSlaveStartLevelMenu() {
    if (this.lastSelectedStartLevelSlaveMenuId && (this.lastSelectedStartLevelSlaveMenuId.length > 0)){
        return (this.lastSelectedStartLevelSlaveMenuId);
    }
    else if (this.ekFlexMenu_defaultMenuIdString && this.ekFlexMenu_defaultMenuIdString.length > 0){
        return (this.ekFlexMenu_defaultMenuIdString);
    }
    else{
        return ("");
    }
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
function __ekFlexMenu_unSelectSubmenuList(menuList) {
	var listAr = menuList.split(",");
	var idx;
	for (idx=0; idx < listAr.length; idx++) {
		this.unSelectSubmenu(listAr[idx]);
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
function __ekFlexMenu_convertIdToSlaveControlId(slaveObj, idString) {
	var result = idString;
	if (slaveObj && idString && idString.length && (idString.length >= ekFlexMenu.private_hashLength)) {
		result = slaveObj.hashCode() + idString.substr(ekFlexMenu.private_hashLength);
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
function __ekFlexMenu_isTopLevelUI(idString) {
	return (this.topLevelUI && this.topLevelUI[ekFlexMenu.parseMenuSubmenuIdString(idString)]);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Helper funtion for __ekFlexMenu_selectSubmenu, uses 
// recursionSelects to ensure selected submenus are visible
// even if they are buried with muliple nesting levels:
function __ekFlexMenu_selectSubmenuHelper(idString) {
	var menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(idString);
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(menuSubmenuId)) {
		if (this.private_selectedMenuList.length) {
			this.private_selectedMenuList += "," + menuSubmenuId;
		}
		else {
			this.private_selectedMenuList = menuSubmenuId;
		}
		
		var btnObj = this.getFolderButtonObject(menuSubmenuId);
		if (ekFlexMenu.private_isValidSubmenuButton(btnObj)) {
			var wasHovering = (ekFlexMenu.hasClassName(btnObj, ekFlexMenu_classNames.buttonHover)
				|| ekFlexMenu.hasClassName(btnObj, ekFlexMenu_classNames.buttonSelectedHover));
			if (wasHovering) {
				ekFlexMenu.removeClassName(btnObj, ekFlexMenu_classNames.buttonHover);
				ekFlexMenu.addClassName(btnObj, ekFlexMenu_classNames.buttonSelectedHover);
			}
			else {
				ekFlexMenu.removeClassName(btnObj, ekFlexMenu_classNames.button);
				ekFlexMenu.addClassName(btnObj, ekFlexMenu_classNames.buttonSelected);
			}
		}
		
		var itmObj = this.getSubmenuItemsObject(menuSubmenuId);
		if (ekFlexMenu.private_isValidSubmenuItems(itmObj)) {
			ekFlexMenu.removeClassName(itmObj, ekFlexMenu_classNames.submenuItemsHidden);
			ekFlexMenu.addClassName(itmObj, ekFlexMenu_classNames.submenuItems);
		}

		// Ensure parent folders are visible as well, in case
		// we got here from something else than a user click:
		if (!(this.private_isSlaveControl && this.isTopLevelUI(menuSubmenuId))) {
			var parentId = this.getParentLevelSubmenuId(menuSubmenuId);
			if (parentId != menuSubmenuId) {
				this.selectSubmenuHelper(parentId); // recursively call this function until all parents are open.
			}
		
			this.markParentSubmenu(menuSubmenuId);
		}
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Unselects the identified menu; if there is a folder-button, 
// then the class is updated to an unselected state. Then 
// hides the associated submenu items:
function __ekFlexMenu_unSelectSubmenu(idString, topLevelUIOverride) {
	if (idString && idString.length) {
		var overrideTopLevelUI = false;
		if (ekFlexMenu.isDefinedNotNull(topLevelUIOverride)) {
			overrideTopLevelUI = topLevelUIOverride;
		}
	    var menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(idString);
	    if (ekFlexMenu.private_isValidMenuSubmenuIdString(menuSubmenuId)) {
			if ((ekFlexMenu.private_getSubmenuId(menuSubmenuId) == 0) 
				|| ((ekFlexMenu.private_getSubmenuId(menuSubmenuId) > 0) 
				&& (overrideTopLevelUI || !this.private_isSlaveControl || !this.isTopLevelUI(menuSubmenuId)))) {
				var btnObj = this.getFolderButtonObject(menuSubmenuId);
				if (ekFlexMenu.private_isValidSubmenuButton(btnObj)) {
					var wasHovering = (ekFlexMenu.hasClassName(btnObj, ekFlexMenu_classNames.buttonHover)
						|| ekFlexMenu.hasClassName(btnObj, ekFlexMenu_classNames.buttonSelectedHover));
					if (wasHovering) {
						ekFlexMenu.removeClassName(btnObj, ekFlexMenu_classNames.buttonSelectedHover);
						ekFlexMenu.addClassName(btnObj, ekFlexMenu_classNames.buttonHover);
					}
					else {
						ekFlexMenu.removeClassName(btnObj, ekFlexMenu_classNames.buttonSelected);
						ekFlexMenu.addClassName(btnObj, ekFlexMenu_classNames.button);
					}
				}
				
				var itmObj = this.getSubmenuItemsObject(menuSubmenuId);
				// Don't hide slave containers:
				if (!(this.private_isSlaveControl 
					&& (ekFlexMenu.submenuIsTopLevel(menuSubmenuId) 
						|| ekFlexMenu.hasClassName(itmObj, ekFlexMenu_classNames.slaveContainer)))) {
					if (ekFlexMenu.private_isValidSubmenuItems(itmObj)) {
						ekFlexMenu.removeClassName(itmObj, ekFlexMenu_classNames.submenuItems);
						ekFlexMenu.addClassName(itmObj, ekFlexMenu_classNames.submenuItemsHidden);
					}
				}

				this.unMarkParentSubmenu(menuSubmenuId);
			}
		}
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Closes all currently open submenus, to prevent overlap & visual clutter:
function __ekFlexMenu_collapseAllOpenSubmenus(showRootFlag) {
	if (this.private_selectionChanged) {
		this.unSelectSubmenuList(this.private_selectedMenuList);
		this.private_selectedMenuList = ""
	}
	else {
		var openMenusArray = this.getElementsByClassNameAndTagName(ekFlexMenu_classNames.submenuItems, "UL");

		// hide all visible submenus:
	for (var idx=0; idx < openMenusArray.length; idx++) {
		this.unSelectSubmenu(openMenusArray[idx].id);
	}
	
		// TODO: FIX: ensure all buttons are disabled (should be done 
		// by previous step, but this fails for master/slave menus):
		var activeButtons = this.getElementsByClassNameAndTagName(ekFlexMenu_classNames.buttonSelected, "SPAN");
		for (idx=0; idx < activeButtons.length; idx++) {
			this.unSelectSubmenu(activeButtons[idx].id);
		}
	}
	
	// Now that all menus have been hdden, determine 
	// if the the root-menu should be made visible:
	if ("undefined" != typeof showRootFlag) {
		// parameter was passed, use it to control/override defalt behaviour:
		if (showRootFlag)
			this.showRootMenu();
	} 
	else {
		// use default behaviour:
		if (!this.private_startWithRootFolderCollapsed)
			this.showRootMenu();
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Used for slave menu; Closes all unselected submenus:
function __ekFlexMenu_collapseUnselectedStartLevelSubmenus() {
    var lastMenuId = this.getLastSlaveStartLevelMenu();
	var openMenusArray = this.getElementsByClassNameAndTagName(ekFlexMenu_classNames.submenuItems, "UL");

	// hide all visible submenus:
    for (var idx=0; idx < openMenusArray.length; idx++) {
        if (lastMenuId != ekFlexMenu.parseMenuSubmenuIdString(openMenusArray[idx].id)){
	        this.unSelectSubmenu(openMenusArray[idx].id);
	    }
	}

	// TODO: FIX: ensure all buttons are disabled (should be done 
	// by previous step, but this fails for master/slave menus):
	var activeButtons = this.getElementsByClassNameAndTagName(ekFlexMenu_classNames.buttonSelected, "SPAN");
	for (idx=0; idx < activeButtons.length; idx++) {
		this.unSelectSubmenu(activeButtons[idx].id);
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Hide sibling submenus of the designated submenu:
function __ekFlexMenu_collapseSiblingSubmenus(idString) {
	var menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(idString);
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(menuSubmenuId)) {
		var parentLevelId = this.getParentLevelSubmenuId(menuSubmenuId);
		if (ekFlexMenu.private_isValidMenuSubmenuIdString(parentLevelId)
			&& (parentLevelId != menuSubmenuId)) {
			var idArray = this.getDirectChildIds(parentLevelId)
			for (var idx=0; idx < idArray.length; idx++) {
				if (idArray[idx] != menuSubmenuId) {
					this.unSelectSubmenu(idArray[idx]);
				}
			}
		}
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Sets the parent folders' style to be a parent (optionally 
// used in CSS to style parents differently):
function __ekFlexMenu_markParentSubmenu(idString) {
	var menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(idString);
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(menuSubmenuId)) {
		var parentLevelId = this.getParentLevelSubmenuId(menuSubmenuId);
		if (ekFlexMenu.private_isValidMenuSubmenuIdString(parentLevelId)
			&& (parentLevelId != menuSubmenuId)) 
		{
			var parentObj = this.getSubmenuObject(parentLevelId);
			if ((ekFlexMenu.isDefinedNotNull(parentObj)) 
				&& (ekFlexMenu.private_isDefined(parentObj.className)))
			{
				if (ekFlexMenu.hasClassName(parentObj, ekFlexMenu_classNames.submenu)) {
					ekFlexMenu.removeClassName(parentObj, ekFlexMenu_classNames.submenu);
					ekFlexMenu.addClassName(parentObj, ekFlexMenu_classNames.submenuParent);
				}
				else if (ekFlexMenu.hasClassName(parentObj, ekFlexMenu_classNames.submenuHover)) {
					ekFlexMenu.removeClassName(parentObj, ekFlexMenu_classNames.submenuHover);
					ekFlexMenu.addClassName(parentObj, ekFlexMenu_classNames.submenuParentHover);
				}
			}
		}
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Sets the parent folders' style to be a normal non-parent 
// (optionally used in CSS to style parents & children differently):
function __ekFlexMenu_unMarkParentSubmenu(idString) {
	var menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(idString);
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(menuSubmenuId)) {
		var parentLevelId = this.getParentLevelSubmenuId(menuSubmenuId);
		if (ekFlexMenu.private_isValidMenuSubmenuIdString(parentLevelId)
			&& (parentLevelId != menuSubmenuId)) 
		{
			var parentObj = this.getSubmenuObject(parentLevelId);
			if ((ekFlexMenu.isDefinedNotNull(parentObj)) 
				&& (ekFlexMenu.private_isDefined(parentObj.className))) 
			{
				if (ekFlexMenu.hasClassName(parentObj, ekFlexMenu_classNames.submenuParent)) {
					ekFlexMenu.removeClassName(parentObj, ekFlexMenu_classNames.submenuParent);
					ekFlexMenu.addClassName(parentObj, ekFlexMenu_classNames.submenu);
				}
				else if (ekFlexMenu.hasClassName(parentObj, ekFlexMenu_classNames.submenuParentHover)) {
					ekFlexMenu.removeClassName(parentObj, ekFlexMenu_classNames.submenuParentHover);
					ekFlexMenu.addClassName(parentObj, ekFlexMenu_classNames.submenuHover);
				}
			}
		}
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Sets the menus' container style to be hovered,
// (optionally used in CSS to style contents & children differently):
function __ekFlexMenu_hoverSubmenu(idString) {
	var menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(idString);
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(menuSubmenuId)) {
		var menuObj = this.getSubmenuObject(menuSubmenuId);
		if ((ekFlexMenu.isDefinedNotNull(menuObj)) 
			&& (ekFlexMenu.private_isDefined(menuObj.className)))
		{
			if (ekFlexMenu.hasClassName(menuObj, ekFlexMenu_classNames.submenu)) {
				ekFlexMenu.removeClassName(menuObj, ekFlexMenu_classNames.submenu);
				ekFlexMenu.addClassName(menuObj, ekFlexMenu_classNames.submenuHover);
			}
			else if (ekFlexMenu.hasClassName(menuObj, ekFlexMenu_classNames.submenuParent)) {
				ekFlexMenu.removeClassName(menuObj, ekFlexMenu_classNames.submenuParent);
				ekFlexMenu.addClassName(menuObj, ekFlexMenu_classNames.submenuParentHover);
			}
		}
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Sets the menus' container style to be hovered,
// (optionally used in CSS to style contents & children differently):
function __ekFlexMenu_unHoverSubmenu(idString) {
	var menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(idString);
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(menuSubmenuId)) {
		var menuObj = this.getSubmenuObject(menuSubmenuId);
		if ((ekFlexMenu.isDefinedNotNull(menuObj)) 
			&& (ekFlexMenu.private_isDefined(menuObj.className))) 
		{
			if (ekFlexMenu.hasClassName(menuObj, ekFlexMenu_classNames.submenuHover)) {
				ekFlexMenu.removeClassName(menuObj, ekFlexMenu_classNames.submenuHover);
				ekFlexMenu.addClassName(menuObj, ekFlexMenu_classNames.submenu);
			}
			else if (ekFlexMenu.hasClassName(menuObj, ekFlexMenu_classNames.submenuParentHover)) {
				ekFlexMenu.removeClassName(menuObj, ekFlexMenu_classNames.submenuParentHover);
				ekFlexMenu.addClassName(menuObj, ekFlexMenu_classNames.submenuParent);
			}
		}
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Returns an array of all direct child-submenu-ids (length = 0 if none):
function __ekFlexMenu_getDirectChildIds(idString) {
	var result = new Array;
	var elementName = ekFlexMenu.private_namePrefix + "submenu_items";
	var cmpId, elementArray;
	var parentMenuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(idString);
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(parentMenuSubmenuId)) {
		elementArray = this.getEkFlexMenuElementsByName(elementName);
		if (("undefined" != typeof elementArray)
			&& (null != elementArray)
			&& ("undefined" != typeof elementArray.length)
			&& (null != elementArray.length))
			{
				for (var idx=0; idx < elementArray.length; idx++) {
					cmpId = ekFlexMenu.parseMenuSubmenuIdString(elementArray[idx].id);
					if (ekFlexMenu.private_isValidMenuSubmenuIdString(cmpId)) {
						if ((parentMenuSubmenuId == this.getParentLevelSubmenuId(cmpId)
							&& (parentMenuSubmenuId != cmpId))) {  //ekFlexMenu.private_getSubmenuIdString
							result[result.length] = cmpId;
						}
					}
				}
			}
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// returns an array of the menu-elements whose name 
// attribute matches the supplied name:
function __ekFlexMenu_getEkFlexMenuElementsByName(elementName) {
	var result = new Array;
	var divArray = this.getEkFlexMenuElementsByTagName("div");
	for (var idx=0; idx < divArray.length; idx++) {
		if (elementName == divArray[idx].name) {
			result[result.length] = divArray[idx];
		}
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// returns an array of the ekflexmenu-elements with the 
// specified tag-name: 
function __ekFlexMenu_getEkFlexMenuElementsByTagName(tagName) {
	var result = new Array;
	var ekflexmenuContainer = this.getEkFlexMenuContainerElement();
	if (ekflexmenuContainer && ("undefined" != typeof ekflexmenuContainer.getElementsByTagName)) {
		var divArray = ekflexmenuContainer.getElementsByTagName(tagName);
		if (("undefined" != typeof divArray) && (null != divArray)) {
			result = divArray;
		}
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// returns an array of the menu-elements whose className 
// attribute matches the supplied name:
function __ekFlexMenu_getElementsByClassName(className) {
	var result = new Array;
	var divArray = this.getEkFlexMenuElementsByTagName("*");
	for (var idx=0; idx < divArray.length; idx++) {
		if (("undefined" != divArray[idx].className)
			&& (ekFlexMenu.hasClassName(divArray[idx], className))) {
			result[result.length] = divArray[idx];
		}
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// returns an array of the menu-elements whose className 
// attribute matches the supplied name:
function __ekFlexMenu_getElementsByClassNameAndTagName(className, tagName) {
	var result = new Array;
	var divArray = this.getEkFlexMenuElementsByTagName(tagName);
	for (var idx=0; idx < divArray.length; idx++) {
		if (("undefined" != divArray[idx].className)
			&& (ekFlexMenu.hasClassName(divArray[idx], className))) {
			result[result.length] = divArray[idx];
		}
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Unselects the identified menu; if there is a folder-button, 
// then the class is updated to an unselected state. Then 
// hides the associated submenu items:
function __ekFlexMenu_hoverButton(idString, hoverFlag) {
	var menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(idString);
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(menuSubmenuId)) {
		var btnObj = this.getFolderButtonObject(menuSubmenuId);
		if (ekFlexMenu.private_isValidSubmenuButton(btnObj)) {
			var wasHovering = (ekFlexMenu.hasClassName(btnObj, ekFlexMenu_classNames.buttonHover)
				|| ekFlexMenu.hasClassName(btnObj, ekFlexMenu_classNames.buttonSelectedHover));
			if (hoverFlag == wasHovering) {
				return;
			}
			var isSelected = (ekFlexMenu.hasClassName(btnObj, ekFlexMenu_classNames.buttonSelected) 
				|| ekFlexMenu.hasClassName(btnObj, ekFlexMenu_classNames.buttonSelectedHover));
			if (hoverFlag) {
				ekFlexMenu.removeClassName(btnObj, ((isSelected) ? ekFlexMenu_classNames.buttonSelected : ekFlexMenu_classNames.button));
				ekFlexMenu.addClassName(btnObj, ((isSelected) ? ekFlexMenu_classNames.buttonSelectedHover : ekFlexMenu_classNames.buttonHover));
			}
			else {
				ekFlexMenu.removeClassName(btnObj, ((isSelected) ? ekFlexMenu_classNames.buttonSelectedHover : ekFlexMenu_classNames.buttonHover));
				ekFlexMenu.addClassName(btnObj, ((isSelected) ? ekFlexMenu_classNames.buttonSelected : ekFlexMenu_classNames.button));
			}
		}
	}
}

///////////////////////////////////////////////////////////
// Annonymous Helper Function.
// Called by __ekFlexMenu_mouseIn to prepare for the
// delayed opening of identified submenu.
// Parameters: 
//	1 - the ID of the element that triggered the event.
function __ekFlexMenu_mouseInHelperCaller(id) {
	if (id) {
		var menuObj = ekFlexMenu.getMenuObj(id);
		if (menuObj) {
			menuObj.mouseInHelper();
		}
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Called by external (non-object-instance) code, to prepare for 
// delayed opening of identified submenu.
// Parameters: 
//	1 - the event object.
//	2 - the element-object that triggered the event.
function __ekFlexMenu_mouseIn(e, el) {
	if (this.private_mouseEventTimer) {
		window.clearTimeout(this.private_mouseEventTimer);
		this.private_mouseEventTimer = null;
	}
	this.private_mouseEventEnteringElementId = el.id;
	this.private_mouseEventTimer = window.setTimeout(function () {__ekFlexMenu_mouseInHelperCaller(el.id)}, 500);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Shows/selects the appropriate submenu.
function __ekFlexMenu_mouseInHelper() {
	if (this.private_mouseEventEnteringElementId) {
		var menuSubmenuId = ekFlexMenu.parseMenuSubmenuIdString(this.private_mouseEventEnteringElementId);
		if (ekFlexMenu.private_isValidMenuSubmenuIdString(menuSubmenuId)) {
			if (this.private_isMasterControl) {
				// Dont select bottom level menus for master-control 
				// via mouse-over; force user to click to select these:
				itemsObj = this.getSubmenuItemsObject(menuSubmenuId);
				if (!ekFlexMenu.isDefinedNotNull(itemsObj)) {
					return;
				}
			}
			this.selectSubmenu(menuSubmenuId, true);
		}
	}
}

///////////////////////////////////////////////////////////
// Annonymous Helper Function.
// Called by __ekFlexMenu_mouseOut to prepare for the
// delayed opening of identified submenu.
// Parameters: 
//	1 - the ID of the element that triggered the event.
function __ekFlexMenu_mouseOutHelperCaller(id) {
	if (id) {
		var menuObj = ekFlexMenu.getMenuObj(id);
		if (menuObj) {
			menuObj.mouseOutHelper();
		}
	}
}


///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Called by external (non-object-instance) code, to prepare for 
// delayed opening of identified submenu.
// Parameters: 
//	1 - the event object.
//	2 - the element-object that triggered the event.
function __ekFlexMenu_mouseOut(e, el) {
	if (this.private_mouseEventTimer) {
		window.clearTimeout(this.private_mouseEventTimer);
		this.private_mouseEventTimer = null;
	}
	var id = __ekFlexMenu_static_getValidParentId(el);
	this.private_mouseEventExitingElementId = id;
	this.private_mouseEventTimer = window.setTimeout(function () {__ekFlexMenu_mouseOutHelperCaller(id)}, 600);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Hides/unselects the appropriate submenu (possibly all but root).
// Parameters: 
//	None.
function __ekFlexMenu_mouseOutHelper() {
	//if (this.private_mouseEventEnteringElementId) {
	//	this.unSelectSubmenu(this.private_mouseEventEnteringElementId);
	//}
	if (this.private_autoCollapseSubmenus) {
		// don't leave all submenus hidden for slave-menus, otherwise nothing to click:
		if (this.private_isSlaveControl) {
			this.collapseUnselectedStartLevelSubmenus();
		}
		else{
		    this.collapseAllOpenSubmenus();
		}
	}
	else if (this.private_mouseEventEnteringElementId) {
		this.unSelectSubmenu(this.private_mouseEventEnteringElementId);
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Returns the Menu-Submenu-Id string, for a given Submenu-Id:
function __ekFlexMenu_buildMenuSubmenuId(submenuId) {
	return (this.hashCode() + "_" + this.menuId() + "_" + submenuId);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Returns the corresponding submenu-folder-button object, 
// for a given Submenu-Id (or Menu-Submenu-Id):
function __ekFlexMenu_getFolderButtonObject(submenuId) {
	var id = ekFlexMenu.parseMenuSubmenuIdString(submenuId);
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(id)) {
		id = id + ekFlexMenu.private_buttonElementIdPostFix;
	}
	else {
		id = this.buildMenuSubmenuId(submenuId) + ekFlexMenu.private_buttonElementIdPostFix;
	}
	return (document.getElementById(id));
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Returns the corresponding submenu-Items object, 
// for a given Submenu-Id (or Menu-Submenu-Id):
function __ekFlexMenu_getSubmenuItemsObject(submenuId) {
	var id = ekFlexMenu.parseMenuSubmenuIdString(submenuId);
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(id)) {
		id = id + ekFlexMenu.private_submenuItemsElementIdPostFix;
	}
	else {
		id = this.buildMenuSubmenuId(submenuId) + ekFlexMenu.private_submenuItemsElementIdPostFix;
	}
	return (document.getElementById(id));
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Returns the corresponding submenu object, 
// for a given Submenu-Id (or Menu-Submenu-Id):
function __ekFlexMenu_getSubmenuObject(submenuId) {
	var id = ekFlexMenu.parseMenuSubmenuIdString(submenuId);
	var result = null;
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(id)) {
		result = document.getElementById(id);
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Returns the parent-submenu-id for the given Submenu-Id 
// (or the given Menu-Submenu-Id), returns zero if top (root):
function __ekFlexMenu_getParentLevelSubmenuId(submenuId) {
	var result = this.buildMenuSubmenuId("0"); // default to root.
	var id = ekFlexMenu.parseMenuSubmenuIdString(submenuId);
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(id)) {
		id = id + ekFlexMenu.private_parentIdElementIdPostFix;
	}
	else {
		id = this.buildMenuSubmenuId(submenuId) + ekFlexMenu.private_parentIdElementIdPostFix;
	}
	var hiddenObj = document.getElementById(id);
	if (hiddenObj 
		&& ("undefined" != typeof hiddenObj.value)
		&& ("undefined" != typeof hiddenObj.value.length)
		&& (hiddenObj.value.length > 0)) {
		result = hiddenObj.value;
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Returns the integer value of the menu level for
// the menu identified by the given submenu-id string.
function __ekFlexMenu_getMenuLevel(submenuId) {
	var result = 0;
	if (ekFlexMenu.private_isValidMenuSubmenuIdString(submenuId)) {
		var obj = this.getSubmenuObject(submenuId);
		if (obj && obj.className && obj.className.length && (obj.className.length > 0)) {
			var levelPrefix = "ekflexmenu_menu_level_";
			var idx = obj.className.indexOf(levelPrefix);
			if (idx >= 0) {
				var val = obj.className.substr(idx + levelPrefix.length)
				if (val.length) {
					result = parseInt(val, 10);
				}
			}
		}
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Returns the outermost container element (DIV) that
// holds this entire ekFlexMenu object:
function __ekFlexMenu_getEkFlexMenuContainerElement() {
	var containerId = this.hashCode() + "_"
		+ this.menuId() 
		+ "_"
		+ "0" 
		+ ekFlexMenu.private_ekflexmenuContainerElementIdPostFix;
	var containerObj = document.getElementById(containerId);
	if (containerObj
		&& ekFlexMenu.private_isValidEKMenu(containerObj)) {
		return (containerObj);
	}
	else {
		return (null);
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Called when a menu-item (such as a link) is clicked, 
// modifies the items href parameter to pass the selected
// item info over the querystring:
function __ekFlexMenu_ekFlexMenu_selectMenuItem(el) {
	var elm = el;
	var isWrapper = false;
	
	if (ekFlexMenu.isDefinedNotNull(elm)
		&& ekFlexMenu.isDefinedNotNull(elm.parentNode)
		&& ekFlexMenu.isDefinedNotNull(elm.parentNode.tagName)
		&& ("A" == elm.parentNode.tagName)) 
	{
		// event is from a button, that's wrapped 
		// with an anchor. Use the anchor element:
		elm = elm.parentNode; 
		isWrapper = true;
	}
		
	if (elm && ("undefined" != typeof elm.id) && ("undefined" != typeof elm.href)) {
		//// Update: to correct a problem with FireFox (where events like mouse-out
		//// could call the handlers between the current page unloading and the next
		//// page loading) we must ensure that the event handlers are not called
		//// while we're navigating/submitting the page:
		//// TODO: Test for IE, skip if true (only needed for non-IE browsers, particuarly FireFox).
		// Further Update:
		//   Now testing validity of calling event handlers from menu HTML, so this 
		//   time consuming call to "disableAllEventHandlers" is not needed:
		//this.disableAllEventHandlers();
		
		if (elm.href.indexOf("?") < 0) {
			elm.href += "?";
		}
		else {
			elm.href += "&";
		}
	
		var modId = elm.id;
		var matchVal = "ekfxmensel_";
		if (modId.length > matchVal.length) {
			var idx = modId.indexOf(matchVal);
			if (idx >= 0) {
				modId = modId.substr(idx + matchVal.length);
			}
		}
		elm.href += matchVal.substr(0, matchVal.length - 1) + "=" + modId;

		if ((this.private_lastSelectedMenuItemObj != null) && (this.private_lastSelectedMenuItemObj != elm)) {
			ekFlexMenu.removeClassName(this.private_lastSelectedMenuItemObj, ekFlexMenu_classNames.linkSelected);
			ekFlexMenu.addClassName(this.private_lastSelectedMenuItemObj, ekFlexMenu_classNames.link);
		}
		this.private_lastSelectedMenuItemObj = elm;

		if (!isWrapper) {
			ekFlexMenu.removeClassName(elm.className, ekFlexMenu_classNames.link);
			ekFlexMenu.addClassName(elm.className, ekFlexMenu_classNames.linkSelected);
		}
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Disables all event handlers for elements of this menu object:
function __ekFlexMenu_disableAllEventHandlers() {
	var elArray = this.getEkFlexMenuElementsByTagName("*");
	for (var idx=0; idx < elArray.length; idx++) {
		this.disableElementEventHandlers(elArray[idx]);
	}
	var el = this.getEkFlexMenuContainerElement();
	if (el)
	{
		this.disableElementEventHandlers(el);
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Disables all event handlers for elements of this menu object:
function __ekFlexMenu_disableElementEventHandlers(el) {
	if (el) {
		if (ekFlexMenu.isDefinedNotNull(el.onmouseout))
			el.onmouseout = null;

		if (ekFlexMenu.isDefinedNotNull(el.onmouseover))
			el.onmouseover = null;

		if (ekFlexMenu.isDefinedNotNull(el.onfocus))
			el.onfocus = null;

		if (ekFlexMenu.isDefinedNotNull(el.onblur))
			el.onblur = null;

		if (ekFlexMenu.isDefinedNotNull(el.onclick))
			el.onclick = null;

		if (ekFlexMenu.isDefinedNotNull(el.ondblclick))
			el.ondblclick = null;

		if (ekFlexMenu.isDefinedNotNull(el.onkeydown))
			el.onkeydown = null;

		if (ekFlexMenu.isDefinedNotNull(el.onkeypress))
			el.onkeypress = null;

		if (ekFlexMenu.isDefinedNotNull(el.onkeyup))
			el.onkeyup = null;
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// This function modifies all these to eliminate page 
// refreshes (not needed if Javascript is enabled).
// Parameters: 
//	None.
function __ekFlexMenu_updateNoScriptLinks() {
return;
// UPDATE:
//	This function no longer runs, instead the "noscript" links 
//  are removed when the user clicks a menu button. This was
// done becuase IE had a problem with background image flicker
// whenever a page was loaded (images were refreshed after
// the page was rendered - causing a moment with the background
// being displayed on some elements...
//
//	var links = this.getEkFlexMenuElementsByTagName("A");
//	for (var idx=0; idx < links.length; idx++) {
//		if (("undefined" != typeof links[idx].href) && (0 <= links[idx].href.indexOf("ekfxmen_noscript=1"))) {
//			links[idx].href = "#NoScroll";
//		}
//	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Called by page-load initialization code, to determine if MouseOverPopUp 
// is enabled, and perform related initialization if it is:
function __ekFlexMenu_initializeMouseOverPopUp() {
    var containerId = "#" + this.buildMenuSubmenuId(0) + "_ekflexmenu";
    this.enableMouseOverPopUp = (null != $ektron(containerId).attr("onmouseover"));
    if (this.enableMouseOverPopUp) {
        $ektron(containerId + " a.ekflexmenu_link").mouseover(function () { if (ekFlexMenu_IsValid(ekFlexMenu) && ekFlexMenu_IsValid(ekFlexMenu.clearSiblingButtons)) { return (ekFlexMenu.clearSiblingButtons(this)); } return (true); });
        
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
// Called by page-load initialization code, to initialize this object
// with values passed from the server.
// Parameters: 
//	None.
function __ekFlexMenu_initializeWithServerVariables() {
	var baseId = this.hashCode();
	if (baseId && baseId.length) {
		// Obtain the server control property, autoCollapseBranches:
		if ((ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_autoCollapseBranches))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_autoCollapseBranches[baseId]))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_autoCollapseBranches[baseId].length))
			&& (0 < window.ekFlexMenu_autoCollapseBranches[baseId].length)) {
			
			this.private_autoCollapseSubmenus = ("true" == window.ekFlexMenu_autoCollapseBranches[baseId]);
		}

		// Obtain the server control property, swRev:
		if ((ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_swRev))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_swRev[baseId]))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_swRev[baseId].length))
			&& (0 < window.ekFlexMenu_swRev[baseId].length)) {
			
			this.private_swRevision = window.ekFlexMenu_swRev[baseId];
		}

		// Obtain the server control property, startCollapsed:
		if ((ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_startCollapsed))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_startCollapsed[baseId]))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_startCollapsed[baseId].length))
			&& (0 < window.ekFlexMenu_startCollapsed[baseId].length)) {
			
			this.private_startCollapsed = ("true" == window.ekFlexMenu_startCollapsed[baseId]);
		}

		// Obtain the server control property, startWithRootFolderCollapsed:
		if ((ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_startWithRootFolderCollapsed))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_startWithRootFolderCollapsed[baseId]))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_startWithRootFolderCollapsed[baseId].length))
			&& (0 < window.ekFlexMenu_startWithRootFolderCollapsed[baseId].length)) {
			
			this.private_startWithRootFolderCollapsed = ("true" == window.ekFlexMenu_startWithRootFolderCollapsed[baseId]);
		}

		// Obtain the hash-code of the server control property, MasterControlId:
		if ((ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_masterControlIdHash))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_masterControlIdHash[baseId]))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_masterControlIdHash[baseId].length))
			&& (0 < window.ekFlexMenu_masterControlIdHash[baseId].length)) {
			
			this.private_masterControlIdHash = window.ekFlexMenu_masterControlIdHash[baseId];
		}

		// Obtain the server control property, ajaxEnabled:
		if ((ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_ajaxEnabled))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_ajaxEnabled[baseId]))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_ajaxEnabled[baseId].length))
			&& (0 < window.ekFlexMenu_ajaxEnabled[baseId].length)) {
			
			this.private_ajaxEnabled = ("true" == window.ekFlexMenu_ajaxEnabled[baseId]);
		}
		
		// Obtain the Ajax-WebService base path:
		if ((ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_ajaxWSPath))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_ajaxWSPath[baseId]))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_ajaxWSPath[baseId].length))
			&& (0 < window.ekFlexMenu_ajaxWSPath[baseId].length)) {
			//			
			this.ekFlexMenu_ajaxWSPath = window.ekFlexMenu_ajaxWSPath[baseId];
			if (this.ekFlexMenu_ajaxWSPath.length && this.ekFlexMenu_ajaxWSPath.lastIndexOf("/") != (this.ekFlexMenu_ajaxWSPath.length - 1)) {
				this.ekFlexMenu_ajaxWSPath += "/";
			}
		}
		
		// Set displayXslt:
		if ((ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_displayXslt))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_displayXslt[baseId]))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_displayXslt[baseId].length))
			&& (0 < window.ekFlexMenu_displayXslt[baseId].length)) {
			//			
			this.ekFlexMenu_displayXslt = window.ekFlexMenu_displayXslt[baseId];
		}
		
		// Set cacheInterval:
		if ((ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_cacheInterval))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_cacheInterval[baseId]))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_cacheInterval[baseId].length))
			&& (0 < window.ekFlexMenu_cacheInterval[baseId].length)) {
			//			
			this.ekFlexMenu_cacheInterval = window.ekFlexMenu_cacheInterval[baseId];
		}

		// Obtain the slave/subscriber list:
		if ((ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_subscriberList))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_subscriberList[baseId]))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_subscriberList[baseId].length))
			&& (0 < window.ekFlexMenu_subscriberList[baseId].length)) {
			
			this.private_subscriberList = window.ekFlexMenu_subscriberList[baseId];
			
			if (this.private_subscriberList.length > 0) {
				var subList = this.private_subscriberList.split(",");
				if (subList && subList[0]) {
					this.private_slaveControl = subList[0];
					this.private_isMasterControl = true;
				}
			}
		}
		
		// Default slave-menu:
		if ((ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_defaultMenuIdString))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_defaultMenuIdString[baseId]))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_defaultMenuIdString[baseId].length))
			&& (0 < window.ekFlexMenu_defaultMenuIdString[baseId].length)) {
			//			
			this.ekFlexMenu_defaultMenuIdString = window.ekFlexMenu_defaultMenuIdString[baseId];
		}
		
		// Slave menu start-level ids:
		if ((ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_slaveStartLevelIds))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_slaveStartLevelIds[baseId]))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_slaveStartLevelIds[baseId].length))
			&& (0 < window.ekFlexMenu_slaveStartLevelIds[baseId].length)) {
			//			
			var startLevelIds = window.ekFlexMenu_slaveStartLevelIds[baseId].split(",");
			if (null == this.ekFlexMenu_slaveStartLevelIds) {
				this.ekFlexMenu_slaveStartLevelIds = new Array;
			}
			for (var idx = 0; idx < startLevelIds.length; idx++) {
				if (!this.ekFlexMenu_slaveStartLevelIds[startLevelIds[idx]]) {
					this.ekFlexMenu_slaveStartLevelIds[startLevelIds[idx]] = true;
				}
			}
		}

		// The server may have passed a submenu id, indicating which one to open initially:
		if ((ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_startupSubmenuBranchId))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_startupSubmenuBranchId[baseId]))
			&& (ekFlexMenu.isDefinedNotNull(window.ekFlexMenu_startupSubmenuBranchId[baseId].length))
			&& (0 < window.ekFlexMenu_startupSubmenuBranchId[baseId].length)) {
			
			var id = ekFlexMenu.parseMenuSubmenuIdString(window.ekFlexMenu_startupSubmenuBranchId[baseId]);
			if (ekFlexMenu.private_isValidMenuSubmenuIdString(id)) {
				this.selectSubmenu(id);
			}
		}
	
		if (this.private_masterControlIdHash.length) {
			this.private_isSlaveControl = true;
			this.initializeSlaveMenu();
		}
		
		if (this.private_isMasterControl) {
			this.initializeMasterMenu();
		}
		
		this.updateNoScriptLinks();
		this.initializeMouseOverPopUp();
	}
}

///////////////////////////////////////////////////////////
// Makes the contents of the root-menu visible, selects it's button if it exists.
// Parameters: 
//	None.
function __ekFlexMenu_showRootMenu() {
	var rootMenuId = this.buildMenuSubmenuId(0);
	this.selectSubmenu(rootMenuId);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
function __ekFlexMenu_ajax_loadXMLDoc(url)
{
	var result = false;

	ekFlexMenu.ajaxCancelServerCall();
	if (window.XMLHttpRequest) {
		ekFlexMenu.static_userAjaxXmlHttp1 = new XMLHttpRequest()
	}
	else if (window.ActiveXObject) {
		ekFlexMenu.static_userAjaxXmlHttp1 = new ActiveXObject("Msxml2.XMLHTTP");
		if (null == ekFlexMenu.static_userAjaxXmlHttp1) {
			ekFlexMenu.static_userAjaxXmlHttp1 = new ActiveXObject("Microsoft.XMLHTTP");
		}
	}

	if (ekFlexMenu.static_userAjaxXmlHttp1 != null) {
		ekFlexMenu.static_userAjaxXmlHttp1.onreadystatechange = ekFlexMenu.ajaxCallBack_stateChange;
		ekFlexMenu.static_userAjaxXmlHttp1.open("POST", url, true);
		ekFlexMenu.static_userAjaxXmlHttp1.send('');
		result = true;
	}

	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
function __ekFlexMenu_ajax_DecodeHTML(str)
{
	var result = "";
	if (str){
		result = new String(str);
		result = result.replace(/\&amp;/gi, "&");
		result = result.replace(/\&lt;/gi, "<");
		result = result.replace(/\&gt;/gi, ">");
		result = result.replace(/\&quot;/gi, "\"");
		result = result.replace(/\&#39;/gi, "'");
	}
    return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
function __ekFlexMenu_ajax_getPayload(response)
{
	var result = null;
	if (response)
	{
		if (response.xml) {
			result = response.xml;
		}
		else if (response.childNodes && ("undefined" != typeof XMLSerializer)) {
			if (XMLSerializer) {
				result = new XMLSerializer().serializeToString(response);
			}
		}
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
function __ekFlexMenu_ajax_appendText(targId)
{
	var targ = document.getElementById(targId);
	if (targ && ("undefined" != typeof targ.innerHTML)) {
		targ.innerHTML = this.DecodeHTML(this.getPayload(ekFlexMenu.static_userAjaxXmlHttp1.responseXML));
	}
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
function __ekFlexMenu_ajax_appendXml(targId)
{
	if (!ekFlexMenu.isDefinedNotNull(ekFlexMenu.static_userAjaxXmlHttp1)
		|| !ekFlexMenu.isDefinedNotNull(ekFlexMenu.static_userAjaxXmlHttp1.responseXML)){
		return;
	}

	var targ = document.getElementById(targId);
	if (targ && ("undefined" != typeof targ.innerHTML)) {
		if (ekFlexMenu.isDefinedNotNull(ekFlexMenu.static_userAjaxXmlHttp1.responseXML.text)) {
			//targ.innerHTML = ekFlexMenu.static_userAjaxXmlHttp1.responseXML.text;
			var menuFrag = this.removeMenuFragmentContainer(ekFlexMenu.static_userAjaxXmlHttp1.responseXML.text);
			if (menuFrag.length > 0) {
				targ.innerHTML = targ.innerHTML + menuFrag;
			}
		}
		else {
			// (FireFox, etc.)
			targ.innerHTML = "";
			if (ekFlexMenu.isDefinedNotNull(ekFlexMenu.static_userAjaxXmlHttp1.responseXML.firstChild)
				&& ekFlexMenu.isDefinedNotNull(ekFlexMenu.static_userAjaxXmlHttp1.responseXML.firstChild.textContent)) {
				targ.innerHTML = ekFlexMenu.static_userAjaxXmlHttp1.responseXML.firstChild.textContent;
			} else if ("undefined" != typeof XMLSerializer) {
				result = new XMLSerializer().serializeToString(ekFlexMenu.static_userAjaxXmlHttp1.responseXML);
				targ.innerHTML = this.DecodeHTML(result);
			}
			else if ("undefined" != typeof document.importNode) {
				var src = document.importNode(ekFlexMenu.static_userAjaxXmlHttp1.responseXML.documentElement, true);
				var tempEl = document.createElement("span");
				tempEl.appendChild(src);
				targ.innerHTML = this.DecodeHTML(tempEl.innerHTML);
				tempEl = null;
			}
		}
	}
	this.userAjaxParentId1 = "";
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
function __ekFlexMenu_ajax_removeMenuFragmentContainer(menuStr)
{
	var result = "";
	var idx = menuStr.indexOf("<ul");
	if (idx >= 0) {
		result = menuStr.substr(idx);
		idx = result.lastIndexOf("</li>");
		if (idx > 0) {
			result = result.substr(0, idx-1);
		}
	}
	return (result);
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
function __ekFlexMenu_ajax_callService(ctrlHash, menuId, submenuId, parentId, menuDepth)
{
	this.userAjaxParentId1 = "";
	if (parentId.length > 0) {
		this.userAjaxParentId1 = parentId;
		return (this.loadXMLDoc(this.ekFlexMenu_ajaxWSPath + "WebServiceAPI/Navigation/FlexMenu.asmx/GetMenuFragment?ctrl_hash=" + ctrlHash + "&menu_depth=" + menuDepth + "&menu_id=" + menuId + "&submenu_id=" + submenuId + "&menu_xslt=" + this.ekFlexMenu_displayXslt + "&cache_interval=" + this.ekFlexMenu_cacheInterval));
	}
	return false
}

///////////////////////////////////////////////////////////
// ekFlexMenu Instance Member Helper Function.
function __ekFlexMenu_ajax_callAjaxForUserClick(btnId)
{
	var result = false;
	
	// check if container's children already loaded:
	var containerId = ekFlexMenu.parseMenuSubmenuIdString(btnId);
	var si = this.getSubmenuItemsObject(containerId);
	if (si){
		result = true;
	}
	else {
		// false, initiate ajax-call:
		var ctrlHash = this.hashCode();
		var menuId = ekFlexMenu.private_getMenuIdString(btnId);
		var submenuId = ekFlexMenu.private_getSubmenuIdString(btnId);
		var parentId = this.getFolderButtonObject(btnId).parentNode.id;
		//var menuDepth = 1 + this.getMenuLevel(btnId);
		result = this.callService(ctrlHash, menuId, submenuId, parentId, 1);
	}
	
	return (result);
}

///////////////////////////////////////////////////////////
ekFlexMenu_loadEventConfigured = false; // global variable for ekFlexMenu_addLoadEvent(), to indicate if code has initialized.
///////////////////////////////////////////////////////////
// This funtion is caled by the in-line-code following
// this functions' definition, to ensure that the 
// windows' on-load event is hooked with the ekFlexMenu
// initialization code. 
function ekFlexMenu_addLoadEvent() 
{
	if (ekFlexMenu_loadEventConfigured)
		return;
		
	ekFlexMenu_loadEventConfigured = true;
    var oldOnload = window.onload;
    window.onload = function() {
        if ("function" == typeof oldOnload) 
            oldOnload();

        //setTimeout(ekFlexMenu.private_startupAllSmartMenus, 100);
        ekFlexMenu.private_startupAllSmartMenus();
	}
}
ekFlexMenu_addLoadEvent(); // Call the preceeding function to hook the ekFlexMenu initialization code.
///////////////////////////////////////////////////////////

///////////////////////////////////////////////////////////
ekFlexMenu_unloadEventConfigured = false; // global variable for ekFlexMenu_addUnLoadEvent(), to indicate if code has initialized.
///////////////////////////////////////////////////////////
// This funtion is caled by the in-line-code following
// this functions' definition, to ensure that the 
// windows' on-unload event is hooked with the ekFlexMenu
// cleanup code. 
function ekFlexMenu_addUnLoadEvent() 
{
	if (ekFlexMenu_unloadEventConfigured)
		return;
		
	ekFlexMenu_unloadEventConfigured = true;
    var oldOnunload = window.onunload;
    window.onunload = function() {
        if ("function" == typeof oldOnunload) 
            oldOnunload();

        //setTimeout(ekFlexMenu.private_startupAllSmartMenus, 100);
        ekFlexMenu.private_shutdownAllSmartMenus();
	}
}
ekFlexMenu_addUnLoadEvent(); // Call the preceeding function to hook the ekFlexMenu initialization code.
///////////////////////////////////////////////////////////

///////////////////////////////////////////////////////////////////////////////
//	Menu element names (prefixed by "ekmengrp_"):
//  Note: these are only rendered if the SmartMenu server controls' renderElementNames  is true (default=false, see Navigation.vb).
//
//		accessible_menu_startheading - H2: Wraps the skip-menu with a navigation-heading (only rendered when 508-Compliance is enabled).
//		accessible_menu_startlink - A: Wraps the skip-menu text with a navigation-link (only rendered when 508-Compliance is enabled).
//		btnlink - A: Wraps each menu button title with a navigation-anchor (only rendered when 508-Compliance is enabled).
//		button - SPAN: Holds the title, and acts as a button (or folder) for the associated submenu.
//		ekflexmenu - DIV: Wraps the entire menu (the outer-most non-user container element).
//		link - A: A Link for individual menu items (quicklinks, external links, etc.).
//		menu_end - DIV: Wraps the menu-end page-anchor (only rendered when 508-Compliance is enabled).
//		menu_start - DIV: Wraps the menu-start link (only rendered when 508-Compliance is enabled).
//		submenu - DIV: Holds submenu items, such as a submenu title and links.
//		submenu_items - DIV: Container for menu lists.
//		submenu_navheading - H3: Wraps each menu button title with a navigation-heading (only rendered when 508-Compliance is enabled).
//		unorderedlist - UL: A container for menu list items (useful for non-graphical browsers).
//		unorderedlist_item - LI: Container for menu items (typically either links or sub-menus).

///////////////////////////////////////////////////////////////////////////////

function EkTbWebMenuPopUpWindow (url, hWind, nWidth, nHeight, nScroll, nResize) {
    url = url.replace(/&amp;amp;/g,"&").replace(/&amp;/g,"&");
	if (nWidth > screen.width) {
		nWidth = screen.width;
	}
	if (nHeight > screen.height) {
		nHeight = screen.height;
	}
	var cToolBar = 'toolbar=0,location=0,directories=0,status=' + nResize + ',menubar=0,scrollbars=' + nScroll + ',resizable=' + nResize + ',width=' + nWidth + ',height=' + nHeight;
	var popupwin = window.open(url, hWind, cToolBar);
	return popupwin;
}

///////////////////////////////////
// 
function ekFlexMenu_LogMsg(msg){
    var dt = new Date();
    msg = Date() + " - "+ msg;
    if (window.console && window.console.log){
        window.console.log(msg);
    }
    else if (window.Debug && window.Debug.writeln){
        window.Debug.writeln(msg);
    }
    else{
        ekFlexMenu_DebugMsg(msg);
    }
}

var g_ekFlexMenu_DebugWindow=null;
function ekFlexMenu_DebugMsg(Msg) {
    Msg = '>>>' + Msg + ' <br> ';
    if ((g_ekFlexMenu_DebugWindow == null) || (g_ekFlexMenu_DebugWindow.closed)) {
        g_ekFlexMenu_DebugWindow = window.open('Debug Notes', 'myWin', 'toolbar=no, directories=no, location=no, status=yes, menubar=no, resizable=yes, scrollbars=yes, width=500, height=300');
    }
    g_ekFlexMenu_DebugWindow.document.writeln(Msg);
    g_ekFlexMenu_DebugWindow.scrollTo(0,10000000);
}