Méthode IInkRecognitionAlternate ::AlternatesWithConstantPropertyValues (msinkaut.h)

Article
02/29/2024

Récupère une collection IInkRecognitionAlternates , qui est une division de l’objet IInkRecognitionAlternate sur lequel cette méthode est appelée.

Syntaxe

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

Paramètres

[in] PropertyType

Spécifie une valeur de chaîne qui identifie la propriété. Pour obtenir la liste des propriétés qui peuvent être utilisées, consultez RecognitionProperty.

Pour plus d’informations sur le type de données BSTR, consultez Utilisation de la bibliothèque COM.

[out, retval] AlternatesWithConstantPropertyValues

Lorsque cette méthode retourne, contient une collection IInkRecognitionAlternates qui est constituée d’une division de l’alternative sur laquelle cette méthode est appelée. Chaque objet IInkRecognitionAlternate de la collection contient des segments de reconnaissance adjacents qui ont la même valeur de propriété pour le paramètre propertyType .

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Réussite.
E_POINTER	Un paramètre contenait un pointeur non valide.
E_INVALIDARG	La plage de reconnaissance n’est pas valide.
E_INK_EXCEPTION	Une exception s’est produite lors du traitement.
E_OUTOFMEMORY	Impossible d’allouer de la mémoire pour terminer l’opération.

Remarques

Chaque alternative de la collection contient des segments de reconnaissance adjacents qui ont la même valeur de propriété pour la propriété passée à la méthode.

Par exemple, vous pouvez retourner des alternatives qui divisent l’alternative d’origine par :

Niveau de limites de confiance -forte, intermédiaire ou médiocre-dans le résultat de la reconnaissance.
Limites de ligne.
Limites de segment de reconnaissance.

Pour obtenir la liste complète des types de propriétés, consultez RecognitionProperty.

Note Le module de reconnaissance détermine la segmentation des traits en segments de reconnaissance. Certains segments de reconnaissance, tels que les espaces, peuvent correspondre à une collection InkStrokes vide.

Note Le module de reconnaissance détermine l’ordre des segments de reconnaissance. Par conséquent, les segments de reconnaissance adjacents peuvent être basés sur l’ordre dans lequel l’encre a été dessinée ou en fonction de l’emplacement, par exemple, si elle est positionnée de gauche à droite, positionnée de haut en bas, et ainsi de suite.

La propriété ConfidenceAlternates est une alternative à la méthode AlternatesWithConstantPropertyValues , où ConfidenceLevel est la propriété RecognitionProperty qui sépare les alternatives dans la collection d’alternatives de reconnaissance retournée.

La propriété LineAlternates est une alternative à la méthode AlternatesWithConstantPropertyValues , où LineNumber est la propriété RecognitionProperty qui sépare les substituts dans la collection d’alternatives de reconnaissance retournée.

Note La méthode AlternatesWithConstantPropertyValues , la propriété LineAlternates et la propriété ConfidenceAlternates de la fonction objet IInkRecognitionAlternate sont différentes de la méthode AlternatesFromSelection de l’objet IInkRecognitionResult . AlternatesFromSelection retourne une collection d’alternatives pour les segments demandés du résultat de reconnaissance.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP Édition Tablet PC [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	msinkaut.h
Bibliothèque	InkObj.dll