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

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

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

Clipboard.ContainsFileDropList メソッド

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

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

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

Visual Basic (宣言)

Public Shared Function ContainsFileDropList
 As Boolean

Visual Basic (使用法)

Dim returnValue As Boolean

returnValue = Clipboard.ContainsFileDropList

public static bool ContainsFileDropList
 ()

C++

public:
static bool ContainsFileDropList ()

public static boolean ContainsFileDropList
 ()

JScript

public static function ContainsFileDropList
 () : boolean

戻り値
ファイルドロップリストがクリップボードに存在する場合は true。それ以外の場合は false。

例外

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

解説

ファイルドロップリストとは、ファイルへのパス情報を含んだ文字列のコレクションです。

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

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

使用例

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

Visual Basic

' Demonstrates SetFileDropList, ContainsFileDroList, and GetFileDropList
Public Function SwapClipboardFileDropList(ByVal
 replacementList _
    As System.Collections.Specialized.StringCollection) _
    As System.Collections.Specialized.StringCollection

    Dim returnList As System.Collections.Specialized.StringCollection
 _
        = Nothing

    If Clipboard.ContainsFileDropList() Then

        returnList = Clipboard.GetFileDropList()
        Clipboard.SetFileDropList(replacementList)
    End If

    Return returnList

End Function

// Demonstrates SetFileDropList, ContainsFileDroList, and GetFileDropList
public System.Collections.Specialized.StringCollection
    SwapClipboardFileDropList(
    System.Collections.Specialized.StringCollection replacementList)
{
    System.Collections.Specialized.StringCollection returnList = null;
    if (Clipboard.ContainsFileDropList())
    {
        returnList = Clipboard.GetFileDropList();
        Clipboard.SetFileDropList(replacementList);
    }
    return returnList;
}

.NET Framework のセキュリティ