Fungsi TTEmbedFontFromFileA (t2embapi.h)

Artikel
03/15/2023

Membuat struktur font yang berisi font karakter lebar (16-bit) yang disubset. File eksternal menyediakan informasi font.

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

Sintaks

LONG TTEmbedFontFromFileA(
  [in]           HDC            hDC,
  [in]           LPCSTR         szFontFileName,
  [in]           USHORT         usTTCIndex,
  [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] szFontFileName

Nama file font dan jalur yang akan disematkan. Ini adalah string ANSI.

[in] usTTCIndex

Indeks berbasis nol ke dalam file font (TTC) yang mengidentifikasi font fisik untuk disematkan. Jika file berisi satu font (seperti file kerangka TTF atau OTF), parameter ini harus diatur ke 0.

[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] pusCharCodeSet

Arahkan ke buffer yang berisi kode karakter Unicode opsional untuk subset. Bidang ini hanya digunakan untuk subset font dan diabaikan jika theulFlagsfield 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 fungsi 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 dari konteks perangkat, lihat TTEmbedFont; untuk informasi tentang menyematkan karakter UCS-4 dari konteks perangkat, lihat TTEmbedFontEx.

Persyaratan


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