> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# UserProperty プロパティ

> ABBYY FineReader Engine API の UserProperty プロパティ — ユーザー定義の VARIANT 情報をオブジェクトに関連付ける共通プロパティ。

<Note>
  これは共通のメソッドです。プラットフォーム固有の実装上の制限がある場合は、このメソッドを使用するオブジェクトのトピックに記載されています。
</Note>

このプロパティを使用すると、ユーザー定義の任意の情報をオブジェクトに関連付けることができます。この情報は VARIANT として渡され、格納できるのは単純な型 (String、整数型) のみです。SAFEARRAY 型や VARIANT 型をこの 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。

<div id="syntax">
  ## 構文
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT get_UserProperty(
   BSTR     name,
   VARIANT* result
);
HRESULT put_UserProperty(
   BSTR    name,
   VARIANT value
);
```

### C\#

```csharp theme={null}
object get_UserProperty( string name );
void set_UserProperty(
   string name,
   object value
);
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
Property UserProperty(name As String) As Object
```

<div id="parameters">
  ## パラメーター
</div>

name

\[in] この変数には、たとえば "MyProperty" のように、他のプロパティと区別して識別するための任意の文字列値が格納されます。

result

\[out, retval] ユーザー定義プロパティの値を受け取る VARIANT 変数へのポインターです。

value

\[in] この VARIANT 変数には、プロパティの新しい値が格納されます。

<div id="return-values">
  ## 戻り値
</div>

このプロパティに固有の戻り値はありません。[ABBYY FineReader Engine 関数の標準の戻り値](/ja/fine-reader/engine/api-reference/return-codes)を返します。

<div id="remarks">
  ## 備考
</div>

プロパティは名前で識別されます。したがって、特定のオブジェクトに対して、同じ名前のプロパティを複数持つことはできません。オブジェクトに指定された名前のユーザー プロパティが存在しない場合は、そのプロパティに初めて値が割り当てられたときに作成されます。オブジェクトに存在しないプロパティの値を取得しようとすると、空の VARIANT が返されます。[CopyFrom](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method) メソッドでオブジェクトをコピーすると、ユーザー定義プロパティもコピーされます。オブジェクトを永続化できる場合、ユーザー定義プロパティも永続化されます。

このプロパティは、次のオブジェクトで提供されます。

* [BaseLanguage](/ja/fine-reader/engine/api-reference/language-related-objects/baselanguage)
* [Block](/ja/fine-reader/engine/api-reference/layout-related-objects/block)
* [Layout](/ja/fine-reader/engine/api-reference/layout-related-objects/layout)
* [TextLanguage](/ja/fine-reader/engine/api-reference/language-related-objects/textlanguage)

<div id="see-also">
  ## 関連項目
</div>

[Properties の操作](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)