Compartir vía


Clipboard.GetImage Método

Definición

Recupera una imagen del Portapapeles.

public:
 static System::Drawing::Image ^ GetImage();
public static System.Drawing.Image GetImage ();
public static System.Drawing.Image? GetImage ();
static member GetImage : unit -> System.Drawing.Image
Public Shared Function GetImage () As Image

Devoluciones

Image que representa los datos de imagen del Portapapeles o null si el Portapapeles no contiene ningún dato con el formato Bitmap o que se pueda convertir a ese formato.

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.

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

Use el ContainsImage método para determinar si el Portapapeles contiene datos de imagen antes de recuperarlos con este método.

Use el SetImage método para agregar datos de imagen al Portapapeles.

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