Função SetClipboardViewer (winuser.h)

Artigo
08/28/2023

Adiciona a janela especificada à cadeia de visualizadores da área de transferência. As janelas do visualizador da área de transferência recebem uma mensagem WM_DRAWCLIPBOARD sempre que o conteúdo da área de transferência é alterado. Essa função é usada para compatibilidade com versões anteriores do Windows.

Sintaxe

HWND SetClipboardViewer(
  [in] HWND hWndNewViewer
);

Parâmetros

[in] hWndNewViewer

Digite: HWND

Um identificador para a janela a ser adicionada à cadeia de área de transferência.

Retornar valor

Digite: HWND

Se a função for bem-sucedida, o valor retornado identificará a próxima janela na cadeia de visualizadores da área de transferência. Se ocorrer um erro ou não houver outras janelas na cadeia de visualizadores da área de transferência, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Comentários

As janelas que fazem parte da cadeia de visualizadores da área de transferência, chamada janelas do visualizador da área de transferência, devem processar as mensagens da área de transferência WM_CHANGECBCHAIN e WM_DRAWCLIPBOARD. Cada janela do visualizador da área de transferência chama a função SendMessage para passar essas mensagens para a próxima janela na cadeia de visualizadores da área de transferência.

Uma janela do visualizador da área de transferência deve, eventualmente, remover-se da cadeia de visualizadores da área de transferência chamando a função ChangeClipboardChain , por exemplo, em resposta à mensagem WM_DESTROY .

A função SetClipboardViewer existe para fornecer compatibilidade com versões anteriores do Windows. A cadeia do visualizador da área de transferência pode ser interrompida por um aplicativo que não consegue lidar com as mensagens da cadeia de transferência corretamente. Novos aplicativos devem usar técnicas mais robustas, como o número de sequência da área de transferência ou o registro de um ouvinte de formato de área de transferência. Para obter mais detalhes sobre essas técnicas alternativas, consulte Monitoramento do conteúdo da área de transferência.

Exemplos

Para obter um exemplo, consulte Adicionando uma janela à 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)