ControlCollection.GetInlineShapeForControl-Methode

Artikel
05/07/2013

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

control
Typ: System.Windows.Forms.Control
Das Steuerelement in der ControlCollection-Instanz, aus dem Sie das InlineShape abrufen möchten.

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

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

ControlCollection Schnittstelle

Microsoft.Office.Tools.Word-Namespace

Freigeben über