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






Gets or sets the background mode which determine the appearance of UXDock's background.

Syntax

Visual Basic (Declaration) 
<CategoryAttribute("Background")>
Public Property BackgroundMode As BackgroundMode
Visual Basic (Usage)Copy Code
Dim instance As UXDock
Dim value As BackgroundMode
 
instance.BackgroundMode = value
 
value = instance.BackgroundMode
C# 
[CategoryAttribute("Background")]
public BackgroundMode BackgroundMode {get; set;}
Delphi 
public read-write property BackgroundMode: BackgroundMode;
JScript 
CategoryAttribute("Background")
public function get,set BackgroundMode : BackgroundMode
Managed Extensions for C++ 
[CategoryAttribute("Background")]
public: __property BackgroundMode get_BackgroundMode();
public: __property void set_BackgroundMode( 
   BackgroundMode value
);
C++/CLI 
[CategoryAttribute("Background")]
public:
property BackgroundMode BackgroundMode {
   BackgroundMode get();
   void set (    BackgroundMode 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.