Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Propiedad ScrollableControl.AutoScrollMargin

 

Publicado: noviembre de 2016

Obtiene o establece el tamaño del margen de desplazamiento automático.

Espacio de nombres:   System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)

public Size AutoScrollMargin { get; set; }

Valor de propiedad

Type: System.Drawing.Size

Un Size que representa el alto y ancho del margen de desplazamiento automático en píxeles.

Exception Condition
ArgumentOutOfRangeException

El Height o Width valor asignado es menor que 0.

El margen de desplazamiento automático es la distancia entre cualquier control secundario y los bordes del control primario desplazable. El AutoScrollMargin tamaño se agrega al tamaño de los controles secundarios incluidos en el control desplazable para determinar si se necesitan barras de desplazamiento. El AutoScrollMargin propiedad se evalúa cuando se cambia el tamaño del control primario desplazable o los controles secundarios individuales se incluyen en la vista y se utiliza para determinar si se deben mostrar barras de desplazamiento. Los controles acoplados se excluyen de los cálculos que determinan si se deben mostrar barras de desplazamiento.

System_CAPS_noteNota

Si un control acoplado Dock propiedad se establece en DockStyle.Fill, el control llena el control primario desplazable y se omite el control acoplado al utilizar el AutoScrollMargin para determinar si son necesarias las barras de desplazamiento.

Si la distancia desde el borde de un control secundario para el control primario desplazable es menor que el valor asignado a la AutoScrollMargin propiedad y AutoScroll propiedad se establece en true, se muestra la barra de desplazamiento apropiada.

System_CAPS_noteNota

Se recomienda, al acoplar controles en un control desplazable, agregar un control secundario desplazable, como un Panel, para contener cualquier otro control que requiera desplazamiento. Debe agregar el elemento secundario Panel control en el control desplazable y su Dock propiedad establecida en DockStyle.Fill y su AutoScroll propiedad establecida en true. Debe establecer el AutoScroll propiedad del control primario desplazable a false.

En el ejemplo de código siguiente se utiliza la clase derivada, Panel. El ejemplo se evalúa como la ubicación de un cuadro de texto y cambia la apariencia y el comportamiento de su contenedor primario, el control de panel. El ejemplo requiere que haya creado una instancia de un Panel control, TextBox, y Button. Coloque el cuadro de texto en el panel de forma que se solape al menos uno de los bordes del panel. Llame a esta función al hacer clic en un botón para ver la diferencia en el comportamiento y la apariencia del panel.

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);
       }
    }
 }

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: