ScrollableControl.AutoScrollMargin Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Größe des AutoBildlaufrandes ab oder legt diese fest.
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, setPublic Property AutoScrollMargin As SizeEigenschaftswert
Eine Size, die die Höhe und Breite des AutoBildlaufrands in Pixel darstellt.
Ausnahmen
Beispiele
Im folgenden Codebeispiel wird die abgeleitete Klasse verwendet Panel. Im Beispiel wird die Position eines Textfelds ausgewertet und das Aussehen und Verhalten des übergeordneten Containers, das Panel-Steuerelement, geändert. Das Beispiel erfordert, dass Sie eine Instanz eines Panel Steuerelements, TextBoxund .Button Platzieren Sie das Textfeld auf dem Panel, damit es mindestens einen der Ränder des Panels überlappen kann. Rufen Sie diese Funktion auf, wenn Sie auf eine Schaltfläche klicken, um den Unterschied im Verhalten und der Darstellung des Panels anzuzeigen.
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
Hinweise
Der Rand des automatischen Bildlaufs ist der Abstand zwischen untergeordneten Steuerelementen und den Kanten des bildlauffähigen übergeordneten Steuerelements. Die AutoScrollMargin Größe wird der Größe aller untergeordneten Steuerelemente hinzugefügt, die im bildlauffähigen Steuerelement enthalten sind, um zu bestimmen, ob Bildlaufleisten erforderlich sind. Die AutoScrollMargin Eigenschaft wird ausgewertet, wenn das übergeordnete bildlauffähige Steuerelement geändert wird oder die einzelnen untergeordneten Steuerelemente in die Ansicht gebracht werden, und wird verwendet, um festzustellen, ob Bildlaufleisten angezeigt werden müssen. Angedockte Steuerelemente werden von den Berechnungen ausgeschlossen, die bestimmen, ob Bildlaufleisten angezeigt werden müssen.
Hinweis
Wenn die Eigenschaft eines angedockten Steuerelements Dock festgelegt DockStyle.Fillist, füllt das Steuerelement das übergeordnete bildlauffähige Steuerelement aus, und das angedockte Steuerelement wird ignoriert, wenn dies AutoScrollMargin verwendet wird, um zu bestimmen, ob Bildlaufleisten erforderlich sind.
Wenn der Abstand vom Rand eines untergeordneten Steuerelements zum übergeordneten Bildlaufsteuerelement kleiner als der Wert ist, der der AutoScrollMargin Eigenschaft zugewiesen ist und die AutoScroll Eigenschaft auf festgelegt trueist, wird die entsprechende Bildlaufleiste angezeigt.
Hinweis
Es wird empfohlen, beim Andocken von Steuerelementen innerhalb eines bildlauffähigen Steuerelements ein untergeordnetes bildlauffähiges Steuerelement hinzuzufügen, z. B. ein Panel, um alle anderen Steuerelemente zu enthalten, die möglicherweise einen Bildlauf erfordern. Sie sollten das untergeordnete Panel Steuerelement dem bildlauffähigen Steuerelement und dessen Dock Eigenschaft hinzufügen, auf die die Eigenschaft festgelegt DockStyle.Fill ist, und dessen AutoScroll Eigenschaft auf true. Sie sollten die AutoScroll Eigenschaft des übergeordneten bildlauffähigen Steuerelements auf falsefestlegen.