Form.SetDesktopLocation(Int32, Int32) Método

Definição

Define o local do formulário em coordenadas de área de trabalho.Sets the location of the form in desktop coordinates.

public:
 void SetDesktopLocation(int x, int y);
public void SetDesktopLocation (int x, int y);
member this.SetDesktopLocation : int * int -> unit
Public Sub SetDesktopLocation (x As Integer, y As Integer)

Parâmetros

x
Int32

A coordenada X do local do formulário.The x-coordinate of the form's location.

y
Int32

A coordenada Y do local do formulário.The y-coordinate of the form's location.

Exemplos

O exemplo a seguir demonstra como usar os membros SetDesktopLocation, Load e Activate.The following example demonstrates how to use the SetDesktopLocation, Load and Activate members. Para executar o exemplo, Cole o código a seguir em um formulário chamado Form1 que contém um botão chamado Button1 e dois controles de Label chamados Label1 e Label2.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;
void Button1_Click( System::Object^ sender, System::EventArgs^ e )
{
   
   // Create a new Form1 and set its Visible property to true.
   Form1^ form2 = gcnew 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.
void Form1_Activated( Object^ sender, System::EventArgs^ e )
{
   Label1->Text = String::Format( "x: {0} y: {1}", x, y );
   Label2->Text = String::Format( "Number of forms currently open: {0}", count );
}

static int count = 0;
void Form1_Closed( Object^ sender, System::EventArgs^ e )
{
   count -= 1;
}

void Form1_Load( Object^ sender, System::EventArgs^ e )
{
   count += 1;
}
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;
}
Shared x As Integer = 200
Shared y As Integer = 200

Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click

    ' Create a new Form1 and set its Visible property to true.
    Dim form2 As 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.
    Me.Activate()
    Me.Button1.Enabled = False
End Sub



' 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 Sub Form1_Activated(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles MyBase.Activated
    Label1.Text = "x: " & x & " y: " & y
    Label2.Text = "Number of forms currently open: " & count
End Sub

Shared count As Integer = 0

Private Sub Form1_Closed(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles MyBase.Closed
    count -= 1
End Sub

Private Sub Form1_Load(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles MyBase.Load
    count += 1
End Sub

Comentários

As coordenadas da área de trabalho são baseadas na área de trabalho da tela, que exclui a barra de tarefas.Desktop coordinates are based on the working area of the screen, which excludes the taskbar. Você pode usar esse método para posicionar seu formulário na área de trabalho.You can use this method to position your form on the desktop. Como as coordenadas da área de trabalho são baseadas na área de trabalho do formulário, você pode usar esse método para garantir que seu formulário esteja completamente visível na área de trabalho.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. Esse método destina-se a ser usado principalmente para formulários de nível superior; Use o método LayoutMdi para posicionar formulários filho MDI (interface de vários documentos).This method is intended to be used primarily for top-level forms; use the LayoutMdi method to position multiple-document interface (MDI) child forms.

Aplica-se a

Veja também