Clipboard.GetImage メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

クリップボードからイメージを取得します。

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。Bitmap 形式のデータ、またはその形式に変換できるデータがクリップボードに含まれていない場合は null。

例外

ExternalException

クリップボードをクリアできませんでした。 この例外は、通常、クリップボードが別のプロセスで使用されている場合に発生します。

ThreadStateException

現在のスレッドがシングル スレッド アパートメント (STA: Single Thread Apartment) モードになっていません。 アプリケーションの Main メソッドに STAThreadAttribute を追加してください。

例

このメンバーの例を次に示します。

// 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 クラスは、STA (シングル スレッド アパートメント) モードに設定されたスレッドでのみ使用できます。 このクラスを使用するには、お使いの Main メソッドが STAThreadAttribute 属性でマークされているようにします。

こちらもご覧ください

• Image
• Bitmap
• ContainsImage()
• SetImage(Image)