Partager via


ChangeClipboardChain, fonction (winuser.h)

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)

Voir aussi

ChangeClipboardChain

Presse-papiers

Conceptuel

Référence

SetClipboardViewer

WM_CHANGECBCHAIN