Clipboard.ContainsImage メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Clipboard.ContainsImage メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

Bitmap 形式のデータ、またはその形式に変換できるデータがクリップボードに存在するかどうかを示します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Shared Function ContainsImage
 As Boolean

Visual Basic (使用法)

Dim returnValue As Boolean

returnValue = Clipboard.ContainsImage

public static bool ContainsImage
 ()

C++

public:
static bool ContainsImage ()

public static boolean ContainsImage ()

JScript

public static function ContainsImage
 () : boolean

戻り値
イメージデータがクリップボードに存在する場合は true。それ以外の場合は false。

例外

例外の種類	条件
ExternalException	クリップボードをクリアできませんでした。この例外は、通常、クリップボードが別のプロセスで使用されている場合に発生します。
ThreadStateException	現在のスレッドがシングルスレッドアパートメント (STA: Single Thread Apartment) モードになっていません。アプリケーションの Main メソッドに STAThreadAttribute を追加してください。

解説

GetImage メソッドを使用してイメージデータを取得する前に、その形式のデータがクリップボードに含まれているかどうかを確認するには、このメソッドを使用します。

メモ
Clipboard クラスは、シングルスレッドアパートメント (STA: Single Thread Apartment) モードに設定されているスレッドでだけ使用できます。このクラスを使用するには、Main メソッドが確実に STAThreadAttribute 属性でマークされているようにします。

使用例

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

Visual Basic

' 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

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

.NET Framework のセキュリティ