'Declaration Public Event SelectedLocationChanging As SelectedLocationChangingHandler
public event SelectedLocationChangingHandler SelectedLocationChanging
The event handler receives an argument of type SelectedLocationChangingEventArgs containing data related to this event. The following SelectedLocationChangingEventArgs properties provide information specific to this event.
| Property | Description |
|---|---|
| Cancel (Inherited from System.ComponentModel.CancelEventArgs) | |
| ChangeKind | Returns a constant which defines the action that caused the change. |
| NewSelectedLocation | Returns a reference to the Infragistics.Win.Misc.UltraNavigationBarLocation instance that will become the SelectedLocation. |
The UltraNavigationBar's SelectedLocation property returns the terminal location in the navigation path. This is always the "rightmost" location displayed by the control. The UltraNavigationBar's SelectedLocation property always returns a non-null value; in the case where no locations are specifically selected, the RootLocation is returned, i.e., the root location is always selected. The UltraNavigationBarLocation's UltraNavigationBarLocation.SelectedLocation property return the one member of its UltraNavigationBarLocation.Locations collection which is also present on the navigation path; this location appears to the immediate right of its parent. Setting the UltraNavigationBarLocation's SelectedLocation property to null causes all members of the navigation path which follow that location to be removed from the navigation path; the location whose SelectedLocation property was set to null then becomes the control's SelectedLocation.
Setting the SelectedLocation property to null is logically equivalent to setting it to reference the RootLocation.
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