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 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 Left Right Toplignes 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 à

Partager via