Propriedade SimpleShape.Location

Artigo
10/26/2012

Obtém ou define as coordenadas da quina esquerda de cima da forma relativas à quina esquerda de cima de seu contêiner.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (em Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxe

'Declaração
<BrowsableAttribute(True)> _
Public Property Location As Point

[BrowsableAttribute(true)]
public Point Location { get; set; }

[BrowsableAttribute(true)]
public:
property Point Location {
    Point get ();
    void set (Point value);
}

[<BrowsableAttribute(true)>]
member Location : Point with get, set

function get Location () : Point
function set Location (value : Point)

Valor de propriedade

Tipo: System.Drawing.Point
O Point que representa o canto superior esquerdo da forma em relação ao canto superior esquerdo de seu recipiente.

Comentários

Porque o Point classe é um tipo de valor (Structure na Visual Basic, struct no Visual C#), ele é retornado por valor.Isso significa que acessar a propriedade retorna uma cópia do ponto superior esquerdo da forma.Portanto, ajustando a x ou y parâmetros da Point retornado por essa propriedade não afetará o Left, Right, Top, ou Bottom valores de propriedade da forma.Para ajustar essas propriedades, definir cada valor da propriedade individualmente, ou definir a Location propriedade por meio de uma nova Point.

Exemplos

O exemplo a seguir demonstra como usar o Location propriedade para mover um OvalShape controle.Este exemplo requer que você tenha um OvalShape controle denominado OvalShape1 em um formulário.

Private Sub OvalShape1_Click() Handles OvalShape1.Click
    ' Move the shape incrementally until it reaches the bottom 
    ' of the form.
    If OvalShape1.Bottom < Me.ClientSize.Height - 50 Then
        ' Move down 50 pixels.
        OvalShape1.Location = New Point(OvalShape1.Left, 
          OvalShape1.Top + 50)
    Else
        ' Move back to the top.
        OvalShape1.Location = New Point(OvalShape1.Left, 0)
    End If
End Sub

private void ovalShape1_Click(System.Object sender, System.EventArgs e)
{
    // Move the shape incrementally until it reaches the bottom 
    // of the form.
    if (ovalShape1.Bottom < this.ClientSize.Height - 50)
    // Move down 50 pixels.
    {
        ovalShape1.Location = new Point(ovalShape1.Left, ovalShape1.Top + 50);
    }
    else
    {
        // Move back to the top.
        ovalShape1.Location = new Point(ovalShape1.Left, 0);
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.