ScrollableControl.AutoScrollMargin Egenskap

Definition

Hämtar eller anger storleken på den automatiska rullningsmarginalen.

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

Egenskapsvärde

En Size som representerar höjden och bredden på den automatiska rullningsmarginalen i bildpunkter.

Undantag

Det Height tilldelade värdet eller Width är mindre än 0.

Exempel

I följande kodexempel används den härledda klassen , Panel. Exemplet utvärderar platsen för en textruta och ändrar utseendet och beteendet för den överordnade containern, panelkontrollen. Exemplet kräver att du har skapat en instans av en Panel kontroll, TextBox, och Button. Placera textrutan på panelen så att den överlappar minst en av panelens kanter. Anropa den här funktionen genom att klicka på en knapp för att se skillnaden i panelens beteende och utseende.

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

Kommentarer

Den automatiska rullningsmarginalen är avståndet mellan underordnade kontroller och kanterna på den rullningsbara överordnade kontrollen. Storleken AutoScrollMargin läggs till i storleken på eventuella underordnade kontroller som finns i den rullningsbara kontrollen för att avgöra om rullningslister behövs eller inte. Egenskapen AutoScrollMargin utvärderas när den överordnade rullningsbara kontrollen ändras eller de enskilda underordnade kontrollerna visas och används för att avgöra om rullningslister måste visas. Dockade kontroller undantas från de beräkningar som avgör om rullningslister måste visas.

Note

Om egenskapen för en dockad kontroll Dock är inställd på DockStyle.Fillfyller kontrollen den överordnade rullningsbara kontrollen och den dockade kontrollen ignoreras när du använder AutoScrollMargin för att avgöra om rullningslister behövs.

Om avståndet från kanten av en underordnad kontroll till den överordnade rullningsbara kontrollen är mindre än värdet som tilldelats egenskapen AutoScrollMargin och AutoScroll egenskapen är inställd på true, visas lämplig rullningslist.

Note

När du dockar kontroller i en rullningsbar kontroll rekommenderar vi att du lägger till en underordnad rullningsbar kontroll, till exempel en Panel, för att innehålla andra kontroller som kan kräva rullning. Du bör lägga till den underordnade Panel kontrollen i den rullningsbara kontrollen och dess Dock egenskap inställd på DockStyle.Fill och dess AutoScroll egenskap inställd på true. Du bör ange egenskapen för AutoScroll den överordnade rullningsbara kontrollen till false.

Gäller för

Se även