메인 콘텐츠로 건너뛰기
이것은 공통 메서드입니다. 플랫폼별 구현 제한 사항이 있는 경우 이 메서드를 사용하는 객체의 항목에 나열됩니다.
이 속성을 사용하면 사용자 정의 정보를 객체에 연결할 수 있습니다. 이 정보는 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 엔진 함수의 표준 반환 값을 반환합니다.

​
참고

속성은 이름으로 식별됩니다. 따라서 각 객체에는 지정된 이름의 속성을 하나만 가질 수 있습니다. 객체에 지정된 이름의 사용자 정의 속성이 없으면, 해당 속성에 값이 처음 할당될 때 생성됩니다. 객체에 없는 속성의 값을 가져오려고 하면 빈 VARIANT가 반환됩니다. CopyFrom 메서드로 객체를 복사할 때는 사용자 정의 속성도 함께 복사됩니다. 객체를 영구 저장할 수 있는 경우 사용자 정의 속성도 함께 영구 저장됩니다. 다음 객체는 이 속성을 지원합니다:

​
참고 항목

속성 사용