Funzione GetUnicodeRanges (recapis.h)

Restituisce gli intervalli di punti Unicode supportati dal riconoscitore.

Sintassi

HRESULT GetUnicodeRanges(
  HRECOGNIZER     hrec,
  ULONG           *pcRanges,
  CHARACTER_RANGE *pcr
);

Parametri

hrec

Handle per il riconoscitore.

pcRanges

In input, il numero di intervalli che il buffer pcr può contenere. Nell'output, il numero di intervalli contenuti nel buffer pcr .

pcr

Matrice di strutture CHARACTER_RANGE . Ogni struttura contiene un intervallo di punti Unicode supportati dal riconoscitore. L'ordine della matrice è arbitrario. Per determinare le dimensioni necessarie del buffer, impostare pcr su NULL; utilizzare il numero di intervalli per allocare il buffer pcr .

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
Operazione completata.
E_POINTER
Uno dei parametri è un puntatore non valido.
TPC_E_INSUFFICIENT_BUFFER
Il buffer pcr è troppo piccolo.
E_FAIL
Si è verificato un errore non specificato.
E_INVALIDARG
È stato ricevuto un argomento non valido.
E_OUTOFMEMORY
Memoria insufficiente.

Commenti

Questa funzione è facoltativa.

Alcuni riconoscitori non supportano questa funzionalità, ma possono comunque includere la funzione Funzione GetUnicodeRanges . Per tali riconoscitori, la funzione GetUnicodeRanges restituisce E_NOTIMPL.

Per controllare gli intervalli Unicode usati da un contesto di riconoscimento specifico, usare le funzioni GetEnabledUnicodeRanges e SetEnabledUnicodeRanges . Questi intervalli sono vincolati a essere un subset degli intervalli restituiti da GetUnicodeRanges.

I riconoscitori movimenti Microsoft usano caratteri Unicode da 0xF000 a 0xF0FF. Ogni singolo valore Unicode in questo intervallo rappresenta un singolo movimento. Per un elenco completo dei valori Unicode per i movimenti, vedere Valori di intervallo Unicode dei movimenti.

Requisiti

Requisito Valore
Client minimo supportato Windows XP Tablet PC Edition [app desktop | App UWP]
Server minimo supportato Nessuno supportato
Piattaforma di destinazione Windows
Intestazione recapis.h
DLL inkobjcore.dll

Vedi anche

Funzione GetEnabledUnicodeRanges

Funzione SetEnabledUnicodeRanges