ScrollableControl.AutoScrollPosition Eigenschaft

Definition

Ruft die Position des AutoBildlaufs ab oder legt diese fest.Gets or sets the location of the auto-scroll position.

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; }
member this.AutoScrollPosition : System.Drawing.Point with get, set
Public Property AutoScrollPosition As Point

Eigenschaftswert

Ein Point, der die Position des AutoBildlaufs in Pixel darstellt.A Point that represents the auto-scroll position in pixels.

Attribute

Beispiele

Im folgenden Codebeispiel wird die ScrollableControl abgeleitete Klasse Panel verwendet und der linken oberen Ecke des Bild lauffähigen Bereichs eine Schaltfläche hinzugefügt.The following code example uses the ScrollableControl derived class Panel and adds a button to the upper left corner of the scrollable area. Im Beispiel wird der Offset ermöglicht, der vom AutoScrollPositionbestimmt wird.The example allows for the offset determined by the AutoScrollPosition. Das Beispiel wurde unter der Annahme geschrieben, dass Sie über eine Form verfügen, die eine Panel mit einer Button enthält.The example was written under the assumption that you have a Form that contains a Panel with a Button on it. Um den automatischen Bildlauf zu aktivieren, platzieren Sie die Schaltfläche außerhalb des Client Bereichs der Panel.To enable auto-scrolling, place the button outside of the client area of the 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 scrollbaren Steuer Elements dar.The AutoScrollPosition property represents the location of the visible portion of a scrollable control. Verwenden Sie diese Eigenschaft, um den Teil des Steuer Elements zu ändern, der angezeigt wird.Use this property to change the portion of the control that is displayed.

Wenn Sie Steuerelemente Programm gesteuert zu einem Formular hinzufügen, verwenden Sie die AutoScrollPosition-Eigenschaft, um das Steuerelement entweder innerhalb oder außerhalb des aktuellen sichtbaren scrollbereichs zu positionieren.When adding controls programmatically to a form, use the AutoScrollPosition property to position the control either inside or outside of the current viewable scroll area.

Hinweis

Die abgerufenen X-und Y Koordinaten Werte sind negativ, wenn das Steuerelement einen Rollup von der Startposition (0,0) durchgeführt hat.The X and Y coordinate values retrieved are negative if the control has scrolled away from its starting position (0,0). Wenn Sie diese Eigenschaft festlegen, müssen Sie immer positive X und Y Werte zuweisen, um die Scrollposition relativ zur Anfangsposition festzulegen.When you set this property, you must always assign positive X and Y values to set the scroll position relative to the starting position. Wenn Sie z. b. eine horizontale Schiebe Leiste haben und x und y auf 200 festlegen, verschieben Sie den Bild Lauf 200 Pixel nach rechts. Wenn Sie dann x und y auf 100 festlegen, wird der Bildlauf nach links um 100 Pixel angezeigt, da Sie 100 Pixel von der Startposition aus festlegen.For example, if you have a horizontal scroll bar and you set x and y to 200, you move the scroll 200 pixels to the right; if you then set x and y to 100, the scroll appears to jump the left by 100 pixels, because you are setting it 100 pixels away from the starting position. Im ersten Fall gibt AutoScrollPosition {-200, 0}; zurück. im zweiten Fall wird {-100,0}zurückgegeben.In the first case, AutoScrollPosition returns {-200, 0}; in the second case, it returns {-100,0}.

Um zu ermitteln, wann AutoScrollPosition geändert wird, 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 bei nachfolgenden Paint Ereignissen.To detect when AutoScrollPosition changes, create an event handler for the Paint event, save the old position value in a private variable, and compare the new value to the old value on subsequent Paint events.

Gilt für:

Siehe auch