User Component API

PDF417 등 사용자 컴포넌트를 개발할 때 사용 가능한 메소드는 아래와 같습니다.

Method Detail

GetNewInstance

DWORD GetNewInstance()

사용자 컴포넌트 객체 생성 함수입니다.

GetCopyInstance

DWORD GetCopyInstance(DWORD src)

사용자 컴포넌트 객체 복사 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

DeleteInstance

void DeleteInstance(DWORD src)

사용자 컴포넌트 객체 삭제 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

getAttrListLength

int getAttrListLength(DWORD src)

사용자 컴포넌트가 사용하는 속성 개수를 반환하는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

getAttrList

BOOL getAttrList(DWORD src, WCHAR** attrs, const int length)

사용자 컴포넌트에서 사용하는 속성 명을 배열에 넣어서 attrs로 리턴합니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

attrs - 속성명이 반환되는 버퍼의 Pointer

length - getAttrListLength를 호출하여 나온 속성 개수

getAttrLength

int getAttrLength(DWORD src, const WCHAR* name)

입력된 속성 값의 길이를 반환하는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

name - 속성명

getAttr

BOOL getAttr(DWORD src, const WCHAR* name, WCHAR* value, const int value_length)

name에 해당하는 속성 값을 value로 반환하는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

name - 속성명

value - 속성의 값을 저장하는 장소

value_length - getAttrLength를 호출하여 나온 값

setAttr

BOOL setAttr(DWORD src, const WCHAR* name, const WCHAR* value)

입력된 속성명의 속성 값을 변경하는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

name - 속성명

value - 변경하려는 속성의 값

readMe

void readMe(DWORD src, const char* pData, const int length)

사용자 컴포넌트의 속성을 serialize된 binary data로부터 읽는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

pData - 속성 값을 읽어들이기 위한 binary data 저장소

length - 읽어들일 데이터의 길이

writeMeExLength

int writeMeExLength(DWORD src)

사용자 컴포넌트의 속성을 serialize할 binary data의 길이를 반환하는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

writeMeEx

void writeMeEx(DWORD src, char* pData, const int length)

사용자 컴포넌트의 속성을 serialize하는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

pData - serialize할 binary data의 pointer

length - serialize할 binary data의 길이

isHiddenAttr

BOOL isHiddenAttr(DWORD src, LPCWSTR attrname)

사용자 컴포넌트 속성의 속성 창 표시 여부를 속성별로 결정하는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

attrname - 체크할 속성명

getAttrType

int getAttrType(DWORD src, LPCWSTR attrname)

속성별로 속성 타입을 체크하여 타입에 맞게 속성을 추가하는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

attrname - 체크할 속성명

getEnumSize

int getEnumSize(DWORD src, LPCWSTR attrname)

getAttrType 함수의 리턴값이 Enum일 경우 Enum의 개수를 가져오는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

attrname - 체크할 속성명

getEnumValues

BOOL getEnumValues(DWORD src, LPCWSTR attrname, WCHAR** enumNames, const int length)

getAttrType 함수의 리턴값이 Enum일 경우 Enum의 값을 가져오는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

attrname - 체크할 속성명

enumNames - Enum 값이 저장될 배열(미리 할당하여야 함)

length - Enum 값의 개수

paint

void paint(DWORD src, HDC hDC, LPCWSTR data, const float x, const float y, const float w, const float h, const float scale)

화면에 그릴 때 호출되는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

hDC - 그려질 화면의 핸들(WIN32 API 참조)

data - 라벨의 Caption

x - 컴포넌트의 x 좌표

y - 컴포넌트의 y 좌표

w - 컴포넌트의 너비

h - 컴포넌트의 높이

scale - 확대 값

paintEX

void paintEX(DWORD src, HDC hDC, LPCWSTR data, const float x, const float y, const float w, const float h, const float scale, const float x_offset, const float y_offset)

화면에 그릴 때 호출되는 함수로 실제 이미지가 저장될 offset 값을 전달할 수 있습니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

hDC - 그려질 화면의 핸들(WIN32 API 참조)

data - 라벨의 Caption

x - 컴포넌트의 x 좌표

y - 컴포넌트의 y 좌표

w - 컴포넌트의 너비

h - 컴포넌트의 높이

scale - 확대 값

x_offset - 실제 이미지가 저장될 x offset

y_offset - 실제 이미지가 저장될 y offset

void print(DWORD src, HDC hDC, LPCWSTR data, const float x, const float y, const float w, const float h, const float scale, const float x_offset, const float y_offset)

인쇄할 때 호출되는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

hDC - 그려질 화면의 핸들(WIN32 API 참조)

data - 라벨의 Caption

x - 컴포넌트의 x 좌표

y - 컴포넌트의 y 좌표

w - 컴포넌트의 너비

h - 컴포넌트의 높이

scale - 확대 값

x_offset - 프린트 x Offset

y_offset - 프린트 x Offset

getAutosize

void getAutosize(DWORD src, HDC hDC, LPCWSTR data, float * w, float * h)

자동크기조정을 사용할 때 사용자 컴포넌트의 가로, 세로 크기를 설정하는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

hDC - 그려질 화면의 핸들(WIN32 API 참조)

data - 라벨의 Caption

w - 컴포넌트의 원래 너비의 pointer

h - 컴포넌트의 원래 높이의 pointer

setWorkPath

void setWorkPath(DWORD src, const WCHAR* work_path)

사용자 컴포넌트 작업을 위한 임시 폴더 경로를 지정하는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

work_path - 임시 폴더 경로

setDLLPath

void setDLLPath(DWORD src, const WCHAR* dll_path)

사용자 컴포넌트가 위치한 경로를 지정하는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

dll_path - 사용자 컴포넌트가 위치한 경로

setExtraParam

void setExtraParam(DWORD src, const WCHAR* extra_param)

뷰어에서 사용자 컴포넌트로 파라미터를 전달하는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

extra_param - 사용자 컴포넌트로 전달할 파라미터

getTooltipLength

int getTooltipLength(DWORD src, const float x, const float y)

사용자 컴포넌트의 툴팁 문자열 길이를 반환하는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

x - 툴팁의 x 좌표

y - 툴팁의 y 좌표

getTooltip

BOOL getTooltip(DWORD src, const float x, const float y, WCHAR* tooltip, const int tooltip_length)

사용자 컴포넌트의 툴팁 표시 여부를 반환하는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

x - 툴팁의 x 좌표

y - 툴팁의 y 좌표

tooltip - 툴팁 텍스트

tooltip_length - 툴팁 텍스트의 길이

splitBindEx

BSTR splitBindEx(DWORD src, HDC hDC, LPCWSTR data, const float firstHeiht, int firstcount, const float nextHeiht, const float desiredWidth)

노트의 그리기 형태에 "사용자 컴포넌트"를 적용하는 함수입니다.

Parameters:

src - 사용자 컴포넌트 객체 핸들

hDC - 그려질 화면의 핸들(WIN32 API 참조)

data - 표시할 데이터

firstHeiht - 첫 번째 가용 높이

firstcount - 첫 번째 페이지 여부

nextHeiht - 두 번째 이후 가용 높이

desiredWidth - 가용 너비