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 包含 的 ，並包含 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 事件的舊值進行比較。
