Compartilhar via


Função ChangeClipboardChain (winuser.h)

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)

Confira também

ChangeClipboardChain

Área de transferência

Conceitual

Referência

Setclipboardviewer

WM_CHANGECBCHAIN