Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Form.SetDesktopLocation Method

Sets the location of the form in desktop coordinates.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public void SetDesktopLocation (
	int x,
	int y
)
public void SetDesktopLocation (
	int x, 
	int y
)
public function SetDesktopLocation (
	x : int, 
	y : int
)

Parameters

x

The x-coordinate of the form's location.

y

The y-coordinate of the form's location.

Desktop coordinates are based on the working area of the screen, which excludes the taskbar. You can use this method to position 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. This method is intended to be used primarily for top-level forms; use the LayoutMdi method to position multiple-document interface (MDI) child forms.

The following code example demonstrates how to use the SetDesktopLocation, Load and Activate members. To run the example, paste the following code in a form called Form1 containing a button called Button1 and two Label controls called Label1 and Label2.

static int x = 200;
static int y = 200;

private void Button1_Click(System.Object sender, 
    System.EventArgs e)
{
    // Create a new Form1 and set its Visible property to true.
    Form1 form2 = new Form1();
    form2.Visible = true;

    // Set the new form's desktop location so it  
    // appears below and to the right of the current form.
    form2.SetDesktopLocation(x, y);
    x += 30;
    y += 30;

    // Keep the current form active by calling the Activate
    // method.
    this.Activate();
    this.Button1.Enabled = false;
}



// Updates the label text to reflect the current values of x 
// and y, which was were incremented in the Button1 control's 
// click event.
private void Form1_Activated(object sender, System.EventArgs e)
{
    Label1.Text = "x: "+x+" y: "+y;
    Label2.Text = "Number of forms currently open: "+count;
}

static int count = 0;

private void Form1_Closed(object sender, System.EventArgs e)
{
    count -= 1;
}

private void Form1_Load(object sender, System.EventArgs e)
{
    count += 1;
}

private static int x = 200;
private static int y = 200;

private void button1_Click(Object sender, System.EventArgs e)
{
    // Create a new Form1 and set its Visible property to true.
    Form1 form2 = new Form1();
    form2.set_Visible(true);
    // Set the new form's desktop location so it  
    // appears below and to the right of the current form.
    form2.SetDesktopLocation(x, y);
    x += 30;
    y += 30;
    // Keep the current form active by calling the Activate
    // method.
    this.Activate();
    this.button1.set_Enabled(false);
} //button1_Click

// Updates the label text to reflect the current values of x 
// and y, which was were incremented in the button1 control's 
// click event.
private void Form1_Activated(Object sender, System.EventArgs e)
{
    label1.set_Text("x: " + x + " y: " + y);
    label2.set_Text("Number of forms currently open: " + count);
} //Form1_Activated

private static int count = 0;

private void Form1_Closed(Object sender, System.EventArgs e)
{
    count -= 1;
} //Form1_Closed

private void Form1_Load(Object sender, System.EventArgs e)
{
    count += 1;
} //Form1_Load

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0, 1.1, 1.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft