메인 콘텐츠로 건너뛰기
이는 공통 메서드입니다. 플랫폼별 구현 제한 사항은 이 메서드를 사용하는 객체의 항목에서 확인할 수 있습니다.
이 속성을 사용하면 사용자 정의 정보를 객체에 연결할 수 있습니다. 이 정보는 VARIANT로 전달되며, 이 VARIANT에는 단순 유형(String, 정수 유형)만 포함될 수 있고 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 메서드를 통해 객체를 복사하면 사용자 정의 속성도 함께 복사됩니다. 객체를 영구 저장할 수 있는 경우 사용자 정의 속성도 영구 저장됩니다. 다음 객체는 이 속성을 제공합니다:

​
참고 항목

Properties 사용