Metodo IContextNode::Confirm
Modifica il tipo di conferma, che controlla quale oggetto IInkAnalyzer può modificare sull'oggetto IContextNode.
Sintassi
HRESULT Confirm(
[in] ConfirmationType confirmedType
);
Parametri
-
confirmType [in]
-
ConfirmType applicato al nodo.
Valore restituito
Per una descrizione dei valori restituiti, vedere Classi e interfacce - Analisi input penna.
Commenti
Usare questo metodo per abilitare l'utente finale per verificare che IInkAnalyzer abbia analizzato correttamente i tratti. Dopo aver chiamato IContextNode::Confirm , IInkAnalyzer non cambierà gli oggetti IContextNode per tali tratti durante l'analisi successiva.
Usare IContextNode::Conferma quando l'utente ha confermato i risultati dell'analisi e non vuole che IInkAnalyzer cambi un IContextNode durante un'analisi successiva. Ad esempio, se l'utente scrive la parola "a" e quindi l'applicazione chiama IInkAnalyzer::Analizza metodo, l'analizzatore input penna genera un nodo InkWord con il valore "to". Se l'utente aggiunge di nuovo "me" dopo "a" come una parola e l'applicazione chiama di nuovo IInkAnalyzer::Analizza metodo , l'analizzatore input penna può rimuovere il nodo InkWord precedente e creare un nuovo nodo InkWord con il valore "tome". Tuttavia, se dopo la prima chiamata a IInkAnalyzer::Analizza metodo, l'applicazione chiama IContextNode::Confirm nel nodo InkWord per "to" con il valore NodeType NodeTypeAndProperties di ConfirmType, prima che l'utente aggiunge "me", quindi quando l'applicazione chiama IInkAnalyzer::Analizza metodo, l'analizzatore input penna non rimuove o modifica il nodo "to". L'analizzatore input penna può invece riconoscere due nodi InkWord per "to" e "me".
IContextNode può confermare solo gli oggetti di tipo InkWord e InkDrawing (vedere Tipi di nodi di contesto). IContextNode::Confirm restituisce E_INVALIDARG quando il nodo non è un nodo foglia.
Metodo IInkAnalyzer::RemoveStroke e IInkAnalyzer::RemoveStrokes non confermare qualsiasi nodo da cui rimuovere i dati del tratto.
IContextNode::SetStrokes, IInkAnalyzer::SetStrokesType e IInkAnalyzer::SetStrokeType restituiscono CORE_E_INVALIDOPERATION se l'oggetto IContextNode è già confermato.
IContextNode::ReparentStrokeByIdToNode restituisce un errore se viene confermato il nodo di origine o di destinazione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows XP Tablet PC Edition [solo app desktop] |
| Server minimo supportato |
Nessuno supportato |
| Intestazione |
|
| DLL |
|