SetClipboardViewer, fonction (winuser.h)

Article
08/28/2023

Ajoute la fenêtre spécifiée à la chaîne de visionneuses du Presse-papiers. Les fenêtres de visionneuse du Presse-papiers reçoivent un message WM_DRAWCLIPBOARD chaque fois que le contenu du Presse-papiers change. Cette fonction est utilisée pour la compatibilité descendante avec les versions antérieures de Windows.

Syntaxe

HWND SetClipboardViewer(
  [in] HWND hWndNewViewer
);

Paramètres

[in] hWndNewViewer

Type : HWND

Handle à la fenêtre à ajouter à la chaîne du Presse-papiers.

Valeur retournée

Type : HWND

Si la fonction réussit, la valeur de retour identifie la fenêtre suivante dans la chaîne de visionneuse du Presse-papiers. Si une erreur se produit ou s’il n’y a pas d’autres fenêtres dans la chaîne de visionneuse du Presse-papiers, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Les fenêtres qui font partie de la chaîne de visionneuse du Presse-papiers, appelées fenêtres de visionneuse du Presse-papiers, doivent traiter les messages du Presse-papiers WM_CHANGECBCHAIN et WM_DRAWCLIPBOARD. Chaque fenêtre de visionneuse du Presse-papiers appelle la fonction SendMessage pour passer ces messages à la fenêtre suivante de la chaîne de visionneuse du Presse-papiers.

Une fenêtre de visionneuse du Presse-papiers doit finalement se supprimer de la chaîne de visionneuse du Presse-papiers en appelant la fonction ChangeClipboardChain , par exemple, en réponse au message WM_DESTROY .

La fonction SetClipboardViewer existe pour assurer la compatibilité descendante avec les versions antérieures de Windows. La chaîne de visionneuse du Presse-papiers peut être interrompue par une application qui ne parvient pas à gérer correctement les messages de chaîne du Presse-papiers. Les nouvelles applications doivent utiliser des techniques plus robustes, telles que le numéro séquentiel du Presse-papiers ou l’inscription d’un écouteur de format presse-papiers. Pour plus d’informations sur ces techniques alternatives, consultez Surveillance du contenu du Presse-papiers.

Exemples

Pour obtenir un exemple, consultez Ajout d’une fenêtre à 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)