원하는 아이템 위치로 스크롤 할 수 있는 API이다.
| Parameters | Type | Description |
|---|---|---|
| nItemIndex | long | 포커스 대상 아이템 인덱스 |
| nFocusType | short | 포커스 방식 |
| nDuration | short | [옵션] 애니메이션 지속시간(단위:ms) |
| strTiming | STRING | [옵션] 애니메이션 시간 방식 |
| strCallbackFunc | STRING | [옵션] 애니메이션이 완료된 후 호출될 함수명 |
| Type | Description |
|---|---|
| BOOL | 정상 처리 여부 |
nFocusType 파라미터는 아이템의 스크롤 위치를 지정하면, 아래와 같은 값을 가질 수 있다.
** nFocusType 9: 자동 0: 상단에 맞춤 1: 가운데에 맞춤 2: 하단/우측에 맞춤
nDuration 파라미터는 애니메이션인 진행될 시간을 지정하며, 단위는 밀리세컨드이다. 0값을 지정한 경우에는, 애니메이션 효과가 발생하지 않고, 스크롤이 반영된 이후에, strCallbackFunc 파라미터에 해당하는 콜백함수가 호출된다.
strTiming 파라미터는 "swing", "linear" 두가지만을 지원한다. 공백 문자열로 지정한 경우에는 기본값으로 "swing"이 사용된다.
strCallbackFunc 파라미터 값에 공백문자열을 지정하면, 콜백함수가 사용되지 않는다. 유효한 함수의 이름을 지정한 경우, 함수 파라미터로 nDuration 파라미터, strTiming 파라미터가 순차적으로 전달된다.
function btn_scroll_on_mouseup()
{
listview.scrollto(100);
listview.focusitem(5, 9, "", "ScrollComplete");
}
function ScrollComplete(nDuration, strTiming)
{
factory.consoleprint("ScrollComplete> nDuration = " + nDuration);
factory.consoleprint("ScrollComplete> strTiming = " + strTiming);
}