ScrollableControl.AutoScrollPosition 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

Source:

ScrollableControl.cs

获取或设置自动滚动位置的位置。

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

属性值

Point

一个 Point 表示自动滚动位置（以像素为单位）。

属性

BrowsableAttribute

示例

下面的代码示例使用 ScrollableControl 派生类 Panel ，并将一个按钮添加到可滚动区域的左上角。 该示例允许由 确定的 AutoScrollPosition偏移量。 该示例是在假设你有一个Form包含PanelButton该示例的假设下编写的。 若要启用自动滚动，请将按钮置于工作区 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 属性表示可滚动控件的可见部分的位置。 使用此属性可更改显示的控件部分。

以编程方式向窗体添加控件时，使用 AutoScrollPosition 属性将控件置于当前可查看滚动区域内部或外部。

注释

X如果控件已从其起始位置（0,0）滚动，则检索的坐标Y值为负值。 设置此属性时，必须始终分配正 X 值和 Y 值来设置相对于起始位置的滚动位置。 例如，如果你有水平滚动条并将 x 和 y 设置为 200，则向右移动 200 像素的滚动;如果随后将 x 和 y 设置为 100，则滚动将显示为 100 像素，因为你将它设置为离起始位置 100 像素。 在第一种情况下， AutoScrollPosition 返回 {-200， 0};在第二种情况下，返回 {-100,0}。

若要检测何时 AutoScrollPosition 发生更改，请为 Paint 事件创建事件处理程序，将旧位置值保存在私有变量中，并将新值与后续 Paint 事件上的旧值进行比较。

另请参阅

• AutoScroll
• AutoScrollMargin
• AutoScrollMinSize
• VerticalScroll
• HorizontalScroll