Funzione GetCharABCWidthsFloatA (wingdi.h)

Articolo
11/20/2024

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

Handle 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 riceve 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.

Osservazioni

A differenza della funzione GetCharABCWidths che restituisce larghezze solo per i tipi di carattere TrueType, la funzione GetCharABCWidthsFlo at recupera le 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 possono 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 non compresi nell'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 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