Função SetClipboardViewer (winuser.h)
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) |
Confira também
Conceitual
Referência