SimpleShape.Location-Eigenschaft

Článek
08/23/2008

Aktualisiert: November 2007

Ruft die Koordinaten der linken oberen Ecke der Form relativ zur linken oberen Ecke des Containers ab oder legt diese fest.

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

Syntax

'Declaration
<BrowsableAttribute(True)> _
Public Property Location As Point
'Usage
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)

Eigenschaftenwert

Typ: System.Drawing.Point

Point , der die linke obere Ecke der Form relativ zur linken oberen Ecke des Containers darstellt.

Hinweise

Da die Point-Klasse ein Werttyp ist (Structure in Visual Basic, struct in Visual C#), erfolgt die Rückgabe als Wert. Wenn Sie auf die Eigenschaft zugreifen, wird hierdurch eine Kopie des oberen linken Punkts der Form zurückgegeben. Eine Anpassung der Parameter x oder y des von dieser Eigenschaft zurückgegebenen Point wirkt sich daher nicht auf die Eigenschaftenwerte Left, Right, Top oder Bottom der Form aus. Um diese Eigenschaften anzupassen, legen Sie jeden Eigenschaftenwert einzeln fest, oder legen Sie die Location-Eigenschaft mit einem neuen Point fest.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie mit der Location-Eigenschaft ein OvalShape-Steuerelement verschieben. Für dieses Beispiel müssen Sie über ein OvalShape-Steuerelement mit dem Namen OvalShape1 auf einem Formular verfügen.

Private Sub 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)
    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);
    }
}

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.