CDC::GetFontData

Artykuł
02/27/2013

Pobiera informacje metryki czcionek z pliku czcionki skalowalne.

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

Parametry

dwTable
Określa nazwę tabeli metrycznych zwracane.Ten parametr może być jedną z tabel metrycznych udokumentowane w specyfikacji pliki czcionek TrueType, opublikowane przez firmę Microsoft Corporation.Jeśli ten parametr jest 0, informacje są pobierane od początku pliku czcionki.
dwOffset
Określa przesunięcie od początku tabeli, od którego należy rozpocząć pobieranie informacji.Jeśli ten parametr jest 0, informacje są pobierane od początku tabeli określonej przez dwTable parametru.Jeśli ta wartość jest większa niż lub równa rozmiar tabeli, GetFontData zwraca wartość 0.
lpData
Punkty do buforu, który otrzyma informacje dotyczące czcionek.Jeśli wartość ta jest NULL, funkcja zwraca rozmiar buforu wymagane czcionki danych określonych w dwTable parametru.
cbData
Określa długość, w bajtach, informacje, które mają zostać pobrane.Jeśli ten parametr ma wartość 0, GetFontData zwraca rozmiar danych określonych w dwTable parametru.

Wartość zwracana

Określa liczbę bajtów zwróconych w buforze wskazywanej przez lpData , jeśli funkcja się powiedzie; –1 inaczej.

Uwagi

Informacje pobrać jest identyfikowany przez określenie przesunięcie w pliku czcionki i długość informacji, aby powrócić.

Czasami można użyć aplikacji GetFontData Członkowskich funkcji zapisać czcionek TrueType z dokumentu.Aby to zrobić, aplikacja określa, czy czcionki można osadzić i następnie pobiera plik cała czcionka, określając 0 dla dwTable, dwOffset, i cbData parametry.

Aplikacje można określić, czy czcionka może być osadzana sprawdzając otmfsType członek OUTLINETEXTMETRIC struktury.Jeśli bit 1 otmfsType jest ustawiony osadzanie nie jest dozwolone dla czcionki.Jeśli bit 1 jest wyczyszczone, można osadzić czcionki.Jeżeli jest ustawiony bit 2, osadzanie jest tylko do odczytu.

Jeżeli aplikacja próbuje użyć tej funkcji, aby pobrać informacje dla czcionek typu TrueType, GetFontData Członkowskie, funkcja zwraca –1.