Funzione GetCharABCWidthsA (wingdi.h)

Articolo
11/20/2024

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 i 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 caratteri 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.

Osservazioni

Il rasterizzatore TrueType fornisce la spaziatura dei caratteri ABC dopo che è stata selezionata una dimensione 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 le larghezze A o C negative per un carattere, tale carattere include sporgenti o sovrasporgenti.

Per convertire le larghezze ABC in unità di progettazione dei tipi di carattere, un'applicazione deve utilizzare 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 non compresi nell'intervallo del tipo di carattere attualmente selezionato.

Per recuperare la larghezza dei caratteri in 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wingdi.h (include Windows.h)
libreria	Gdi32.lib
dll	Gdi32.dll