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

Recupera o reconhecedor padrão de um idioma conhecido, especificado por um LCID (identificador de código de idioma) de suporte nacional (NLS).

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 é retornado, contém um ponteiro para o reconhecedor solicitado.

Valor de retorno

Esse método pode retornar um desses valores.

Observações

Cada idioma pode ter um reconhecedor padrão. Por exemplo, um usuário pode ter um reconhecedor padrão para inglês americano 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, em seguida, 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 do NLS.

Requisitos

Consulte também

IInkRecognizer Interface

IInkRecognizers

Coleção InkRecognizers