SnapLine Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 sealedpublic sealed class SnapLinetype SnapLine = classPublic 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 las líneas de guía que le ayudan a diseñar los controles del contenedor en relación entre sí. Las líneas de acoplamiento se originan en los controles y en 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 ajuste 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, a 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 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 bastará para la mayoría de los controles, ya que define las Leftlíneas de ajuste , Right, Topy 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 ajuste horizontales de controles basados en texto, como 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 formularios Windows Forms mediante 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. |
