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 |
|---|---|
|
Erfolg. |
|
Einer der Parameter ist ein ungültiger Zeiger. |
|
Es ist ein unbekannter Fehler aufgetreten. |
|
Ein ungültiges Argument wurde empfangen. |
|
Der pcr-Puffer ist zu klein. |
|
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 |