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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour