Funzione GetOutlineTextMetricsW (wingdi.h)

Articolo
20/11/2024

La funzione GetOutlineTextMetrics recupera le metriche di testo per i tipi di carattere TrueType.

Sintassi

C++

UINT GetOutlineTextMetricsW(
  [in]            HDC                  hdc,
  [in]            UINT                 cjCopy,
  [out, optional] LPOUTLINETEXTMETRICW potm
);

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[in] cjCopy

Dimensioni, in byte, della matrice che riceve le metriche di testo.

[out, optional] potm

Puntatore a una struttura OUTLINETEXTMETRIC . Se questo parametro è NULL, la funzione restituisce le dimensioni del buffer necessario per i dati delle metriche recuperati.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero o la dimensione del buffer richiesto.

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

Osservazioni

La struttura OUTLINETEXTMETRIC contiene la maggior parte delle informazioni sulle metriche di testo fornite per i tipi di carattere TrueType (inclusa una struttura TEXTMETRIC ). Le dimensioni restituite in OUTLINETEXTMETRIC sono in unità logiche; dipendono dalla modalità di mapping corrente.

Nota

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