IInkRecognizers::GetDefaultRecognizer-Methode (msinkaut.h)

Ruft die Standarderkennung für eine bekannte Sprache ab, die durch einen NlS-Sprachcodebezeichner (Language Code Identifier, LCID) 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 kein Gebietsschema in den Regionalen Optionen 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ückgibt, enthält einen Zeiger auf die angeforderte Erkennung.

Rückgabewert

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	Innerhalb der -Methode ist eine Ausnahme aufgetreten.
E_INVALIDARG	Das Flag ist ungültig.
E_UNEXPECTED	Unerwarteter Parameter oder Eigenschaftstyp.

Hinweise

Jede Sprache kann über eine Standarderkennung verfügen. Beispielsweise kann ein Benutzer über eine Standarderkennung für Englisch in den USA 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 in den Regional- und Sprachoptionen in ControlPanel auf der Registerkarte Sprachen auf Details, und wählen 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 wenn keine Erkennung für das angeforderte Gebietsschema installiert ist.

GetDefaultRecognizer überprüft zunächst, ob eine übereinstimmende Erkennung für das Eingabegebietsschema des Benutzers vorhanden ist. Wenn keine vorhanden ist, wird überprüft, ob eine übereinstimmende Erkennung für das aktuelle Systemgebietsschema vorhanden ist.

Weitere Informationen zu NLS finden Sie unter NLS-Terminologie.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	msinkaut.h
Bibliothek	InkObj.dll

Weitere Informationen

IInkRecognizer-Schnittstelle

IInkRecognizer

InkRecognizers-Sammlung