Compartir a través de

Portapapeles

El del Portapapeles de es un conjunto de funciones y mensajes que permiten a las aplicaciones transferir datos. Dado que todas las aplicaciones tienen acceso al Portapapeles, los datos se pueden transferir fácilmente entre aplicaciones o dentro de una aplicación.

Esta información general no describe cómo copiar y pegar objetos vinculados o incrustados. Para obtener información sobre estos temas, consulte la documentación del Modelo de objetos componentes (COM).

En esta sección

En los temas siguientes se proporciona información sobre el Portapapeles, los formatos del Portapapeles, las operaciones del Portapapeles y los mensajes del Portapapeles. La referencia de API contiene las funciones y los mensajes que puede usar para trabajar con el Portapapeles.

Nombre Descripción
Acerca del del Portapapeles Describe el Portapapeles.
formatos del Portapapeles Describe los formatos del Portapapeles. Una ventana puede colocar más de un objeto en el Portapapeles, cada uno de los cuales representa la misma información en un formato de Portapapeles diferente. Los usuarios no deben tener en cuenta los formatos del Portapapeles usados para un objeto en el Portapapeles.
de operaciones del Portapapeles de Describe las operaciones del Portapapeles. Una ventana debe usar el Portapapeles al cortar, copiar o pegar datos. Una ventana coloca los datos en el Portapapeles para las operaciones de cortar y copiar y recupera datos del Portapapeles para las operaciones de pegado.
formato del Portapapeles HTML Describe el formato del Portapapeles HTML.
usar el portapapeles Una ventana del visor del Portapapeles muestra el contenido actual del Portapapeles y recibe mensajes cuando cambia el contenido del Portapapeles.
de referencia del Portapapeles Contiene la referencia de API.

Funciones del Portapapeles

En la tabla siguiente se enumeran las funciones que puede usar para trabajar con el Portapapeles:

Nombre Descripción
AddClipboardFormatListener Coloca la ventana especificada en la lista de agentes de escucha con formato de portapapeles mantenido por el sistema.
ChangeClipboardChain Quita una ventana especificada de la cadena de visores del Portapapeles.
CloseClipboard Cierra el Portapapeles.
CountClipboardFormats Recupera el número de formatos de datos diferentes actualmente en el Portapapeles.
EmptyClipboard Vacía el Portapapeles y libera los identificadores de los datos del Portapapeles. A continuación, la función asigna la propiedad del Portapapeles a la ventana que tiene abierto el Portapapeles.
EnumClipboardFormats Enumera los formatos de datos disponibles actualmente en el Portapapeles. Los formatos de datos del Portapapeles se almacenan en una lista ordenada. Para realizar una enumeración de formatos de datos del Portapapeles, realice una serie de llamadas a la función EnumClipboardFormats . Para cada llamada, el formato parámetro especifica un formato de Portapapeles disponible y la función devuelve el siguiente formato de Portapapeles disponible.
GetClipboardData Recupera datos del Portapapeles en un formato especificado. El Portapapeles debe haberse abierto anteriormente.
GetClipboardFormatName Recupera del Portapapeles el nombre del formato registrado especificado. La función copia el nombre en el búfer especificado.
GetClipboardOwner Recupera el identificador de ventana del propietario actual del Portapapeles.
GetClipboardSequenceNumber Recupera el número de secuencia del Portapapeles para la estación de ventana actual.
GetClipboardViewer Recupera el identificador de la primera ventana de la cadena del visor del Portapapeles.
GetOpenClipboardWindow Recupera el identificador de la ventana que actualmente tiene abierto el Portapapeles.
GetPriorityClipboardFormat Recupera el primer formato de Portapapeles disponible en la lista especificada.
GetUpdatedClipboardFormats Recupera los formatos del Portapapeles admitidos actualmente.
IsClipboardFormatAvailable Determina si el Portapapeles contiene datos en el formato especificado.
OpenClipboard Abre el Portapapeles para su examen e impide que otras aplicaciones modifiquen el contenido del Portapapeles.
RegisterClipboardFormat Registra un nuevo formato del Portapapeles. A continuación, este formato se puede usar como un formato de Portapapeles válido.
RemoveClipboardFormatListener Quita la ventana especificada de la lista de agentes de escucha con formato de portapapeles mantenido por el sistema.
SetClipboardData Coloca los datos en el Portapapeles en un formato de Portapapeles especificado. La ventana debe ser el propietario actual del portapapeles, y la aplicación debe haber llamado a la función OpenClipboard. (Al responder al mensaje de WM_RENDERFORMAT , el propietario del Portapapeles no debe llamar a OpenClipboard antes de llamar a SetClipboardData).
SetClipboardViewer Agrega la ventana especificada a la cadena de visores del Portapapeles. Las ventanas del visor del Portapapeles reciben un mensaje WM_DRAWCLIPBOARD cada vez que cambia el contenido del Portapapeles.

Mensajes del Portapapeles

En la tabla siguiente se enumeran los mensajes que se envían a las ventanas del visor del Portapapeles:

Nombre Descripción
WM_CLEAR Se envía a un control de edición o cuadro combinado para eliminar (borrar) la selección actual, si existe, del control de edición.
WM_COPY Se envía a un control de edición o cuadro combinado para copiar la selección actual en el Portapapeles en formato CF_TEXT.
WM_CUT Se envía a un control de edición o cuadro combinado para eliminar (cortar) la selección actual, si existe, en el control de edición y copiar el texto eliminado al Portapapeles en el formato CF_TEXT.
WM_PASTE Se envía a un control de edición o cuadro combinado para copiar el contenido actual del Portapapeles en el control de edición en la posición del símbolo de intercalación actual. Los datos solo se insertan si el Portapapeles contiene datos en formato CF_TEXT .

Notificaciones del Portapapeles

En la tabla siguiente se enumeran los mensajes de notificación del Portapapeles que se envían a las ventanas del visor del Portapapeles:

Nombre Descripción
WM_ASKCBFORMATNAME Enviado al propietario del Portapapeles por una ventana del visor del Portapapeles para solicitar el nombre de un formato CF_OWNERDISPLAY.
WM_CHANGECBCHAIN Se envía a la primera ventana de la cadena del visor del Portapapeles cuando se quita una ventana de la cadena.
WM_CLIPBOARDUPDATE Se envía cuando el contenido del Portapapeles ha cambiado.
WM_DESTROYCLIPBOARD Se envía al propietario del Portapapeles cuando una llamada a la función EmptyClipboard vacía el Portapapeles.
WM_DRAWCLIPBOARD Se envía a la primera ventana de la cadena del visor del Portapapeles cuando cambia el contenido del Portapapeles. Esto permite que una ventana del visor del Portapapeles muestre el nuevo contenido del Portapapeles.
WM_HSCROLLCLIPBOARD Enviado al propietario del Portapapeles por una ventana del visor del Portapapeles. Esto ocurre cuando el Portapapeles contiene datos en el formato CF_OWNERDISPLAY y se produce un evento en la barra de desplazamiento horizontal del visor del Portapapeles. El propietario debe desplazarse por la imagen del Portapapeles y actualizar los valores de la barra de desplazamiento.
WM_PAINTCLIPBOARD Enviado al propietario del Portapapeles por una ventana del visor del Portapapeles cuando el Portapapeles contiene datos en el formato CF_OWNERDISPLAY y el área de cliente del visor del Portapapeles necesita volver a pintar.
WM_RENDERALLFORMATS Enviado al propietario del Portapapeles antes de que se destruya, si el propietario del Portapapeles ha retrasado la representación de uno o varios formatos del Portapapeles. Para que el contenido del Portapapeles permanezca disponible para otras aplicaciones, el propietario del Portapapeles debe representar datos en todos los formatos que es capaz de generar y colocar los datos en el Portapapeles llamando a la función SetClipboardData .
WM_RENDERFORMAT Se envía al propietario del Portapapeles si ha retrasado la representación de un formato específico del Portapapeles y si una aplicación ha solicitado datos en ese formato. El propietario del Portapapeles debe representar datos en el formato especificado y colocarlos en el Portapapeles llamando a la función SetClipboardData .
WM_SIZECLIPBOARD Enviado al propietario del Portapapeles por una ventana del visor del Portapapeles cuando el Portapapeles contiene datos en el formato CF_OWNERDISPLAY y el área de cliente del visor del Portapapeles ha cambiado el tamaño.
WM_VSCROLLCLIPBOARD Enviado al propietario del Portapapeles por una ventana del visor del Portapapeles cuando el Portapapeles contiene datos en el formato CF_OWNERDISPLAY y se produce un evento en la barra de desplazamiento vertical del visor del Portapapeles. El propietario debe desplazarse por la imagen del Portapapeles y actualizar los valores de la barra de desplazamiento.

Estructuras

En la tabla siguiente se enumeran las estructuras que se usan con el Portapapeles:

Nombre Descripción
METAFILEPICT Define el formato de imagen de metarchivo usado para intercambiar datos de metarchivo a través del Portapapeles.
  • Last updated on