Intersoft ClientUI Documentation
BackgroundTemplate Property
See Also  Send Feedback
Intersoft.Client.UI.Aqua.UXDock Namespace > UXDock Class : BackgroundTemplate Property






Gets or sets the template of the background.

Syntax

Visual Basic (Declaration) 
<CategoryAttribute("Background")>
Public Property BackgroundTemplate As DataTemplate
Visual Basic (Usage)Copy Code
Dim instance As UXDock
Dim value As DataTemplate
 
instance.BackgroundTemplate = value
 
value = instance.BackgroundTemplate
C# 
[CategoryAttribute("Background")]
public DataTemplate BackgroundTemplate {get; set;}
Delphi 
public read-write property BackgroundTemplate: DataTemplate;
JScript 
CategoryAttribute("Background")
public function get,set BackgroundTemplate : DataTemplate
Managed Extensions for C++ 
[CategoryAttribute("Background")]
public: __property DataTemplate* get_BackgroundTemplate();
public: __property void set_BackgroundTemplate( 
   DataTemplate* value
);
C++/CLI 
[CategoryAttribute("Background")]
public:
property DataTemplate^ BackgroundTemplate {
   DataTemplate^ get();
   void set (    DataTemplate^ value);
}

Remarks

UXDock has three of background mode you can choose from. The following are the list of background modes available in UXDock.

  • Simple
    Uses a simple border element named BackgroundElement. You can control the appearances from Background, BorderBrush, BorderThickness properties similar with any other Silverlight components, or you can just use the edit template and create a completely custom background inside the BackgroundElement.
    XAML Copy Code 
    <Intersoft:UXDock Background="Orange" BorderThickness="8" BorderBrush="Gold" CornerRadius="12">
    <Intersoft:UXDockButton Text="Home" Icon="Home.png"/>
    <Intersoft:UXDockButton Text="Clock" Icon="Clock.png"/>
    <Intersoft:UXDockButton Text="Picture" Icon="Picture.png"/>
    <Intersoft:UXDockButton Text="Mail" Icon="Mail.png"/>
    <Intersoft:UXDockSeparator/>
    <Intersoft:UXDockButton Text="Document" Icon="Document.png" StackMode="GridStyle">
        <Intersoft:UXStackItem Text="Video" Icon="Video.png"/>
        <Intersoft:UXStackItem Text="Photo" Icon="Photo.png"/>
        <Intersoft:UXStackItem Text="Music" Icon="Mp3.png"/>
        <Intersoft:UXStackItem Text="Text" Icon="Text.png"/>
    </Intersoft:UXDockButton>
</Intersoft:UXDock>

  • ComplexImages
    Uses three containers named BackgroundImageLeftElement, BackgroundImageRightElement and BackgroundImageCenterElement where you can specify the contents from BackgroundImageLeft, BackgroundImageRight and BackgroundImageCenter properties.
    XAML Copy Code 
    <Intersoft:UXDock BackgroundImageCenter="dockwood_center.png" BackgroundImageLeft="dockwood_left.png" BackgroundImageRight="dockwood_right.png" BackgroundMode="ComplexImages">
    <Intersoft:UXDockButton Text="Home" Icon="Home.png"/>
    <Intersoft:UXDockButton Text="Clock" Icon="Clock.png"/>
    <Intersoft:UXDockButton Text="Picture" Icon="Picture.png"/>
    <Intersoft:UXDockButton Text="Mail" Icon="Mail.png"/>
    <Intersoft:UXDockSeparator/>
    <Intersoft:UXDockButton Text="Document" Icon="Document.png" StackMode="GridStyle">
        <Intersoft:UXStackItem Text="Video" Icon="Video.png"/>
        <Intersoft:UXStackItem Text="Photo" Icon="Photo.png"/>
        <Intersoft:UXStackItem Text="Music" Icon="Mp3.png"/>
        <Intersoft:UXStackItem Text="Text" Icon="Text.png"/>
    </Intersoft:UXDockButton>
</Intersoft:UXDock>


  • BackgroundTemplate
    Uses custom data templates.
    XAML Copy Code 
    <UserControl.Resources>
                <DataTemplate x:Key="BackgroundTemplate">
                        <Grid>
                                <Grid.Background>
                                        <LinearGradientBrush EndPoint="2.446,1.507" StartPoint="-0.17,0.131">
                                                <GradientStop Color="#FFFFFB8F" Offset="0"/>
                                                <GradientStop Color="#FF9400FF" Offset="1"/>
                                        </LinearGradientBrush>
                                </Grid.Background>
                                <TextBlock Margin="0,0,0,4" TextWrapping="Wrap" Text="Background Template" d:LayoutOverrides="Width, Height" HorizontalAlignment="Right" VerticalAlignment="Bottom" Foreground="White" FontSize="26.667"/>
                        </Grid>
                </DataTemplate>
        </UserControl.Resources>

    <Grid x:Name="LayoutRoot" Background="White">
        <Intersoft:UXDock BackgroundTemplate="{StaticResource BackgroundTemplate}">
            <Intersoft:UXDockButton Text="Home" Icon="Home.png"/>
            <Intersoft:UXDockButton Text="Clock" Icon="Clock.png"/>
            <Intersoft:UXDockButton Text="Picture" Icon="Picture.png"/>
            <Intersoft:UXDockButton Text="Mail" Icon="Mail.png"/>
            <Intersoft:UXDockSeparator/>
            <Intersoft:UXDockButton Text="Document" Icon="Document.png" StackMode="GridStyle">
                <Intersoft:UXStackItem Text="Video" Icon="Video.png"/>
                <Intersoft:UXStackItem Text="Photo" Icon="Photo.png"/>
                <Intersoft:UXStackItem Text="Music" Icon="Mp3.png"/>
                <Intersoft:UXStackItem Text="Text" Icon="Text.png"/>
            </Intersoft:UXDockButton>
        </Intersoft:UXDock>
    </Grid>

 

By default the background will adjust its width or height based when the zooming effect is applied. To turn off this feature, set the BackgroundBehavior property to Fix.

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.