Clipboard.IsCurrent(IDataObject) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したデータ オブジェクトをクリップボードの内容と比較します。
public:
static bool IsCurrent(System::Windows::IDataObject ^ data);public static bool IsCurrent (System.Windows.IDataObject data);static member IsCurrent : System.Windows.IDataObject -> boolPublic Shared Function IsCurrent (data As IDataObject) As Booleanパラメーター
- data
- IDataObject
システム クリップボードの内容と比較するデータ オブジェクト。
戻り値
指定したデータ オブジェクトがシステム クリップボードの内容と一致する場合は true。それ以外の場合は false。
例外
data が nullです。
クリップボードへのアクセス中にエラーが発生しました。 例外の詳細には、特定のエラーを識別する HResult が含まれます。「ErrorCode」を参照してください。
例
次の例では、このメソッドの使用方法を示します。
// For this example, the data to be placed on the clipboard is a simple
// string.
string textData = "I want to put this string on the clipboard.";
// The example will enable auto-conversion of data for this data object.
bool autoConvert = true;
// Create a new data object, specifying the data format, data to encapsulate, and enabling
// auto-conversion services.
DataObject data = new DataObject(DataFormats.UnicodeText, (Object)textData, autoConvert);
// If the data to be copied is supposed to be persisted after the application ends,
// then set the second parameter of SetDataObject to true.
if(persistentData)
{
// Place the persisted data on the clipboard.
Clipboard.SetDataObject(data, true);
}
else
{
// Place the non-persisted data on the clipboard.
Clipboard.SetDataObject(data, false);
}
// If you keep a copy of the source data object, you can use the IsCurrent method to see if
// the data object is still on the clipboard.
bool isOriginalDataObject = Clipboard.IsCurrent(data);
' For this example, the data to be placed on the clipboard is a simple
' string.
Dim textData As String = "I want to put this string on the clipboard."
' The example will enable auto-conversion of data for this data object.
Dim autoConvert As Boolean = True
' Create a new data object, specifying the data format, data to encapsulate, and enabling
' auto-conversion services.
Dim data As New DataObject(DataFormats.UnicodeText, CType(textData, Object), autoConvert)
' If the data to be copied is supposed to be persisted after the application ends,
' then set the second parameter of SetDataObject to true.
If persistentData Then
' Place the persisted data on the clipboard.
Clipboard.SetDataObject(data, True)
Else
' Place the non-persisted data on the clipboard.
Clipboard.SetDataObject(data, False)
End If
' If you keep a copy of the source data object, you can use the IsCurrent method to see if
' the data object is still on the clipboard.
Dim isOriginalDataObject As Boolean = Clipboard.IsCurrent(data)
注釈
クリップボードに以前に配置されたデータ オブジェクトがまだ存在し、変更されていないかどうかを判断するには、このメソッドを使用します。