Clipboard.SetImage(Image) 方法

定义

命名空间:
System.Windows.Forms
程序集:
System.Windows.Forms.dll
Source:
Clipboard.cs
Source:
Clipboard.cs
Source:
Clipboard.cs
Source:
Clipboard.cs
Source:
Clipboard.cs

清除剪贴板，然后添加格式ImageBitmap。

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 方法。

适用于

另请参阅