Propriedade Shape.Anchor

Artigo
05/17/2015

Obtém ou define as bordas do contêiner ao qual uma forma é associada e determina como uma forma é redimensionada quando seu pai é redimensionado.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (em Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxe

'Declaração
Public Overridable Property Anchor As AnchorStyles

public virtual AnchorStyles Anchor { get; set; }

public:
virtual property AnchorStyles Anchor {
    AnchorStyles get ();
    void set (AnchorStyles value);
}

abstract Anchor : AnchorStyles with get, set 
override Anchor : AnchorStyles with get, set

function get Anchor () : AnchorStyles 
function set Anchor (value : AnchorStyles)

Valor de propriedade

Tipo: AnchorStyles
Uma combinação bit a bit dos valores AnchorStyles.O padrão é Top e Left.

Comentários

Use o Anchor propriedade para definir como uma forma é redimensionada automaticamente quando o controle pai é redimensionado. Ancoragem uma forma para o controle pai garante que as bordas ancoradas permanecem na mesma posição em relação às bordas do controle pai quando o controle pai é redimensionado.

Você pode ancorar uma forma para uma ou mais bordas do seu contêiner. Por exemplo, suponha que você tenha um Form que contém um RectangleShape cujo Anchor o valor da propriedade é definido como Top e Bottom. O RectangleShape é estendido para manter a distância entre as bordas superior e inferior da Form como o Height do Form é aumentado.

Observações para herdeiros

Quando você substitui o Anchor propriedade em uma classe derivada, use a classe base Anchor propriedade estender a implementação base. Caso contrário, você deve fornecer todos a implementação. Você não precisa substituir ambos os get e set acessadores do Anchor propriedade; Você pode substituir apenas um, se for necessário.

Exemplos

O exemplo a seguir mostra como usar o Anchor propriedade redimensionar formas quando um formulário é redimensionado. Esse exemplo requer que você tenha dois ou mais controles forma ou linha em um formulário.

Private Sub ResizeShapes()
    ' Loop through the ShapeCollection. 
    For Each shape As PowerPacks.Shape In ShapeContainer1.Shapes
        ' Set the Anchor property.
        shape.Anchor = AnchorStyles.Bottom Or AnchorStyles.Left Or
          AnchorStyles.Right Or AnchorStyles.Top
    Next 
End Sub

private void ResizeShapes()
{
    // Loop through the ShapeCollection. 
    foreach (Shape shape in shapeContainer1.Shapes)
    {
        // Set the Anchor property.
        shape.Anchor = AnchorStyles.Bottom | AnchorStyles.Left | 
            AnchorStyles.Right | AnchorStyles.Top;
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.