SnapLine Classe

Referência

Definição

Namespace:: System.Windows.Forms.Design.Behavior

Assembly:: System.Design.dll

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

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa os segmentos de linha horizontal e vertical que são criados dinamicamente na interface do usuário para ajudar no layout em tempo de design dos controles em um contêiner. Essa classe não pode ser herdada.

public ref class SnapLine sealed

public sealed class SnapLine

type SnapLine = class

Public NotInheritable Class SnapLine

Herança: Object
SnapLine

Comentários

A tabela a seguir lista os modos comuns aos quais as ferramentas de design visual dão suporte para ajudá-lo com controles de posicionamento e dimensionamento em uma superfície de design.

Mode	Descrição
Forma livre	Permite que você disponha os controles livremente.
Grid	Exibe uma grade sobreposta estática que ajuda você a definir controles.
Snapline	Exibe linhas de guia que ajudam você a definir os controles do contêiner em relação uns aos outros. Os snaplines se originam de controles e seu contêiner.

A SnapLine classe e os tipos relacionados ajudam a dar suporte ao modo Snapline.

Os snaplines são gerados dinamicamente e automaticamente à medida que uma borda de controle se move perto de outro controle ou perto dos limites de seu contêiner. Isso pode ocorrer quando um controle é adicionado da caixa de ferramentas ou movido ou redimensionado por operações de mouse ou comandos de teclado. Os controles normalmente têm snaplines horizontais e verticais definidos; para controles retangulares, eles normalmente se estendem de todas as quatro bordas.

A SnapLine classe usa apenas algumas propriedades para descrever cada snapline, conforme mostrado na tabela a seguir.

Propriedade	Descrição
SnapLineType	Especifica o local e a direção da linha em relação ao controle associado. Normalmente, apenas snaplines de tipos semelhantes se alinham automaticamente entre si.
Offset	Especifica a distância em pixels da origem, que é o canto superior esquerdo do controle, até onde o snapline é iniciado.
Priority	Especifica a importância relativa do snapline. Durante qualquer determinado ponto de decisão de layout, somente as linhas de ajuste que estão ativas e têm a maior prioridade são exibidas.
Filter	Define categorias personalizadas de snaplines. Essa é uma cadeia de caracteres opcional.
IsHorizontal e IsVertical	Indica se um snapline tem orientação horizontal ou vertical, respectivamente.

A ControlDesigner classe armazena snaplines para seu tipo de controle correspondente na SnapLines propriedade. Esse tratamento de classe base de snaplines será suficiente para a maioria dos controles, pois define as Left Right Toplinhas de ajuste, e Bottom , que são alinhadas ao longo das bordas do controle. Quando você estiver desenvolvendo um controle personalizado, se essa organização padrão não for suficiente, substitua a SnapLines propriedade da classe derivada de ControlDesigner. Por exemplo, talvez você queira alinhar os snaplines horizontais de controles baseados em texto, como rótulos, com as linhas superior e base do texto (em vez das bordas superior e inferior do controle).

A SnapLineType classe não pode ser derivada.

Há um amplo suporte para esse recurso em Visual Studio, consulte Passo a passo: Organizando controles em Windows Forms usando snaplines.

Construtores

SnapLine(SnapLineType, Int32)	Inicializa uma nova instância da classe SnapLine usando o tipo de guia de alinhamento e deslocamento especificados.
SnapLine(SnapLineType, Int32, SnapLinePriority)	Inicializa uma nova instância da classe SnapLine usando o tipo de guia de alinhamento, o deslocamento e a prioridade especificados.
SnapLine(SnapLineType, Int32, String)	Inicializa uma nova instância da classe SnapLine usando o tipo de guia de alinhamento, o deslocamento e o nome do filtro especificados.
SnapLine(SnapLineType, Int32, String, SnapLinePriority)	Inicializa uma nova instância da classe SnapLine usando o tipo de guia de alinhamento, o deslocamento, o nome do filtro e a prioridade especificados.

Propriedades

Filter	Obtém a categoria de filtro definida pelo programador associada a esta guia de alinhamento.
IsHorizontal	Obtém um valor que indica se a guia de alinhamento tem uma orientação horizontal.
IsVertical	Obtém um valor que indica se a guia de alinhamento tem uma orientação vertical.
Offset	Obtém o número de pixels de deslocamento da guia de alinhamento em relação à origem do controle associado.
Priority	Obtém um valor que indica a importância relativa da guia de alinhamento.
SnapLineType	Obtém o tipo de guia de alinhamento, que indica o local e a orientação gerais.

Métodos

AdjustOffset(Int32)	Ajusta a propriedade Offset da guia de alinhamento.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ShouldSnap(SnapLine, SnapLine)	Retorna um valor que indica se o SnapLine especificado deve ser encaixado em outro SnapLine.
ToString()	Retorna uma representação de cadeia de caracteres da guia de alinhamento atual.

Aplica-se a

Share via