Funzione GetCharABCWidthsFloatA (wingdi.h)

Articolo
08/27/2023

La funzione GetCharABCWidthsFloat recupera le larghezze, in unità logiche, di caratteri consecutivi in un intervallo specificato dal tipo di carattere corrente.

Sintassi

BOOL GetCharABCWidthsFloatA(
  [in]  HDC        hdc,
  [in]  UINT       iFirst,
  [in]  UINT       iLast,
  [out] LPABCFLOAT lpABC
);

Parametri

[in] hdc

Gestire nel contesto del dispositivo.

[in] iFirst

Specifica il punto di codice del primo carattere nel gruppo di caratteri consecutivi in cui vengono cercate le larghezze ABC.

[in] iLast

Specifica il punto di codice dell'ultimo carattere nel gruppo di caratteri consecutivi in cui vengono cercate le larghezze ABC. Questo intervallo è inclusivo. Se l'ultimo carattere specificato precede il primo carattere specificato, viene restituito un errore.

[out] lpABC

Puntatore a una matrice di strutture ABCFLOAT che ricevono le larghezze dei caratteri, in unità logiche.

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

A differenza della funzione GetCharABCWidths che restituisce larghezze solo per i tipi di carattere TrueType, la funzione GetCharABCWidthsFloat recupera larghezze per qualsiasi tipo di carattere. Le larghezze restituite da questa funzione sono nel formato a virgola mobile IEEE.

Se la trasformazione da mondo a dispositivo corrente non viene identificata, le larghezze restituite potrebbero essere valori non iniziali, anche se i valori corrispondenti nello spazio del dispositivo sono numeri interi.

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.

Gli spazi ABC vengono misurati lungo la linea di base del carattere selezionato.

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

Nota

L'intestazione wingdi.h definisce GetCharABCWidthsFloat 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


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