SetClipboardData, fonction (winuser.h)

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 Formatsdu 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

Voir aussi

Presse-papiers

CloseClipboard

Conceptuel

GetClipboardData

OpenClipboard

Référence

RegisterClipboardFormat

WM_RENDERALLFORMATS

WM_RENDERFORMAT