Compartir a través de


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.