Freigeben über


ControlCollection.GetInlineShapeForControl-Methode

Ruft das zugrunde liegende InlineShape für das angegebene Steuerelement ab.

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

Syntax

'Declaration
Function GetInlineShapeForControl ( _
    control As Control _
) As InlineShape
InlineShape GetInlineShapeForControl(
    Control control
)

Parameter

Rückgabewert

Typ: Microsoft.Office.Interop.Word.InlineShape
Das zugrunde liegende InlineShape für das angegebene Steuerelement.

Hinweise

Wenn für die Umbruchart des Steuerelements nicht Mit Text in Zeile festgelegt ist, gibt die GetInlineShapeForControl-Methode nullein Nullverweis (Nothing in Visual Basic) zurück.

Beispiele

Im folgenden Codebeispiel wird dem Dokument ein Button hinzugefügt, sodass für das Dokument die Umbruchart "Mit Text in Zeile" verwendet wird.Der Code ruft anschließend die GetInlineShapeForControl-Methode auf, um die Position des Steuerelements aus dem zugrunde liegenden InlineShape abzurufen.

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

.NET Framework-Sicherheit

Siehe auch

Referenz

ControlCollection Schnittstelle

Microsoft.Office.Tools.Word-Namespace