|Visual Basic (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.
|(Inherited from )||Gets or sets a value indicating whether the event should be canceled.|
|ChangeKind||Returns a constant which defines the action that caused the change.|
|NewSelectedLocation||Returns a reference to the 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 Infragistics.Win.Misc.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.