Fungsi TTEmbedFont (t2embapi.h)

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.

Sintaksis

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 dapat memiliki nol atau lebih dari nilai berikut.

[in] ulCharSet

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

[out] pulPrivStatus

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

[out] pulStatus

Pointer ke bitfield yang berisi informasi status tentang permintaan penyematan. Bidang ini diisi setelah menyelesaikan fungsi ini. Saat ini tidak ada bit yang 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

Arahkan 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 pTTEmbedInfoNULL, tidak ada URL yang akan ditambahkan ke objek font yang disematkan dan tidak ada pemeriksaan URL yang akan terjadi ketika klien memanggil TTLoadEmbeddedFont.

Mengembalikan nilai

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.

Komentar

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

Lihat juga

TTEMBEDINFO

TTEmbedFontEx

TTEmbedFontFromFileA

TTLoadEmbeddedFont