Metodo IInkRecognizerContext::p utref_Guide (msinkaut.h)

Articolo
08/25/2023

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

Si tratta di una 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 riassegnazione dell'insieme InkStrokes).

L'enumerazione InkRecognizerCapabilities contiene i flag di IRC_FreeInput, IRC_LinedInput e IRC_BoxedInput . Questi flag specificano le funzionalità di un riconoscimento, ma perché sono di sola lettura, non è possibile impostare nessuno di questi elementi direttamente in un oggetto IInkRecognizer o InkRecognizerContext . L'unico modo per inserire un riconoscimento in una modalità specifica consiste nell'impostare la guida usando la proprietà Guide . Se non si imposta la proprietà Guide , il riconoscimento predefinito viene impostato sulla modalità FreeInput (se il riconoscimento è in grado di eseguire questa operazione). 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 riconoscimento è in modalità IRC_LinedInput (se il riconoscimento è in grado di eseguire questa operazione). Il riconoscimento usa 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 riconoscimento è in modalità IRC_LinedInput (se il riconoscimento è in grado di farlo) per la scrittura verticale. Il riconoscimento usa la proprietà Columns per controllare il numero di righe verticali. Se il 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 riconoscimento è in modalità IRC_BoxedInput (se il riconoscimento è in grado di farlo).

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

Per informazioni su come eseguire query su quali funzionalità o modalità sono disponibili da un riconoscimento specifico, vedere la proprietà Capabilities dell'oggetto IInkRecognizer . In generale, i riconoscimento dello script latino supportano l'input gratuito e l'input allineato orizzontalmente, i riconoscimento dei caratteri dell'Asia orientale supportano l'input libero e l'input casellato e il riconoscimento dei movimenti supporta solo l'input gratuito.

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