Intersoft ClientUI Documentation
UXFrame Class
Members  Example  See Also  Send Feedback
Intersoft.Client.UI.Navigation Namespace : UXFrame Class






UXFrame is a content control that supports navigation. Represents a navigation control that supports local Silverlight pages and contents from external XAP package.

Object Model

UXFrame Class

Syntax

Visual Basic (Declaration) 
<TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Border)>
<StyleTypedPropertyAttribute(Property="ErrorStyle", StyleTargetType=Intersoft.Client.UI.Navigation.UXFrameErrorPage)>
<TemplatePartAttribute(Name="PresenterElement", Type=Intersoft.Client.UI.Controls.ContentTransition)>
<StyleTypedPropertyAttribute(Property="LoaderStyle", StyleTargetType=Intersoft.Client.UI.Navigation.UXFrameLoader)>
<StyleTypedPropertyAttribute(Property="PresenterStyle", StyleTargetType=Intersoft.Client.UI.Controls.ContentTransition)>
<TemplatePartAttribute(Name="BusyElement", Type=System.Windows.Controls.Border)>
Public NotInheritable Class UXFrame 
   Inherits Intersoft.Client.Framework.ISFrame
   Implements IApplicationHost, IAuthenticationHost, IControl, IFramework, ILicensing, INavigationHost 
Visual Basic (Usage)Copy Code
Dim instance As UXFrame
C# 
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Border)]
[StyleTypedPropertyAttribute(Property="ErrorStyle", StyleTargetType=Intersoft.Client.UI.Navigation.UXFrameErrorPage)]
[TemplatePartAttribute(Name="PresenterElement", Type=Intersoft.Client.UI.Controls.ContentTransition)]
[StyleTypedPropertyAttribute(Property="LoaderStyle", StyleTargetType=Intersoft.Client.UI.Navigation.UXFrameLoader)]
[StyleTypedPropertyAttribute(Property="PresenterStyle", StyleTargetType=Intersoft.Client.UI.Controls.ContentTransition)]
[TemplatePartAttribute(Name="BusyElement", Type=System.Windows.Controls.Border)]
public sealed class UXFrame : Intersoft.Client.Framework.ISFrame, IApplicationHost, IAuthenticationHost, IControl, IFramework, ILicensing, INavigationHost 
Delphi 
public class UXFrame = class(Intersoft.Client.Framework.ISFrame, IApplicationHost, IAuthenticationHost, IControl, IFramework, ILicensing, INavigationHost)sealed;
JScript 
TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Border)
StyleTypedPropertyAttribute(Property="ErrorStyle", StyleTargetType=Intersoft.Client.UI.Navigation.UXFrameErrorPage)
TemplatePartAttribute(Name="PresenterElement", Type=Intersoft.Client.UI.Controls.ContentTransition)
StyleTypedPropertyAttribute(Property="LoaderStyle", StyleTargetType=Intersoft.Client.UI.Navigation.UXFrameLoader)
StyleTypedPropertyAttribute(Property="PresenterStyle", StyleTargetType=Intersoft.Client.UI.Controls.ContentTransition)
TemplatePartAttribute(Name="BusyElement", Type=System.Windows.Controls.Border)
public sealed class UXFrame extends Intersoft.Client.Framework.ISFrame implements IApplicationHost, IAuthenticationHost, IControl, IFramework, ILicensing, INavigationHost 
Managed Extensions for C++ 
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Border)]
[StyleTypedPropertyAttribute(Property="ErrorStyle", StyleTargetType=Intersoft.Client.UI.Navigation.UXFrameErrorPage)]
[TemplatePartAttribute(Name="PresenterElement", Type=Intersoft.Client.UI.Controls.ContentTransition)]
[StyleTypedPropertyAttribute(Property="LoaderStyle", StyleTargetType=Intersoft.Client.UI.Navigation.UXFrameLoader)]
[StyleTypedPropertyAttribute(Property="PresenterStyle", StyleTargetType=Intersoft.Client.UI.Controls.ContentTransition)]
[TemplatePartAttribute(Name="BusyElement", Type=System.Windows.Controls.Border)]
public __gc __sealed class UXFrame : public Intersoft.Client.Framework.ISFrame, IApplicationHost, IAuthenticationHost, IControl, IFramework, ILicensing, INavigationHost 
C++/CLI 
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Border)]
[StyleTypedPropertyAttribute(Property="ErrorStyle", StyleTargetType=Intersoft.Client.UI.Navigation.UXFrameErrorPage)]
[TemplatePartAttribute(Name="PresenterElement", Type=Intersoft.Client.UI.Controls.ContentTransition)]
[StyleTypedPropertyAttribute(Property="LoaderStyle", StyleTargetType=Intersoft.Client.UI.Navigation.UXFrameLoader)]
[StyleTypedPropertyAttribute(Property="PresenterStyle", StyleTargetType=Intersoft.Client.UI.Controls.ContentTransition)]
[TemplatePartAttribute(Name="BusyElement", Type=System.Windows.Controls.Border)]
public ref class UXFrame sealed : public Intersoft.Client.Framework.ISFrame, IApplicationHost, IAuthenticationHost, IControl, IFramework, ILicensing, INavigationHost 

Example

The following example shows a XAML page with a static header area for branding, and a dynamic content area to display navigable pages.
XAMLCopy Code
<Intersoft:UXPage 
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:Intersoft="http://intersoft.clientui.com/schemas"
        mc:Ignorable="d"
        x:Class="Intersoft.ClientUI.WebSiteNavigation.Samples.MainPage" 
        Title="MainPage Page"
        d:DesignWidth="1024" d:DesignHeight="768">
        
        <Grid x:Name="LayoutRoot">
                <Border>
                        <Grid Margin="10">
                                <Grid.RowDefinitions>
                                        <RowDefinition Height="64"/>
                                        <RowDefinition/>
                                </Grid.RowDefinitions>
                                <Grid x:Name="Header">
                                        <Image Source="/Assets/Images/Branding.png"/>
                                </Grid>                                    
                                <Intersoft:UXFrame x:Name="ContentFrame" Grid.Row="1">
                                        <Intersoft:UXFrame.UriMapper>
                                                <Intersoft:UriMapper>
                                                        <Intersoft:UriMapping Uri="" MappedUri="/Views/Home.xaml"/>
                                                        <Intersoft:UriMapping Uri="/Error" MappedUri="/ErrorPage.xaml"/>
                                                        <Intersoft:UriMapping Uri="/{page}" MappedUri="/Views/{page}.xaml"/>
                                                </Intersoft:UriMapper>
                                        </Intersoft:UXFrame.UriMapper>
                                </Intersoft:UXFrame>
                        </Grid>
                </Border>
        </Grid>
</Intersoft:UXPage>

Remarks

UXFrame is the core navigation component that acts as the container of navigable content and facilitates the navigation to pages. UXFrame supports navigation to pages in the local assembly or pages in external application package (.xap). Built upon ClientUI Framework, UXFrame delivers consistent and navigation experiences across multiple, nested navigation frames.

Several key features include journal-aware deep navigation, predefined visual transitions, seamless integration with navigation UI through advanced architecture such as routed commands and events, easy MVVM binding, role-based security, busy state management and much more.

For detailed information about the navigation concept, architecture, and how to implement navigation features, see Navigation Overview. To learn more about the advanced navigation features, see Advanced Features in ClientUI Navigation Framework.

Inheritance Hierarchy

System.Object
   System.Windows.DependencyObject
      System.Windows.UIElement
         System.Windows.FrameworkElement
            System.Windows.Controls.Control
               System.Windows.Controls.ContentControl
                  System.Windows.Controls.Frame
                        Intersoft.Client.UI.Navigation.UXFrame

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.