ScrollableControl.AutoScrollMargin Tulajdonság

Definíció

Lekéri vagy beállítja az automatikus görgetési margó méretét.

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

Tulajdonság értéke

Az Size automatikus görgetési margó magassága és szélessége képpontban kifejezve.

Kivételek

A Height hozzárendelt érték kisebb Width , mint 0.

Példák

Az alábbi példakód a származtatott osztályt használja. Panel A példa kiértékeli egy szövegdoboz helyét, és megváltoztatja a szülőtároló, a panel vezérlőjének megjelenését és viselkedését. A példához létre kell hoznia egy vezérlőelem egy példányát Panel , TextBoxés Button. Helyezze a szövegdobozt a panelre úgy, hogy az átfedésben legyen a panel legalább egy szélével. Hívja meg ezt a függvényt egy gombra kattintva a panel viselkedésének és megjelenésének különbségének megtekintéséhez.

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

Megjegyzések

Az automatikus görgetési margó a gyermekvezérlők és a görgethető szülővezérlő szélei közötti távolság. A AutoScrollMargin rendszer hozzáadja a méretet a görgethető vezérlőben található gyermekvezérlők méretéhez annak megállapításához, hogy szükség van-e görgetősávokra. A AutoScrollMargin tulajdonság kiértékelése a szülő görgethető vezérlő átméretezésekor vagy az egyes gyermekvezérlők megtekintésekor történik, és annak meghatározására szolgál, hogy a görgetősávokat meg kell-e jeleníteni. A rögzített vezérlők nem szerepelnek a számításokban, amelyek meghatározzák, hogy a görgetősávokat meg kell-e jeleníteni.

Note

Ha egy rögzített vezérlőelem tulajdonsága Dock a következőre DockStyle.Fillvan állítva, a vezérlő kitölti a szülő görgethető vezérlőt, és a rögzített vezérlő figyelmen kívül lesz hagyva, amikor a AutoScrollMargin görgetősávok szükségét határozza meg.

Ha a gyermekvezérlő szélétől a szülő görgethető vezérlőelemig mért távolság kisebb, mint a tulajdonsághoz AutoScrollMargin rendelt érték, és a AutoScroll tulajdonság értéke meg van adva true, megjelenik a megfelelő görgetősáv.

Note

A görgethető vezérlőelemek rögzítésekor javasoljuk, hogy egy gyermek görgethető vezérlőt (például egy Panel) adjon hozzá, hogy az tartalmazzon minden olyan vezérlőt, amely görgetést igényelhet. A gyermek Panel vezérlőelemet hozzá kell adni a görgethető vezérlőhöz, a tulajdonsága DockDockStyle.Fill pedig AutoScroll a következőre truevan állítva. A szülő görgethető vezérlőelem tulajdonságát a következőre kell állítania AutoScrollfalse: .

A következőre érvényes:

Lásd még