Funzione GetCharABCWidthsA (wingdi.h)

Articolo
03/08/2023

La funzione GetCharABCWidths recupera le larghezze, in unità logiche, di caratteri consecutivi in un intervallo specificato dal tipo di carattere TrueType corrente. Questa funzione ha esito positivo solo con tipi di carattere TrueType.

Sintassi

BOOL GetCharABCWidthsA(
  [in]  HDC   hdc,
  [in]  UINT  wFirst,
  [in]  UINT  wLast,
  [out] LPABC lpABC
);

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[in] wFirst

Primo carattere nel gruppo di caratteri consecutivi del tipo di carattere corrente.

[in] wLast

Ultimo carattere nel gruppo di caratteri consecutivi del tipo di carattere corrente.

[out] lpABC

Puntatore a una matrice di strutture ABC che riceve le larghezze dei caratteri, in unità logiche. Questa matrice deve contenere almeno il numero di strutture ABC presenti nell'intervallo specificato dai parametri uFirstChar e uLastChar .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Il rasterizzatore TrueType fornisce la spaziatura dei caratteri ABC dopo aver selezionato una dimensione del punto specifica. Una spaziatura è la distanza aggiunta alla posizione corrente prima di posizionare il glifo. La spaziatura B è la larghezza della parte nera del glifo. La spaziatura C è la distanza aggiunta alla posizione corrente per fornire spazio vuoto a destra del glifo. La larghezza avanzata totale è specificata da A+B+C.

Quando la funzione GetCharABCWidths recupera larghezze A o C negative per un carattere, tale carattere include sporgenti o sporgenti.

Per convertire le larghezze ABC in unità di progettazione dei tipi di carattere, un'applicazione deve usare il valore archiviato nel membro otmEMSquare di una struttura OUTLINETEXTMETRIC . Questo valore può essere recuperato chiamando la funzione GetOutlineTextMetrics .

Le larghezze ABC del carattere predefinito vengono utilizzate per i caratteri al di fuori dell'intervallo del tipo di carattere attualmente selezionato.

Per recuperare la larghezza dei caratteri nei tipi di carattere non TrueType, le applicazioni devono usare la funzione GetCharWidth .

Nota

L'intestazione wingdi.h definisce GetCharABCWidths come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll