IDWriteFontFace::TryGetFontTable method (dwrite.h)

Menemukan tabel font OpenType yang ditentukan jika ada dan mengembalikan penunjuk ke tabel tersebut. Fungsi ini mengakses data font yang mendasar melalui antarmuka IDWriteFontFileStream yang diterapkan oleh pemuat file font.

Sintaksis

HRESULT TryGetFontTable(
  [in]  UINT32     openTypeTableTag,
  [out] const void **tableData,
  [out] UINT32     *tableSize,
  [out] void       **tableContext,
  [out] BOOL       *exists
);

Parameter

[in] openTypeTableTag

Jenis: UINT32

Tag empat karakter tabel font OpenType untuk ditemukan. Gunakan makro DWRITE_MAKE_OPENTYPE_TAG untuk membuatnya sebagaiUINT32 . Tidak seperti GDI, itu tidak mendukung TTCF khusus dan tag null untuk mengakses seluruh font.

[out] tableData

Jenis: const void**

Ketika metode ini kembali, berisi alamat penunjuk ke dasar tabel dalam memori. Penunjuk hanya valid selama wajah font yang digunakan untuk mendapatkan tabel font masih ada; (bukan wajah font lainnya, bahkan jika benar-benar mengacu pada font fisik yang sama). Parameter ini diteruskan tanpa diinisialisasi.

[out] tableSize

Jenis: UINT32*

Ketika metode ini kembali, berisi penunjuk ke ukuran, dalam byte, dari tabel font.

[out] tableContext

Jenis: batal**

Ketika metode ini kembali, alamat penunjuk ke konteks buram, yang harus dibebaskan dengan memanggil ReleaseFontTable. Konteks sebenarnya berasal dari tingkat bawah IDWriteFontFileStream, yang dapat diimplementasikan oleh aplikasi atau DWrite itu sendiri. Dimungkinkan agar NULLtableContext dikembalikan, terutama jika implementasi melakukan pemetaan memori langsung pada seluruh file. Namun demikian, selalu rilis nanti, dan jangan gunakan sebagai pengujian untuk keberhasilan fungsi. Tabel yang sama dapat dikueri beberapa kali, tetapi karena setiap konteks yang dikembalikan bisa berbeda, Anda harus merilis setiap konteks secara terpisah.

[out] exists

Jenis: BOOL*

Ketika metode ini kembali, TRUE jika tabel font ada; jika tidak, FALSE.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT.

Komentar

Konteks untuk tag yang sama mungkin berbeda untuk setiap panggilan, sehingga masing-masing harus dipegang dan dirilis secara terpisah.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop | Aplikasi UWP]
server minimum yang didukung	Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Platform Target	Windows
Header	dwrite.h
Pustaka	Dwrite.lib
DLL	Dwrite.dll

Lihat juga

IDWriteFontFace