Clipboard.SetImage(Image) Método

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

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

public:
 static void SetImage(System::Drawing::Image ^ image);
public static void SetImage(System.Drawing.Image image);
static member SetImage : System.Drawing.Image -> unit
Public Shared Sub SetImage (image As Image)

Parámetros

image
Image

que Image se va a agregar al Portapapeles.

Excepciones

ExternalException

No se pudo borrar el Portapapeles. Esto suele ocurrir cuando otro proceso usa el Portapapeles.

ThreadStateException

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

ArgumentNullException

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

' Demonstrates SetImage, ContainsImage, and GetImage.
Public Function SwapClipboardImage( _
    ByVal replacementImage As System.Drawing.Image) _
    As System.Drawing.Image

    Dim returnImage As System.Drawing.Image = Nothing

    If Clipboard.ContainsImage() Then
        returnImage = Clipboard.GetImage()
        Clipboard.SetImage(replacementImage)
    End If

    Return returnImage
End Function

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 .

Note

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

Se aplica a

Consulte también