Propriedade Shape.Anchor

Artigo
10/26/2012

Obtém ou define as bordas do recipiente ao qual uma forma está vinculada 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: System.Windows.Forms.AnchorStyles
Uma combinação bit a bit da AnchorStyles valores.The default is Top and Left.

Comentários

Use o Anchor propriedade para definir como uma forma é redimensionada automaticamente quando o controle pai é redimensionado.Ancoragem de 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 recipiente.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 está estendido para manter a distância entre as bordas superior e inferior da Form como o Height da Form é aumentado.

Observações para herdeiros

Quando você substituir o Anchor propriedade em uma classe derivada, use a classe base Anchor propriedade para estender a implementação base.Caso contrário, você deve fornecer todas as a implementação.Não é necessário para substituir a ambos os get e set acessadores da Anchor propriedade; Você pode substituir apenas uma, se for necessário.

Exemplos

O exemplo a seguir mostra como usar o Anchor propriedade para redimensionar as formas, quando um formulário é redimensionado.Este 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áveis.