Clipboard.IsCurrent(IDataObject) Methode

Definitie

Naamruimte:
System.Windows
Assembly:
PresentationCore.dll

Hiermee wordt een opgegeven gegevensobject vergeleken met de inhoud van het Klembord.

public:
 static bool IsCurrent(System::Windows::IDataObject ^ data);
public static bool IsCurrent(System.Windows.IDataObject data);
static member IsCurrent : System.Windows.IDataObject -> bool
Public Shared Function IsCurrent (data As IDataObject) As Boolean

Parameters

data
IDataObject

Een gegevensobject dat moet worden vergeleken met de inhoud van het klembord van het systeem.

Retouren

Boolean

true als het opgegeven gegevensobject overeenkomt met wat zich op het klembord van het systeem bevindt; anders, false.

Uitzonderingen

ArgumentNullException

data is null.

ExternalException

Er is een fout opgetreden bij het openen van het Klembord. De details van de uitzondering bevatten een HResult die de specifieke fout identificeert. Zie ErrorCode.

Voorbeelden

In het volgende voorbeeld ziet u het gebruik van deze methode.


               // 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)

Opmerkingen

Gebruik deze methode om te bepalen of een gegevensobject dat eerder op het Klembord is geplaatst, nog steeds aanwezig is en ongewijzigd blijft.

Van toepassing op