ControlCollection.GetShapeForControl (Método)
Obtiene el valor Shape subyacente para el control especificado.
Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word (en Microsoft.Office.Tools.Word.dll)
Sintaxis
'Declaración
Function GetShapeForControl ( _
control As Control _
) As Shape
Shape GetShapeForControl(
Control control
)
Parámetros
- control
Tipo: System.Windows.Forms.Control
El control en la instancia ControlCollection de la que desea obtener Shape.
Valor devuelto
Tipo: Microsoft.Office.Interop.Word.Shape
El valor Shape subyacente para el control especificado.
Comentarios
Si el estilo de ajuste del control se establece en En línea con el texto, el método GetShapeForControl devuelve nullreferencia null (Nothing en Visual Basic).
Ejemplos
El ejemplo de código siguiente agrega un Button al documento y, a continuación, utiliza el método GetShapeForControl para obtener la ubicación del control de su Shape subyacente.
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());
}
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.