Método IInkDisp::ClipboardCopy (msinkaut.h)

Artículo
08/24/2023

Copia la colección InkStrokes en el Portapapeles.

Sintaxis

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

Parámetros

[in, optional] strokes

Opcional. Especifica los trazos que se van a copiar. Si el parámetro strokes es NULL, el método ClipboardCopy copia todo el objeto InkDisp . El valor predeterminado es NULL.

[in, optional] ClipboardFormats

Opcional. Especifica el valor de enumeración InkClipboardFormats del objeto InkDisp . El valor predeterminado es ICF_Default.

[in, optional] ClipboardModes

Opcional. Especifica el valor de enumeración InkClipboardModes del objeto InkDisp . El valor predeterminado es ICB_Default.

[out, retval] DataObject

Cuando este método vuelve, contiene un puntero al objeto de datos recién creado.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	Correcto.
E_POINTER	Un parámetro contenía un puntero no válido.
E_INK_EXCEPTION	Se produjo una excepción dentro del método .
E_INK_MISMATCHED_INK_OBJECT	El parámetro strokes está asociado a un objeto Ink diferente.

Comentarios

Este método copia todas las propiedades del trazo, incluidos los resultados del reconocimiento. Si se establece el parámetro strokes en NULL, se copia el objeto InkDisp en el Portapapeles, incluida la propiedad CustomStrokes y los resultados de reconocimiento de trazos en la colección IInkCustomStrokes del objeto InkDisp.

Si se pasa una colección InkStrokes vacía, el método devuelve NULL y el contenido del Portapapeles no se modifica.

Nota Se debe llamar a OleInitialize(NULL) para que las API del Portapapeles puedan funcionar.

Precaución Para evitar posibles pérdidas de memoria como resultado del uso de la marca ICB_DelayedCopy , debe llamar al método OleFlushClipboard o OleSetClipboard . Esto debe hacerse antes de que la aplicación salga si la última llamada al método ClipboardCopy usó la marca ICB_DelayedCopy .

Requisitos


Cliente mínimo compatible	Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	msinkaut.h
Library	InkObj.dll