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, das die Textmetriken empfängt, in Byte.

[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 ungleich Null oder die Größe des erforderlichen Puffers.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null.

Bemerkungen

Die OUTLINETEXTMETRIC- Struktur enthält die meisten für TrueType-Schriftarten bereitgestellten Textmetrikinformationen (einschließlich einer TEXTMETRIC- Struktur). Die in OUTLINETEXTMETRIC- zurückgegebenen Größen befinden sich in logischen Einheiten; sie hängen vom aktuellen Zuordnungsmodus ab.

Anmerkung

The wingdi.h header defines GetOutlineTextMetrics as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client- Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Zielplattform- Fenster
Header- wingdi.h (enthalten Windows.h)
Library Gdi32.lib
DLL- Gdi32.dll

Siehe auch

Schriftart- und Textfunktionen

Schriftarten und Textübersicht

GetTextMetrics-

OUTLINETEXTMETRIC-

TEXTMETRIC-