Funzione EnumClipboardFormats (winuser.h)

Articolo
03/13/2024

Enumera i formati di dati attualmente disponibili negli Appunti.

I formati di dati degli Appunti vengono archiviati in un elenco ordinato. Per eseguire un'enumerazione dei formati di dati degli Appunti, si effettua una serie di chiamate alla funzione EnumClipboardFormats . Per ogni chiamata, il parametro di formato specifica un formato degli Appunti disponibile e la funzione restituisce il formato degli Appunti disponibile successivo.

Sintassi

UINT EnumClipboardFormats(
  [in] UINT format
);

Parametri

[in] format

Tipo: UINT

Formato degli Appunti noto per essere disponibile.

Per avviare un'enumerazione dei formati degli Appunti, impostare il formato su zero. Quando il formato è zero, la funzione recupera il primo formato disponibile negli Appunti. Per le chiamate successive durante un'enumerazione, impostare il formato sul risultato della chiamata EnumClipboardFormats precedente.

Valore restituito

Tipo: UINT

Se la funzione ha esito positivo, il valore restituito è il formato degli Appunti che segue il formato specificato, ovvero il formato successivo disponibile negli Appunti.

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

Se non sono presenti più formati degli Appunti da enumerare, il valore restituito è zero. In questo caso, la funzione GetLastError restituisce il valore ERROR_SUCCESS. Ciò consente di distinguere tra l'errore della funzione e la fine dell'enumerazione.

Commenti

È necessario aprire gli Appunti prima di enumerare i relativi formati. Usare la funzione OpenClipboard per aprire gli Appunti. La funzione EnumClipboardFormats ha esito negativo se gli Appunti non sono aperti.

La funzione EnumClipboardFormats enumera i formati nell'ordine in cui sono stati inseriti negli Appunti. Se si copiano informazioni negli Appunti, aggiungere oggetti Appunti in ordine dal formato più descrittivo degli Appunti al formato meno descrittivo degli Appunti. Se si incollano informazioni dagli Appunti, recuperare il primo formato degli Appunti che è possibile gestire. Questo sarà il formato più descrittivo degli Appunti che è possibile gestire.

Il sistema fornisce conversioni automatiche dei tipi per determinati formati degli Appunti. Nel caso di tale formato, questa funzione enumera il formato specificato, quindi enumera i formati a cui può essere convertito. Per altre informazioni, vedere Formati standard degli Appunti e Formati degli Appunti sintetizzati.

Esempio

Per un esempio, vedere Esempio di visualizzatore 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-5-1 (introdotta in Windows 10, versione 10.0.14393)