Clipboard.SetImage(Image) Método

  • Referencia

Definición

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

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

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

Image que se va a agregar al Portapapeles.

Excepciones

ExternalException

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

ThreadStateException

El subproceso actual no está en el modo de contenedor uniproceso (STA). Agregue STAThreadAttribute al método Main de la 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 .

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

Consulte también