IContextNode::Confirm-Methode

Ändert den Bestätigungstyp, der steuert, was das IInkAnalyzer-Objekt am IContextNode ändern kann.

Syntax

HRESULT Confirm(
  [in] ConfirmationType confirmedType
);

Parameter

confirmedType [in]

Der ConfirmationType , der auf den Knoten angewendet wird.

Rückgabewert

Eine Beschreibung der Rückgabewerte finden Sie unter Klassen und Schnittstellen – Freihandanalyse.

Bemerkungen

Verwenden Sie diese Methode, um dem Endbenutzer zu ermöglichen, zu bestätigen, dass der IInkAnalyzer die Striche ordnungsgemäß analysiert hat. Nachdem IContextNode::Confirm aufgerufen wurde, ändert der IInkAnalyzer die IContextNode-Objekte für diese Striche während der späteren Analyse nicht.

Verwenden Sie IContextNode::Bestätigen Sie , wenn der Benutzer Analyseergebnisse bestätigt hat und nicht möchte, dass der IInkAnalyzer einen IContextNode während der späteren Analyse ändert. Wenn der Benutzer beispielsweise das Wort "to" schreibt und dann die Anwendung IInkAnalyzer::Analyze-Methode aufruft, generiert die Freihandanalyse einen InkWord-Knoten mit dem Wert "to". Wenn der Benutzer dann "me" nach "to" als ein Wort hinzufügt und die Anwendung die IInkAnalyzer::Analyze-Methode erneut aufruft, kann die Freihandanalyse den vorherigen InkWord-Knoten entfernen und einen neuen InkWord-Knoten mit dem Wert "tome" erstellen. Wenn die Anwendung jedoch nach dem ersten Aufruf von IInkAnalyzer::Analyze MethodIContextNode::Confirm auf dem InkWord-Knoten für "to" mit dem ConfirmationType-WertNodeTypeAndProperties aufruft, bevor der Benutzer das "me" hinzufügt, und wenn die Anwendung IInkAnalyzer::Analyze-Methode aufruft, entfernt oder ändert der Freihandanalysator den Knoten "in" nicht. Stattdessen erkennt der Freihandanalysator möglicherweise zwei InkWord-Knoten für "to" und "me".

IContextNode kann nur Objekte vom Typ InkWord und InkDrawing bestätigen (siehe Kontextknotentypen). IContextNode::Confirm gibt E_INVALIDARG zurück, wenn der Knoten kein Blattknoten ist.

IInkAnalyzer::RemoveStroke-Methode und IInkAnalyzer::RemoveStrokes-Methode bestätigen jeden Knoten, von dem sie Strichdaten entfernen.

IContextNode::SetStrokes, IInkAnalyzer::SetStrokesType und IInkAnalyzer::SetStrokeType geben CORE_E_INVALIDOPERATION zurück, wenn das IContextNode-Objekt bereits bestätigt ist.

IContextNode::ReparentStrokeByIdToNode gibt einen Fehler zurück, wenn entweder der Quell- oder Zielknoten bestätigt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Header	IACom.h (erfordert auch IACom_i.c)
DLL	IACom.dll

Siehe auch

IContextNode

IContextNode::IsConfirmed

Freihandanalysereferenz