SetEnabledUnicodeRanges-Funktion (recapis.h)

Aktiviert mindestens einen Unicode-Punktbereich im Kontext.

Syntax

HRESULT SetEnabledUnicodeRanges(
  HRECOCONTEXT    hrc,
  ULONG           cRanges,
  CHARACTER_RANGE *pcr
);

Parameter

hrc

Das Handle für den Erkennungskontext.

cRanges

Die Anzahl von Bereichen im pRanges-Puffer .

pcr

Ein Array von CHARACTER_RANGE Strukturen. Jede Struktur identifiziert einen Bereich von Unicode-Punkten, den Sie in der Erkennung aktivieren möchten. Die Reihenfolge des Arrays ist beliebig.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
TPC_S_TRUNCATED	Die Erkennung unterstützt keinen der angegebenen Unicode-Punktbereiche.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
E_INVALIDARG	Ein ungültiges Argument wurde empfangen.
E_POINTER	Einer der Parameter ist ein ungültiger Zeiger.

Hinweise

Die SetEnabledUnicodeRanges-Funktion ist optional.

Einige Erkennungen unterstützen das Aktivieren und Deaktivieren bestimmter Codepunkte nicht, enthalten aber möglicherweise weiterhin die SetEnabledUnicodeRanges-Funktion . Für solche Erkennungen gibt die SetEnabledUnicodeRanges-Funktion E_NOTIMPL zurück.

Jede Erkennung unterstützt mindestens einen Unicode-Punktbereich. Um zu bestimmen, welche Unicode-Punktbereiche die Erkennung unterstützt, rufen Sie die GetUnicodeRanges-Funktion auf. Wenn Sie diese Funktion nicht aufrufen, verwendet die Erkennung einen Standardsatz von Unicode-Punktbereichen. Die Standardbereiche sind erkennungsspezifisch.

Die Microsoft-Gestenerkennung verwendet Unicode-Zeichen von 0xF000 bis 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

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

CHARACTER_RANGE-Struktur

GetEnabledUnicodeRanges-Funktion

GetUnicodeRanges-Funktion