ScrollableControl.AutoScrollMargin Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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, set

Public Property AutoScrollMargin As Size

Eigenschaftswert

Size

Eine Size, die die Höhe und Breite des AutoBildlaufrands in Pixel darstellt.

Ausnahmen

ArgumentOutOfRangeException

Der zugewiesene Height-Wert oder Width-Wert ist kleiner als 0 (null).

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.

Gilt für

Teilen über