Metodo ITfInputProcessorProfiles::AddLanguageProfile (msctf.h)

Articolo
02/29/2024

Crea un profilo linguistico costituito da un servizio di testo specifico e da un identificatore di lingua specifico.

Sintassi

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
);

Parametri

[in] rclsid

Contiene CLSID del servizio di testo.

[in] langid

Contiene un valore LANGID che specifica l'identificatore della lingua del profilo a cui viene aggiunto il servizio di testo. Se contiene -1, il servizio di testo viene aggiunto a tutte le lingue.

[in] guidProfile

Contiene un valore GUID che identifica il profilo del linguaggio. Questo è il valore ottenuto da ITfInputProcessorProfiles::GetActiveLanguageProfile quando il profilo è attivo.

[in] pchDesc

Puntatore a un buffer WCHAR contenente la stringa di descrizione per il servizio di testo nel profilo. Questo è il nome del servizio di testo visualizzato nella barra della lingua.

[in] cchDesc

Contiene la lunghezza, in caratteri, della stringa di descrizione in pchDesc. Se contiene -1, si presuppone che pchDesc sia una stringa con terminazione NULL.

[in] pchIconFile

Puntatore a un buffer WCHAR che contiene il percorso e il nome file del file che contiene l'icona da visualizzare nella barra della lingua per il servizio di testo nel profilo. Questo file può essere un file eseguibile (.exe), DLL (.dll) o icona (.ico).

Questo parametro è facoltativo e può essere NULL. In questo caso, viene visualizzata un'icona predefinita per il servizio di testo.

[in] cchFile

Contiene la lunghezza, in caratteri, della stringa di file dell'icona in pchIconFile. Se contiene -1, si presuppone che pchIconFile sia una stringa con terminazione NULL. Questo parametro viene ignorato se pchIconFile è NULL.

[in] uIconIndex

Contiene l'indice in base zero dell'icona in pchIconFile da visualizzare nella barra della lingua per il servizio di testo nel profilo. Questo parametro viene ignorato se pchIconFile è NULL.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_FAIL	Si è verificato un errore non specificato.
E_INVALIDARG	pszDesc non è valido.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msctf.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional

Vedi anche

ITfInputProcessorProfiles

ITfInputProcessorProfiles::GetActiveLanguageProfile

Condividi tramite