Método ControlCollection.GetInlineShapeForControl

Artigo
05/21/2013

Obtém InlineShape 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 GetInlineShapeForControl ( _
    control As Control _
) As InlineShape

InlineShape GetInlineShapeForControl(
    Control control
)

Parâmetros

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

Valor de retorno

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

Comentários

Se o estilo de automática de controle não é definido como Alinhado com o Texto, o método de GetInlineShapeForControl retorna nulluma referência nula (Nothing no Visual Basic).

Exemplos

O exemplo de código a seguir adiciona Button ao documento de modo que o estilo é embutido com quebra automática de texto.O código chama o método de GetInlineShapeForControl para obter o local do controle do InlineShapesubjacente.

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