跳轉到主要內容
這是常用的方法。任何特定平台的實作限制，都會列在使用此方法之物件的相關主題中。
此屬性可讓您將任何使用者自訂資訊與物件建立關聯。這些資訊會以 VARIANT 傳遞，其中只能包含簡單型別 (String、整數型別) ，但此 VARIANT 內不得包含 SAFEARRAY 或 VARIANT 型別。更精確地說，只允許下列 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。

​
語法

​
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

​
參數

name [in] 此變數包含任意 string 值，您可用它在多個屬性中識別此屬性，例如「MyProperty」。 result [out, retval] 指向 VARIANT 變數的指標，該變數會接收使用者定義屬性的值。 value [in] 包含此屬性新值的 VARIANT 變數。

​
回傳值

此屬性沒有特定回傳值。會回傳 ABBYY FineReader Engine 函式的標準回傳值。

​
備註

屬性是依名稱識別。因此，對於指定的物件，只能有一個同名屬性。如果物件沒有指定名稱的使用者屬性，則在第一次為該屬性指派值時建立該屬性。當嘗試取得物件中不存在的屬性值時，會傳回空的 VARIANT。透過 CopyFrom 方法 複製物件時，也會一併複製使用者定義的屬性。如果物件可以持續保存，則使用者定義的屬性也會持續保存。 下列物件提供此屬性：

​
另請參閱

使用屬性