Vai al contenuto principale
Questo è un metodo comune. Eventuali limitazioni di implementazione specifiche della piattaforma sono elencate negli argomenti relativi agli oggetti che utilizzano questo metodo.
Questa proprietà consente di associare a un oggetto qualsiasi informazione definita dall’utente. Queste informazioni vengono passate come VARIANT, che può contenere solo tipi semplici (String, tipi integer), ma non può contenere tipi SAFEARRAY o VARIANT al suo interno. Più precisamente, sono consentiti solo i seguenti tipi di 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.

​
Sintassi

​
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

​
Parametri

name [in] Questa variabile contiene un valore di tipo string qualsiasi da usare per identificare la proprietà rispetto alle altre, ad esempio “MyProperty”. result [out, retval] Un puntatore a una variabile VARIANT che riceve il valore della proprietà definita dall’utente. value [in] Una variabile VARIANT che contiene il nuovo valore della proprietà.

​
Valori di ritorno

Questa proprietà non prevede valori di ritorno specifici. Restituisce i valori di ritorno standard delle funzioni di ABBYY FineReader Engine.

​
Osservazioni

Le proprietà sono identificate dai rispettivi nomi. Pertanto, per un determinato oggetto è consentita una sola proprietà con il nome specificato. Se un oggetto non ha una proprietà definita dall’utente con il nome specificato, questa viene creata quando le viene assegnato un valore per la prima volta. Quando si tenta di ottenere il valore di una proprietà che non esiste in un oggetto, viene restituito un VARIANT vuoto. Quando si copia un oggetto tramite il metodo CopyFrom, vengono copiate anche le proprietà definite dall’utente. Se un oggetto può essere persistente, anche le proprietà definite dall’utente sono persistenti. I seguenti oggetti forniscono questa proprietà:

​
Vedi anche

Uso delle proprietà