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

当前线程未处于单线程单元 (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 类只能在设置为单线程单元 (STA) 模式的线程中使用。 若要使用此类，请确保使用 Main 特性标记 STAThreadAttribute 方法。

另请参阅

• Bitmap
• ContainsImage()
• GetImage()