Funzione GetClipboardData (winuser.h)
Recupera i dati dagli Appunti in un formato specificato. Gli Appunti devono essere stati aperti in precedenza.
Sintassi
HANDLE GetClipboardData(
[in] UINT uFormat
);
Parametri
[in] uFormat
Tipo: UINT
Formato appunti. Per una descrizione dei formati standard degli Appunti, vedere Formati standard degli Appunti.
Valore restituito
Tipo: HANDLE
Se la funzione ha esito positivo, il valore restituito è l'handle di un oggetto Appunti nel formato specificato.
Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Gli Appunti controllano l'handle restituito dalla funzione GetClipboardData , non dall'applicazione. L'applicazione deve copiare immediatamente i dati. L'applicazione non deve liberare l'handle né lasciarla bloccata. L'applicazione non deve usare l'handle dopo aver chiamato la funzione EmptyClipboard o CloseClipboard oppure dopo che la funzione SetClipboardData viene chiamata con lo stesso formato degli Appunti.
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) |
Vedi anche
Informazioni concettuali
Riferimento