ScrollableControl.AutoScrollPosition 属性
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置自动滚动定位的位置。
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, setPublic Property AutoScrollPosition As Point表示自动滚动位置的 Point，单位为像素。
- 属性
下面的代码示例使用 ScrollableControl 派生类 Panel ，并在可滚动区域的左上角添加一个按钮。 该示例允许由 确定的 AutoScrollPosition偏移量。 该示例是在假设你有 一个 Form 包含 Panel 的 ，其上包含 一个 Button 。 若要启用自动滚动，请将按钮放在 的工作区 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 事件的旧值进行比较。
| 产品 | 版本 |
|---|---|
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9, 10 |
