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






Represents a resizable and expandable/collapsible content control that can be used to host any UI elements.

Object Model

UXResizablePane Class

Syntax

Visual Basic (Declaration) 
<TemplateVisualStateAttribute(Name="ContentCollapsed", GroupName="ContentStates")>
<TemplateVisualStateAttribute(GroupName="ContentStates", Name="ContentVisible")>
<TemplateVisualStateAttribute(GroupName="ContentStates", Name="ExpandDirect")>
<StyleTypedPropertyAttribute(Property="ButtonStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXFlatButton)>
<TemplateVisualStateAttribute(GroupName="ContentStates", Name="ExpandAnimated")>
<TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockTop")>
<TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockLeft")>
<TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockBottom")>
<TemplateVisualStateAttribute(GroupName="HeaderStates", Name="HeaderCollapsed")>
<TemplateVisualStateAttribute(GroupName="HeaderStates", Name="HeaderVisible")>
<StyleTypedPropertyAttribute(Property="ResizeThumbStyle", StyleTargetType=Intersoft.Client.UI.Controls.UXThumb)>
<TemplatePartAttribute(Name="CornerThumb", Type=Intersoft.Client.UI.Controls.UXThumb)>
<TemplateVisualStateAttribute(GroupName="ExpandStates", Name="Collapsed")>
<TemplateVisualStateAttribute(GroupName="ResizingStates", Name="Resizing")>
<TemplateVisualStateAttribute(GroupName="ResizingStates", Name="Normal")>
<TemplateVisualStateAttribute(GroupName="ExpandStates", Name="Expanded")>
<TemplatePartAttribute(Name="ResizeThumb", Type=Intersoft.Client.UI.Controls.UXThumb)>
<DescriptionAttribute("Represents a resizable and expandable/collapsible content control that can be used to host any UI elements.")>
<TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockRight")>
<TemplatePartAttribute(Name="RootContentElement", Type=System.Windows.Controls.Border)>
Public Class UXResizablePane 
   Inherits Intersoft.Client.UI.Controls.ExpandableGroupBox
   Implements IControl, IFramework, ILicensing 
Visual Basic (Usage)Copy Code
Dim instance As UXResizablePane
C# 
[TemplateVisualStateAttribute(Name="ContentCollapsed", GroupName="ContentStates")]
[TemplateVisualStateAttribute(GroupName="ContentStates", Name="ContentVisible")]
[TemplateVisualStateAttribute(GroupName="ContentStates", Name="ExpandDirect")]
[StyleTypedPropertyAttribute(Property="ButtonStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXFlatButton)]
[TemplateVisualStateAttribute(GroupName="ContentStates", Name="ExpandAnimated")]
[TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockTop")]
[TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockLeft")]
[TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockBottom")]
[TemplateVisualStateAttribute(GroupName="HeaderStates", Name="HeaderCollapsed")]
[TemplateVisualStateAttribute(GroupName="HeaderStates", Name="HeaderVisible")]
[StyleTypedPropertyAttribute(Property="ResizeThumbStyle", StyleTargetType=Intersoft.Client.UI.Controls.UXThumb)]
[TemplatePartAttribute(Name="CornerThumb", Type=Intersoft.Client.UI.Controls.UXThumb)]
[TemplateVisualStateAttribute(GroupName="ExpandStates", Name="Collapsed")]
[TemplateVisualStateAttribute(GroupName="ResizingStates", Name="Resizing")]
[TemplateVisualStateAttribute(GroupName="ResizingStates", Name="Normal")]
[TemplateVisualStateAttribute(GroupName="ExpandStates", Name="Expanded")]
[TemplatePartAttribute(Name="ResizeThumb", Type=Intersoft.Client.UI.Controls.UXThumb)]
[DescriptionAttribute("Represents a resizable and expandable/collapsible content control that can be used to host any UI elements.")]
[TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockRight")]
[TemplatePartAttribute(Name="RootContentElement", Type=System.Windows.Controls.Border)]
public class UXResizablePane : Intersoft.Client.UI.Controls.ExpandableGroupBox, IControl, IFramework, ILicensing 
Delphi 
public class UXResizablePane = class(Intersoft.Client.UI.Controls.ExpandableGroupBox, IControl, IFramework, ILicensing)
JScript 
TemplateVisualStateAttribute(Name="ContentCollapsed", GroupName="ContentStates")
TemplateVisualStateAttribute(GroupName="ContentStates", Name="ContentVisible")
TemplateVisualStateAttribute(GroupName="ContentStates", Name="ExpandDirect")
StyleTypedPropertyAttribute(Property="ButtonStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXFlatButton)
TemplateVisualStateAttribute(GroupName="ContentStates", Name="ExpandAnimated")
TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockTop")
TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockLeft")
TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockBottom")
TemplateVisualStateAttribute(GroupName="HeaderStates", Name="HeaderCollapsed")
TemplateVisualStateAttribute(GroupName="HeaderStates", Name="HeaderVisible")
StyleTypedPropertyAttribute(Property="ResizeThumbStyle", StyleTargetType=Intersoft.Client.UI.Controls.UXThumb)
TemplatePartAttribute(Name="CornerThumb", Type=Intersoft.Client.UI.Controls.UXThumb)
TemplateVisualStateAttribute(GroupName="ExpandStates", Name="Collapsed")
TemplateVisualStateAttribute(GroupName="ResizingStates", Name="Resizing")
TemplateVisualStateAttribute(GroupName="ResizingStates", Name="Normal")
TemplateVisualStateAttribute(GroupName="ExpandStates", Name="Expanded")
TemplatePartAttribute(Name="ResizeThumb", Type=Intersoft.Client.UI.Controls.UXThumb)
DescriptionAttribute("Represents a resizable and expandable/collapsible content control that can be used to host any UI elements.")
TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockRight")
TemplatePartAttribute(Name="RootContentElement", Type=System.Windows.Controls.Border)
public class UXResizablePane extends Intersoft.Client.UI.Controls.ExpandableGroupBox implements IControl, IFramework, ILicensing 
Managed Extensions for C++ 
[TemplateVisualStateAttribute(Name="ContentCollapsed", GroupName="ContentStates")]
[TemplateVisualStateAttribute(GroupName="ContentStates", Name="ContentVisible")]
[TemplateVisualStateAttribute(GroupName="ContentStates", Name="ExpandDirect")]
[StyleTypedPropertyAttribute(Property="ButtonStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXFlatButton)]
[TemplateVisualStateAttribute(GroupName="ContentStates", Name="ExpandAnimated")]
[TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockTop")]
[TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockLeft")]
[TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockBottom")]
[TemplateVisualStateAttribute(GroupName="HeaderStates", Name="HeaderCollapsed")]
[TemplateVisualStateAttribute(GroupName="HeaderStates", Name="HeaderVisible")]
[StyleTypedPropertyAttribute(Property="ResizeThumbStyle", StyleTargetType=Intersoft.Client.UI.Controls.UXThumb)]
[TemplatePartAttribute(Name="CornerThumb", Type=Intersoft.Client.UI.Controls.UXThumb)]
[TemplateVisualStateAttribute(GroupName="ExpandStates", Name="Collapsed")]
[TemplateVisualStateAttribute(GroupName="ResizingStates", Name="Resizing")]
[TemplateVisualStateAttribute(GroupName="ResizingStates", Name="Normal")]
[TemplateVisualStateAttribute(GroupName="ExpandStates", Name="Expanded")]
[TemplatePartAttribute(Name="ResizeThumb", Type=Intersoft.Client.UI.Controls.UXThumb)]
[DescriptionAttribute("Represents a resizable and expandable/collapsible content control that can be used to host any UI elements.")]
[TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockRight")]
[TemplatePartAttribute(Name="RootContentElement", Type=System.Windows.Controls.Border)]
public __gc class UXResizablePane : public Intersoft.Client.UI.Controls.ExpandableGroupBox, IControl, IFramework, ILicensing 
C++/CLI 
[TemplateVisualStateAttribute(Name="ContentCollapsed", GroupName="ContentStates")]
[TemplateVisualStateAttribute(GroupName="ContentStates", Name="ContentVisible")]
[TemplateVisualStateAttribute(GroupName="ContentStates", Name="ExpandDirect")]
[StyleTypedPropertyAttribute(Property="ButtonStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXFlatButton)]
[TemplateVisualStateAttribute(GroupName="ContentStates", Name="ExpandAnimated")]
[TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockTop")]
[TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockLeft")]
[TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockBottom")]
[TemplateVisualStateAttribute(GroupName="HeaderStates", Name="HeaderCollapsed")]
[TemplateVisualStateAttribute(GroupName="HeaderStates", Name="HeaderVisible")]
[StyleTypedPropertyAttribute(Property="ResizeThumbStyle", StyleTargetType=Intersoft.Client.UI.Controls.UXThumb)]
[TemplatePartAttribute(Name="CornerThumb", Type=Intersoft.Client.UI.Controls.UXThumb)]
[TemplateVisualStateAttribute(GroupName="ExpandStates", Name="Collapsed")]
[TemplateVisualStateAttribute(GroupName="ResizingStates", Name="Resizing")]
[TemplateVisualStateAttribute(GroupName="ResizingStates", Name="Normal")]
[TemplateVisualStateAttribute(GroupName="ExpandStates", Name="Expanded")]
[TemplatePartAttribute(Name="ResizeThumb", Type=Intersoft.Client.UI.Controls.UXThumb)]
[DescriptionAttribute("Represents a resizable and expandable/collapsible content control that can be used to host any UI elements.")]
[TemplateVisualStateAttribute(GroupName="GlpyhStates", Name="DockRight")]
[TemplatePartAttribute(Name="RootContentElement", Type=System.Windows.Controls.Border)]
public ref class UXResizablePane : public Intersoft.Client.UI.Controls.ExpandableGroupBox, IControl, IFramework, ILicensing 

Remarks

You use UXResizablePane control to display a single content that can be collapsed and expanded through the expander button attached to its header element. In addition to the expand and collapse feature, the content of UXResizablePane will become resizable which means that users can drag the resize thumb to increase or decrease the dimension of the content. The position of the resize thumb is controlled by the ResizeDock property explained later in this topic.

Unlike traditional layout controls, UXResizablePane can work independently without requiring a layout manager. One of the benefits is that it allows you to use UXResizablePane with any Silverlight/WPF panels such as Grid and StackPanel. The most recommended panel to use with UXResizablePane is a DockPanel, which allows fluid resizing and fill layout behavior.

The following example shows how to define a simple UXResizablePane in XAML and use it with DockPanel.

XAML Copy Code 
<Intersoft:DockPanel FillChildMode="Custom">

    <Intersoft:UXResizablePane Header="Navigation" Width="140" MaxWidth="200">
        <Intersoft:UXItemsControl>
            <Intersoft:UXNavigationButton Content="Home" NavigateUri="/Home" Icon="Assets/Images/Home.png" IsDefaultNavigationSource="True"/>
            <Intersoft:UXNavigationButton Content="Customers" NavigateUri="/Customers" Icon="Assets/Images/CustomersFolder.png"/>
            <Intersoft:UXNavigationButton Content="Products" NavigateUri="/Products" Icon="Assets/Images/Products.png"/>
            <Intersoft:UXNavigationButton Content="About" NavigateUri="/About" Icon="Assets/Images/ClientUI_Silverlight.png"/>
        </Intersoft:UXItemsControl>
    </Intersoft:UXResizablePane>

    <Grid Intersoft:DockPanel.IsFillElement="True">
        <TextBlock Text="Fill Element" HorizontalAlignment="Center" VerticalAlignment="Center" />
    </Grid>
</Intersoft:DockPanel>
It is best practice to define the size in the UXResizablePane instead of defining it in the content. This allows the UXResizablePane control to properly maintain the dimension during resizing and expand/collapse.

The UXResizablePane control sports a modern user interface design which includes an expander button for expanding and collapsing the content section, as well as the resize thumb for fluid content resizing. UXResizablePane is shown in expanded state by default, which is shown in the following figure.

The following figure shows the UXResizablePane control while in collapsed/minimized state.

For more information about UXResizablePane and its features, see UXResizablePane Overview.

Inheritance Hierarchy

System.Object
   System.Windows.DependencyObject
      System.Windows.UIElement
         System.Windows.FrameworkElement
            System.Windows.Controls.Control
               System.Windows.Controls.ContentControl
                  Intersoft.Client.Framework.ISContentControl
                     Intersoft.Client.Framework.ISHeaderedContentControl
                        Intersoft.Client.UI.Controls.GroupBox
                           Intersoft.Client.UI.Controls.ExpandableGroupBox
                              Intersoft.Client.UI.Aqua.UXResizablePane

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.