IInkRecognizers::GetDefaultRecognizer-Methode (msinkaut.h)

Ruft die Standarderkennung für eine bekannte Sprache ab, die durch einen NLS-Sprachcodebezeichner (National Language Support) angegeben wird.

Syntax

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

Parameter

[in] lcid

Der LCID-Gebietsschemabezeichner der Sprache, für die Sie die Standarderkennung abrufen. Wenn lcid 0 ist, verwendet die Methode die Gebietsschemaeinstellung des Benutzers, um zu bestimmen, welche Standarderkennung abgerufen werden soll. Wenn der Benutzer in den regionalen Optionen kein Gebietsschema angegeben hat, verwendet die Methode das Gebietsschema, das für den Computer angegeben wurde. Der Standardwert ist 0.

[out, retval] DefaultRecognizer

Wenn diese Methode zurückgegeben wird, enthält sie einen Zeiger auf die angeforderte Erkennung.

Zurückgegebener Wert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S_OK
Erfolg.
E_POINTER
Ein Parameter enthielt einen ungültigen Zeiger.
E_INK_EXCEPTION
In der Methode ist eine Ausnahme aufgetreten.
E_INVALIDARG
Die Kennzeichnung ist ungültig.
E_UNEXPECTED
Unerwarteter Parameter oder Eigenschaftentyp.

Bemerkungen

Jede Sprache kann über eine Standarderkennung verfügen. Ein Benutzer kann z. B. über eine Standarderkennung für US-Englisch und eine Standarderkennung für Französisch verfügen. Wenn kein Gebietsschema angegeben ist, gibt diese Methode die Erkennung für das aktive Eingabegebietsschema zurück. Um das aktive Eingabegebietsschema auszuwählen, klicken Benutzer auf der Registerkarte "Sprachen" in controlPanel in den Regions- und Sprachoptionen auf "Details", und wählen Sie dann die Standardeingabesprache aus.

Der Standardwert des lcid-Parameters ist 0.

Diese Methode generiert einen Fehler, wenn der lcid-Parameter kein bekanntes Gebietsschema ist oder eine Erkennung für das angeforderte Gebietsschema nicht installiert ist.

GetDefaultRecognizer überprüft zuerst, ob ein übereinstimmendes Erkennungselement für das Eingabegebietsschema des Benutzers vorhanden ist. Wenn keine vorhanden ist, wird überprüft, ob ein übereinstimmende Erkennungsmodul für das aktuelle Systemgebietsschema vorhanden ist.

Weitere Informationen zu NLS finden Sie unter NLS-Terminologie.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP Tablet PC Edition [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Nicht unterstützt
Zielplattform Windows
Header msinkaut.h

Siehe auch

IInkRecognizer-Schnittstelle

IInkRecognizers

InkRecognizers-Auflistung