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