SetClipboardViewer, fonction (winuser.h)
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) |
Voir aussi
Conceptuel
Référence