Metodo ControlCollection.GetShapeForControl

Articolo
08/11/2011

Ottiene l'oggetto Shape sottostante per il controllo specificato.

Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Sintassi

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

Shape GetShapeForControl(
    Control control
)

Parametri

control
Tipo: System.Windows.Forms.Control
Il controllo nell'istanza di ControlCollection da cui ottenere l'oggetto Shape.

Valore restituito

Tipo: Microsoft.Office.Interop.Word.Shape
L'oggetto Shape sottostante per il controllo specificato.

Note

Se lo stile di ritorno a capo del controllo è impostato su In linea con il testo, il metodo GetShapeForControl restituisce nullriferimento null (Nothing in Visual Basic).

Esempi

Nell'esempio di codice seguente viene aggiunto un oggetto Button al documento, quindi viene utilizzato il metodo GetShapeForControl per ottenere la posizione del controllo dall'oggetto Shape sottostante.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

ControlCollection Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Word

Condividi tramite