Click to Rate and Give Feedback
MSDN
MSDN Library
.NET Development
.NET Framework 4
Form Class
Form Methods
 SetDesktopBounds Method
Collapse All/Expand All Collapse All
This page is specific to
Microsoft Visual Studio 2010/.NET Framework 4

Other versions are also available for the following:
.NET Framework Class Library
Form..::.SetDesktopBounds Method

Sets the bounds of the form in desktop coordinates.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
Visual Basic
Public Sub SetDesktopBounds ( _
    x As Integer, _
    y As Integer, _
    width As Integer, _
    height As Integer _
)
C#
public void SetDesktopBounds(
    int x,
    int y,
    int width,
    int height
)
Visual C++
public:
void SetDesktopBounds(
    int x, 
    int y, 
    int width, 
    int height
)
F#
member SetDesktopBounds : 
        x:int * 
        y:int * 
        width:int * 
        height:int -> unit 

Parameters

x
Type: System..::.Int32
The x-coordinate of the form's location.
y
Type: System..::.Int32
The y-coordinate of the form's location.
width
Type: System..::.Int32
The width of the form.
height
Type: System..::.Int32
The height of the form.

Desktop coordinates are based on the working area of the screen, which excludes the taskbar. You can use this method to set the position and size of your form on the desktop. Since desktop coordinates are based on the working area of the form, you can use this method to ensure that your form is completely visible on the desktop.

The following code example demonstrates using the SetDesktopBounds method. To run this example, paste the following code in a form that contains a button named Button2. Ensure all events are associated with their event handlers.

Visual Basic
Private Sub Button2_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button2.Click
    Dim i As Integer
    For i = 0 To 20
        ' With each loop through the code, the form's desktop location is 
        ' adjusted right and down by 10 pixels and its height and width 
        ' are each decreased by 10 pixels. 
        Me.SetDesktopBounds(Me.Location.X + 10, Me.Location.Y + 10, _
            Me.Width - 10, Me.Height - 10)

        ' Call Sleep to show the form gradually shrinking.
        System.Threading.Thread.Sleep(50)
    Next
End Sub
C#
    private void Button2_Click(System.Object sender, System.EventArgs e)
    {
        
        for(int i = 0; i <= 20; i++)
        {
            // With each loop through the code, the form's 
            // desktop location is adjusted right and down
            //  by 10 pixels and its height and width are each
            // decreased by 10 pixels. 
            this.SetDesktopBounds(this.Location.X+10, 
                this.Location.Y+10, this.Width-10, this.Height-10);

            // Call Sleep to show the form gradually shrinking.
            System.Threading.Thread.Sleep(50);
        }
    }
Visual C++
void Button2_Click( System::Object^ sender, System::EventArgs^ e )
{
   for ( int i = 0; i <= 20; i++ )
   {

      // With each loop through the code, the form's 
      // desktop location is adjusted right and down
      //  by 10 pixels and its height and width are each
      // decreased by 10 pixels. 
      this->SetDesktopBounds( this->Location.X + 10, this->Location.Y + 10, this->Width - 10, this->Height - 10 );

      // Call Sleep to show the form gradually shrinking.
      System::Threading::Thread::Sleep( 50 );

   }
}

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

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

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
Processing
© 2012 Microsoft. All rights reserved. Terms of Use | Trademarks | Privacy Statement
Page view tracker