IInkRecognitionAlternate::AlternatesWithConstantPropertyValues-Methode (msinkaut.h)

Ruft eine IInkRecognitionAlternates -Auflistung ab, bei der es sich um eine Division des IInkRecognitionAlternate -Objekts handelt, für das diese Methode aufgerufen wird.

Syntax

HRESULT AlternatesWithConstantPropertyValues(
  [in]          BSTR                      PropertyType,
  [out, retval] IInkRecognitionAlternates **AlternatesWithConstantPropertyValues
);

Parameter

[in] PropertyType

Gibt einen Zeichenfolgenwert an, der die Eigenschaft identifiziert. Eine Liste der eigenschaften, die verwendet werden können, finden Sie unter RecognitionProperty.

Weitere Informationen zum BSTR-Datentyp finden Sie unter Verwenden der COM-Bibliothek.

[out, retval] AlternatesWithConstantPropertyValues

Wenn diese Methode zurückgegeben wird, enthält sie eine IInkRecognitionAlternates -Auflistung, die aus einer Division der Alternativen besteht, für die diese Methode aufgerufen wird. Jedes IInkRecognitionAlternate -Objekt in der Auflistung enthält angrenzende Erkennungssegmente, die denselben Eigenschaftswert für den propertyType-Parameter aufweisen.

Zurückgegebener Wert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S_OK
 Erfolg.
E_POINTER
 Ein Parameter enthielt einen ungültigen Zeiger.
E_INVALIDARG
 Der Erkennungsbereich ist ungültig.
E_INK_EXCEPTION
 Ausnahme beim Verarbeiten.
E_OUTOFMEMORY
 Speicher kann nicht zugewiesen werden, um den Vorgang abzuschließen.

Bemerkungen

Jede Alternative in der Auflistung enthält benachbarte Erkennungssegmente, die denselben Eigenschaftswert für die an die Methode übergebene Eigenschaft aufweisen.

Sie können z. B. Alternative zurückgeben, die die ursprüngliche Alternative dividieren durch:

  • Konfidenzgrenze: stark, zwischen oder schlecht im Erkennungsergebnis.
  • Linienbegrenzungen.
  • Grenzen des Erkennungssegments.
Eine vollständige Liste der Eigenschaftentypen finden Sie unter RecognitionProperty.
Hinweis Die Erkennung bestimmt die Segmentierung von Strichen in die Erkennungssegmente. Einige Erkennungssegmente, z. B. Leerzeichen, können einer leeren InkStrokes-Auflistung entsprechen.
 
Hinweis Die Erkennung bestimmt die Reihenfolge der Erkennungssegmente. Daher können benachbarte Erkennungssegmente auf der Reihenfolge basieren, in der die Freihand gezeichnet wurde oder basierend auf der Position, z. B. ob sie von links nach rechts, von oben nach unten positioniert ist usw.
 
Die ConfidenceAlternates-Eigenschaft ist eine Alternative zur AlternatesWithConstantPropertyValues-Methode , wobei ConfidenceLevel die RecognitionProperty ist, die die Alternativen in der zurückgegebenen Erkennungsalternativenauflistung trennt.

Die LineAlternates-Eigenschaft ist eine Alternative zur AlternatesWithConstantPropertyValues-Methode , wobei LineNumber die RecognitionProperty ist, die die Alternativen in der zurückgegebenen Erkennungsalternativenauflistung trennt.

Hinweis Die AlternatesWithConstantPropertyValues-Methode , die LineAlternates-Eigenschaft und die ConfidenceAlternates-Eigenschaft der IInkRecognitionAlternate-Objektfunktion anders als die AlternatesFromSelection-Methode des IInkRecognitionResult-Objekts . AlternatesFromSelection gibt eine Sammlung von Alternativen für die angeforderten Segmente des Erkennungsergebnisses zurück.
 

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP Tablet PC Edition [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Nicht unterstützt
Zielplattform Windows
Header msinkaut.h

Siehe auch

ConfidenceAlternates-Eigenschaft

GetAlternatesFromSelection-Methode

GetPropertyValue-Methode

IInkRecognitionAlternate-Schnittstelle

IInkRecognitionAlternates-Schnittstelle

IInkRecognitionResult-Schnittstelle

LineAlternates-Eigenschaft

  • Last updated on