ChangeClipboardChain, fonction (winuser.h)

Article
08/27/2023

Supprime une fenêtre spécifiée de la chaîne de visionneuses du Presse-papiers.

Syntaxe

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

Paramètres

[in] hWndRemove

Type : HWND

Handle de la fenêtre à supprimer de la chaîne. Le handle doit avoir été passé à la fonction SetClipboardViewer .

[in] hWndNewNext

Type : HWND

Handle de la fenêtre qui suit la fenêtre hWndRemove dans la chaîne de visionneuse du Presse-papiers. (Il s’agit du handle retourné par SetClipboardViewer, sauf si la séquence a été modifiée en réponse à un message WM_CHANGECBCHAIN .)

Valeur retournée

Type : BOOL

La valeur de retour indique le résultat du passage du message WM_CHANGECBCHAIN aux fenêtres de la chaîne de visionneuse du Presse-papiers. Étant donné qu’une fenêtre de la chaîne retourne généralement FALSE lorsqu’elle traite WM_CHANGECBCHAIN, la valeur de retour de ChangeClipboardChain est généralement FALSE. S’il n’y a qu’une seule fenêtre dans la chaîne, la valeur de retour est généralement TRUE.

Remarques

La fenêtre identifiée par hWndNewNext remplace la fenêtre hWndRemove dans la chaîne. La fonction SetClipboardViewer envoie un message WM_CHANGECBCHAIN à la première fenêtre de la chaîne de visionneuse du Presse-papiers.

Pour obtenir un exemple, consultez Suppression d’une fenêtre de la chaîne de visionneuse du Presse-papiers.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-misc-l1-5-1 (introduit dans Windows 10, version 10.0.14393)