ControlCollection.GetShapeForControl(Control) Método

Definição

Obtém o Shape subjacente para o controle especificado.

public Microsoft.Office.Interop.Word.Shape GetShapeForControl (System.Windows.Forms.Control control);

Parâmetros

control
Control

O controle na instância ControlCollection da qual você deseja obter o Shape.

Retornos

Shape

O Shape subjacente para o controle especificado.

Exemplos

O exemplo de código a seguir adiciona um Button ao documento e, em seguida, usa o GetShapeForControl método para obter o local do controle de seu subjacente Shape .

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());
    }
}
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

Comentários

Se o estilo de disposição do controle for definido como alinhado com o texto, o GetShapeForControl método retornará null .

Aplica-se a