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

Vedi anche

Appunti

CloseClipboard

Informazioni concettuali

EmptyClipboard

EnumClipboardFormats

Riferimento

SetClipboardData