Funzione GetOutlineTextMetricsA (wingdi.h)

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

Sintassi

UINT GetOutlineTextMetricsA(
  [in]            HDC                  hdc,
  [in]            UINT                 cjCopy,
  [out, optional] LPOUTLINETEXTMETRICA potm
);

Parametri

[in] hdc

Handle nel 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 necessarie per i dati delle metriche recuperate.

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.

Commenti

La struttura OUTLINETEXTMETRIC contiene la maggior parte delle informazioni sulla metrica 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
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

Vedi anche

Funzioni carattere e testo

Panoramica dei tipi di carattere e del testo

GetTextMetrics

OUTLINETEXTMETRIC

TEXTMETRIC