Funzione SetClipboardViewer (winuser.h)

Articolo
03/04/2024

Aggiunge la finestra specificata alla catena di visualizzatori degli Appunti. Le finestre del visualizzatore appunti ricevono un messaggio WM_DRAWCLIPBOARD ogni volta che il contenuto degli Appunti cambia. Questa funzione viene usata per la compatibilità con le versioni precedenti di Windows.

Sintassi

HWND SetClipboardViewer(
  [in] HWND hWndNewViewer
);

Parametri

[in] hWndNewViewer

Tipo: HWND

Handle alla finestra da aggiungere alla catena degli Appunti.

Valore restituito

Tipo: HWND

Se la funzione ha esito positivo, il valore restituito identifica la finestra successiva nella catena del visualizzatore appunti. Se si verifica un errore o non sono presenti altre finestre nella catena del visualizzatore appunti, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Le finestre che fanno parte della catena di visualizzatore appunti, denominate finestre del visualizzatore appunti, devono elaborare i messaggi degli Appunti WM_CHANGECBCHAIN e WM_DRAWCLIPBOARD. Ogni finestra del visualizzatore appunti chiama la funzione SendMessage per passare questi messaggi alla finestra successiva nella catena del visualizzatore appunti.

Una finestra del visualizzatore appunti deve essere rimossa dalla catena di visualizzatore appunti chiamando la funzione ChangeClipboardChain , ad esempio in risposta al messaggio di WM_DESTROY .

La funzione SetClipboardViewer esiste per garantire la compatibilità con le versioni precedenti di Windows. La catena di visualizzatore appunti può essere interrotta da un'applicazione che non riesce a gestire correttamente i messaggi della catena degli Appunti. Le nuove applicazioni devono usare tecniche più affidabili, ad esempio il numero di sequenza degli Appunti o la registrazione di un listener in formato Appunti. Per altre informazioni su queste tecniche alternative, vedere Monitoraggio dei contenuti degli Appunti.

Esempio

Per un esempio, vedere Aggiunta di una finestra alla catena visualizzatore Appunti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-misc-l1-5-1 (introdotta in Windows 10, versione 10.0.14393)