Metodo IInkRecognizerContext::get_Guide (msinkaut.h)

Articolo
08/25/2023

Ottiene o imposta InkRecognizerGuide da utilizzare per l'input penna.

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT get_Guide(
  IInkRecognizerGuide **RecognizerGuide
);

Parametri

RecognizerGuide

Valore restituito

nessuno

Osservazioni

L'impostazione della proprietà Guide ha esito positivo solo se l'insieme InkStrokes è NULL. È necessario impostare la proprietà Guide prima di associare l'insieme InkStrokes all'insieme InkRecognizerContext oppure impostare l'insieme InkStrokes su NULL e quindi impostare la Guida (e possibile ricollegare l'insieme InkStrokes).

L'enumerazione InkRecognizerCapabilities contiene i flag IRC_FreeInput, IRC_LinedInput e IRC_BoxedInput . Questi flag specificano le funzionalità di un riconoscitore, ma poiché sono di sola lettura, non è possibile impostarne una direttamente in un oggetto IInkRecognizer o InkRecognizerContext . L'unico modo per inserire un riconoscitore in una modalità specifica consiste nell'impostare la guida usando la proprietà Guide . Se non si imposta la proprietà Guide , il sistema di riconoscimento viene impostato per impostazione predefinita sulla modalità FreeInput (se il sistema di riconoscimento è in grado di eseguire questa operazione). Un altro modo per impostare il riconoscitore in modalità FreeInput consiste nell'impostare la proprietà Guide su un oggetto InkRecognizerGuide con la relativa proprietà Columns impostata su zero e la relativa proprietà Rows impostata su zero.

Se si imposta la proprietà Guide su un oggetto InkRecognizerGuide con la relativa proprietà Columns impostata su zero e la relativa proprietà Rows impostata su 1 o più, il riconoscitore è in modalità IRC_LinedInput (se il riconoscitore è in grado di eseguire questa operazione). Il riconoscitore utilizza la proprietà Rows per controllare il numero di righe.

Se si imposta la proprietà Guide su un oggetto InkRecognizerGuide con la relativa proprietà Rows impostata su zero e la relativa proprietà Columns impostata su 1 o più, il sistema di riconoscimento è in modalità IRC_LinedInput (se il riconoscitore è in grado di eseguire questa operazione) per la scrittura verticale. Il riconoscitore utilizza la proprietà Columns per controllare il numero di linee verticali. Se il sistema di riconoscimento è in grado di eseguire questa operazione, la proprietà Capabilities dell'oggetto IInkRecognizer restituisceIRC_DownAndLeft o IRC_DownAndRight o entrambi.

Se si imposta la proprietà Guide su un oggetto InkRecognizerGuide con la relativa proprietà Columns impostata su 1 o più e la relativa proprietà Rows impostata su 1 o più, il riconoscitore è in modalità IRC_BoxedInput (se il riconoscitore è in grado di eseguire questa operazione).

Se si imposta la modalità su una non disponibile da questo sistema di riconoscimento, viene restituito un errore.

Per informazioni su come eseguire query su quali funzionalità o modalità sono disponibili da un sistema di riconoscimento specifico, vedere la proprietà Capabilities dell'oggetto IInkRecognizer . In generale, i riconoscitori dello script latino supportano l'input libero e l'input allineato orizzontale, i riconoscitori dei caratteri asiatici supportano l'input libero e l'input boxed e il riconoscimento movimento supporta solo l'input libero.

Requisiti


Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	msinkaut.h
Libreria	InkObj.dll