ScrollableControl.AutoScrollMargin Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur ukuran margin gulir otomatis.
public:
property System::Drawing::Size AutoScrollMargin { System::Drawing::Size get(); void set(System::Drawing::Size value); };public System.Drawing.Size AutoScrollMargin { get; set; }member this.AutoScrollMargin : System.Drawing.Size with get, setPublic Property AutoScrollMargin As SizeNilai Properti
Size yang mewakili tinggi dan lebar margin gulir otomatis dalam piksel.
Pengecualian
Contoh
Contoh kode berikut menggunakan kelas turunan, Panel. Contoh mengevaluasi lokasi kotak teks dan mengubah tampilan dan perilaku kontainer induknya, kontrol panel. Contoh mengharuskan Anda telah membuat instans Panel kontrol, TextBox, dan Button. Tempatkan kotak teks pada panel sehingga tumpang tindih setidaknya salah satu tepi panel. Panggil fungsi ini pada klik tombol untuk melihat perbedaan perilaku dan tampilan panel.
void SetAutoScrollMargins()
{
/* If the text box is outside the panel's bounds,
turn on auto-scrolling and set the margin. */
if ( text1->Location.X > panel1->Location.X || text1->Location.Y > panel1->Location.Y )
{
panel1->AutoScroll = true;
/* If the AutoScrollMargin is set to less
than (5,5), set it to 5,5. */
if ( panel1->AutoScrollMargin.Width < 5 || panel1->AutoScrollMargin.Height < 5 )
{
panel1->SetAutoScrollMargin( 5, 5 );
}
}
}
private void SetAutoScrollMargins()
{
/* If the text box is outside the panel's bounds,
turn on auto-scrolling and set the margin. */
if (text1.Location.X > panel1.Location.X ||
text1.Location.Y > panel1.Location.Y)
{
panel1.AutoScroll = true;
/* If the AutoScrollMargin is set to less
than (5,5), set it to 5,5. */
if( panel1.AutoScrollMargin.Width < 5 ||
panel1.AutoScrollMargin.Height < 5)
{
panel1.SetAutoScrollMargin(5, 5);
}
}
}
Private Sub SetAutoScrollMargins()
' If the text box is outside the panel's bounds,
' turn on auto-scrolling and set the margin.
If (text1.Location.X > panel1.Location.X) Or _
(text1.Location.Y > panel1.Location.Y) Then
panel1.AutoScroll = True
' If the AutoScrollMargin is set to less
' than (5,5), set it to 5,5.
If (panel1.AutoScrollMargin.Width < 5) Or _
(panel1.AutoScrollMargin.Height < 5) Then
panel1.SetAutoScrollMargin(5, 5)
End If
End If
End Sub
Keterangan
Margin gulir otomatis adalah jarak antara kontrol turunan dan tepi kontrol induk yang dapat digulir. Ukuran AutoScrollMargin ditambahkan ke ukuran kontrol turunan apa pun yang terkandung dalam kontrol yang dapat digulir untuk menentukan apakah bilah gulir diperlukan atau tidak. Properti AutoScrollMargin dievaluasi ketika kontrol yang dapat digulir induk diubah ukurannya atau kontrol turunan individual ditampilkan, dan digunakan untuk menentukan apakah bilah gulir harus ditampilkan. Kontrol yang ditambatkan dikecualikan dari perhitungan yang menentukan apakah bilah gulir harus ditampilkan.
Nota
Jika properti kontrol Dock yang ditampung diatur ke DockStyle.Fill, kontrol mengisi kontrol yang dapat digulir induk dan kontrol yang di-dock diabaikan saat menggunakan AutoScrollMargin untuk menentukan apakah bilah gulir diperlukan.
Jika jarak dari tepi kontrol anak ke kontrol yang dapat digulir induk kurang dari nilai yang ditetapkan ke AutoScrollMargin properti dan AutoScroll properti diatur ke true, bilah gulir yang sesuai ditampilkan.
Nota
Sebaiknya, saat menambatkan kontrol dalam kontrol yang dapat digulir, Anda menambahkan kontrol yang dapat digulir anak, seperti Panel, untuk berisi kontrol lain yang mungkin memerlukan pengguliran. Anda harus menambahkan kontrol anak Panel ke kontrol yang dapat digulir dan propertinya Dock diatur ke DockStyle.Fill dan propertinya AutoScroll diatur ke true. Anda harus mengatur AutoScroll properti kontrol yang dapat digulir induk ke false.
