OpenClipboard, fonction (winuser.h)

Article
03/06/2024

Ouvre le Presse-papiers pour examen et empêche d’autres applications de modifier le contenu du Presse-papiers.

Syntaxe

BOOL OpenClipboard(
  [in, optional] HWND hWndNewOwner
);

Paramètres

[in, optional] hWndNewOwner

Type : HWND

Handle de la fenêtre à associer au Presse-papiers ouvert. Si ce paramètre a la valeur NULL, le Presse-papiers ouvert est associé à la tâche actuelle.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

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

Remarques

OpenClipboard échoue si le Presse-papiers est ouvert dans une autre fenêtre.

Une application doit appeler la fonction CloseClipboard après chaque appel réussi à OpenClipboard.

La fenêtre identifiée par le paramètre hWndNewOwner ne devient pas le propriétaire du Presse-papiers, sauf si la fonction EmptyClipboard est appelée.

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 .

Exemples

Pour obtenir un exemple, consultez Copie d’informations dans le 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)