ScrollableControl.AutoScroll Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Kapsayıcının kullanıcının görünür sınırların dışına yerleştirilmiş tüm denetimlere kaydırmasına olanak verip vermediğini belirten bir değer alır veya ayarlar.
public:
virtual property bool AutoScroll { bool get(); void set(bool value); };public virtual bool AutoScroll { get; set; }member this.AutoScroll : bool with get, setPublic Overridable Property AutoScroll As BooleanÖzellik Değeri
true kapsayıcı otomatik kaydırmayı etkinleştirirse; aksi takdirde , false. Varsayılan değer false değeridir.
Örnekler
Aşağıdaki kod örneği, özellik olarak ayarlandığında trueyatay ve/veya dikey kaydırma çubuklarının AutoScroll gerektiği gibi otomatik olarak nasıl sağlandığını gösterir. Örneği çalıştırmak için şu adımları izleyin:
Yeni bir Windows Forms uygulaması oluşturun.
Forma bir Panel ekleyin.
Panele bir TextBox ekleyin ve olarak adlandırın
text1.Sağ bölümün panelin sağ kenarının ötesine doğru genişlemesi için metin kutusunu hareket ettirin.
Metin kutusunun yalnızca panelin sınırlarının dışında olan bölümünün ana hatlarını görmeniz gerekir. Metin kutusunun tamamı görünür durumdaysa, metin kutusu panelde değil formdadır.
Forma bir Button ekleyin.
Düğmenin
Clickolayı için bir işleyici ekleyin.Aşağıdaki örnek kodu ekleyin ve düğmenin işleyicisinden çağırın
Click.
Örneği çalıştırdığınızda, metin kutusunun yalnızca panelin sınırları içinde yer alan bölümünü görebilirsiniz. Düğmeye tıkladığınızda, metin kutusunun geri kalanını görmenizi sağlayacak yatay bir kaydırma çubuğu görüntülenir.
Metin kutusunun bir bölümünü panelin alt kısmının altına yerleştirirseniz, düğmeye tıkladığınızda dikey bir kaydırma çubuğu görürsünüz.
Örnek kod, metin kutusunun özelliği olarak ayarlamadan önce ve özelliği trueayarlamadan önce panelin sınırlarının AutoScrollAutoScrollMargin dışında olup olmadığını denetler. Bu sınır dışı denetim gerekli değildir. olarak ayarlanırsa AutoScrolltrue, metin kutusu tamamen panel içinde olduğunda kaydırma çubuğu görüntülenmez. Ayrıca, kenar boşluklarını varsayılan ayarları olan 0,0'da bırakabilirsiniz.
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
Açıklamalar
olduğunda true, bu özellik kapsayıcının görünür sınırlarından daha büyük bir sanal boyuta sahip olmasını sağlar.
Uyarı
Windows Forms'da bir alt denetim sağ veya alta (Control içerir Right veya Bottom) sabitlendiğinde Kapsayıcı olarak ayarlanmış falsegibi AutoScroll davranır.
Şu anda Windows Forms'da türetilen ScrollableControl tüm sınıfların her ikisi de RightToLeft etkinleştirildiğinde ve AutoScroll olarak ayarlandığında truedüzgün davranmasını engelleyen bir sınırlama vardır. Örneğin, formunuza - veya öğesinden Panel türetilmiş bir kapsayıcı sınıfı gibi Panel bir denetim (veya TableLayoutPanelgibiFlowLayoutPanel) yerleştirdiğini varsayalım. Kapsayıcıyı olarak ayarlarsanız AutoScroll ve kapsayıcının Anchor içindeki denetimlerden bir veya daha fazlalarında özelliğini olarak Rightayarlarsanız hiçbir kaydırma çubuğu görüntülenmez.true öğesinden ScrollableControl türetilen sınıf, olarak ayarlanmış falsegibi AutoScroll davranır. Şu anda tek geçici çözüm, içine başka bir ScrollableControliç içe ScrollableControl geçmektir. Örneğin, bu durumda çalışmanız gerekiyorsaTableLayoutPanel, bunu bir Panel denetimin içine yerleştirebilir ve üzerinde Panel olarak trueayarlayabilirsinizAutoScroll.
Uyarı
AutoScroll kaydırma çubuklarının görünürlüğünü otomatik olarak korur. Bu nedenle, veya VScroll özelliğinin HScrolltrue olarak ayarlanması etkinleştirildiğinde AutoScroll hiçbir etkisi olmaz.
