Metodo IInkRecognizerContext::p utref_Guide (msinkaut.h)

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

Questa proprietà è di lettura/scrittura.

Sintassi

HRESULT putref_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 collegare l'insieme InkStrokes all'insieme InkRecognizerContext oppure è necessario 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 uno 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 farlo). Un altro modo per impostare il riconoscimento 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 sistema di riconoscimento è in grado di farlo). 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 riconoscitore è in modalità IRC_LinedInput (se il sistema di riconoscimento è in grado di eseguire questa operazione) per la scrittura verticale. Lo strumento di riconoscimento 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 restituisce IRC_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 sistema di riconoscimento è in grado di farlo).

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 riconoscitore specifico, vedere la proprietà Capabilities dell'oggetto IInkRecognizer . In generale, i riconoscitori di script latini supportano l'input libero e l'input allineato orizzontalmente, i riconoscitori dei caratteri dell'Asia orientale supportano input libero e input boxed e il riconoscimento movimento supporta solo l'input libero.

Requisiti

Vedere anche

Capabilities, proprietà

Columns, proprietà

Interfaccia IInkRecognizer

IInkRecognizerContext

Enumerazione InkRecognizerCapabilities

Classe InkRecognizerContext

Classe InkRecognizerGuide

Insieme InkStrokes

Rows, proprietà