Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Inscrit un nouveau format de Presse-papiers. Ce format peut ensuite être utilisé comme format de Presse-papiers valide.
Syntaxe
UINT RegisterClipboardFormatA(
[in] LPCSTR lpszFormat
);
Paramètres
[in] lpszFormat
Type : LPCTSTR
Nom du nouveau format.
Valeur de retour
Type : uiNT
Si la fonction réussit, la valeur de retour identifie le format du Presse-papiers inscrit.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Remarques
Si un format inscrit portant le nom spécifié existe déjà, un nouveau format n’est pas inscrit et la valeur de retour identifie le format existant. Cela permet à plusieurs applications de copier et coller des données au même format de Presse-papiers inscrit. Notez que la comparaison de noms de format ne respecte pas la casse.
Les formats de Presse-papiers inscrits sont identifiés par des valeurs dans la plage 0xC000 via 0xFFFF.
Lorsque les formats de Presse-papiers inscrits sont placés ou récupérés dans le Presse-papiers, ils doivent être sous la forme d’une valeur HGLOBAL.
Exemples
Pour obtenir un exemple, consultez Inscrire un format presse-papiers.
Note
L’en-tête winuser.h définit RegisterClipboardFormat comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winuser.h (include 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
conceptuelle
de référence