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