Description
문서 중의 필드 리스트를 구한다.
Prototype
BSTR GetFieldList([HwpFieldNumber number], [HwpFieldOption option])
number
문서 중에서 동일한 이름의 필드가 여러 개 존재할 때 이를 구별하기 위한 식별 방법을 지정한다.
생략하면 hwpFieldPlain이 지정된다.
ID |
값 |
설명 |
hwpFieldPlain |
0 |
아무 기호 없이 순서대로 필드 이름이 나열된다. |
hwpFieldNumber |
1 |
필드 이름 뒤에 일련번호가 {{#}}와 같은 형식으로 붙는다. |
hwpFieldCount |
2 |
필드 이름뒤에 그 이름의 필드가 몇 개 있는지 {{#}}와 같은 형식으로 붙는다. |
option
다음과 같은 옵션을 조합할 수 있다. 0을 지정하면 모두 off이다.
생략하면 0이 지정된다.
ID |
값 |
설명 |
hwpFieldCell |
1 |
셀에 부여된 필드 리스트만을 구한다. hwpFieldClickHere와는 함께 지정할 수 없다. |
hwpFieldClickHere |
2 |
누름틀에 부여된 필드 리스트만을 구한다. hwpFieldCell과는 함께 지정할 수 없다. |
hwpFieldSelection |
4 |
셀렉션 내에 존재하는 필드 리스트를 구한다. |
Return Values
각 필드 사이를 문자코드 0x02로 구분하여 다음과 같은 형식으로 리턴 한다. (가장 마지막 필드에는 0x02가 붙지 않는다.)
"필드이름#1\x2필드이름#2\x2...필드이름#n"
0x02 로 구분되어 있기 때문에 String.fromCharCode() 함수를 통하여 구분합니다.