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 |
|---|---|
|
Erfolg. |
|
Ein Parameter enthielt einen ungültigen Zeiger. |
|
Innerhalb der -Methode ist eine Ausnahme aufgetreten. |
|
Das Flag ist ungültig. |
|
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 |