Método ITfInputProcessorProfiles::AddLanguageProfile (msctf.h)

Artigo
02/29/2024

Cria um perfil de idioma que consiste em um serviço de texto específico e um identificador de idioma específico.

Sintaxe

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

Parâmetros

[in] rclsid

Contém o CLSID do serviço de texto.

[in] langid

Contém um valor LANGID que especifica o identificador de idioma do perfil ao qual o serviço de texto é adicionado. Se contiver -1, o serviço de texto será adicionado a todos os idiomas.

[in] guidProfile

Contém um valor guid que identifica o perfil de idioma. Esse é o valor obtido por ITfInputProcessorProfiles::GetActiveLanguageProfile quando o perfil está ativo.

[in] pchDesc

Ponteiro para um buffer WCHAR que contém a cadeia de caracteres de descrição do serviço de texto no perfil. Esse é o nome do serviço de texto exibido na barra de idiomas.

[in] cchDesc

Contém o comprimento, em caracteres, da cadeia de caracteres de descrição em pchDesc. Se isso contiver -1, pchDesc será considerado uma cadeia de caracteres terminada em NULL.

[in] pchIconFile

Ponteiro para um buffer WCHAR que contém o caminho e o nome do arquivo que contém o ícone a ser exibido na barra de idiomas do serviço de texto no perfil. Esse arquivo pode ser um arquivo executável (.exe), DLL (.dll) ou ícone (.ico).

Esse parâmetro é opcional e pode ser NULL. Nesse caso, um ícone padrão é exibido para o serviço de texto.

[in] cchFile

Contém o comprimento, em caracteres, da cadeia de caracteres de arquivo de ícone em pchIconFile. Se contiver -1, pchIconFile será considerado uma cadeia de caracteres terminada em NULL. Esse parâmetro será ignorado se pchIconFile for NULL.

[in] uIconIndex

Contém o índice baseado em zero do ícone em pchIconFile a ser exibido na barra de idiomas do serviço de texto no perfil. Esse parâmetro será ignorado se pchIconFile for NULL.

Retornar valor

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_FAIL	Ocorreu um erro não especificado.
E_INVALIDARG	pszDesc é inválido.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	msctf.h
DLL	Msctf.dll
Redistribuível	TSF 1.0 no Windows 2000 Professional

Confira também

ITfInputProcessorProfiles

ITfInputProcessorProfiles::GetActiveLanguageProfile

Compartilhar via