Condividi tramite


Metodo IInkRecognizerContext::get_Guide (msinkaut.h)

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 IInkRecognizerrestituisceIRC_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

Vedi anche

Capabilities, proprietà

Columns, proprietà

Interfaccia IInkRecognizer

IInkRecognizerContext

Enumerazione InkRecognizerCapabilities

Classe InkRecognizerContext

Classe InkRecognizerGuide

Insieme InkStrokes

Rows, proprietà