IDWriteFontFace::TryGetFontTable method (dwrite.h)

  • Artikel

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 diimplementasikan oleh pemuat file font.

Sintaks

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 sebagai UINT32. 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 berlaku 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 IDWriteFontFileStream tingkat bawah, yang dapat diimplementasikan oleh aplikasi atau DWrite itu sendiri. TabelContextNULL dapat 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 akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

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

Persyaratan

Persyaratan 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]
Target Platform Windows
Header dwrite.h
Pustaka Dwrite.lib
DLL Dwrite.dll

Lihat juga

IDWriteFontFace