Funzione GetTextFaceA (wingdi.h)
La funzione GetTextFace recupera il nome del carattere di tipo selezionato nel contesto del dispositivo specificato.
Sintassi
int GetTextFaceA(
[in] HDC hdc,
[in] int c,
[out] LPSTR lpName
);
Parametri
[in] hdc
Handle nel contesto del dispositivo.
[in] c
Lunghezza del buffer a cui punta lpFaceName. Per la funzione ANSI è un conteggio BYTE e per la funzione Unicode è un conteggio di WORD. Si noti che per la funzione ANSI, i caratteri nelle pagine codici SBCS accettano un byte ogni byte, mentre la maggior parte dei caratteri nelle pagine codici DBCS accetta due byte; per la funzione Unicode, la maggior parte dei caratteri Unicode attualmente definiti (quelli nel piano multilingue di base (BMP) sono una WORD mentre i surrogati Unicode sono due WORD.
[out] lpName
Puntatore al buffer che riceve il nome del carattere di tipo. Se questo parametro è NULL, la funzione restituisce il numero di caratteri nel nome, incluso il carattere Null terminante.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è il numero di caratteri copiati nel buffer.
Se la funzione ha esito negativo, il valore restituito è zero.
Commenti
Il nome del carattere tipizzato viene copiato come stringa di caratteri con terminazione Null.
Se il nome è più lungo del numero di caratteri specificato dal parametro nCount , il nome viene troncato.
Nota
L'intestazione wingdi.h definisce GetTextFace 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
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | wingdi.h (include Windows.h) |
| Libreria | Gdi32.lib |
| DLL | Gdi32.dll |