Propriedade SimpleShape.Location

Artigo
08/25/2010

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

<BrowsableAttribute(True)> _
Public Property Location As Point

Dim instance As SimpleShape
Dim value As Point

value = instance.Location

instance.Location = value

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

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

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

Valor de propriedade

Tipo: System.Drawing.Point
The 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 valorStructure em Visual Basic, struct translation from VPE for Csharp Visual), ele será retornado por valor. Isso significa que, acessando a propriedade retornará uma cópia do ponto do canto superior esquerdo da forma.Portanto, ajustando o x ou y parâmetros das Point retornado por esta propriedade não afetará o Left, Right, Top, ou Bottom valores de propriedade da forma. Para ajustar essas propriedades, conjunto cada valor da propriedade individualmente, ou conjunto o Location propriedade por meio de 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 chamado OvalShape1 em um formulário.

PrivateSub OvalShape1_Click(ByVal sender As System.Object, _
 ByVal e As System.EventArgs) 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)
    EndIfEndSub

privatevoid 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);
    }
}

Permissões

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ódigos parcialmente Confiável.