Fonction EmptyClipboard (winuser.h)

Article
03/04/2024

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)