IsClipboardFormatAvailable, fonction (winuser.h)

Article
03/04/2024

Détermine si le Presse-papiers contient des données au format spécifié.

Syntaxe

BOOL IsClipboardFormatAvailable(
  [in] UINT format
);

Paramètres

[in] format

Type : UINT

Format de Presse-papiers standard ou inscrit. Pour obtenir une description des formats standard du Presse-papiers, consultez Formats du Presse-papiers standard .

Valeur retournée

Type : BOOL

Si le format du Presse-papiers est disponible, la valeur de retour est différente de zéro.

Si le format du Presse-papiers n’est pas disponible, la valeur de retour est zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

En règle générale, une application qui ne reconnaît qu’un seul format de Presse-papiers appelle cette fonction lors du traitement du message WM_INITMENU ou WM_INITMENUPOPUP . L’application active ou désactive ensuite l’élément de menu Coller, en fonction de la valeur de retour. Les applications qui reconnaissent plusieurs formats de Presse-papiers doivent utiliser la fonction GetPriorityClipboardFormat à cet effet.

Exemples

Pour obtenir un exemple, consultez Collage d’informations à partir 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-2-0 (introduit dans Windows 8.1)