Button.CopyPicture (Método)
Copia el Button al Portapapeles como una imagen.
Espacio de nombres: Microsoft.Office.Tools.Excel.Controls
Ensamblado: Microsoft.Office.Tools.Excel.v4.0.Utilities (en Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Sintaxis
'Declaración
Public Function CopyPicture ( _
Appearance As XlPictureAppearance, _
Format As XlCopyPictureFormat _
) As Object
public Object CopyPicture(
XlPictureAppearance Appearance,
XlCopyPictureFormat Format
)
Parámetros
- Appearance
Tipo: Microsoft.Office.Interop.Excel.XlPictureAppearance
Especifica cómo se debe copiar la imagen.
- Format
Tipo: Microsoft.Office.Interop.Excel.XlCopyPictureFormat
Formato de imagen.Acepta el valor de xlPicture.
Valor devuelto
Tipo: System.Object
true si la copia se realiza correctamente; de lo contrario, false.
Comentarios
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
En el ejemplo de código siguiente se muestra un control Button que se copia a sí mismo al Portapapeles cuando el usuario hace clic en él. El controlador de eventos Click del botón llama al método CopyPicture para copiar el botón al Portapapeles como un mapa de bits.
Se trata de un ejemplo para una personalización en el nivel del documento.
Private Sub CopyControlAsPicture()
Dim CopyButton As Microsoft.Office.Tools.Excel.Controls.Button = _
Me.Controls.AddButton(Me.Range("B2", "D3"), "CopyButton")
CopyButton.Text = "Click to copy this control"
AddHandler CopyButton.Click, AddressOf copyButtonPicture_Click
End Sub
Private Sub CopyButtonPicture_Click(ByVal sender As Object, ByVal e As EventArgs)
Dim ClickedButton As Microsoft.Office.Tools.Excel.Controls.Button = _
CType(sender, Microsoft.Office.Tools.Excel.Controls.Button)
ClickedButton.CopyPicture(Excel.XlPictureAppearance.xlScreen, _
Excel.XlCopyPictureFormat.xlBitmap)
End Sub
private void CopyControlAsPicture()
{
Microsoft.Office.Tools.Excel.Controls.Button copyButton =
this.Controls.AddButton(this.Range["B2", "D3"],
"copyButton");
copyButton.Text = "Click to copy this control";
copyButton.Click += new EventHandler(copyButtonPicture_Click);
}
void copyButtonPicture_Click(object sender, EventArgs e)
{
Microsoft.Office.Tools.Excel.Controls.Button clickedButton =
(Microsoft.Office.Tools.Excel.Controls.Button)sender;
clickedButton.CopyPicture(
Excel.XlPictureAppearance.xlScreen,
Excel.XlCopyPictureFormat.xlBitmap);
}
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.