Método ControlCollection.GetShapeForControl

Artigo
05/21/2013

Obtém Shape subjacente para o controle específico.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)

Sintaxe

'Declaração
Function GetShapeForControl ( _
    control As Control _
) As Shape

Shape GetShapeForControl(
    Control control
)

Parâmetros

control
Tipo: System.Windows.Forms.Control
O controle de ControlCollection na instância de que você deseja obter Shape.

Valor de retorno

Tipo: Microsoft.Office.Interop.Word.Shape
Shape subjacente para o controle específico.

Comentários

Se o estilo de quebra automática do controle é definida como Alinhado com o Texto, o método de GetShapeForControl retorna nulluma referência nula (Nothing no Visual Basic).

Exemplos

O exemplo de código a seguir adiciona Button ao documento, e usa o método de GetShapeForControl para obter o local do controle do Shapesubjacente.

Private Sub WordGetShape()
    Dim testButton As Microsoft.Office.Tools.Word.Controls.Button = _
        Me.Controls.AddButton(10, 10, 50, 25, "testButton")

    Dim buttonShape As Microsoft.Office.Interop.Word.Shape = _
            Me.Controls.GetShapeForControl(testButton)

    If buttonShape IsNot Nothing Then
        MessageBox.Show("The following properties can be cached in the" & _
            vbCrLf & "document to enable you to recreate the control:" _
            & vbCrLf & vbCrLf & "Height: " & buttonShape.Height _
            & vbCrLf & "Width: " & buttonShape.Width _
            & vbCrLf & "Top: " & buttonShape.Top _
            & vbCrLf & "Left: " & buttonShape.Left)
    End If
End Sub

private void WordGetShape()
{
    Microsoft.Office.Tools.Word.Controls.Button testButton =
        this.Controls.AddButton(10, 10, 50, 25, "testButton");

    Microsoft.Office.Interop.Word.Shape buttonShape =
        this.Controls.GetShapeForControl(testButton);

    if (buttonShape != null)
    {
        MessageBox.Show("The following properties can be cached in the" +
            "\n" + "document to enable you to recreate the control:" +
            "\n\n" + "Height: " + buttonShape.Height.ToString() +
            "\n" + "Width: " + buttonShape.Width.ToString() + "\n" +
            "Top: " + buttonShape.Top.ToString() + "\n" +
            "Left: " + buttonShape.Left.ToString());
    }
}

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.

Consulte também

Referência

ControlCollection Interface

Namespace Microsoft.Office.Tools.Word

Compartilhar via