Función ChangeClipboardChain (winuser.h)

Artículo
03/09/2024

Quita una ventana especificada de la cadena de visores del Portapapeles.

Sintaxis

BOOL ChangeClipboardChain(
  [in] HWND hWndRemove,
  [in] HWND hWndNewNext
);

Parámetros

[in] hWndRemove

Tipo: HWND

Identificador de la ventana que se va a quitar de la cadena. El identificador debe haberse pasado a la función SetClipboardViewer .

[in] hWndNewNext

Tipo: HWND

Identificador de la ventana que sigue a la ventana hWndRemove en la cadena del visor del Portapapeles. (Este es el identificador devuelto por SetClipboardViewer, a menos que la secuencia se haya cambiado en respuesta a un mensaje de WM_CHANGECBCHAIN ).

Valor devuelto

Tipo: BOOL

El valor devuelto indica el resultado de pasar el mensaje WM_CHANGECBCHAIN a las ventanas de la cadena del visor del Portapapeles. Dado que una ventana de la cadena normalmente devuelve FALSE cuando procesa WM_CHANGECBCHAIN, el valor devuelto de ChangeClipboardChain suele ser FALSE. Si solo hay una ventana en la cadena, el valor devuelto suele ser TRUE.

Comentarios

La ventana identificada por hWndNewNext reemplaza la ventana hWndRemove en la cadena. La función SetClipboardViewer envía un mensaje WM_CHANGECBCHAIN a la primera ventana de la cadena del visor del Portapapeles.

Para obtener un ejemplo, vea Quitar una ventana de 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 (incluya 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)