ScrollableControl.AutoScrollPosition Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mendapatkan atau mengatur lokasi posisi gulir otomatis.

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

Nilai Properti

Point

Point yang mewakili posisi gulir otomatis dalam piksel.

Atribut

BrowsableAttribute

Contoh

Contoh kode berikut menggunakan ScrollableControl kelas Panel turunan dan menambahkan tombol ke sudut kiri atas area yang dapat digulir. Contoh memungkinkan offset yang ditentukan oleh AutoScrollPosition. Contoh ditulis dengan asumsi bahwa Anda memiliki Form yang berisi Panel dengan Button di atasnya. Untuk mengaktifkan pengguliran otomatis, letakkan tombol di luar area Panelklien .

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

Keterangan

Properti AutoScrollPosition mewakili lokasi bagian yang terlihat dari kontrol yang dapat digulir. Gunakan properti ini untuk mengubah bagian kontrol yang ditampilkan.

Saat menambahkan kontrol secara terprogram ke formulir, gunakan AutoScrollPosition properti untuk memosisikan kontrol baik di dalam atau di luar area gulir yang dapat dilihat saat ini.

Catatan

Nilai X koordinat dan Y yang diambil negatif jika kontrol telah digulir menjauh dari posisi awalnya (0,0). Saat Anda mengatur properti ini, Anda harus selalu menetapkan nilai dan Y positif X untuk mengatur posisi gulir relatif terhadap posisi awal. Misalnya, jika Anda memiliki bilah gulir horizontal dan Anda mengatur x dan y ke 200, Anda memindahkan gulir 200 piksel ke kanan; jika Anda kemudian mengatur x dan y ke 100, gulir tampak melompat ke kiri sebesar 100 piksel, karena Anda mengaturnya 100 piksel menjauh dari posisi awal. Dalam kasus pertama, AutoScrollPosition mengembalikan {-200, 0}; dalam kasus kedua, mengembalikan {-100,0}.

Untuk mendeteksi kapan AutoScrollPosition perubahan, buat penanganan aktivitas untuk Paint peristiwa, simpan nilai posisi lama dalam variabel privat, dan bandingkan nilai baru dengan nilai lama pada peristiwa berikutnya Paint .

Lihat juga

• AutoScroll
• AutoScrollMargin
• AutoScrollMinSize
• VerticalScroll
• HorizontalScroll