Fonction EmptyClipboard (winuser.h)
Vide le Presse-papiers et libère les poignées dans les données du Presse-papiers. La fonction affecte ensuite la propriété du Presse-papiers à la fenêtre sur laquelle le Presse-papiers est actuellement ouvert.
Syntaxe
BOOL EmptyClipboard();
Valeur de retour
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
Avant d’appeler EmptyClipboard, une application doit ouvrir le Presse-papiers à l’aide de la fonction OpenClipboard . Si l’application spécifie un handle de fenêtre NULL lors de l’ouverture du Presse-papiers, EmptyClipboard réussit, mais définit le propriétaire du Presse-papiers sur NULL. Notez que 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