GetClipboardData, fonction (winuser.h)

Article
08/27/2023

Récupère les données du Presse-papiers dans un format spécifié. Le Presse-papiers doit avoir été ouvert précédemment.

Syntaxe

HANDLE GetClipboardData(
  [in] UINT uFormat
);

Paramètres

[in] uFormat

Type : UINT

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

Valeur retournée

Type : HANDLE

Si la fonction réussit, la valeur de retour est le handle d’un objet presse-papiers au format spécifié.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Attention Les données du Presse-papiers ne sont pas approuvées. Analysez soigneusement les données avant de les utiliser dans votre application.

Une application peut énumérer les formats disponibles à l’avance à l’aide de la fonction EnumClipboardFormats .

Le Presse-papiers contrôle le handle retourné par la fonction GetClipboardData , et non l’application. L’application doit copier les données immédiatement. L’application ne doit pas libérer le handle ni le laisser verrouillé. L’application ne doit pas utiliser le handle après l’appel de la fonction EmptyClipboard ou CloseClipboard , ou après l’appel de la fonction SetClipboardData avec le même format de Presse-papiers.

Le système effectue des conversions implicites de format de données entre certains formats du Presse-papiers lorsqu’une application appelle la fonction GetClipboardData . Par exemple, si le format CF_OEMTEXT se trouve dans le Presse-papiers, une fenêtre peut récupérer des données au format CF_TEXT . Le format dans le Presse-papiers est converti en format demandé à la demande. Pour plus d’informations, consultez Formats du Presse-papiers synthétisé.

Exemples

Pour obtenir un exemple, consultez Copie d’informations dans le Presse-papiers.

Configuration requise


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)