Clipboard.GetImage 方法

  • 參考

定義

命名空間:
System.Windows.Forms
組件:
System.Windows.Forms.dll

從剪貼簿擷取影像。

public:
 static System::Drawing::Image ^ GetImage();
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

傳回

Image

如果剪貼簿不包含任何 Image 格式或可以轉換為該格式的資料，則為代表剪貼簿影像資料或 null 的 Bitmap。

例外狀況

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

備註

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

SetImage使用 方法可將影像資料新增至剪貼簿。

注意

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

適用於

另請參閱