CDC::GetFontData

Artikel
02/26/2013

Ruft SchriftartMetrik Informationen aus einer Datei der skalierbaren Schriftarten ab.

DWORD GetFontData(
   DWORD dwTable,
   DWORD dwOffset,
   LPVOID lpData,
   DWORD cbData 
) const;

Parameter

dwTable
Gibt den Namen der metrischen zurückgegeben werden, Tabelle an.Dieser Parameter kann eine der Tabellen metrischen sein, die in der TrueTyp-Schriftart-Dateibeschreibung dokumentiert werden, die von der Microsoft Corporation veröffentlicht wird.Wenn dieser Parameter 0 ist, sind die Informationen abgerufenes Starten am Anfang der Schriftartdatei.
dwOffset
Gibt den Offset vom Beginn der Tabelle an, mit der beginnen, Informationen abrufen.Wenn dieser Parameter 0 ist, sind die Informationen abgerufenes Starten am Anfang der Tabelle, die durch den dwTable-Parameter angegeben wird.Wenn dieser Wert größer oder gleich der Größe der Tabelle ist, GetFontData gibt 0 zurück.
lpData
Zeigt auf einen Puffer, der die Schriftartinformationen abruft.Wenn dieser Wert NULL ist, gibt die Funktion die Größe des Puffers zurück, der für die Schriftartdaten benötigt wird, die im dwTable-Parameter angegeben werden.
cbData
Gibt die Länge, in Bytes, der abgerufen werden, Informationen an.Wenn dieser Parameter 0 ist, gibt GetFontData die Größe der Daten zurück, die im dwTable-Parameter angegeben werden.

Rückgabewert

Gibt die Anzahl der Bytes an, die im Puffer zurückgegeben werden, der auf durch lpData dargestellt wird, wenn die Funktion erfolgreich; andernfalls - 1.

Hinweise

Die abzurufen Informationen werden identifiziert, indem ein Offset in die Schriftartdatei und in die Länge der Informationen angibt, um zurückzukehren.

Eine Anwendung kann die GetFontData-Memberfunktion manchmal verwenden, um eine TrueTyp-Schriftart mit einem Dokument zu speichern.Verwenden Sie hierzu die Anwendung bestimmt, ob die Schriftart eingebettet werden kann und ruft dann die gesamte Schriftartdatei ab und gibt 0 für dwTable, dwOffset und cbData-Parameter an.

Anwendungen können bestimmen, ob eine Schriftart eingebettet werden kann, indem die otmfsType-Member der Struktur OUTLINETEXTMETRIC überprüft.Wenn 1 Bit von otmfsType festgelegt ist, wird das Einbetten nicht für die Schriftart zulässig.Wenn 1 Bit deaktiviert ist, kann die Schriftart eingebettet werden.Wenn 2 Bit festgelegt ist, ist die Einbettung schreibgeschützt.

Wenn eine Anwendung versucht, diese Funktion zu verwenden, um Informationen für eine NichtTrueType-Schriftart abzurufen, gibt die GetFontData-Memberfunktion - 1 zurück.