SnapLine Classe
Definição
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 (interface do usuário) para auxiliar no layout de tempo de design dos controles em um contêiner. Essa classe não pode ser herdada.
public ref class SnapLine sealedpublic sealed class SnapLinetype SnapLine = classPublic 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.
| Modo | 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, 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 determinado ponto de decisão de layout, 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 as LeftRightlinhas de ajuste, e TopBottom , 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á amplo suporte para esse recurso no Visual Studio, consulte Passo a passo: Organizando controles em windows forms usando snaplines.
Construtores
| Nome | 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, deslocamento, nome do filtro e prioridade especificados. |
| SnapLine(SnapLineType, Int32, String) |
Inicializa uma nova instância da SnapLine classe usando o tipo de snapline, o deslocamento e o nome do filtro especificados. |
| SnapLine(SnapLineType, Int32) |
Inicializa uma nova instância da SnapLine classe usando o tipo de snapline e o deslocamento especificados. |
Propriedades
| Nome | Description |
|---|---|
| Filter |
Obtém a categoria de filtro definida pelo programador associada a este snapline. |
| IsHorizontal |
Obtém um valor que indica se o snapline tem uma orientação horizontal. |
| IsVertical |
Obtém um valor que indica se o snapline tem uma orientação vertical. |
| Offset |
Obtém o número de pixels que o snapline é deslocado da origem do controle associado. |
| Priority |
Obtém um valor que indica a importância relativa do snapline. |
| SnapLineType |
Obtém o tipo de um snapline, que indica a localização e a orientação gerais. |
Métodos
| Nome | 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 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 Objectatual. (Herdado de Object) |
| ShouldSnap(SnapLine, SnapLine) |
Retorna um valor que indica se o especificado SnapLine deve ajustar a outro SnapLine. |
| ToString() |
Retorna uma representação de cadeia de caracteres do snapline atual. |
