Fungsi TTEmbedFont (t2embapi.h)

Artikel
03/15/2023

Membuat struktur font yang berisi font karakter lebar yang disubset (16-bit). Font saat ini dari konteks perangkat (hDC) menyediakan informasi font.

Fungsi ini meneruskan data ke rutinitas panggilan balik yang ditentukan klien untuk penyisipan ke dalam aliran dokumen.

Sintaks

LONG TTEmbedFont(
  [in]           HDC            hDC,
  [in]           ULONG          ulFlags,
  [in]           ULONG          ulCharSet,
  [out]          ULONG          *pulPrivStatus,
  [out]          ULONG          *pulStatus,
                 WRITEEMBEDPROC lpfnWriteToStream,
  [in]           LPVOID         lpvWriteStream,
  [in]           USHORT         *pusCharCodeSet,
  [in]           USHORT         usCharCodeCount,
  [in]           USHORT         usLanguage,
  [in, optional] TTEMBEDINFO    *pTTEmbedInfo
);

Parameter

[in] hDC

Handel konteks perangkat.

[in] ulFlags

Bendera yang menentukan permintaan penyematan. Bendera ini bisa memiliki nol atau lebih dari nilai berikut.

Nilai	Makna
TTEMBED_EMBEDEUDC	Sertakan data file font EUDC terkait dengan struktur font.
TTEMBED_RAW	Mengembalikan struktur font yang berisi set karakter penuh, tidak dikompresi. Ini adalah perilaku default fungsi.
TTEMBED_SUBSET	Mengembalikan font subset yang hanya berisi glyph yang ditunjukkan oleh parameter pusCharCodeSet atau pulCharCodeSet . Kode karakter ini harus ditandai sebagai karakter 16-bit atau UCS-4, yang sesuai untuk parameter .
TTEMBED_TTCOMPRESSED	Mengembalikan struktur font terkompresi.

[in] ulCharSet

Bendera yang menentukan kumpulan karakter font yang akan disematkan. Bendera ini dapat memiliki salah satu nilai berikut.

Nilai	Makna
CHARSET_UNICODE	Set karakter Unicode, membutuhkan pengodean karakter 16-bit.
CHARSET_SYMBOL	Set karakter simbol, membutuhkan pengodean karakter 16-bit.

[out] pulPrivStatus

Penunjuk ke bendera yang menunjukkan hak istimewa penyematan font. Bendera ini dapat memiliki salah satu nilai berikut. Fungsi ini mengembalikan lisensi yang paling tidak ketat yang diberikan.

Nilai	Makna
EMBED_PREVIEWPRINT	Pratinjau dan Penyematan Cetak.
EMBED_EDITABLE	Penyematan yang Dapat Diedit.
EMBED_INSTALLABLE	Penyematan yang Dapat Diinstal.
EMBED_NOEMBEDDING	Penyematan Lisensi Terbatas.

[out] pulStatus

Pointer ke bitfield yang berisi informasi status tentang permintaan penyematan. Bidang ini diisi setelah menyelesaikan fungsi ini. Tidak ada bit yang saat ini didefinisikan untuk parameter ini.

lpfnWriteToStream

Penunjuk ke fungsi panggilan balik yang ditentukan klien, yang menulis struktur font ke aliran dokumen. Lihat WRITEEMBEDPROC.

[in] lpvWriteStream

Token untuk mewakili aliran output.

[in] pusCharCodeSet

Penunjuk ke buffer yang berisi kode karakter Unicode opsional untuk subset. Bidang ini hanya digunakan untuk subset font dan diabaikan jika bidang ulFlags tidak menentukan TTEMBED_SUBSET.

[in] usCharCodeCount

Jumlah karakter dalam daftar karakter yang ditunjukkan oleh pusCharCodeSet. Bidang ini hanya digunakan untuk subset font dan diabaikan jika bidang ulFlags tidak menentukan TTEMBED_SUBSET.

[in] usLanguage

Menentukan bahasa mana dalam tabel nama yang akan disimpan saat subset. Atur ke 0 untuk menyimpan semua bahasa. Bidang ini hanya digunakan untuk subset font dan diabaikan jika bidang ulFlags tidak menentukan TTEMBED_SUBSET.

[in, optional] pTTEmbedInfo

Penunjuk ke struktur TTEMBEDINFO yang berisi URL tempat objek font yang disematkan dapat direferensikan secara sah. Jika pTTEmbedInfo adalah NULL, tidak ada URL yang akan ditambahkan ke objek font yang disematkan dan tidak ada pemeriksaan URL yang akan terjadi ketika klien memanggil TTLoadEmbeddedFont.

Nilai kembali

Jika penyematan berhasil, mengembalikan E_NONE.

Struktur font dimasukkan ke dalam aliran dokumen oleh klien. pulPrivStatus diatur, menunjukkan hak istimewa penyematan font; dan pulStatus diatur untuk memberikan hasil operasi penyematan.

Jika tidak, mengembalikan kode kesalahan yang dijelaskan dalam Pesan Kesalahan Embedding-Function.

Keterangan

Klien bertanggung jawab untuk menentukan dan menunjukkan kumpulan karakter font.

Untuk informasi tentang menyematkan karakter UCS-4, lihat TTEmbedFontEx. Untuk informasi tentang menyematkan karakter font dari file, lihat TTEmbedFontFromFileA.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	t2embapi.h
Pustaka	T2embed.lib
DLL	T2embed.dll

Lihat juga

Bagikan melalui