GetFontData-Funktion (wingdi.h)

Die GetFontData-Funktion ruft Schriftartmetrikendaten für eine TrueType-Schriftart ab.

Syntax

DWORD GetFontData(
  [in]  HDC   hdc,
  [in]  DWORD dwTable,
  [in]  DWORD dwOffset,
  [out] PVOID pvBuffer,
  [in]  DWORD cjBuffer
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] dwTable

Der Name einer Schriftartmetriktabelle, aus der die Schriftartdaten abgerufen werden sollen. Dieser Parameter kann eine der Metriktabellen identifizieren, die in der von der Microsoft Corporation veröffentlichten TrueType Font Files-Spezifikation dokumentiert sind. Wenn dieser Parameter null ist, werden die Informationen ab dem Anfang der Datei für TrueType-Schriftartdateien oder ab dem Anfang der Daten für die aktuell ausgewählte Schriftart für TrueType-Sammlungsdateien abgerufen. Um die Daten vom Anfang der Datei für TrueType-Sammlungsdateien abzurufen, geben Sie "ttcf" (0x66637474) an.

[in] dwOffset

Der Offset vom Anfang der Metriktabelle der Schriftart bis zum Speicherort, an dem die Funktion mit dem Abrufen von Informationen beginnen soll. Wenn dieser Parameter null ist, werden die Informationen ab dem Anfang der Tabelle abgerufen, die durch den dwTable-Parameter angegeben wird. Wenn dieser Wert größer oder gleich der Größe der Tabelle ist, tritt ein Fehler auf.

[out] pvBuffer

Ein Zeiger auf einen Puffer, der die Schriftartinformationen empfängt. Wenn dieser Parameter NULL ist, gibt die Funktion die Größe des Puffers zurück, der für die Schriftartdaten erforderlich ist.

[in] cjBuffer

Die Länge der abzurufenden Informationen in Bytes. Wenn dieser Parameter null ist, gibt GetFontData die Größe der daten zurück, die im dwTable-Parameter angegeben sind.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der zurückgegebenen Bytes.

Wenn die Funktion fehlschlägt, wird der Rückgabewert GDI_ERROR.

Hinweise

Diese Funktion soll verwendet werden, um TrueType-Schriftartinformationen direkt aus der Schriftartdatei durch Schriftartbearbeitungsanwendungen abzurufen. Informationen zum Einbetten von Schriftarten finden Sie in der Referenz zur Einbettung von Schriftarten.

Eine Anwendung kann manchmal die GetFontData-Funktion verwenden, um eine TrueType-Schriftart mit einem Dokument zu speichern. Dazu bestimmt die Anwendung, ob die Schriftart eingebettet werden kann, indem sie den otmfsType-Member der OUTLINETEXTMETRIC-Struktur überprüft. Wenn Bit 1 von otmfsType festgelegt ist, ist das Einbetten für die Schriftart nicht zulässig. Wenn Bit 1 klar ist, kann die Schriftart eingebettet werden. Wenn Bit 2 festgelegt ist, ist die Einbettung schreibgeschützt. Wenn das Einbetten zulässig ist, kann die Anwendung die gesamte Schriftartdatei abrufen und null für die Parameter dwTable, dwOffset und cbData angeben.

Wenn eine Anwendung versucht, diese Funktion zum Abrufen von Informationen für eine Nicht-TrueType-Schriftart zu verwenden, tritt ein Fehler auf.

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 (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll

Weitere Informationen

Schriftart- und Textfunktionen

Übersicht über Schriftarten und Text

GetTextMetrics

OUTLINETEXTMETRIC