SnapLine Classe

Définition

Représente les segments de ligne horizontaux et verticaux créés dynamiquement dans l’interface utilisateur pour faciliter la disposition des contrôles dans un conteneur au moment du design. Cette classe ne peut pas être héritée.

public ref class SnapLine sealed
public sealed class SnapLine
type SnapLine = class
Public NotInheritable Class SnapLine
Héritage
SnapLine

Remarques

Le tableau suivant répertorie les modes courants pris en charge par les outils de conception visuelle pour vous aider à positionner et dimensionnement les contrôles sur une aire de conception.

Mode Description
Forme libre Vous permet de disposer librement des contrôles.
Grille Affiche une grille superposée statique qui vous aide à disposer des contrôles.
Alignement Affiche des lignes de repère qui vous aident à disposer les contrôles du conteneur les uns par rapport aux autres. Les lignes d’alignement proviennent de contrôles et de leur conteneur.

La SnapLine classe et les types associés prennent en charge le mode Snapline.

Les lignes d’alignement sont générées dynamiquement et automatiquement quand un bord de contrôle se déplace près d’un autre contrôle ou près des limites de son conteneur. Cela peut se produire lorsqu’un contrôle est ajouté à partir de la boîte à outils, ou déplacé ou redimensionné par des opérations de la souris ou des commandes du clavier. Les contrôles ont généralement des lignes d’alignement horizontales et verticales définies ; pour les contrôles rectangulaires, ceux-ci s’étendent généralement à partir des quatre bords.

La SnapLine classe n’utilise que quelques propriétés pour décrire chaque ligne d’alignement, comme indiqué dans le tableau suivant.

Propriété Description
SnapLineType Spécifie l’emplacement et la direction de la ligne par rapport au contrôle associé. En règle générale, seules les lignes d’alignement de types similaires s’alignent automatiquement les unes sur les autres.
Offset Spécifie la distance en pixels de l’origine, qui est le coin supérieur gauche du contrôle, à l’emplacement de démarrage de l’alignement.
Priority Spécifie l’importance relative de la ligne d’alignement. Au cours d’un point de décision de disposition donné, seules les lignes d’alignement actives et ayant la priorité la plus élevée sont affichées.
Filter Définit des catégories personnalisées de lignes d’alignement. Il s’agit d’une chaîne facultative.
IsHorizontal et IsVertical Indique si une ligne d’alignement a une orientation horizontale ou verticale, respectivement.

La ControlDesigner classe stocke les lignes d’alignement pour son type de contrôle correspondant dans la SnapLines propriété . Cette gestion par classe de base des lignes d’alignement suffit pour la majorité des contrôles, car elle définit les LeftRightToplignes d’alignement , , etBottom, qui sont alignées le long des bords du contrôle. Lorsque vous développez un contrôle personnalisé, si cette organisation par défaut ne suffit pas, remplacez la SnapLines propriété de la classe dérivée de ControlDesigner. Par exemple, vous pouvez aligner les alignements horizontaux des contrôles textuels, tels que les étiquettes, avec les lignes supérieures et de base du texte (au lieu des bords supérieur et inférieur du contrôle).

La SnapLineType classe ne peut pas être dérivée de .

Il existe une prise en charge étendue de cette fonctionnalité dans Visual Studio. Consultez Procédure pas à pas : Organiser des contrôles sur Windows Forms à l’aide de lignes d’alignement.

Constructeurs

SnapLine(SnapLineType, Int32)

Initialise une nouvelle instance de la classe SnapLine en utilisant le type et l'offset de ligne d'alignement (SnapLine) spécifiés.

SnapLine(SnapLineType, Int32, SnapLinePriority)

Initialise une nouvelle instance de la classe SnapLine en utilisant le type, l'offset et la priorité de ligne d'alignement (SnapLine) spécifiés.

SnapLine(SnapLineType, Int32, String)

Initialise une nouvelle instance de la classe SnapLine en utilisant le type, l'offset et le nom de filtre de ligne d'alignement (SnapLine) spécifiés.

SnapLine(SnapLineType, Int32, String, SnapLinePriority)

Initialise une nouvelle instance de la classe SnapLine en utilisant le type, l'offset, le nom de filtre et la priorité de ligne d'alignement (SnapLine) spécifiés.

Propriétés

Filter

Obtient la catégorie de filtres définie par le programmeur associée à cette ligne d'alignement (SnapLine).

IsHorizontal

Obtient une valeur qui indique si la ligne d'alignement (SnapLine) présente une orientation horizontale.

IsVertical

Obtient une valeur qui indique si la ligne d'alignement (SnapLine) présente une orientation verticale.

Offset

Obtient le nombre des pixels qui constitue l'offset de la ligne d'alignement (SnapLine) par rapport au point d'origine du contrôle associé.

Priority

Obtient une valeur qui indique l'importance relative de la ligne d'alignement.

SnapLineType

Obtient le type d'une ligne d'alignement (SnapLine) qui indique l'emplacement et l'orientation généraux.

Méthodes

AdjustOffset(Int32)

Ajuste la propriété Offset de la ligne d'alignement (SnapLine).

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ShouldSnap(SnapLine, SnapLine)

Retourne une valeur qui indique si le SnapLine spécifié doit s'aligner sur un autre SnapLine.

ToString()

Retourne une représentation de type chaîne de la ligne d'alignement (SnapLine) actuelle.

S’applique à

Voir aussi