Partager via


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

Presse-papiers

Conceptuel

OpenClipboard

Référence

SetClipboardData

WM_DESTROYCLIPBOARD