OpenClipboard, fonction (winuser.h)
Ouvre le Presse-papiers pour examen et empêche d’autres applications de modifier le contenu du Presse-papiers.
Syntaxe
BOOL OpenClipboard(
[in, optional] HWND hWndNewOwner
);
Paramètres
[in, optional] hWndNewOwner
Type : HWND
Handle de la fenêtre à associer au Presse-papiers ouvert. Si ce paramètre a la valeur NULL, le Presse-papiers ouvert est associé à la tâche actuelle.
Valeur retournée
Type : BOOL
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
OpenClipboard échoue si le Presse-papiers est ouvert dans une autre fenêtre.
Une application doit appeler la fonction CloseClipboard après chaque appel réussi à OpenClipboard.
La fenêtre identifiée par le paramètre hWndNewOwner ne devient pas le propriétaire du Presse-papiers, sauf si la fonction EmptyClipboard est appelée.
Si une application appelle OpenClipboard avec hwnd défini sur NULL, EmptyClipboard définit le propriétaire du Presse-papiers sur NULL ; Cela entraîne l’échec de SetClipboardData .
Exemples
Pour obtenir un exemple, consultez Copie d’informations dans le 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-2-0 (introduit dans Windows 8.1) |
Voir aussi
Conceptuel
Référence