Form.SetDesktopBounds(Int32, Int32, Int32, Int32) Method
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.
Sets the bounds of the form in desktop coordinates.
public:
void SetDesktopBounds(int x, int y, int width, int height);
public void SetDesktopBounds (int x, int y, int width, int height);
member this.SetDesktopBounds : int * int * int * int -> unit
Public Sub SetDesktopBounds (x As Integer, y As Integer, width As Integer, height As Integer)
Parameters
- x
- Int32
The x-coordinate of the form's location.
- y
- Int32
The y-coordinate of the form's location.
- width
- Int32
The width of the form.
- height
- Int32
The height of the form.
Examples
The following 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.
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 );
}
}
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);
}
}
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
Remarks
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.