ControlCollection.GetShapeForControl-Methode

Artikel
08/10/2011

Ruft das zugrunde liegende Shape 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 GetShapeForControl ( _
    control As Control _
) As Shape

Shape GetShapeForControl(
    Control control
)

Parameter

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

Rückgabewert

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

Hinweise

Wenn für die Umbruchart des Steuerelements Mit Text in Zeile festgelegt ist, gibt die GetShapeForControl-Methode nullNULL-Verweis (Nothing in Visual Basic) zurück.

Beispiele

Im folgenden Codebeispiel wird dem Dokument ein Button hinzugefügt und anschließend mit der GetShapeForControl-Methode die Position des Steuerelements aus dem zugrunde liegenden Shape abgerufen.

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

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

.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