SetClipboardData, fonction (winuser.h)

Article
08/28/2023

Place les données dans le Presse-papiers dans un format spécifié. La fenêtre doit être le propriétaire actuel du Presse-papiers, et l’application doit avoir appelé la fonction OpenClipboard . (Quand il répond au message WM_RENDERFORMAT , le propriétaire du Presse-papiers ne doit pas appeler OpenClipboard avant d’appeler SetClipboardData.)

Syntaxe

HANDLE SetClipboardData(
  [in]           UINT   uFormat,
  [in, optional] HANDLE hMem
);

Paramètres

[in] uFormat

Type : UINT

Format du Presse-papiers. Ce paramètre peut être un format inscrit ou l’un des formats standard du Presse-papiers. Pour plus d’informations, consultez Formats du Presse-papiers standard et Formats du Presse-papiers inscrit.

[in, optional] hMem

Type : HANDLE

Handle pour les données dans le format spécifié. Ce paramètre peut avoir la valeur NULL, ce qui indique que la fenêtre fournit des données au format du Presse-papiers spécifié (affiche le format) sur demande ; il s’agit d’un rendu différé. Si une fenêtre retarde le rendu, elle doit traiter les messages WM_RENDERFORMAT et WM_RENDERALLFORMATS .

Si SetClipboardData réussit, le système est propriétaire de l’objet identifié par le paramètre hMem . L’application peut ne pas écrire dans ou libérer les données une fois que la propriété a été transférée au système, mais elle peut verrouiller et lire à partir des données jusqu’à ce que la fonction CloseClipboard soit appelée. (La mémoire doit être déverrouillée avant la fermeture du Presse-papiers.) Si le paramètre hMem identifie un objet mémoire, l’objet doit avoir été alloué à l’aide de la fonction avec l’indicateur GMEM_MOVEABLE .

Valeur retournée

Type : HANDLE

Si la fonction réussit, la valeur de retour est le handle des données.

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

Remarques

Windows 8 : Les bitmaps à partager avec les applications d’application du Windows Store doivent être au format CF_BITMAP (bitmap dépendante de l’appareil).

Si une application appelle SetClipboardData en réponse à WM_RENDERFORMAT ou WM_RENDERALLFORMATS, l’application ne doit pas utiliser le handle après l’appel de SetClipboardData .

Si une application appelle OpenClipboard avec hwnd défini sur NULL, EmptyClipboard définit le propriétaire du Presse-papiers sur NULL ; Cela entraîne l’échec de SetClipboardData .

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 du Presse-papiers est converti au format demandé à la demande. Pour plus d’informations, consultez Formats synthétisés du Presse-papiers.

Exemples

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

Spécifications


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)