Clipboard.SetImage(Image) Método

Definición

Limpia el Portapapeles y, a continuación, agrega Image en el formato Bitmap.

public static void SetImage (System.Drawing.Image image);

Parámetros

image
Image

Image que se va a agregar al Portapapeles.

Excepciones

No se ha podido vaciar el Portapapeles. Esto ocurre normalmente cuando otro proceso utiliza el Portapapeles.

El subproceso actual no está en el modo de contenedor uniproceso (STA). Agregue STAThreadAttribute al método Main de la aplicación.

image es null.

Ejemplos

En el ejemplo siguiente se muestra este miembro.

// Demonstrates SetImage, ContainsImage, and GetImage.
public System.Drawing.Image SwapClipboardImage(
    System.Drawing.Image replacementImage)
{
    System.Drawing.Image returnImage = null;
    if (Clipboard.ContainsImage())
    {
        returnImage = Clipboard.GetImage();
        Clipboard.SetImage(replacementImage);
    }
    return returnImage;
}

Comentarios

Para recuperar datos de imagen del Portapapeles, use primero el ContainsImage método para determinar si el Portapapeles contiene datos de imagen antes de recuperarlos con el GetImage método .

Nota

La clase Clipboard solo se puede usar en subprocesos establecidos en modo de subprocesamiento controlado simple (STA). Para usar esta clase, asegúrese de que el método Main está marcado con el atributo STAThreadAttribute.

Se aplica a

Producto Versiones
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Consulte también