ScrollableControl.AutoScrollPosition 屬性

定義

取得或設定自動捲動的位置。

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,表示自動捲動的位置 (以像素為單位)。

屬性

範例

下列程式碼範例會使用 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 事件的舊值進行比較。

適用於

另請參閱