ScrollableControl.AutoScrollMargin Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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
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.