Freigeben über


SetEnabledUnicodeRanges-Funktion (recapis.h)

Aktiviert einen oder mehrere Unicode-Punktbereiche im Kontext.

Syntax

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

Die Parameter

hrc

Das Handle für den Erkennungskontext.

cRanges

Die Anzahl der Bereiche im pRanges-Puffer .

pcr

Ein Array von CHARACTER_RANGE Strukturen. Jede Struktur identifiziert einen Bereich von Unicode-Punkten, die 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 Description
S_OK
Erfolg.
TPC_S_TRUNCATED
Die Erkennung unterstützt keinen der angegebenen Unicode-Punktbereiche.
E_FAIL
Ein nicht angegebener Fehler ist aufgetreten.
E_INVALIDARG
Ein ungültiges Argument wurde empfangen.
E_POINTER
Einer der Parameter ist ein ungültiger Zeiger.

Bemerkungen

Die SetEnabledUnicodeRanges-Funktion ist optional.

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

Jede Erkennung unterstützt einen oder mehrere Unicode-Punktbereiche. Rufen Sie die GetUnicodeRanges-Funktion auf, um zu bestimmen, welche Unicode-Punktbereiche die Erkennung unterstützt. Wenn Sie diese Funktion nicht aufrufen, verwendet die Erkennung einen Standardsatz von Unicode-Punktbereichen. Die Standardbereiche sind spezifisch.

Die Microsoft-Gestenerkennung verwendet 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
Mindestens unterstützter Client Windows XP Tablet PC Edition [Desktop-Apps | UWP-Apps]
Mindestanforderungen für unterstützte Server Nicht unterstützt
Zielplattform Fenster
Header recapis.h
Library inkobjcore.lib
DLL inkobjcore.dll

Siehe auch

CHARACTER_RANGE Struktur

GetEnabledUnicodeRanges-Funktion

GetUnicodeRanges-Funktion