Funzione SetClipboardData (winuser.h)

Articolo
08/28/2023

Inserisce i dati negli Appunti in un formato specificato negli Appunti. La finestra deve essere il proprietario corrente degli Appunti e l'applicazione deve avere chiamato la funzione OpenClipboard . Quando risponde al messaggio di WM_RENDERFORMAT , il proprietario degli Appunti non deve chiamare OpenClipboard prima di chiamare SetClipboardData.

Sintassi

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

Parametri

[in] uFormat

Tipo: UINT

Formato degli Appunti. Questo parametro può essere un formato registrato o uno dei formati standard degli Appunti. Per altre informazioni, vedere Formati standard degli Appunti e formati registrati negli Appunti.

[in, optional] hMem

Tipo: HANDLE

Handle per i dati nel formato specificato. Questo parametro può essere NULL, che indica che la finestra fornisce dati nel formato degli Appunti specificato (esegue il rendering del formato) su richiesta; questo è noto come rendering ritardato. Se un rendering di una finestra ritarda, deve elaborare i messaggi di WM_RENDERFORMAT e WM_RENDERALLFORMATS .

Se SetClipboardData ha esito positivo, il sistema possiede l'oggetto identificato dal parametro hMem . L'applicazione potrebbe non scrivere o liberare i dati dopo che la proprietà è stata trasferita al sistema, ma può bloccare e leggere dai dati fino a quando non viene chiamata la funzione CloseClipboard . La memoria deve essere sbloccata prima della chiusura degli Appunti. Se il parametro hMem identifica un oggetto memoria, l'oggetto deve essere stato allocato usando la funzione con il flag di GMEM_MOVEABLE .

Valore restituito

Tipo: HANDLE

Se la funzione ha esito positivo, il valore restituito è l'handle per i dati.

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

Commenti

Windows 8: Le bitmap da condividere con le app di Windows Store devono essere nel formato CF_BITMAP (bitmap dipendente dal dispositivo).

Se un'applicazione chiama SetClipboardData in risposta a WM_RENDERFORMAT o WM_RENDERALLFORMATS, l'applicazione non deve usare l'handle dopo aver chiamato SetClipboardData.

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

Il sistema esegue conversioni di formato dati implicite tra determinati formati appunti quando un'applicazione chiama la funzione GetClipboardData . Ad esempio, se il formato CF_OEMTEXT si trova negli Appunti, una finestra può recuperare i dati nel formato CF_TEXT . Il formato negli Appunti viene convertito nel formato richiesto su richiesta. Per altre informazioni, vedere Formati degli Appunti sintetizzati.

Esempio

Per un esempio, vedere Copia di informazioni negli Appunti.

Requisiti


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)