개요

모바일 기기의 연락처 데이터를 연동하여 처리합니다.

지원 환경

속성

id

ContactSet의 고유 식별자를 설정하는 속성입니다.

지원 환경

속성 타입

문법

ContactSet.id

문법 설정

참고

-  addChild나 insertChild 메소드를 사용하여 컴포넌트를 등록할때 parent 가 자식컴포넌트를 구별하기 위한 고유한 key값입니다.

- 속성명이나 메소드명과 같은 예약어를 id 속성값으로 설정할 경우 오류가 발생할 수 있습니다.

- 컴포넌트의 속성은 아니지만 편의를 위하여 넥사크로 스튜디오에서 설정할 수 있는 기능이 제공됩니다.

- name 속성은 사용자가 지정한 컴포넌트의 이름으로 논리적으로 중복이 가능합니다.

- 넥사크로 스튜디오에서 컴포넌트를 생성하거나 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.

name

ContactSet 의 이름을 설정하는 속성입니다.

지원 환경

속성 타입

문법

ContactSet.name[= strName]

문법 설정

참고

- name 속성은 사용자가 지정한 컴포넌트의 이름으로 논리적으로 중복이 가능합니다.

- 넥사크로 스튜디오에서 컴포넌트를 생성하거나 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.

parent

ContactSet 의 부모 오브젝트를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

ContactSet.parent

문법 설정

var objParent = this.ContactSet00.parent;

참고

- parent 속성은 일반적으로 컴포넌트가 속한 Form을 갖습니다.

- ContactSet 이(가) Div 와 같은 컨테이너 컴포넌트에 자식으로 존재한다면 parent 속성은 해당 컨테이너 컴포넌트를 갖습니다.

- Calendar 와 같이 서브컨트롤이 존재하는 컴포넌트에서 서브컨트롤의 parent 속성은 해당 컴포넌트를 갖습니다.

메서드

append

모바일 기기에 연락처정보를 추가하는 메소드입니다.

지원 환경

문법

ContactSet.append(objContact)

파라미터

var objContact = new nexacro.Contact();

objContact.contactname.familyname = "testname";
this.ContactSet00.append(objContact);

반환

참고

- 모바일 기기에 연락처정보 추가에 성공하면 onsuccess 이벤트가 발생합니다.
  모바일 기기에 연락처정보 추가에 실패하면 onerror 이벤트가 발생합니다.

query

모바일 기기에서 연락처정보 중 조건에 맞는 연락처를 조회하는 메소드입니다.

지원 환경

문법

ContactSet.query( strQueryInfo [, nResultCnt] )

파라미터

this.ContactSet00.query( "contactname:홍길동;phonenumbers:*2214", 5 );

반환

참고

- 모바일 기기에서 연락처정보 조회에 성공하면 onsuccess 이벤트가 발생합니다.
  모바일 기기에서 연락처정보 조회에 실패하면 onerror 이벤트가 발생합니다.

- 조건문 예제입니다.

remove

모바일 기기에서 연락처정보를 삭제하는 메소드입니다.

지원 환경

문법

ContactSet.remove(strUniqueID)

파라미터

this.ContactSet00.remove("5");

반환

참고

- 모바일 기기에서 연락처정보 삭제에 성공하면 onsuccess 이벤트가 발생합니다.
  모바일 기기에서 연락처정보 삭제에 실패하면 onerror 이벤트가 발생합니다.

update

모바일 기기에서 연락처정보를 갱신하는 메소드입니다.

지원 환경

문법

ContactSet.update(objContact)

파라미터

var objContact = e.contacts[0];                                   // onsuccess 이벤트에서 연락처정보를 받는다.

objContact.contactname.familyname = "new name";  // 내용수정
this.Contact00.update(objContact);                             // 연락처정보를 갱신한다.

반환

참고

- 모바일 기기에서 연락처정보 수정에 성공하면 onsuccess 이벤트가 발생합니다.
  모바일 기기에서 연락처정보 수정에 실패하면 onerror 이벤트가 발생합니다.

- ContactSet 에서 query() 메소드를 통해 연락처정보를 조회한 후 update() 메소드를 실행합니다.

이벤트

onerror

모바일 기기에서 연락처정보의 처리가 실패한 경우에 발생하는 이벤트입니다.

지원 환경

문법

onerror(obj:nexacro.ContactSet,e:nexacro.ContactSetErrorEventInfo);

파라미터

onsuccess

모바일 기기에서 연락처정보의 처리가 성공했을 경우에 발생하는 이벤트입니다.

지원 환경

문법

onsuccess(obj:nexacro.ContactSet,e:nexacro.ContactSetEventInfo);

파라미터