Control.Left-Eigenschaft

Ruft den Abstand zwischen dem linken Rand des Steuerelements und dem linken Rand des Clientbereichs des zugehörigen Containers in Pixel ab oder legt diesen fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Property Left As Integer
'Usage
Dim instance As Control
Dim value As Integer

value = instance.Left

instance.Left = value

public int Left { get; set; }

public:
property int Left {
    int get ();
    void set (int value);
}

/** @property */
public int get_Left ()

/** @property */
public void set_Left (int value)

public function get Left () : int

public function set Left (value : int)

Eigenschaftenwert

Ein Int32-Wert, der den Abstand zwischen dem linken Rand des Steuerelements und dem linken Rand des Clientbereichs des zugehörigen Containers in Pixel darstellt.

Hinweise

Der Left-Eigenschaftenwert ist gleich der Point.X-Eigenschaft des Location-Eigenschaftenwerts des Steuerelements.

Wenn Änderungen am Width-Eigenschaftenwert und am Left-Eigenschaftenwert vorgenommen wurden, wird die Änderung des Right-Eigenschaftenwerts des Steuerelements erzwungen.

Beispiel

Im folgenden Codebeispiel werden drei Button-Steuerelemente in einem Formular erstellt und mehrere entsprechende Eigenschaften zum Festlegen von Größe und Position verwendet. Bei diesem Beispiel muss ein Form mit einer Höhe und Breite von mindestens 300 Pixel vorhanden sein.

' Create three buttons and place them on a form using 
' several size and location related properties. 
Private Sub AddOKCancelButtons()
   ' Set the button size and location using 
      ' the Size and Location properties. 
   Dim buttonOK As New Button()
   buttonOK.Location = New Point(136, 248)
   buttonOK.Size = New Size(75, 25)
   ' Set the Text property and make the 
   ' button the form's default button. 
   buttonOK.Text = "&OK"
   Me.AcceptButton = buttonOK
   
   ' Set the button size and location using the Top, 
   ' Left, Width, and Height properties. 
   Dim buttonCancel As New Button()
   buttonCancel.Top = buttonOK.Top
   buttonCancel.Left = buttonOK.Right + 5
   buttonCancel.Width = buttonOK.Width
   buttonCancel.Height = buttonOK.Height
   ' Set the Text property and make the 
   ' button the form's cancel button. 
   buttonCancel.Text = "&Cancel"
   Me.CancelButton = buttonCancel
   
   ' Set the button size and location using 
   ' the Bounds property. 
   Dim buttonHelp As New Button()
   buttonHelp.Bounds = New Rectangle(10, 10, 75, 25)
   ' Set the Text property of the button.
   buttonHelp.Text = "&Help"
   
   ' Add the buttons to the form.
   Me.Controls.AddRange(New Control() {buttonOK, buttonCancel, buttonHelp})
End Sub

// Create three buttons and place them on a form using 
// several size and location related properties. 
private void AddOKCancelButtons()
{
   // Set the button size and location using 
   // the Size and Location properties.
   Button buttonOK = new Button();
   buttonOK.Location = new Point(136,248);
   buttonOK.Size = new Size(75,25);
   // Set the Text property and make the 
   // button the form's default button. 
   buttonOK.Text = "&OK";
   this.AcceptButton = buttonOK;

   // Set the button size and location using the Top, 
   // Left, Width, and Height properties.
   Button buttonCancel = new Button();
   buttonCancel.Top = buttonOK.Top;
   buttonCancel.Left = buttonOK.Right + 5;
   buttonCancel.Width = buttonOK.Width;
   buttonCancel.Height = buttonOK.Height;
   // Set the Text property and make the 
   // button the form's cancel button.
   buttonCancel.Text = "&Cancel";
   this.CancelButton = buttonCancel;

   // Set the button size and location using 
   // the Bounds property.
   Button buttonHelp = new Button();
   buttonHelp.Bounds = new Rectangle(10,10, 75, 25);
   // Set the Text property of the button.
   buttonHelp.Text = "&Help";

   // Add the buttons to the form.
   this.Controls.AddRange(new Control[] {buttonOK, buttonCancel, buttonHelp} );
}

// Create three buttons and place them on a form using
// several size and location related properties.
void AddOKCancelButtons()
{
   
   // Set the button size and location using
   // the Size and Location properties.
   Button^ buttonOK = gcnew Button;
   buttonOK->Location = Point(136,248);
   buttonOK->Size = System::Drawing::Size( 75, 25 );
   
   // Set the Text property and make the
   // button the form's default button.
   buttonOK->Text = "&OK";
   this->AcceptButton = buttonOK;
   
   // Set the button size and location using the Top,
   // Left, Width, and Height properties.
   Button^ buttonCancel = gcnew Button;
   buttonCancel->Top = buttonOK->Top;
   buttonCancel->Left = buttonOK->Right + 5;
   buttonCancel->Width = buttonOK->Width;
   buttonCancel->Height = buttonOK->Height;
   
   // Set the Text property and make the
   // button the form's cancel button.
   buttonCancel->Text = "&Cancel";
   this->CancelButton = buttonCancel;
   
   // Set the button size and location using
   // the Bounds property.
   Button^ buttonHelp = gcnew Button;
   buttonHelp->Bounds = Rectangle(10,10,75,25);
   
   // Set the Text property of the button.
   buttonHelp->Text = "&Help";
   
   // Add the buttons to the form.
   array<Control^>^temp1 = {buttonOK,buttonCancel,buttonHelp};
   this->Controls->AddRange( temp1 );
}

// Create three buttons and place them on a form using 
// several size and location related properties. 
private void AddOKCancelButtons()
{
    // Set the button size and location using 
    // the Size and Location properties.
    Button buttonOK = new Button();
    buttonOK.set_Location(new Point(136, 248));
    buttonOK.set_Size(new Size(75, 25));
    // Set the Text property and make the 
    // button the form's default button. 
    buttonOK.set_Text("&OK");
    this.set_AcceptButton(buttonOK);
    // Set the button size and location using the Top, 
    // Left, Width, and Height properties.
    Button buttonCancel = new Button();
    buttonCancel.set_Top(buttonOK.get_Top());
    buttonCancel.set_Left(buttonOK.get_Right() + 5);
    buttonCancel.set_Width(buttonOK.get_Width());
    buttonCancel.set_Height(buttonOK.get_Height());
    // Set the Text property and make the 
    // button the form's cancel button.
    buttonCancel.set_Text("&Cancel");
    this.set_CancelButton(buttonCancel);
    // Set the button size and location using 
    // the Bounds property.
    Button buttonHelp = new Button();
    buttonHelp.set_Bounds(new Rectangle(10, 10, 75, 25));
    // Set the Text property of the button.
    buttonHelp.set_Text("&Help");
    // Add the buttons to the form.
    this.get_Controls().AddRange(new Control[] { buttonOK, buttonCancel,
        buttonHelp });
} //AddOKCancelButtons

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
Point.X
Right