Share via


SnapLine Clase

Definición

Representa los segmentos de línea horizontal y vertical que se crean dinámicamente en la interfaz de usuario para ayudar en el diseño de controles en un contenedor en tiempo de diseño. Esta clase no puede heredarse.

public ref class SnapLine sealed
public sealed class SnapLine
type SnapLine = class
Public NotInheritable Class SnapLine
Herencia
SnapLine

Comentarios

En la tabla siguiente se enumeran los modos comunes que admiten las herramientas de diseño visual para ayudarle a colocar y cambiar el tamaño de los controles en una superficie de diseño.

Mode Descripción
Formato libre. Le permite diseñar libremente controles.
Cuadrícula Muestra una cuadrícula superpuesta estática que le ayuda a diseñar controles.
Línea de ajuste Muestra líneas de guía que le ayudan a diseñar los controles del contenedor en relación entre sí. Las líneas de ajuste se originan en los controles y su contenedor.

La SnapLine clase y los tipos relacionados ayudan a admitir el modo Snapline.

Las líneas de ajuste se generan de forma dinámica y automática a medida que un borde de control se mueve cerca de otro control o cerca de los límites de su contenedor. Esto puede ocurrir cuando se agrega un control desde el cuadro de herramientas, o se mueve o cambia de tamaño mediante operaciones del mouse o comandos de teclado. Los controles suelen tener líneas de acoplamiento horizontales y verticales definidas; para los controles rectangulares, normalmente se extienden desde los cuatro bordes.

La SnapLine clase usa solo algunas propiedades para describir cada línea de ajuste, como se muestra en la tabla siguiente.

Propiedad Descripción
SnapLineType Especifica la ubicación y la dirección de la línea con respecto a su control asociado. Normalmente, solo las líneas de acoplamiento de tipos similares se alinearán automáticamente entre sí.
Offset Especifica la distancia en píxeles desde el origen, que es la esquina superior izquierda del control, hasta donde se inicia la línea de ajuste.
Priority Especifica la importancia relativa de la línea de ajuste. Durante cualquier punto de decisión de diseño determinado, solo se muestran las líneas de acoplamiento que están activas y tienen la prioridad más alta.
Filter Define categorías personalizadas de líneas de ajuste. Se trata de una cadena opcional.
IsHorizontal y IsVertical Indica si una línea de ajuste tiene orientación horizontal o vertical, respectivamente.

La ControlDesigner clase almacena las líneas de ajuste para su tipo de control correspondiente en la SnapLines propiedad . Este control de clases base de las líneas de ajuste será suficiente para la mayoría de los controles, ya que define las Leftlíneas de ajuste , RightTop, y Bottom , que se alinean a lo largo de los bordes del control. Al desarrollar un control personalizado, si esta organización predeterminada no es suficiente, invalide la SnapLines propiedad de la clase derivada de ControlDesigner. Por ejemplo, puede que desee alinear las líneas de acoplamiento horizontal de los controles basados en texto, como las etiquetas, con las líneas superior y base del texto (en lugar de los bordes superior e inferior del control).

La SnapLineType clase no se puede derivar de .

Hay una amplia compatibilidad con esta característica en Visual Studio, consulte Tutorial: Organizar controles en Windows Forms usar líneas de ajuste.

Constructores

SnapLine(SnapLineType, Int32)

Inicializa una nueva instancia de la clase SnapLine utilizando el tipo y el desplazamiento de la línea de ajuste especificados.

SnapLine(SnapLineType, Int32, SnapLinePriority)

Inicializa una nueva instancia de la clase SnapLine utilizando el tipo, el desplazamiento y la prioridad de la línea de ajuste especificados.

SnapLine(SnapLineType, Int32, String)

Inicializa una nueva instancia de la clase SnapLine utilizando el tipo, el desplazamiento y el nombre de filtro de la línea de ajuste especificados.

SnapLine(SnapLineType, Int32, String, SnapLinePriority)

Inicializa una nueva instancia de la clase SnapLine utilizando el tipo, el desplazamiento, el nombre de filtro y la prioridad de la línea de ajuste especificados.

Propiedades

Filter

Obtiene la categoría de filtro definida por el programador asociada a esta guía de alineación.

IsHorizontal

Obtiene un valor que indica si la guía de alineación tiene una orientación horizontal.

IsVertical

Obtiene un valor que indica si la guía de alineación tiene una orientación vertical.

Offset

Obtiene el número de píxeles que está desplazada la guía de alineación con respecto al origen del control asociado.

Priority

Obtiene un valor que indica la importancia relativa de la guía de alineación.

SnapLineType

Obtiene el tipo de una guía de alineación, que indica la ubicación general y la orientación.

Métodos

AdjustOffset(Int32)

Ajusta la propiedad Offset de la guía de alineación.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ShouldSnap(SnapLine, SnapLine)

Devuelve un valor que indica si la SnapLine especificada debe ajustarse a otra SnapLine.

ToString()

Devuelve una representación de cadena de la guía de alineación actual.

Se aplica a

Consulte también