Função ChangeClipboardChain (winuser.h)

Artigo
03/13/2024

Remove uma janela especificada da cadeia de visualizadores da área de transferência.

Sintaxe

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

Parâmetros

[in] hWndRemove

Digite: HWND

Um identificador para a janela a ser removida da cadeia. O identificador deve ter sido passado para a função SetClipboardViewer .

[in] hWndNewNext

Digite: HWND

Um identificador para a janela que segue a janela hWndRemove na cadeia de visualizadores da área de transferência. (Esse é o identificador retornado por SetClipboardViewer, a menos que a sequência tenha sido alterada em resposta a uma mensagem de WM_CHANGECBCHAIN .)

Retornar valor

Tipo: BOOL

O valor retornado indica o resultado da passagem da mensagem WM_CHANGECBCHAIN para as janelas na cadeia de visualizadores da área de transferência. Como uma janela na cadeia normalmente retorna FALSE quando processa WM_CHANGECBCHAIN, o valor retornado de ChangeClipboardChain normalmente é FALSE. Se houver apenas uma janela na cadeia, o valor retornado normalmente será TRUE.

Comentários

A janela identificada por hWndNewNext substitui a janela hWndRemove na cadeia. A função SetClipboardViewer envia uma mensagem WM_CHANGECBCHAIN para a primeira janela na cadeia de visualizadores da área de transferência.

Para obter um exemplo, consulte Removendo uma janela da cadeia de visualizadores da área de transferência.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-misc-l1-5-1 (introduzido no Windows 10, versão 10.0.14393)