Propriedade SimpleShape.Location

Artigo
05/17/2015

Obtém ou define as coordenadas do canto superior esquerdo da forma em relação ao canto superior esquerdo 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: Point
O Point que representa o canto superior esquerdo da forma em relação ao canto superior esquerdo de seu contêiner.

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 do Point retornado a partir dessa propriedade não afetará o Left, Right, Top, ou Bottom valores de propriedade da forma. Para ajustar essas propriedades, defina cada valor de propriedade individualmente ou defina o Location propriedade usando um novo 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ável.