Metode ITfInputProcessorProfiles::AddLanguageProfile (msctf.h)

Artikel
08/24/2023

Membuat profil bahasa yang terdiri dari layanan teks tertentu dan pengidentifikasi bahasa tertentu.

Sintaks

HRESULT AddLanguageProfile(
  [in] REFCLSID    rclsid,
  [in] LANGID      langid,
  [in] REFGUID     guidProfile,
  [in] const WCHAR *pchDesc,
  [in] ULONG       cchDesc,
  [in] const WCHAR *pchIconFile,
  [in] ULONG       cchFile,
  [in] ULONG       uIconIndex
);

Parameter

[in] rclsid

Berisi layanan teks CLSID.

[in] langid

Berisi nilai LANGID yang menentukan pengidentifikasi bahasa profil tempat layanan teks ditambahkan. Jika ini berisi -1, layanan teks ditambahkan ke semua bahasa.

[in] guidProfile

Berisi nilai GUID yang mengidentifikasi profil bahasa. Ini adalah nilai yang diperoleh oleh ITfInputProcessorProfiles::GetActiveLanguageProfile saat profil aktif.

[in] pchDesc

Penunjuk ke buffer WCHAR yang berisi string deskripsi untuk layanan teks di profil. Ini adalah nama layanan teks yang ditampilkan di bilah bahasa.

[in] cchDesc

Berisi panjang, dalam karakter, dari string deskripsi di pchDesc. Jika ini berisi -1, pchDesc diasumsikan sebagai string yang dihentikan NULL.

[in] pchIconFile

Penunjuk ke buffer WCHAR yang berisi jalur dan nama file file yang berisi ikon yang akan ditampilkan di bilah bahasa untuk layanan teks di profil. File ini bisa menjadi file yang dapat dieksekusi (.exe), DLL (.dll) atau ikon (.ico).

Parameter ini bersifat opsional dan dapat berupa NULL. Dalam hal ini, ikon default ditampilkan untuk layanan teks.

[in] cchFile

Berisi panjang, dalam karakter, dari string file ikon di pchIconFile. Jika ini berisi -1, pchIconFile diasumsikan sebagai string yang dihentikan NULL. Parameter ini diabaikan jika pchIconFile ADALAH NULL.

[in] uIconIndex

Berisi indeks berbasis nol ikon di pchIconFile yang akan ditampilkan di bilah bahasa untuk layanan teks di profil. Parameter ini diabaikan jika pchIconFile ADALAH NULL.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
E_FAIL	Terjadi kesalahan yang tidak ditentukan.
E_INVALIDARG	pszDesc tidak valid.

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	msctf.h
DLL	Msctf.dll
Redistribusi	TSF 1.0 di Windows 2000 Professional

Lihat juga

ITfInputProcessorProfiles

ITfInputProcessorProfiles::GetActiveLanguageProfile

Bagikan melalui