ScrollableControl.AutoScrollMargin Eigenschap

Definitie

Hiermee haalt u de grootte van de automatische schuifmarge op of stelt u deze in.

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

Waarde van eigenschap

Een Size die de hoogte en breedte van de marge voor automatisch schuiven in pixels aangeeft.

Uitzonderingen

De Height toegewezen waarde of Width waarde is kleiner dan 0.

Voorbeelden

In het volgende codevoorbeeld wordt de afgeleide klasse gebruikt. Panel Het voorbeeld evalueert de locatie van een tekstvak en wijzigt het uiterlijk en gedrag van de bovenliggende container, het configuratiescherm. Voor het voorbeeld moet u een exemplaar van een Panel besturingselement hebben gemaakt, TextBoxen Button. Plaats het tekstvak op het deelvenster, zodat het ten minste één van de randen van het deelvenster overlapt. Roep deze functie aan met een klik op een knop om het verschil in het gedrag en uiterlijk van het deelvenster te zien.

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

Opmerkingen

De marge voor automatisch schuiven is de afstand tussen onderliggende besturingselementen en de randen van het bovenliggende besturingselement dat kan worden gescrold. De AutoScrollMargin grootte wordt toegevoegd aan de grootte van onderliggende besturingselementen in het schuifbare besturingselement om te bepalen of schuifbalken wel of niet nodig zijn. De AutoScrollMargin eigenschap wordt geëvalueerd wanneer het bovenliggende besturingselement voor schuifbare grootte wordt gewijzigd of de afzonderlijke onderliggende besturingselementen in beeld worden gebracht en wordt gebruikt om te bepalen of schuifbalken moeten worden weergegeven. Gekoppelde besturingselementen worden uitgesloten van de berekeningen die bepalen of schuifbalken moeten worden weergegeven.

Note

Als de eigenschap van Dock een gekoppeld besturingselement is ingesteld op DockStyle.Fill, vult het besturingselement het bovenliggende besturingselement waarop kan worden geschoven en wordt het gekoppelde besturingselement genegeerd wanneer u het AutoScrollMargin besturingselement gebruikt om te bepalen of schuifbalken nodig zijn.

Als de afstand van de rand van een onderliggend besturingselement naar het bovenliggende besturingselement kleiner is dan de waarde die aan de AutoScrollMargin eigenschap is toegewezen en de AutoScroll eigenschap is ingesteld trueop, wordt de juiste schuifbalk weergegeven.

Note

U wordt aangeraden bij het dokken van besturingselementen binnen een schuifbaar besturingselement een onderliggend besturingselement, zoals een Panel, toe te voegen om andere besturingselementen te bevatten waarvoor mogelijk moet worden geschoven. U moet het onderliggende Panel besturingselement toevoegen aan het schuifbare besturingselement en de Dock bijbehorende eigenschap ingesteld op DockStyle.Fill en de AutoScroll bijbehorende eigenschap ingesteld op true. U moet de AutoScroll eigenschap van het bovenliggende besturingselement falseinstellen op .

Van toepassing op

Zie ook