Clipboard.ContainsImage 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

指出剪貼簿上是否有 Bitmap 格式的資料，或是可以轉換為該格式的資料。

public:
 static bool ContainsImage();

public static bool ContainsImage ();

static member ContainsImage : unit -> bool

Public Shared Function ContainsImage () As Boolean

傳回

Boolean

如果剪貼簿上有影像資料，則為 true，否則為 false。

例外狀況

ExternalException

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

ThreadStateException

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

範例

下列範例示範這個成員。

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

備註

使用這個方法來判斷剪貼簿是否包含影像資料，然後再使用 GetImage 方法擷取它。

注意

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

另請參閱

• Bitmap
• GetImage()
• SetImage(Image)