Freigeben über


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