Fungsi TTEmbedFontEx (t2embapi.h)

Artikel
08/26/2023

Membuat struktur font yang berisi font karakter UCS-4 yang disubset (32-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.

TTEmbedFontEx digunakan dengan cara yang sama seperti TTEmbedFont, tetapi menerima kumpulan kode karakter yang diberikan dalam UCS-4 (32 bit).

Sintaks

LONG TTEmbedFontEx(
  [in]           HDC            hDC,
  [in]           ULONG          ulFlags,
  [in]           ULONG          ulCharSet,
  [out]          ULONG          *pulPrivStatus,
  [out]          ULONG          *pulStatus,
                 WRITEEMBEDPROC lpfnWriteToStream,
  [in]           LPVOID         lpvWriteStream,
  [in]           ULONG          *pulCharCodeSet,
  [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.

Nilai	Makna
TTEMBED_EMBEDEUDC	Sertakan data file font EUDC terkait dengan struktur font.
TTEMBED_RAW	Mengembalikan struktur font yang berisi kumpulan karakter lengkap, 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 bisa 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 untuk menandai yang menunjukkan hak istimewa penyematan font. Bendera ini bisa 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 ditentukan untuk parameter ini.

lpfnWriteToStream

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

[in] lpvWriteStream

Token untuk mewakili aliran output.

[in] pulCharCodeSet

Arahkan ke buffer yang berisi kode karakter UCS-4 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 pulCharCodeSet. 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 pTTEmbedInfoadalah 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 Fungsi Penyematan.

Keterangan

Fungsi ini mereferensikan rutinitas panggilan balik yang ditentukan klien untuk menyematkan struktur font ke dalam aliran dokumen.

Klien bertanggung jawab untuk menentukan dan menunjukkan kumpulan karakter font.

Untuk informasi tentang menyematkan karakter Unicode, lihat TTEmbedFont; untuk informasi tentang menyematkan karakter Unicode 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