Portapapeles

El Portapapeles 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

Nombre	Descripción
Acerca 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.
Operaciones del Portapapeles	Describe las operaciones del Portapapeles. Una ventana debe usar el Portapapeles al cortar, copiar o pegar datos. Una ventana coloca 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.
Uso del Portapapeles	Una ventana del visor del Portapapeles muestra el contenido actual del Portapapeles y recibe mensajes cuando cambia el contenido del Portapapeles.
Referencia del Portapapeles	Contiene la referencia de API.

Funciones del Portapapeles

Nombre	Descripción
AddClipboardFormatListener	Coloca la ventana especificada en la lista de agentes de escucha de formato del Portapapeles mantenidos 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 parámetro format 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 de 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 de Portapapeles. A continuación, este formato se puede usar como formato de Portapapeles válido.
RemoveClipboardFormatListener	Quita la ventana especificada de la lista de agentes de escucha de formato del Portapapeles mantenido por el sistema.
SetClipboardData	Coloca 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 de WM_DRAWCLIPBOARD cada vez que cambia el contenido del Portapapeles.

Mensajes 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 CF_TEXT formato.
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 en el Portapapeles en CF_TEXT formato.
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

Nombre	Descripción
WM_ASKCBFORMATNAME	Se envía al propietario del Portapapeles mediante una ventana del visor del Portapapeles para solicitar el nombre de un formato de portapapeles de 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	Se envía al propietario del Portapapeles mediante 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	Se envía al propietario del Portapapeles mediante 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	Se envía 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 los datos en todos los formatos que pueda 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 de Portapapeles específico y si una aplicación ha solicitado datos en ese formato. El propietario del Portapapeles debe representar los 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

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