Freigeben über


CDC::GetFontData

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.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CDC-Klasse

Hierarchiediagramm

CDC::GetOutlineTextMetrics

GetFontData

OUTLINETEXTMETRIC