Metodo IInkDisp::ClipboardCopy (msinkaut.h)

Articolo
08/24/2023

Copia l'insieme InkStrokes negli Appunti.

Sintassi

HRESULT ClipboardCopy(
  [in, optional] IInkStrokes         *strokes,
  [in, optional] InkClipboardFormats ClipboardFormats,
  [in, optional] InkClipboardModes   ClipboardModes,
  [out, retval]  IDataObject         **DataObject
);

Parametri

[in, optional] strokes

Facoltativo. Specifica i tratti da copiare. Se il parametro tratti è NULL, il metodo ClipboardCopy copia l'intero oggetto InkDisp . Il valore predefinito è NULL.

[in, optional] ClipboardFormats

Facoltativa. Specifica il valore di enumerazione InkClipboardFormats dell'oggetto InkDisp . Il valore predefinito è ICF_Default.

[in, optional] ClipboardModes

Facoltativa. Specifica il valore di enumerazione InkClipboardModes dell'oggetto InkDisp . Il valore predefinito è ICB_Default.

[out, retval] DataObject

Quando questo metodo restituisce, contiene un puntatore all'oggetto dati appena creato.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_POINTER	Un parametro contiene un puntatore non valido.
E_INK_EXCEPTION	Si è verificata un'eccezione all'interno del metodo.
E_INK_MISMATCHED_INK_OBJECT	Il parametro tratti è associato a un oggetto Ink diverso.

Commenti

Questo metodo copia tutte le proprietà del tratto, inclusi i risultati del riconoscimento. L'impostazione del parametro tratti su NULL copia l'oggetto InkDisp negli Appunti, inclusa la proprietà CustomStrokes e i risultati del riconoscimento per i tratti nell'insieme IInkCustomStrokes dell'oggetto InkDisp vengono mantenuti.

Se viene passata un insieme InkStrokes vuoto, il metodo restituisce NULL e il contenuto degli Appunti non viene modificato.

NotaOleInitialize(NULL) deve essere chiamato prima che le API degli Appunti possano funzionare.

Attenzione Per evitare potenziali perdite di memoria a causa dell'uso del flag di ICB_DelayedCopy, è necessario chiamare il metodo OleFlushClipboard o OleSetClipboard. Questa operazione deve essere eseguita prima dell'uscita dell'applicazione se l'ultima chiamata al metodo ClipboardCopy ha usato il flag di ICB_DelayedCopy .

Requisiti


Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	msinkaut.h
Libreria	InkObj.dll