IInkRecognitionAlternate::AlternatesWithConstantPropertyValues-Methode (msinkaut.h)

Artikel
03/06/2024

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ückgibt, enthält eine IInkRecognitionAlternates-Auflistung , die aus einer Division des Alternativen besteht, für den diese Methode aufgerufen wird. Jedes IInkRecognitionAlternate-Objekt in der Auflistung enthält benachbarte Erkennungssegmente, die denselben Eigenschaftswert für den propertyType-Parameter aufweisen.

Rückgabewert

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	Während der Verarbeitung ist eine Ausnahme aufgetreten.
E_OUTOFMEMORY	Speicher kann nicht zugewiesen werden, um den Vorgang abzuschließen.

Hinweise

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

Sie können beispielsweise Alternative zurückgeben, die die ursprüngliche Alternative durch teilen:

Grad der Konfidenzgrenzen – stark, mittel oder schlecht – das Erkennungsergebnis.
Liniengrenzen.
Erkennungssegmentgrenzen.

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 Freihandfarbe 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-Eigenschaft ist, die die Alternativen in der zurückgegebenen Sammlung von Erkennungsalternativen trennt.

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

Hinweis Die AlternatesWithConstantPropertyValues-Methode , die LineAlternates-Eigenschaft und die ConfidenceAlternates-Eigenschaft der IInkRecognitionAlternate-Objektfunktion sind 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
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	msinkaut.h
Bibliothek	InkObj.dll