Freigeben über


GetOutlineTextMetricsA-Funktion (wingdi.h)

Die GetOutlineTextMetrics-Funktion ruft Textmetriken für TrueType-Schriftarten ab.

Syntax

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

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] cjCopy

Die Größe des Arrays in Bytes, das die Textmetriken empfängt.

[out, optional] potm

Ein Zeiger auf eine OUTLINETEXTMETRIC-Struktur . Wenn dieser Parameter NULL ist, gibt die Funktion die Größe des Puffers zurück, der für die abgerufenen Metrikdaten erforderlich ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert nonzero oder die Größe des erforderlichen Puffers.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Die OUTLINETEXTMETRIC-Struktur enthält die meisten Informationen zur Textmetrik, die für TrueType-Schriftarten (einschließlich einer TEXTMETRIC-Struktur ) bereitgestellt werden. Die in OUTLINETEXTMETRIC zurückgegebenen Größen befinden sich in logischen Einheiten. Sie hängen vom aktuellen Zuordnungsmodus ab.

Hinweis

Der wingdi.h-Header definiert GetOutlineTextMetrics als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wingdi.h (einschließlich Windows.h)
Bibliothek Gdi32.lib
DLL Gdi32.dll

Weitere Informationen

Schriftart- und Textfunktionen

Übersicht über Schriftarten und Text

GetTextMetrics

OUTLINETEXTMETRIC

TEXTMETRIC