Udostępnij za pośrednictwem

Clipboard.SetImage(Image) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Czyści schowek, a następnie dodaje element Image w Bitmap formacie.

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)

Parametry

image
Image

Element Image do dodania do Schowka.

Wyjątki

ExternalException

Nie można wyczyścić schowka. Zwykle występuje to, gdy schowek jest używany przez inny proces.

ThreadStateException

Bieżący wątek nie jest w trybie jednowątkowego mieszkania (STA). Dodaj metodę STAThreadAttribute do metody aplikacji Main .

ArgumentNullException

image to null.

Przykłady

W poniższym przykładzie pokazano ten element członkowski.

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

Uwagi

Aby pobrać dane obrazu ze Schowka, najpierw użyj ContainsImage metody , aby określić, czy Schowek zawiera dane obrazu przed pobraniem GetImage go za pomocą metody .

Uwaga

Klasa Clipboard może być używana tylko w wątkach ustawionych na tryb pojedynczego wątku (STA). Aby użyć tej klasy, upewnij się, że Main metoda jest oznaczona atrybutem STAThreadAttribute .

Dotyczy

Zobacz też