ScrollableControl.SetAutoScrollMargin(Int32, Int32) Methode

Definition

Legt die Größe des AutoBildlaufrandes fest.Sets the size of the auto-scroll margins.

public:
 void SetAutoScrollMargin(int x, int y);
public void SetAutoScrollMargin (int x, int y);
member this.SetAutoScrollMargin : int * int -> unit
Public Sub SetAutoScrollMargin (x As Integer, y As Integer)

Parameter

x
Int32

Der Width-Wert.The Width value.

y
Int32

Der Height-Wert.The Height value.

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 Feld im Bereich, sodass es mindestens einen der Kanten des Bereichs überlappt.Place the 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 unter Prozedur aufgerufen, um den Unterschied im Verhalten und der Darstellung des Panels anzuzeigen.Call this subprocedure on the click of a button to see the difference in the panel's behavior and appearance.

void MySub()
{
   /* 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 MySub()
 {
    /* 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 MySub()
    ' 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 legt die Breite und Höhe des Rahmens um die einzelnen Steuerelemente fest.The margin sets the width and height of the border around each control. Dieser Rand wird verwendet, um zu bestimmen, wann Bild Lauf leisten im Container benötigt werden und wo Sie scrollen, wenn ein Steuerelement ausgewählt wird.This margin is used to determine when scroll bars are needed on the container and where to scroll to when a control is selected.

Hinweis

Wenn eine negative Zahl als der-Wert oder x y der-Wert übermittelt wird, wird der Wert auf 0 zurückgesetzt.If a negative number is passed in as the x or y values, the value will be reset to 0.

Gilt für:

Siehe auch