SnapLine Classe

Definição

Espaço de Nomes:
System.Windows.Forms.Design.Behavior
Assemblagem:
System.Design.dll

Representa os segmentos de linha horizontais e verticais que são criados dinamicamente na interface do utilizador (UI) para ajudar na disposição em tempo de design dos controlos num contentor. Esta 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

Observações

A tabela seguinte lista os modos comuns que as ferramentas de design visual suportam para o ajudar a posicionar e dimensionar os controlos numa superfície de design.

Mode Description
Forma livre Permite-te dispor os controlos livremente.
Grid Apresenta uma grelha estática sobreposta que ajuda a dispor os controlos.
Snapline Apresenta linhas de orientação que o ajudam a dispor os controlos do contentor em relação uns aos outros. Os snaplines originam-se dos controlos e do seu contentor.

A SnapLine classe e os tipos relacionados ajudam a suportar o modo Snapline.

As snaplines são geradas de forma dinâmica e automática à medida que uma aresta de controlo se aproxima de outro controlo ou perto dos limites do seu contentor. Isto pode ocorrer quando um controlo é adicionado a partir da caixa de ferramentas, ou movido ou redimensionado por operações do rato ou comandos de teclado. Os controlos normalmente têm definidas linhas de encaixe horizontais e verticais; para controlos retangulares, estes normalmente estendem-se a partir das quatro arestas.

A SnapLine classe utiliza apenas algumas propriedades para descrever cada snapline, como mostrado na tabela seguinte.

Property Description
SnapLineType Especifica a localização e direção da linha em relação ao seu controlo associado. Normalmente, apenas snaplines de tipos semelhantes se alinham automaticamente entre si.
Offset Especifica a distância em píxeis desde a origem, que é o canto superior esquerdo do controlo, até onde começa a snapline.
Priority Especifica a importância relativa do snapline. Durante qualquer ponto de decisão de layout, apenas as snaplines ativas e com maior prioridade são exibidas.
Filter Define categorias personalizadas de snaplines. Esta é uma corda opcional.
IsHorizontal e IsVertical Indica se um snapline tem, respetivamente, orientação horizontal ou vertical.

A ControlDesigner classe armazena snaplines para o seu tipo de controlo correspondente na SnapLines propriedade. Esta gestão de snaplines por classe base será suficiente para a maioria dos controlos, pois define os Left, Right, Top, e Bottom snaplines, que estão alinhados ao longo das arestas do controlo. Quando estiver a desenvolver um controlo personalizado, se esta organização padrão não for suficiente, sobrescrita a SnapLines propriedade da classe derivada de ControlDesigner. Por exemplo, pode querer alinhar as linhas horizontais dos controlos baseados em texto, como rótulos, com as linhas superior e base do texto (em vez das bordas superior e inferior do controlo).

A SnapLineType classe não pode ser derivada de.

Existe um suporte extenso para esta funcionalidade em Visual Studio, veja Walkthrough: Arranging Controls on Windows Forms Using Snaplines.

Construtores

Name Description
SnapLine(SnapLineType, Int32, SnapLinePriority)

Inicializa uma nova instância da SnapLine classe usando o tipo de snapline, deslocamento e prioridade especificados.
SnapLine(SnapLineType, Int32, String, SnapLinePriority)

Inicializa uma nova instância da SnapLine classe usando o tipo de snapline especificado, deslocamento, nome do filtro e prioridade.
SnapLine(SnapLineType, Int32, String)

Inicializa uma nova instância da SnapLine classe usando o tipo de snapline especificado, o deslocamento e o nome do filtro.
SnapLine(SnapLineType, Int32)

Inicializa uma nova instância da SnapLine classe usando o tipo e deslocamento de snapline especificados.

Propriedades

Name Description
Filter

Obtém a categoria de filtro definida pelo programador associada a esta snapline.
IsHorizontal

Obtém um valor que indica se a linha de snap tem uma orientação horizontal.
IsVertical

Obtém um valor que indica se a linha de snap tem orientação vertical.
Offset

Obtém o número de píxeis em que a snapline está deslocada da origem do controlo associado.
Priority

Recebe um valor que indica a importância relativa da linha de pressão.
SnapLineType

Obtém o tipo de snapline, que indica a localização geral e orientação.

Métodos

Name Description
AdjustOffset(Int32)

Ajusta a Offset propriedade do snapline.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ShouldSnap(SnapLine, SnapLine)

Devolve um valor que indica se o especificado SnapLine deve encaixar para outro SnapLine.
ToString()

Devolve uma representação de string da snapline atual.

Aplica-se a

Ver também