Funzione GetTextExtentPointI (wingdi.h)

Articolo
03/08/2023

La funzione GetTextExtentPointI calcola la larghezza e l'altezza della matrice specificata di indici glifi.

Sintassi

BOOL GetTextExtentPointI(
  [in]  HDC    hdc,
  [in]  LPWORD pgiIn,
  [in]  int    cgi,
  [out] LPSIZE psize
);

Parametri

[in] hdc

Gestire nel contesto del dispositivo.

[in] pgiIn

Puntatore alla matrice di indici del glifo.

[in] cgi

Specifica il numero di indici del glifo.

[out] psize

Puntatore a una struttura SIZE che riceve le dimensioni della stringa, 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

La funzione GetTextExtentPointI usa il tipo di carattere attualmente selezionato per calcolare le dimensioni della matrice di indici glifi. La larghezza e l'altezza, in unità logiche, vengono calcolate senza considerare alcun ritaglio.

Quando questa funzione restituisce l'extent di testo, presuppone che il testo sia orizzontale, ovvero che l'escape sia sempre 0. Questo vale sia per le misurazioni orizzontali che verticali del testo. Anche se si usa un tipo di carattere che specifica un carattere di escape diverso da zero, questa funzione non usa l'angolo mentre calcola l'extent di testo. L'app deve convertirla in modo esplicito. Tuttavia, quando la modalità grafica è impostata su GM_ADVANCED e l'orientamento del carattere è di 90 gradi rispetto all'orientamento di stampa, i valori restituiti da questa funzione non seguono questa regola. Quando l'orientamento del carattere e l'orientamento di stampa corrispondono per una determinata stringa, questa funzione restituisce le dimensioni della stringa nella struttura SIZE come { cx : 116, cy : 18 }. Quando l'orientamento dei caratteri e l'orientamento di stampa sono separati da 90 gradi per la stessa stringa, questa funzione restituisce le dimensioni della stringa nella struttura SIZE come { cx : 18, cy : 116 }.

Poiché alcuni dispositivi caratteri crenatura, la somma degli extent dei singoli indici del glifo potrebbe non essere uguale alla misura dell'intera matrice di indici glifi.

La larghezza della stringa calcolata tiene conto della spaziatura intercaracter impostata dalla funzione SetTextCharacterExtra .

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