Función SetClipboardViewer (winuser.h)
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. Esta función se usa para la compatibilidad con versiones anteriores de Windows.
Sintaxis
HWND SetClipboardViewer(
[in] HWND hWndNewViewer
);
Parámetros
[in] hWndNewViewer
Tipo: HWND
Identificador de la ventana que se va a agregar a la cadena del Portapapeles.
Valor devuelto
Tipo: HWND
Si la función se realiza correctamente, el valor devuelto identifica la siguiente ventana de la cadena del visor del Portapapeles. Si se produce un error o no hay otras ventanas en la cadena del visor del Portapapeles, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Las ventanas que forman parte de la cadena del visor del Portapapeles, denominadas ventanas del visor del Portapapeles, deben procesar los mensajes del Portapapeles WM_CHANGECBCHAIN y WM_DRAWCLIPBOARD. Cada ventana del visor del Portapapeles llama a la función SendMessage para pasar estos mensajes a la siguiente ventana de la cadena del visor del Portapapeles.
Una ventana del visor del Portapapeles debe quitarse finalmente de la cadena del visor del Portapapeles llamando a la función ChangeClipboardChain , por ejemplo, en respuesta al mensaje WM_DESTROY .
La función SetClipboardViewer existe para proporcionar compatibilidad con versiones anteriores de Windows. La cadena del visor del Portapapeles puede romperse mediante una aplicación que no puede controlar correctamente los mensajes de la cadena del Portapapeles. Las nuevas aplicaciones deben usar técnicas más sólidas, como el número de secuencia del Portapapeles o el registro de un agente de escucha de formato de Portapapeles. Para obtener más información sobre estas técnicas alternativas, consulte Supervisión del contenido del Portapapeles.
Ejemplos
Para obtener un ejemplo, vea Agregar una ventana a la cadena del Visor del Portapapeles.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winuser.h (incluir Windows.h) |
| Library | User32.lib |
| Archivo DLL | User32.dll |
| Conjunto de API | ext-ms-win-ntuser-misc-l1-5-1 (introducido en Windows 10, versión 10.0.14393) |
Consulte también
Conceptual
Referencia