ScrollableControl.AutoScrollPosition ScrollableControl.AutoScrollPosition ScrollableControl.AutoScrollPosition ScrollableControl.AutoScrollPosition Property

정의

자동 스크롤 위치를 가져오거나 설정합니다.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

속성 값

자동 스크롤 위치를 픽셀 단위로 나타내는 Point입니다.A Point that represents the auto-scroll position in pixels.

예제

다음 코드 예제에서는 합니다 ScrollableControl 파생 클래스 Panel 스크롤 가능한 영역의 왼쪽된 위 모서리에 단추를 추가 합니다.The following code example uses the ScrollableControl derived class Panel and adds a button to the upper left corner of the scrollable area. 다음 예제에서는 기준 오프셋을 AutoScrollPosition입니다.The example allows for the offset determined by the AutoScrollPosition. 있다고 가정 하에 작성 된 예제를 Form 를 포함 하는 Panel 사용 하 여를 Button 에.The example was written under the assumption that you have a Form that contains a Panel with a Button on it. 자동 스크롤을 사용 하려면 클라이언트 영역 외부에서 단추를 배치 합니다 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

설명

AutoScrollPosition 속성 표시 부분 스크롤할 수 있는 컨트롤의 위치를 나타냅니다.The AutoScrollPosition property represents the location of the visible portion of a scrollable control. 표시 되는 컨트롤의 부분을 변경 하려면이 속성을 사용 합니다.Use this property to change the portion of the control that is displayed.

폼에 컨트롤을 프로그래밍 방식으로 추가 사용 하 여는 AutoScrollPosition 속성을 내부 또는 현재 볼 수 있는 스크롤 영역 외부의 컨트롤을 배치 합니다.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.

참고

합니다 XY 검색할 좌표 값은 컨트롤의 시작 위치 (0, 0)에서 스크롤 하는 경우에 음수입니다.The X and Y coordinate values retrieved are negative if the control has scrolled away from its starting position (0,0). 양수이 속성을 설정 하는 경우 할당 항상 해야 XY 시작 위치를 기준으로 스크롤 위치를 설정 하는 값입니다.When you set this property, you must always assign positive X and Y values to set the scroll position relative to the starting position. 예를 들어 경우 고 가로 스크롤 막대 집합 x 및 y를 200 있습니다 스크롤 200 픽셀 오른쪽으로 이동. 다음 집합 x y를 100 스크롤 나타납니다 100 픽셀 왼쪽 이동 시작 위치에서 100 픽셀 설정은 있습니다.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. 첫 번째 예에서 AutoScrollPosition 반환 {-200, 0}입니다; 두 번째 경우에서 반환 {-100,0}합니다.In the first case, AutoScrollPosition returns {-200, 0}; in the second case, it returns {-100,0}.

탐지 AutoScrollPosition 변경 내용에 대 한 이벤트 처리기를 만들고는 Paint 이벤트에는 전용 변수에 이전 위치 값을 저장 하 고 후속 이전 값을 새 값을 비교 Paint 이벤트.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.

적용 대상

추가 정보