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
S_OK	Erfolg.
E_POINTER	Einer der Parameter ist ein ungültiger Zeiger.
TPC_E_INSUFFICIENT_BUFFER	Der pcr-Puffer ist zu klein.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
E_INVALIDARG	Ein ungültiges Argument wurde empfangen.
E_OUTOFMEMORY	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

Weitere Informationen

GetEnabledUnicodeRanges-Funktion

SetEnabledUnicodeRanges-Funktion