Funzione RegisterClipboardFormatA (winuser.h)
Registra un nuovo formato degli Appunti. Questo formato può quindi essere usato come formato valido negli Appunti.
Sintassi
UINT RegisterClipboardFormatA(
[in] LPCSTR lpszFormat
);
Parametri
[in] lpszFormat
Tipo: LPCTSTR
Nome del nuovo formato.
Valore restituito
Tipo: UINT
Se la funzione ha esito positivo, il valore restituito identifica il formato degli Appunti registrato.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Se esiste già un formato registrato con il nome specificato, un nuovo formato non è registrato e il valore restituito identifica il formato esistente. Ciò consente a più applicazioni di copiare e incollare i dati usando lo stesso formato registrato negli Appunti. Si noti che il confronto tra nomi di formato è senza distinzione tra maiuscole e minuscole.
I formati registrati negli Appunti sono identificati dai valori nell'intervallo 0xC000 tramite 0xFFFF.
Quando i formati degli Appunti registrati vengono inseriti negli Appunti o recuperati dagli Appunti, devono essere sotto forma di valore HGLOBAL .
Esempio
Per un esempio, vedere Registrazione di un formato appunti.
Nota
L'intestazione winuser.h definisce RegisterClipboardFormat come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
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) |
Vedi anche
Informazioni concettuali
Riferimento