Form.DesktopBounds Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the size and location of the form on the Windows desktop.
public:
property System::Drawing::Rectangle DesktopBounds { System::Drawing::Rectangle get(); void set(System::Drawing::Rectangle value); };
[System.ComponentModel.Browsable(false)]
public System.Drawing.Rectangle DesktopBounds { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.DesktopBounds : System.Drawing.Rectangle with get, set
Public Property DesktopBounds As Rectangle
Property Value
A Rectangle that represents the bounds of the form on the Windows desktop using desktop coordinates.
- Attributes
Examples
The following example sets the size and position of a form so that the form is positioned 50 pixels from the left border of the desktop and 50 pixels from the top of the desktop. This example requires that the method is defined within a form class.
public:
void MoveMyForm()
{
// Create a Rectangle object that will be used as the bound of the form.
Rectangle tempRect = Rectangle( 50, 50, 100, 100 );
// Set the bounds of the form using the Rectangle object.
this->DesktopBounds = tempRect;
}
public void MoveMyForm()
{
// Create a Rectangle object that will be used as the bound of the form.
Rectangle tempRect = new Rectangle(50,50,100,100);
// Set the bounds of the form using the Rectangle object.
this.DesktopBounds = tempRect;
}
Public Sub MoveMyForm()
' Create a Rectangle object that will be used as the bound of the form.
Dim tempRect As New Rectangle(50, 50, 100, 100)
' Set the bounds of the form using the Rectangle object.
DesktopBounds = tempRect
End Sub
Remarks
Desktop coordinates are based on the working area of the screen, which excludes the taskbar. The coordinate system of the desktop is pixel-based. If your application is running on a multiple monitor system, the coordinates of the form are the coordinates for the combined desktop.
You can use this property to size and position a form relative to other forms or applications on the Windows desktop.