跳轉到主要內容
這是通用方法。任何平台特定的實作限制，都會列在使用此方法之物件的主題中。
此屬性可讓您將任何使用者定義的資訊與物件建立關聯。此資訊會以 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 method 複製物件時，也會一併複製使用者定義的屬性。如果物件可持續保存，則使用者定義的屬性也會一併保存。 下列物件提供此屬性：

​
另請參閱

使用屬性