Saltar al contenido principal
Este es un método común. Las limitaciones de implementación específicas de la plataforma se enumeran en los temas de los objetos que usan este método.
Esta propiedad le permite asociar cualquier información definida por el usuario con un objeto. Esta información se pasa como VARIANT, que solo puede contener tipos simples (String, tipos enteros), pero no puede contener tipos SAFEARRAY ni VARIANT dentro de este VARIANT. Más concretamente, solo se permiten los siguientes tipos de VARIANT: VT_EMPTY, VT_UI1, VT_I2, VT_I4, VT_R4, VT_R8, VT_CY, VT_BSTR, VT_NULL, VT_ERROR, VT_BOOL, VT_DATE.

​
Sintaxis

​
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

​
Parámetros

name [in] Esta variable contiene cualquier cadena que quiera usar para identificar la propiedad entre las demás, por ejemplo, “MyProperty”. result [out, retval] Un puntero a una variable VARIANT que recibe el valor de la propiedad definida por el usuario. value [in] Una variable VARIANT que contiene el nuevo valor de la propiedad.

​
Valores de retorno

Esta propiedad no tiene valores de retorno específicos. Devuelve los valores de retorno estándar de las funciones de ABBYY FineReader Engine.

​
Observaciones

Las propiedades se identifican por su nombre. Por lo tanto, solo se permite una propiedad con un nombre determinado para un objeto dado. Si un objeto no tiene una propiedad de usuario con el nombre especificado, esta se crea la primera vez que se le asigna un valor. Si se intenta obtener el valor de una propiedad que no existe en un objeto, se devuelve un VARIANT vacío. Al copiar un objeto mediante el método CopyFrom, también se copian las propiedades definidas por el usuario. Si un objeto puede conservarse, las propiedades definidas por el usuario también se conservan. Los siguientes objetos proporcionan esta propiedad:

​
Consulte también

Trabajar con las propiedades