Saltar al contenido principal
Este es un método común. Cualquier limitación de implementación específica de la plataforma se indicará en los temas de los objetos que utilicen este método.
Esta propiedad permite asociar cualquier información definida por el usuario a 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 tipos VARIANT dentro de este VARIANT. Más concretamente, solo se permiten los siguientes tipos 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 valor de tipo 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 sus nombres. 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 cuando se le asigna un valor por primera vez. Al intentar 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, las propiedades definidas por el usuario también se copian. Si un objeto puede conservarse, las propiedades definidas por el usuario también son persistentes. Los siguientes objetos proporcionan esta propiedad:

​
Consulte también

Uso de propiedades