Passer au contenu principal
Il s’agit d’une méthode commune. Les éventuelles limitations d’implémentation propres à une plateforme sont indiquées dans les rubriques des objets qui utilisent cette méthode.
Cette propriété vous permet d’associer à un objet toute information définie par l’utilisateur. Ces informations sont transmises sous forme de VARIANT, qui ne peut contenir que des types simples (String, types entiers) ; aucun type SAFEARRAY ou VARIANT ne peut toutefois être imbriqué dans ce VARIANT. Plus précisément, seuls les types de variant suivants sont autorisés : VT_EMPTY, VT_UI1, VT_I2, VT_I4, VT_R4, VT_R8, VT_CY, VT_BSTR, VT_NULL, VT_ERROR, VT_BOOL, VT_DATE.

​
Syntaxe

​
C++

HRESULT get_UserProperty(
   BSTR     name,
   VARIANT* result
);
HRESULT put_UserProperty(
   BSTR    name,
   VARIANT value
);

​
C#

object get_UserProperty( string name );
void set_UserProperty(
   string name,
   object value
);

​
Visual Basic .NET

Property UserProperty(name As String) As Object

​
Paramètres

name [in] Cette variable contient une valeur de type string que vous souhaitez utiliser pour identifier la propriété parmi d’autres, par exemple, “MyProperty”. result [out, retval] Pointeur vers une variable VARIANT qui reçoit la valeur de la propriété définie par l’utilisateur. value [in] Variable VARIANT contenant la nouvelle valeur de la propriété.

​
Valeurs de retour

Cette propriété n’a pas de valeur de retour spécifique. Elle renvoie les valeurs de retour standard des fonctions ABBYY FineReader Engine.

​
Remarques

Les propriétés sont identifiées par leur nom. Par conséquent, une seule propriété portant un nom donné est autorisée pour un objet donné. Si un objet ne possède pas de propriété utilisateur portant ce nom, celle-ci est créée lors de la première affectation d’une valeur à cette propriété. Lorsqu’on tente d’obtenir la valeur d’une propriété inexistante dans un objet, un VARIANT vide est renvoyé. Lors de la copie d’un objet via la méthode CopyFrom, les propriétés définies par l’utilisateur sont également copiées. Si un objet peut être enregistré de manière persistante, les propriétés définies par l’utilisateur le sont également. Les objets suivants fournissent cette propriété :

​
Voir aussi

Utilisation des propriétés