SnapLine Classe

Référence

Définition

Espace de noms:: System.Windows.Forms.Design.Behavior

Assembly:: System.Design.dll

Assembly:: System.Windows.Forms.Design.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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: Object
SnapLine

Remarques

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

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

La SnapLine classe et les types associés permettent de prendre en charge le mode Snapline.

Les lignes d’alignement sont générées dynamiquement et automatiquement à mesure qu’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 souris ou des commandes de 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 des quatre bords.

La SnapLine classe utilise seulement 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 à son contrôle associé. En règle générale, seuls 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 l’angle supérieur gauche du contrôle, jusqu’à l’emplacement où démarre la ligne d’alignement.
Priority	Spécifie l’importance relative du snapline. Pendant tout point de décision de disposition donné, seuls les lignes d’alignement actives et dont la priorité est 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 de classe de base des lignes d’alignement suffit pour la majorité des contrôles, car elle définit les Leftlignes d’alignement Right Top, et Bottom les lignes d’alignement, 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 lignes d’alignement horizontales 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.

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 à