ScrollableControl.AutoScrollPosition Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft die Position des AutoBildlaufs ab oder legt diese fest.

public:
 property System::Drawing::Point AutoScrollPosition { System::Drawing::Point get(); void set(System::Drawing::Point value); };

[System.ComponentModel.Browsable(false)]
public System.Drawing.Point AutoScrollPosition { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.AutoScrollPosition : System.Drawing.Point with get, set

Public Property AutoScrollPosition As Point

Eigenschaftswert

Point

Ein Point, der die Position des AutoBildlaufs in Pixel darstellt.

Attribute

BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird die ScrollableControl abgeleitete Klasse Panel verwendet und der oberen linken Ecke des scrollbaren Bereichs eine Schaltfläche hinzugefügt. Das Beispiel lässt den offset zu, der durch bestimmt AutoScrollPositionwird. Das Beispiel wurde unter der Annahme geschrieben, dass Sie ein Form haben, das ein Panel mit einem Button enthält. Um das automatische Scrollen zu aktivieren, platzieren Sie die Schaltfläche außerhalb des Clientbereichs von Panel.

private:
   void button1_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      /* Add a button to top left corner of the
            * scrollable area, allowing for the offset. */
      panel1->AutoScroll = true;
      Button^ myButton = gcnew Button;
      myButton->Location = Point(0 + panel1->AutoScrollPosition.X,0 + panel1->AutoScrollPosition.Y);
      panel1->Controls->Add( myButton );
   }

private void button1_Click(object sender, EventArgs e)
{
   /* Add a button to top left corner of the 
    * scrollable area, allowing for the offset. */
   panel1.AutoScroll = true;
   Button myButton = new Button();
   myButton.Location = new Point(
      0 + panel1.AutoScrollPosition.X, 
      0 + panel1.AutoScrollPosition.Y);
   panel1.Controls.Add(myButton);
}

Private Sub button1_Click(sender As Object, _
   e As EventArgs) Handles button1.Click
   ' Add a button to top left corner of the 
   ' scrollable area, allowing for the offset. 
   panel1.AutoScroll = True
   Dim myButton As New Button()
   myButton.Location = New Point( _
      0 + panel1.AutoScrollPosition.X, _
      0 + panel1.AutoScrollPosition.Y)
   panel1.Controls.Add(myButton)
End Sub

Hinweise

Die AutoScrollPosition -Eigenschaft stellt die Position des sichtbaren Teils eines bildlaufbaren Steuerelements dar. Verwenden Sie diese Eigenschaft, um den angezeigten Teil des Steuerelements zu ändern.

Verwenden Sie beim programmgesteuerten Hinzufügen von Steuerelementen zu einem Formular die AutoScrollPosition -Eigenschaft, um das Steuerelement entweder innerhalb oder außerhalb des aktuell sichtbaren Bildlaufbereichs zu positionieren.

Hinweis

Die X abgerufenen Koordinatenwerte und Y sind negativ, wenn das Steuerelement von seiner Startposition (0,0) weggescrollt wurde. Wenn Sie diese Eigenschaft festlegen, müssen Sie immer positive X werte und Y zuweisen, um die Bildlaufposition relativ zur Startposition festzulegen. Wenn Sie beispielsweise über eine horizontale Bildlaufleiste verfügen und x und y auf 200 festlegen, verschieben Sie den Bildlauf um 200 Pixel nach rechts. wenn Sie x und y dann auf 100 festlegen, wird der Bildlauf um 100 Pixel nach links gesprungen, da Sie ihn 100 Pixel von der Startposition entfernt festlegen. Im ersten Fall AutoScrollPosition wird {-200, 0} zurückgegeben. Im zweiten Fall wird zurückgegeben {-100,0}.

Um zu erkennen, wann AutoScrollPosition Änderungen vorgenommen werden, erstellen Sie einen Ereignishandler für das Paint Ereignis, speichern Sie den alten Positionswert in einer privaten Variablen, und vergleichen Sie den neuen Wert mit dem alten Wert für nachfolgende Paint Ereignisse.

Weitere Informationen

• AutoScroll
• AutoScrollMargin
• AutoScrollMinSize
• VerticalScroll
• HorizontalScroll