Funzione ChangeClipboardChain (winuser.h)

Articolo
03/13/2024

Rimuove una finestra specificata dalla catena di visualizzatori degli Appunti.

Sintassi

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

Parametri

[in] hWndRemove

Tipo: HWND

Handle della finestra da rimuovere dalla catena. L'handle deve essere stato passato alla funzione SetClipboardViewer .

[in] hWndNewNext

Tipo: HWND

Handle per la finestra che segue la finestra hWndRemove nella catena del visualizzatore degli Appunti. Si tratta dell'handle restituito da SetClipboardViewer, a meno che la sequenza non sia stata modificata in risposta a un messaggio di WM_CHANGECBCHAIN .

Valore restituito

Tipo: BOOL

Il valore restituito indica il risultato del passaggio del messaggio WM_CHANGECBCHAIN alle finestre della catena del visualizzatore degli Appunti. Poiché una finestra nella catena restituisce in genere FALSE quando elabora WM_CHANGECBCHAIN, il valore restituito da ChangeClipboardChain è in genere FALSE. Se nella catena è presente una sola finestra, il valore restituito è in genere TRUE.

Commenti

La finestra identificata da hWndNewNext sostituisce la finestra hWndRemove nella catena. La funzione SetClipboardViewer invia un messaggio WM_CHANGECBCHAIN alla prima finestra della catena del visualizzatore degli Appunti.

Per un esempio, vedere Rimozione di una finestra dalla catena del 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 (introdotto in Windows 10, versione 10.0.14393)