GetUnicodeRanges-Funktion (recapis.h)
Gibt die Bereiche von Unicode-Punkten zurück, die von der Erkennung unterstützt werden.
Syntax
HRESULT GetUnicodeRanges(
HRECOGNIZER hrec,
ULONG *pcRanges,
CHARACTER_RANGE *pcr
);
Parameter
hrec
Handle an die Erkennung.
pcRanges
Bei der Eingabe die Anzahl der Bereiche, die der pcr-Puffer enthalten kann. Bei der Ausgabe die Anzahl der Bereiche, die der pcr-Puffer enthält.
pcr
Array von CHARACTER_RANGE-Strukturen . Jede Struktur enthält einen Bereich von Unicode-Punkten, den die Erkennung unterstützt. Die Reihenfolge des Arrays ist beliebig. Legen Sie pcr auf NULL fest, um die erforderliche Größe des Puffers zu bestimmen. verwenden Sie die Anzahl von Bereichen, um den pcr-Puffer zuzuweisen.
Rückgabewert
Diese Funktion kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg. |
|
Einer der Parameter ist ein ungültiger Zeiger. |
|
Der pcr-Puffer ist zu klein. |
|
Es ist ein unbekannter Fehler aufgetreten. |
|
Ein ungültiges Argument wurde empfangen. |
|
Nicht genügend Arbeitsspeicher. |
Hinweise
Diese Funktion ist optional.
Einige Erkennungen unterstützen diese Funktion nicht, enthalten aber möglicherweise weiterhin die Funktion GetUnicodeRanges . Für solche Erkennungen gibt die GetUnicodeRanges-Funktion E_NOTIMPL zurück.
Verwenden Sie die Funktionen GetEnabledUnicodeRanges und SetEnabledUnicodeRanges , um die von einem bestimmten Erkennungskontext verwendeten Unicode-Bereiche zu steuern. Diese Bereiche sind eingeschränkt, um eine Teilmenge der von GetUnicodeRanges zurückgegebenen Bereiche zu sein.
Microsoft-Gestenerkennungen verwenden Unicode-Zeichen aus 0xF000, um 0xF0FF. Jeder einzelne Unicode-Wert in diesem Bereich stellt eine einzelne Geste dar. Eine vollständige Liste der Unicode-Werte für Gesten finden Sie unter Unicode-Bereichswerte von Gesten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP Tablet PC Edition [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | recapis.h |
| DLL | inkobjcore.dll |