Método IUserDictionariesRegistrar::RegisterUserDictionary (spellcheck.h)

  • Artigo

Registra um arquivo a ser usado como um dicionário de usuário para o usuário atual, até que não seja registrado.

Sintaxe

HRESULT RegisterUserDictionary(
  [in] LPCWSTR dictionaryPath,
  [in] LPCWSTR languageTag
);

Parâmetros

[in] dictionaryPath

O caminho do arquivo de dicionário a ser registrado.

[in] languageTag

O idioma para o qual esse dicionário deve ser usado. Se deixado vazio, ele será usado para qualquer idioma.

Retornar valor

Esse método pode retornar um desses valores.

Valor retornado Descrição
S_OK
 Bem sucedido.
S_FALSE
 O arquivo já está registrado para o idioma.
E_INVALIDARG
 O arquivo não existe ou não é válido ou não tem uma extensão válida (.dic, .exc ou .acl)
E_POINTER
 dictionaryPath ou languageTag é um ponteiro nulo.

Comentários

O nome do arquivo deve ter a extensão .dic (palavras adicionadas), .exc (palavras excluídas) ou .acl (pares de palavras de autocorreção). Os arquivos são texto sem formatação UTF-16 LE que deve começar com a BOM (Marca de Pedido de Byte) apropriada. Cada linha contém uma palavra (nas listas de palavras Adicionadas e Excluídas) ou um par de correção automática com as palavras separadas por uma barra vertical ("|") (na lista de palavras AutoCorreção). A lista de palavras na qual o dicionário está incluído é inferida por meio da extensão de arquivo.

Um arquivo registrado para uma subtag de idioma será coletado para todos os idiomas que o contêm. Por exemplo, um dicionário registrado para "en" também será usado por um verificador ortográfico "en-US".

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho spellcheck.h

Confira também

IUserDictionariesRegistrar