Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt

Use this file to discover all available pages before exploring further.

Il s’agit d’une méthode commune. Toute limitation d’implémentation propre à une plateforme sera indiquée dans les rubriques consacrées aux objets qui utilisent cette méthode.
Cette propriété vous permet d’associer à un objet des informations définies par l’utilisateur. Ces informations sont transmises sous la forme d’un VARIANT, qui ne peut contenir que des types simples (String, types entiers) ; il ne peut pas contenir de types SAFEARRAY ou VARIANT imbriqués. 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 quelconque que vous souhaitez utiliser pour identifier la propriété parmi les 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 qui contient la nouvelle valeur de la propriété.

​
Valeurs de retour

Cette propriété ne comporte pas de valeurs de retour spécifiques. Elle renvoie les valeurs de retour standard des fonctions ABBYY FineReader Engine.

​
Remarques

Les propriétés sont identifiées par leur nom. Ainsi, une seule propriété de ce nom est autorisée pour un objet donné. Si un objet ne possède pas de propriété utilisateur portant ce nom, elle est créée lorsqu’une valeur lui est affectée pour la première fois. Lorsqu’on tente de récupérer la valeur d’une propriété qui n’existe pas 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 est persistant, 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