Freigeben über


CDC::GetOutlineTextMetrics

Ruft metrische Informationen für TrueType-Schriftarten ab.

UINT GetOutlineTextMetrics( 
   UINT cbData, 
   LPOUTLINETEXTMETRIC lpotm 
) const;

Parameter

  • lpotm
    Zeigt auf einem Array OUTLINETEXTMETRIC-Strukturen. Wenn dieser Parameter NULL ist, gibt die Funktion die Größe des Puffers zurück, der für die abgerufenen metrischen Daten benötigt wird.

  • cbData
    Gibt die Größe, in Bytes, des Puffers an, zu dem Informationen zurückgegeben werden.

  • lpotm
    zeigt auf eine OUTLINETEXTMETRIC-Struktur. Wenn dieser Parameter NULL ist, gibt die Funktion die Größe des Puffers zurück, der zu der abgerufenen metrischen Informationen benötigt wird.

Rückgabewert

Ungleich 0 (null), wenn die Funktion erfolgreich; 0 andernfalls.

Hinweise

Die OUTLINETEXTMETRIC-Struktur enthält die meisten der metrischen Informationen der Schriftarten, die mit dem TrueType-Format, einschließlich einer TEXTMETRIC-Struktur bereitgestellt werden. Die letzten vier Member der Struktur OUTLINETEXTMETRIC sind Zeiger auf Zeichenfolgen. Anwendungen sollten Leerzeichen für diese Zeichenfolgen zusätzlich zum Speicherplatz zuordnen, das für die anderen Member benötigt wird. Da keine systembedingte Begrenzung für die Größe der Zeichenfolgen gibt, ist die einfachste Methode zum Belegen, die erforderliche Größe abzurufen, indem sie NULL für lpotm im ersten Aufruf der Funktion GetOutlineTextMetrics angibt.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CDC-Klasse

Hierarchiediagramm

GetTextMetrics

GetOutlineTextMetrics

CDC::GetTextMetrics