'Declaration Public Property ActiveLocation As UltraNavigationBarLocation
public UltraNavigationBarLocation ActiveLocation {get; set;}
| Exception | Description |
|---|---|
| System.Exception | Thrown when the specified UltraNavigationBarLocation instance is associated with a different UltraNavigationBar, or not associated with any UltraNavigationBar. |
The ActiveLocation is the location on which most navigational key actions are based. For example, the 'ActivateNextLocation' keyboard action navigates to the next location as relative to the currently active one.
Note: Unlike most Infragistics controls, the UltraNavigationBar's ActiveLocation property changes when the cursor enters and exits the user interface elements associated with an UltraNavigationBarLocation. For this reason, the ActiveLocationChanging and ActiveLocationChanged events can fire with a null Infragistics.Win.Misc.UltraWinNavigationBar.LocationEventArgs.Location under normal operation. Listeners of these events must check the value of the Location property of the event arguments for null before accessing it.
The UltraNavigationBarLocation object manifests itself in two different ways in the user interface; when a location is present in the navigation path and is visible therein, it is presented in the form of a LocationUIElement. When its UltraNavigationBarLocation.Parent location is expanded, and it appears in the child locations dropdown list, it is presented as a LocationListItemUIElement. Both of these elements can receive the keyboard focus; if either one is active their associated UltraNavigationBarLocation instance will be referenced by the ActiveLocation property. To provide a way to differentiate between the two representations of a location, the UltraNavigationBarLocation class exposes properties, UltraNavigationBarLocation.IsButtonActive and UltraNavigationBarLocation.IsListItemActive.
By default, no focus rectangle is drawn for the user interface elements which depict the active state. This is primarily because the Windows Vista Address Bar, after which the control is patterned, also does not display a focus rectangle. This behavior can be changed by setting the DrawsFocusRect property to true. Note that regardless of this setting, the focus rectangle is only displayed when the control actually has the input focus.
Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2