ControlCollection.GetShapeForControl – metoda

Článek
08/11/2011

Získá základní Shape pro zadaný ovládací prvek.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word (v Microsoft.Office.Tools.Word.dll)

Syntaxe

'Deklarace
Function GetShapeForControl ( _
    control As Control _
) As Shape

Shape GetShapeForControl(
    Control control
)

Parametry

control
Typ: System.Windows.Forms.Control
Ovládací prvek v ControlCollection instance, ze kterého chcete získat Shape.

Vrácená hodnota

Typ: Microsoft.Office.Interop.Word.Shape
Základní Shape pro zadaný ovládací prvek.

Poznámky

Pokud je styl obtékání ovládacího prvku nastavena na v čára s textem, GetShapeForControl metoda vrátí nullodkaz Null (Nothing v jazyce Visual Basic).

Příklady

Následující příklad kódu přidá Button dokumentu a používá GetShapeForControl metoda umístění ovládacího prvku z jeho základní Shape.

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Odkaz

ControlCollection Rozhraní

Microsoft.Office.Tools.Word – obor názvů

Sdílet prostřednictvím