Clipboard.GetImage Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Recupera uma imagem da área de transferência.

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

Retornos

Image

Um Image que representa os dados de imagem da área de transferência ou null se a área de transferência não contiver dados que estejam no formato Bitmap ou que possam ser convertidos nesse formato.

Exceções

ExternalException

Não foi possível limpar a Área de Transferência. Isso geralmente ocorre quando a Área de Transferência está sendo usada por outro processo.

ThreadStateException

O thread atual não está no modo STA (Single-Threaded Apartment). Adicione o STAThreadAttribute ao método Main do aplicativo.

Exemplos

O exemplo a seguir demonstra esse membro.

// 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

Comentários

Use o ContainsImage método para determinar se a Área de Transferência contém dados de imagem antes de recuperá-los com esse método.

Use o SetImage método para adicionar dados de imagem à Área de Transferência.

Observação

A Clipboard classe só pode ser usada em threads definidos como modo STA (single thread apartment). Para usar essa classe, verifique se o Main método está marcado com o STAThreadAttribute atributo .

Aplica-se a

Confira também