Clipboard.GetImage Método

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Recupera uma imagem da Prancheta.

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

Devoluções

Image

E representa Image os dados da imagem da Área de Transferência ou null se a Área de Transferência não contém quaisquer dados que estejam no Bitmap formato ou possam ser convertidos para esse formato.

Exceções

ExternalException

A prancheta não pôde ser limpa. Isto ocorre tipicamente quando a Prancheta está a ser usada por outro processo.

ThreadStateException

O tópico atual não está em modo apartamento single-threaded (STA). Adicione-os STAThreadAttribute ao processo da Main sua candidatura.

Exemplos

O exemplo seguinte demonstra este elemento.

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

Observações

Use o ContainsImage método para determinar se a Prancheta contém dados de imagem antes de os recuperar com este método.

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

Note

A classe Clipboard só pode ser usada em threads configurados para o modo apartamento de thread único (modo STA). Para usar essa classe, verifique se o método Main está marcado com o atributo STAThreadAttribute.

Aplica-se a

Ver também