Expand Minimize

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)

public void SetDesktopBounds(
	int x,
	int y,
	int width,
	int height
)

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.

	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);
		}
	}

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft