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 |
|---|---|
|
Erfolg. |
|
Die Erkennung unterstützt keinen der angegebenen Unicode-Punktbereiche. |
|
Es ist ein unbekannter Fehler aufgetreten. |
|
Ein ungültiges Argument wurde empfangen. |
|
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 |