WindowStartupLocation Property (UXWindow)

Gets or sets a value that indicates how the window should be positioned during startup.

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#
C++/CLI

<CategoryAttribute("Common Properties")>
Public Property WindowStartupLocation As StartupLocation

Dim instance As UXWindow
Dim value As StartupLocation
 
instance.WindowStartupLocation = value
 
value = instance.WindowStartupLocation

[CategoryAttribute("Common Properties")]
public StartupLocation WindowStartupLocation {get; set;}

[CategoryAttribute("Common Properties")]
public:
property StartupLocation WindowStartupLocation {
   StartupLocation get();
   void set (    StartupLocation value);
}

Remarks

You can set a window to be automatically positioned to certain location at startup by setting its WindowStartupLocation property. UXWindow exposes three values that you can apply which is explained below:

Auto. The window location will be determined automatically, which is the default value.
CenterScreen. The window will be positioned in center relative to the screen.
CenterOwner. The window will be positioned in center relative to the owner/parent.

When the Auto mode is used, the desktop manager first checks for the Left and Top property of the window. If an exact location is not specified, the desktop manager automatically calculates the position from the last shown window and position the window cascaded against the previous position. The cascading space can be customized through CascadingSpace property in UXDesktop.

Example

The following example shows how to setup the window to appear with the position centered to the screen.

XAML

<Grid x:Name="LayoutRoot">
        <Intersoft:UXDesktop>
                <local:HomeWindow WindowName="wndHome" 
                                  IsActive="True"
                                  WindowStartupLocation="CenterScreen"/>
        </Intersoft:UXDesktop>
</Grid>

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

UXWindow Class
UXWindow Members
Window and Dialog Boxes Overview