Compartilhar via


Método IInkRecognizers::GetDefaultRecognizer (msinkaut.h)

Recupera o reconhecedor padrão para um idioma conhecido, especificado por um LCID (national language support) LCID (national language support).

Sintaxe

HRESULT GetDefaultRecognizer(
  [in]          long           lcid,
  [out, retval] IInkRecognizer **DefaultRecognizer
);

Parâmetros

[in] lcid

O identificador de localidade LCID do idioma para o qual você está recuperando o reconhecedor padrão. Se lcid for 0, o método usará a configuração de localidade do usuário para determinar qual reconhecedor padrão recuperar. Se o usuário não tiver especificado uma localidade em Opções Regionais, o método usará a localidade especificada para o computador. O valor padrão é 0.

[out, retval] DefaultRecognizer

Quando esse método retorna, contém um ponteiro para o reconhecedor solicitado.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
E_POINTER
Um parâmetro continha um ponteiro inválido.
E_INK_EXCEPTION
Ocorreu uma exceção dentro do método .
E_INVALIDARG
O sinalizador é inválido.
E_UNEXPECTED
Parâmetro ou tipo de propriedade inesperado.

Comentários

Cada idioma pode ter um reconhecedor padrão. Por exemplo, um usuário pode ter um reconhecedor padrão para inglês dos EUA e um reconhecedor padrão para francês. Se nenhuma localidade for especificada, esse método retornará o reconhecedor para a localidade de entrada ativa. Para selecionar a localidade de entrada ativa, nas Opções Regionais e de Idioma no ControlPanel, na guia Idiomas, os usuários clicam em Detalhes e selecionam o idioma de entrada Padrão.

O valor padrão do parâmetro lcid é 0.

Esse método gerará um erro se o parâmetro lcid não for uma localidade conhecida ou se um reconhecedor não estiver instalado para a localidade solicitada.

GetDefaultRecognizer primeiro verifica se há um reconhecedor correspondente para a localidade de entrada do usuário. Se não houver nenhum, ele verificará se há um reconhecedor correspondente para a localidade atual do sistema.

Para obter mais informações sobre NLS, consulte Terminologia de NLS.

Requisitos

   
Cliente mínimo com suporte Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho msinkaut.h
Biblioteca InkObj.dll

Confira também

IInkRecognizer Interface

IInkRecognizers

Coleção InkRecognizers