ScrollableControl.AutoScrollMargin Eigenschaft

Definition

Ruft die Größe des AutoBildlaufrandes ab oder legt diese fest.Gets or sets the size of the auto-scroll margin.

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

Eine Size, die die Höhe und Breite des AutoBildlaufrands in Pixel darstellt.A Size that represents the height and width of the auto-scroll margin in pixels.

Ausnahmen

Der zugewiesene Height-Wert oder Width-Wert ist kleiner als 0 (null).The Height or Width value assigned is less than 0.

Beispiele

Im folgenden Codebeispiel wird Paneldie abgeleitete-Klasse verwendet.The following code example uses the derived class, Panel. Im Beispiel wird der Speicherort eines Textfelds ausgewertet und die Darstellung und das Verhalten des übergeordneten Containers, das Panel-Steuerelement, geändert.The example evaluates the location of a text box and changes the appearance and behavior of its parent container, the panel control. Für das Beispiel ist es erforderlich, dass Sie eine Instanz Panel eines- TextBoxSteuer Elements Button, und erstellt haben.The example requires that you have created an instance of a Panel control, TextBox, and Button. Platzieren Sie das Textfeld im Bereich, sodass es mindestens einen der Kanten des Bereichs überlappt.Place the text box on the panel so that it overlaps at least one of the panel's edges. Wenn Sie auf eine Schaltfläche klicken, wird diese Funktion aufgerufen, um den Unterschied im Verhalten und der Darstellung des Panels anzuzeigen.Call this function on the click of a button to see the difference in the panel's behavior and appearance.

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 Auto Bild Lauf Rand ist der Abstand zwischen allen untergeordneten Steuerelementen und den Rändern des Bild lauffähigen übergeordneten Steuer Elements.The auto-scroll margin is the distance between any child controls and the edges of the scrollable parent control. Die AutoScrollMargin Größe wird der Größe aller untergeordneten Steuerelemente im scrollfähigen Steuerelement hinzugefügt, um zu bestimmen, ob Schiebe leisten benötigt werden.The AutoScrollMargin size is added to the size of any child controls contained in the scrollable control to determine whether or not scroll bars are needed. Die AutoScrollMargin -Eigenschaft wird ausgewertet, wenn die Größe des übergeordneten Bild lauffähigen Steuer Elements geändert wird oder die einzelnen untergeordneten Steuerelemente in der Ansicht angezeigt werden. mithilfe von wird bestimmt, ob Schiebe leisten angezeigt werden müssenThe AutoScrollMargin property is evaluated when the parent scrollable control is resized or the individual child controls are brought into view, and is used to determine if scroll bars must be displayed. Angedockte Steuerelemente werden aus den Berechnungen ausgeschlossen, die bestimmen, ob Bild Lauf leisten angezeigt werden müssen.Docked controls are excluded from the calculations that determine if scroll bars must be displayed.

Hinweis

Wenn die- Dock Eigenschaft eines angedockten Steuer Elements DockStyle.Fillauf festgelegt ist, füllt das Steuerelement das übergeordnete scrollfähige Steuerelement aus, und AutoScrollMargin das angedockte Steuerelement wird ignoriert, wenn verwendet wird, um zu bestimmen, ob Schiebe leistenIf a docked control's Dock property is set to DockStyle.Fill, the control fills the parent scrollable control and the docked control is ignored when using the AutoScrollMargin to determine whether scroll bars are needed.

Wenn der Abstand zwischen dem Rand eines untergeordneten Steuer Elements und dem übergeordneten scrollfähigen Steuerelement kleiner ist als der Wert AutoScrollMargin , der der AutoScroll -Eigenschaft zugewiesen ist true, und die-Eigenschaft auf festgelegt ist, wird die entsprechende Bild Lauf Leiste angezeigt.If the distance from the edge of a child control to the parent scrollable control is less than the value assigned to the AutoScrollMargin property and the AutoScroll property is set to true, the appropriate scroll bar is displayed.

Hinweis

Beim Andocken von Steuerelementen in einem Bild lauffähigen Steuerelement wird empfohlen, dass Sie ein unter Panelgeordnetes scrollbares Steuerelement hinzufügen, z. b. ein, um alle anderen Steuerelemente zu enthalten,We recommend, when docking controls within a scrollable control, that you add a child scrollable control, such as a Panel, to contain any other controls that might require scrolling. Panel Sie sollten das untergeordnete Steuerelement dem Bild lauffähigen Steuerelement DockStyle.Fill hinzufügen AutoScroll und dessen Dock - trueEigenschaft auf und die-Eigenschaft auf festgelegtYou should add the child Panel control to the scrollable control and its Dock property set to DockStyle.Fill and its AutoScroll property set to true. Legen Sie die AutoScroll -Eigenschaft des übergeordneten Bild lauffähigen-Steuer falseElements auf fest.You should set the AutoScroll property of the parent scrollable control to false.

Gilt für:

Siehe auch