ScrollableControl.AutoScrollMargin Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

Otomatik kaydırma kenar boşluğunun boyutunu alır veya ayarlar.

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, set
Public Property AutoScrollMargin As Size

Özellik Değeri

Size

Size Otomatik kaydırma kenar boşluğunun yüksekliğini ve genişliğini piksel cinsinden temsil eden bir.

Özel durumlar

ArgumentOutOfRangeException

Height Atanan veya Width değeri 0'dan küçük.

Örnekler

Aşağıdaki kod örneği türetilmiş sınıfını Panelkullanır. Örnek, bir metin kutusunun konumunu değerlendirir ve üst kapsayıcısı olan panel denetiminin görünümünü ve davranışını değiştirir. Örnek içinTextBox, ve Buttondenetimlerinin bir Panel örneğini oluşturmuş olmanız gerekir. Metin kutusunu panelin en az bir kenarıyla örtüşmesi için panele yerleştirin. Panelin davranışındaki ve görünümündeki farkı görmek için bir düğmeye tıklayarak bu işlevi çağırın.

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

Otomatik kaydırma kenar boşluğu, tüm alt denetimlerle kaydırılabilir üst denetimin kenarları arasındaki uzaklıktır. Kaydırma AutoScrollMargin çubuklarının gerekip gerekmediğini belirlemek için kaydırılabilir denetimde yer alan alt denetimlerin boyutuna boyut eklenir. AutoScrollMargin Üst kaydırılabilir denetim yeniden boyutlandırıldığında veya tek tek alt denetimler görünüme getirildiğinde özellik değerlendirilir ve kaydırma çubuklarının görüntülenmesi gerekip gerekmediğini belirlemek için kullanılır. Yerleşik denetimler, kaydırma çubuklarının görüntülenmesi gerekip gerekmediğini belirleyen hesaplamaların dışında tutulur.

Not

Yerleşik denetimin Dock özelliği olarak DockStyle.Fillayarlanırsa, denetim üst kaydırılabilir denetimi doldurur ve kaydırma çubuklarının gerekli olup olmadığını belirlemek için kullanılırken AutoScrollMargin yerleşik denetim yoksayılır.

Bir alt denetimin kenarından üst kaydırılabilir denetime olan uzaklık, özelliğe atanan AutoScrollMargin değerden küçükse ve AutoScroll özellik olarak trueayarlandıysa, uygun kaydırma çubuğu görüntülenir.

Not

Denetimleri kaydırılabilir bir denetime yerleştirdiğinizde, kaydırma gerektirebilecek diğer denetimleri içermesi için gibi bir Panelalt kaydırılabilir denetim eklemeniz önerilir. Alt Panel denetimi kaydırılabilir denetime, Dock özelliği DockStyle.Fill olarak ve AutoScroll özelliği olarak ayarlanmış olarak trueeklemelisiniz. Üst kaydırılabilir denetimin özelliğini olarak falseayarlamalısınızAutoScroll.

Şunlara uygulanır

Ayrıca bkz.