Clipboard.SetImage(Image) Método

Definição

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

Limpa a prancheta e depois adiciona um Image no 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

O Image para adicionar à prancheta.

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.

ArgumentNullException

image é null.

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

Para recuperar dados de imagem do Clipboard, use primeiro o ContainsImage método para determinar se o Clipboard contém dados de imagem antes de os obter com o GetImage método.

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