Compartilhar via


SnapLine Classe

Definição

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
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 livremente os controles.
Grid Exibe uma grade sobreposta estática que ajuda você a estabelecer 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, somente os snaplines de tipos semelhantes se alinharão 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 ponto de decisão de layout determinado, somente as linhas de ajuste que estão ativas e têm a prioridade mais alta 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 os Leftsnaplines , Right, Tope Bottom , que são alinhados 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 de .

Há um amplo suporte para esse recurso no Visual Studio, consulte Passo a passo: Organizando controles nos 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

Confira também