Intersoft ClientUI Documentation
UXNavigationButton Class
Members  See Also  Send Feedback
Intersoft.Client.UI.Aqua Namespace : UXNavigationButton Class






Represents a navigation button for page navigation.

Object Model

UXNavigationButton Class

Syntax

Visual Basic (Declaration) 
<DescriptionAttribute("Represents a navigation button for page navigation.")>
Public Class UXNavigationButton 
   Inherits UXButton
   Implements IControlIFramework, ILicensing, INavigationSourceINavigationSupportICommandSourceIKeyboardFocus 
Visual Basic (Usage)Copy Code
Dim instance As UXNavigationButton
C# 
[DescriptionAttribute("Represents a navigation button for page navigation.")]
public class UXNavigationButton : UXButton, IControlIFramework, ILicensing, INavigationSourceINavigationSupportICommandSourceIKeyboardFocus  
Delphi 
public class UXNavigationButton = class(UXButton, IControl, IFramework, ILicensing, INavigationSource, INavigationSupport, ICommandSource, IKeyboardFocus)
JScript 
DescriptionAttribute("Represents a navigation button for page navigation.")
public class UXNavigationButton extends UXButton implements IControlIFramework, ILicensing, INavigationSourceINavigationSupportICommandSourceIKeyboardFocus 
Managed Extensions for C++ 
[DescriptionAttribute("Represents a navigation button for page navigation.")]
public __gc class UXNavigationButton : public UXButton, IControlIFramework, ILicensing, INavigationSourceINavigationSupportICommandSourceIKeyboardFocus  
C++/CLI 
[DescriptionAttribute("Represents a navigation button for page navigation.")]
public ref class UXNavigationButton : public UXButton, IControlIFramework, ILicensing, INavigationSourceINavigationSupportICommandSourceIKeyboardFocus  

Remarks

You use UXNavigationButton to facilitate navigation across the pages in your application. When a UXNavigationButton is selected, it will become the active selection in the page and automatically deactivate the other navigation buttons in the page. At a glance, the UXNavigationButton works similar to the UXToggleButton, except the navigation button automates certain processes during the navigation and thus more suitable to be used as navigation source.

UXNavigationButton implements INavigationSource interface, which exposes NavigationUri and TargetName property. Therefore, UXNavigationButton can be used to facilitate navigation between pages in a valid navigation host such as UXFrame. To learn more about the navigation host and related features, see Navigation Overview.

The following example shows how to navigate to the pages in the project using UXNavigationButton.

XAML Copy Code
<StackPanel Orientation="Horizontal" Intersoft:DockPanel.Dock="Top">
    <Intersoft:UXNavigationButton Content="Home" NavigateUri="/Home"/>
    <Intersoft:UXNavigationButton Content="Products" NavigateUri="/Products"/>
    <Intersoft:UXNavigationButton Content="Services" NavigateUri="/Services"/>
    <Intersoft:UXNavigationButton Content="About" NavigateUri="/About"/>
</StackPanel>

The result looks like the following figure.

For a more complete walkthrough that shows how to define the UXFrame and use UXNavigationButton to navigate to the pages in the frame, see Walkthrough: Create Simple Website Navigation Using Frame, Navigation Button and Hyperlink.

If your page contains multiple UXFrame instances, you can set the UXNavigationButton to navigate the page on a particular frame by setting the TargetName property of the button to the name of the target frame.

Inheritance Hierarchy

System.Object
   System.Windows.DependencyObject
      System.Windows.UIElement
         System.Windows.FrameworkElement
            System.Windows.Controls.Control
               System.Windows.Controls.ContentControl
                  System.Windows.Controls.Primitives.ButtonBase
                     System.Windows.Controls.Button
                        Intersoft.Client.Framework.ISButton
                           Intersoft.Client.UI.Aqua.UXButton
                              Intersoft.Client.UI.Aqua.UXNavigationButton
                                 Intersoft.Client.UI.Aqua.UXHyperlinkButton

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2012 All Rights Reserved.