ScrollableControl.AutoScrollMargin ScrollableControl.AutoScrollMargin ScrollableControl.AutoScrollMargin ScrollableControl.AutoScrollMargin Property

Definición

Obtiene o establece el tamaño del margen de desplazamiento automático.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

Valor de propiedad

Size que representa el alto y ancho en píxeles del margen de desplazamiento automático.A Size that represents the height and width of the auto-scroll margin in pixels.

Excepciones

El valor de las propiedades Height o Width asignado es menor que 0.The Height or Width value assigned is less than 0.

Ejemplos

En el ejemplo de código siguiente se usa la Panelclase derivada,.The following code example uses the derived class, Panel. En el ejemplo se evalúa la ubicación de un cuadro de texto y se cambia la apariencia y el comportamiento de su contenedor primario, el control de panel.The example evaluates the location of a text box and changes the appearance and behavior of its parent container, the panel control. El ejemplo requiere que se haya creado una instancia de un Panel control, TextBoxy Button.The example requires that you have created an instance of a Panel control, TextBox, and Button. Coloque el cuadro de texto en el panel para que se superponga al menos a uno de los bordes del panel.Place the text box on the panel so that it overlaps at least one of the panel's edges. Llame a esta función al hacer clic en un botón para ver la diferencia en el comportamiento y la apariencia del panel.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

Comentarios

El margen de desplazamiento automático es la distancia entre cualquier control secundario y los bordes del control principal desplazable.The auto-scroll margin is the distance between any child controls and the edges of the scrollable parent control. El AutoScrollMargin tamaño se agrega al tamaño de los controles secundarios contenidos en el control desplazable para determinar si se necesitan o no barras de desplazamiento.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. La AutoScrollMargin propiedad se evalúa cuando se cambia el tamaño del control desplazable primario o los controles secundarios individuales se muestran en la vista, y se usa para determinar si se deben mostrar las barras de desplazamiento.The 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. Los controles acoplados se excluyen de los cálculos que determinan si se deben mostrar las barras de desplazamiento.Docked controls are excluded from the calculations that determine if scroll bars must be displayed.

Nota

Si la propiedad de Dock un control acoplado se establece en DockStyle.Fill, el control rellena el control desplazable primario y AutoScrollMargin se omite el control acoplado al utilizar para determinar si se necesitan barras de desplazamiento.If 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.

Si la distancia desde el borde de un control secundario al control desplazable primario es menor que el valor asignado a la AutoScrollMargin propiedad y la AutoScroll propiedad está establecida en true, se muestra la barra de desplazamiento adecuada.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.

Nota

Se recomienda que, al acoplar controles dentro de un control desplazable, agregue un control desplazable secundario, Panelcomo, para que contenga otros controles que puedan requerir desplazamiento.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. Debe agregar el control secundario Panel al control desplazable y su Dock propiedad establecida en DockStyle.Fill y su AutoScroll propiedad establecida en true.You 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. Debe establecer la AutoScroll propiedad del control desplazable primario en false.You should set the AutoScroll property of the parent scrollable control to false.

Se aplica a

Consulte también: