Funzione OpenClipboard (winuser.h)

Articolo
03/13/2024

Apre gli Appunti per l'esame e impedisce ad altre applicazioni di modificare il contenuto degli Appunti.

Sintassi

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

Parametri

[in, optional] hWndNewOwner

Tipo: HWND

Handle della finestra da associare agli Appunti aperti. Se questo parametro è NULL, gli Appunti aperti sono associati all'attività corrente.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

OpenClipboard ha esito negativo se gli Appunti sono aperti da un'altra finestra.

Un'applicazione deve chiamare la funzione CloseClipboard dopo ogni chiamata riuscita a OpenClipboard.

La finestra identificata dal parametro hWndNewOwner non diventa il proprietario degli Appunti a meno che non venga chiamata la funzione EmptyClipboard .

Se un'applicazione chiama OpenClipboard con hwnd impostato su NULL, EmptyClipboard imposta il proprietario degli Appunti su NULL; in questo modo SetClipboardData non riesce.

Esempio

Per un esempio, vedere Copia di informazioni negli Appunti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-misc-l1-2-0 (introdotto in Windows 8.1)