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.
Dient zum Abrufen oder Festlegen der Größe des automatischen Bildlaufrands.
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
Ein Size Wert, der die Höhe und Breite des automatischen Bildlaufrands in Pixel darstellt.
Ausnahmen
Beispiele
Im folgenden Codebeispiel wird die abgeleitete Klasse verwendet. Panel Das Beispiel wertet die Position eines Textfelds aus und ändert das Erscheinungsbild und Verhalten des übergeordneten Containers, dem Panel-Steuerelement. Das Beispiel erfordert, dass Sie eine Instanz eines Panel Steuerelements TextBox, und Button. Platzieren Sie das Textfeld auf dem Panel, damit es mindestens einen der Ränder des Panels überlappt. 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 für den automatischen Bildlauf ist der Abstand zwischen allen untergeordneten Steuerelementen und den Rändern 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 die Größe des übergeordneten bildlauffähigen Steuerelements geändert wird oder die einzelnen untergeordneten Steuerelemente angezeigt werden, und wird verwendet, um zu bestimmen, ob Bildlaufleisten angezeigt werden müssen. Verankerte Steuerelemente werden von den Berechnungen ausgeschlossen, die bestimmen, ob Bildlaufleisten angezeigt werden müssen.
Hinweis
Wenn die Eigenschaft eines angedockten Steuerelements Dock auf "festgelegt" festgelegt DockStyle.Fillist, füllt das Steuerelement das übergeordnete bildlauffähige Steuerelement aus, und das angedockte Steuerelement wird ignoriert, wenn mithilfe der AutoScrollMargin Einstellung ermittelt wird, ob Bildlaufleisten erforderlich sind.
Wenn der Abstand vom Rand eines untergeordneten Steuerelements zum übergeordneten bildlauffähigen Steuerelement kleiner als der Wert ist, der der AutoScrollMargin Eigenschaft zugewiesen ist und die AutoScroll Eigenschaft auf true festgelegt ist, wird die entsprechende Bildlaufleiste angezeigt.
Hinweis
Es wird empfohlen, beim Andocken von Steuerelementen innerhalb eines bildlauffähigen Steuerelements ein untergeordnetes bildlauffähiges Steuerelement( z. B. ein Panel) hinzuzufügen, 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 DockStyle.Fill die und deren AutoScroll Eigenschaft festgelegt ist true. Sie sollten die AutoScroll Eigenschaft des übergeordneten bildlauffähigen Steuerelements auf falsefestlegen.
