Método ControlCollection.GetInlineShapeForControl

Artigo
08/01/2011

Obtém a base InlineShape para o controle especificado.

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

Sintaxe

'Declaração
Function GetInlineShapeForControl ( _
    control As Control _
) As InlineShape

InlineShape GetInlineShapeForControl(
    Control control
)

Parâmetros

control
Tipo: System.Windows.Forms.Control
O controle no ControlCollection instância a partir do qual você deseja obter o InlineShape.

Valor de retorno

Tipo: Microsoft.Office.Interop.Word.InlineShape
Base InlineShape para o controle especificado.

Comentários

Se a disposição do controle não é definida para alinhado com o texto, o GetInlineShapeForControl método retorna nulluma referência nula (Nothing no Visual Basic).

Exemplos

O exemplo de código a seguir adiciona um Button o documento para que sua disposição do texto seja alinhado com texto. O código, em seguida, chama o GetInlineShapeForControl método para obter a localização do controle de sua base InlineShape.

Private Sub WordGetInlineShape()
    Dim testButton As Microsoft.Office.Tools.Word.Controls.Button = _
        Me.Controls.AddButton(Me.Paragraphs(1).Range, 50, 25, "testButton")

    Dim buttonShape As Microsoft.Office.Interop.Word.InlineShape = _
            Me.Controls.GetInlineShapeForControl(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 & "Range: position " & _
            buttonShape.Range.Start.ToString _
            & " through " & buttonShape.Range.End.ToString _
            & vbCrLf & "Width: " & buttonShape.Width.ToString _
            & vbCrLf & "Height: " & buttonShape.Height.ToString)
    End If
End Sub

private void WordGetInlineShape()
{
    Microsoft.Office.Tools.Word.Controls.Button testButton =
        this.Controls.AddButton(this.Paragraphs[1].Range, 50, 25,
        "testButton");

    Microsoft.Office.Interop.Word.InlineShape buttonShape =
        this.Controls.GetInlineShapeForControl(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" + "Range: position " + buttonShape.Range.Start.
            ToString() + "through " + buttonShape.Range.End.ToString()
            + "\n" + "Width: " + buttonShape.Width.ToString() + "\n" +
            "Height: " + buttonShape.Height.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