Condividi tramite


Metodo IInkRecognizers::GetDefaultRecognizer (msinkaut.h)

Recupera il riconoscitore predefinito per una lingua nota, specificata da un identificatore di codice di lingua nazionale (NLS).

Sintassi

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

Parametri

[in] lcid

Identificatore delle impostazioni locali LCID della lingua per cui si sta recuperando il riconoscitore predefinito. Se lcid è 0, il metodo usa l'impostazione delle impostazioni locali dell'utente per determinare quale sistema di riconoscimento predefinito recuperare. Se l'utente non ha specificato impostazioni locali in Opzioni internazionali, il metodo utilizza le impostazioni locali specificate per il computer. Il valore predefinito è 0.

[out, retval] DefaultRecognizer

Quando termina, questo metodo contiene un puntatore al riconoscitore richiesto.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
Operazione completata.
E_POINTER
Un parametro contiene un puntatore non valido.
E_INK_EXCEPTION
Si è verificata un'eccezione all'interno del metodo .
E_INVALIDARG
Il flag non è valido.
E_UNEXPECTED
Parametro o tipo di proprietà imprevisto.

Commenti

Ogni lingua può avere un riconoscitore predefinito. Ad esempio, un utente può avere un riconoscitore predefinito per l'inglese statunitense e un riconoscitore predefinito per il francese. Se non vengono specificate impostazioni locali, questo metodo restituisce il riconoscitore per le impostazioni locali di input attive. Per selezionare le impostazioni locali di input attive, in Opzioni internazionali e della lingua in ControlPanel, nella scheda Lingue gli utenti fare clic su Dettagli e quindi selezionare la lingua di input predefinita.

Il valore predefinito del parametro lcid è 0.

Questo metodo genera un errore se il parametro lcid non è un'impostazione locale nota o se un riconoscitore non è installato per le impostazioni locali richieste.

GetDefaultRecognizer controlla innanzitutto se è presente un riconoscitore corrispondente per le impostazioni locali di input dell'utente. In caso contrario, verifica se è presente un riconoscitore corrispondente per le impostazioni locali di sistema correnti.

Per altre informazioni su NLS, vedere NLS Terminologia.

Requisiti

   
Client minimo supportato Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato Nessuno supportato
Piattaforma di destinazione Windows
Intestazione msinkaut.h
Libreria InkObj.dll

Vedi anche

Interfaccia IInkRecognizer

IInkRecognizers

Insieme InkRecognizers