Clipboard.IsCurrent(IDataObject) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Windows

Assembly:: PresentationCore.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Confronta un oggetto dati specificato con il contenuto degli Appunti.

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

Parametri

data: IDataObject

Un oggetto dati da confrontare con il contenuto degli Appunti di sistema.

Restituisce

Boolean

true se l'oggetto dati specificato corrisponde a quello presente sugli Appunti di sistema; in caso contrario, false.

Eccezioni

ArgumentNullException

data è null.

ExternalException

Si è verificato un errore durante l'accesso agli Appunti. I dettagli dell'eccezione includeranno un oggetto HResult che identifica l'errore specifico. A tal proposito si veda ErrorCode.

Esempio

Nell'esempio seguente viene illustrato l'uso di questo metodo.


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

Commenti

Utilizzare questo metodo per determinare se un oggetto dati inserito in precedenza negli Appunti è ancora presente e non modificato.

Si applica a

Condividi tramite