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ü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

Weitere Informationen

ConfidenceAlternates-Eigenschaft

GetAlternatesFromSelection-Methode

GetPropertyValue-Methode

IInkRecognitionAlternate-Schnittstelle

IInkRecognitionAlternates-Schnittstelle

IInkRecognitionResult-Schnittstelle

LineAlternates-Eigenschaft