home / documentation / reference / childkeepinwindowx

ChildKeepInWindowX

Description:

Boolean value indicating whether or not the menu should be automatically repositioned from its default location horizontally so that the entire menu appears within the user's browser window. ChildKeepInWindowX applies only to menus that are displayed as child menus.

Value:

Boolean (true or false), Integer (1=true, 0=false), or JavaScript expression that returns a boolean value.

Applies To:

Menus.

Browser Compatibility:

ChildKeepInWindowX is supported in all browsers.

Comments:

Note that this parameter defines the menu's horizontal KeepInWindow behavior when the menu is being displayed as a child menu. Compare this parameter to TopKeepInWindowX, which defines the menu's horizontal KeepInWindow behavior when the menu is used as a top level menu. A single menu can be used as both a top level menu and a child menu on the same page. This Child vs. Top distinction allows you to define different settings depending on how the menu is currently being utilized.

All of the KeepInWindow behaviors are true by default; meaning that HierMenus will always attempt to reposition the menu both horizontally and vertically so that it appears within the user's browser window. In versions of HierMenus prior to version 6, permanently displayed menus and PositionChild child menus were not repositioned via the KeepInWindow behavior. If you wish to emulate the pre-version 6 behavior, you will need to set the appropriate KeepInWindow behaviors to false on those types of menus.

Examples:

// Ok:
ChildKeepInWindowX:true,
ChildKeepInWindowX:0,
ChildKeepInWindowX:(window.thisPage=="cf")?1:0, 
    // if the user defined variable "thisPage" is "cf", 
    // ChildKeepInWindowX is true

// Incorrect:
ChildKeepInWindowX:"false",  // quotes not allowed around booleans
ChildKeepInWindowX:"0",
ChildKeepInWindowX:'(window.thisPage=="cf")?1:0', 
    // no quoted expressions

Default:

true

See Also:

RepositionOnScroll, IsPermanent, PositionChild, TopKeepInWindowX, TopKeepInWindowY ChildKeepInWindowY