GetEnabledUnicodeRanges-Funktion (recapis.h)

Ruft eine Liste der Unicode-Punktbereiche ab, die für den Kontext aktiviert sind. Wenn Sie die SetEnabledUnicodeRanges-Funktion nicht aufrufen, um die aktivierten Bereiche anzugeben, gibt diese Funktion die Standardmäßigen Unicode-Punktbereiche der Erkennung zurück.

Syntax

HRESULT GetEnabledUnicodeRanges(
  HRECOCONTEXT    hrc,
  ULONG           *pcRanges,
  CHARACTER_RANGE *pcr
);

Parameter

hrc

Das Handle für den Erkennungskontext.

pcRanges

Bei der Eingabe die Anzahl der CHARACTER_RANGE Strukturen, die der pcr-Puffer enthalten kann. Bei der Ausgabe die Anzahl der Bereiche, die der pcr-Puffer enthält.

pcr

Ein Array von CHARACTER_RANGE Strukturen. Jede Struktur enthält einen Bereich von Unicode-Punkten, die für den Kontext aktiviert sind. Die Reihenfolge des Arrays ist beliebig. Um die Größe des Puffers zu bestimmen, legen Sie pcr auf NULL fest. 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.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
E_INVALIDARG	Ein ungültiges Argument wurde empfangen.
TPC_E_INSUFFICIENT_BUFFER	Der pcr-Puffer ist zu klein.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

Hinweise

Diese Funktion ist optional.

Einige Erkennungen unterstützen das Aktivieren und Deaktivieren bestimmter Unicode-Punkte nicht, enthalten aber möglicherweise weiterhin die GetEnabledUnicodeRanges-Funktion . Für solche Erkennungen gibt die GetEnabledUnicodeRanges-Funktion die gleichen Bereiche wie die GetUnicodeRanges-Funktion zurück.

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 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	recapis.h
DLL	inkobjcore.dll

Weitere Informationen

CHARACTER_RANGE-Struktur

GetUnicodeRanges-Funktion

SetEnabledUnicodeRanges-Funktion