Funzione GetTextFaceA (wingdi.h)

Articolo
08/27/2023

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