Clipboard.SetImage(Image) 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

清除剪貼簿，然後加入 Image 格式的 Bitmap。

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)

參數

image

Image

要加入剪貼簿的 Image。

例外狀況

ExternalException

無法清除剪貼簿。 這通常在剪貼簿由另一個處理序使用時發生。

ThreadStateException

目前執行緒 (Thread) 不是在單一執行緒 Apartment (STA) 模式。 將 STAThreadAttribute 加入至應用程式的 Main 方法。

ArgumentNullException

image 為 null。

範例

下列範例示範這個成員。

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

備註

若要從剪貼簿擷取影像資料，請先使用 ContainsImage 方法來判斷剪貼簿是否包含影像資料，然後再使用 GetImage 方法擷取。

注意

類別 Clipboard 只能用於設定為單一線程 Apartment (STA) 模式的執行緒。 若要使用此類別，請確定您的 Main 方法已以 STAThreadAttribute 屬性標示。

另請參閱

• Bitmap
• ContainsImage()
• GetImage()