리스트 위젯은 위젯 안에 다수의 항목을 리스트 형태로 표시하는 위젯입니다.


 

Methods


리턴 값

함 수

설 명

 

addItem( text )

리스트에 항목을 추가합니다.

 

addItems( texts )

리스트에 다수의 항목을 추가합니다.


clear()

리스트의 전체 항목을 삭제합니다.

int

count()

리스트 전체 항목 수를 얻어옵니다.

int

currentIndex()

리스트에서 현재 선택된 항목의 번호(index)를 얻어옵니다.

str

currentText()

리스트에서 현재 선택된 항목의 문자열을 얻어옵니다.

 

insertItem( index, text )

리스트에 항목을 삽입합니다.

 

insertItems( index, texts )

리스트에 다수의 항목을 추가합니다.

str

itemText( index )

리스트에서 선택한 항목의 문자열을 얻어옵니다.

 

removeItem( index )

리스트에서 선택한 항목을 삭제합니다.


removeItem( text )

리스트에서 선택한 항목을 삭제합니다.

 

setCurrentIndex( index )

리스트에서 선택 항목을 설정합니다.



 

 addItem( text:문자열 )

 

 addItem은 text의 문자열을 리스트에 입력합니다.


  • addItem으로 입력된 항목은 0번 index 부터 입력되며 추가시 1씩 index가 증가됩니다.


 예)

# 리스트 위젯 개체를 얻어옵니다.

obj = canvas.getObject('ListWidget');  

obj.addItem('1111');

obj.addItem('2222');

obj.addItem('3333');


 



 

 addItems( texts:문자열 리스트 )

 

 addItems은 texts의 문자열 리스트를 순서대로 리스트에 입력합니다.


  • addItems으로 입력된 항목은 0번 index 부터 입력되며 리스트의 문자열 항목 개수만큼 index가 증가됩니다.


 예)

# 리스트 위젯 개체를 얻어옵니다.

obj = canvas.getObject('ListWidget');  

textList = [ '4444', '5555', '6666' ];

obj.addItems(textList);


 



 

 insertItem( index:입력 항목 위치, text:문자열 )

 

 insertItem은 리스트에 이미 항목이 있을 경우에 중간에 삽입할 때 사용합니다.


  • index 위치에 text 문자열을 리스트에 입력합니다.
  • 기존 index 위치에 있던 항목은 index가 1 증가합니다.


 예)

# 리스트 위젯 개체를 얻어옵니다.

obj = canvas.getObject('ListWidget');  

obj. addItem('1111');

obj. addItem('2222');

obj. addItem('3333');

# 1번위치(2222) 항목에 abcd를 삽입합니다.

obj.insertItem(1, 'abcd');  


 



 

 insertItems( index:입력 항목 위치, texts:문자열 리스트 )

 

 insertItems는 리스트에 이미 항목이 있을 경우에 중간에 삽입할 때 사용합니다.


  • index 위치에 texts 문자열 리스트를 리스트에 입력합니다.
  • texts 문자열 리스트의 개수만큼 순서대로 삽입됩니다.
  • 기존 index 위치에 있던 항목은 index가 text 문자열 리스트의 개수만큼 증가합니다.


 예)

# 리스트 위젯 개체를 얻어옵니다.

obj = canvas.getObject('ListWidget');  

obj. addItem('1111');

obj. addItem('2222');

obj. addItem('3333');

textList = [ '4444', '5555', '6666' ];

# 1번위치(2222) 항목에 textList(3개 항목)을 삽입합니다.

obj.insertItems(1, textList);  


 



 

 int count()

 

 count는 리스트 위젯에 등록된 아이템 개수를 반환합니다.


  • 결과값은 숫자로 반환합니다.


 예)

# 리스트 위젯 개체를 얻어옵니다.

obj = canvas.getObject('ListWidget');  

textList = [ '1111', '2222', '3333' ];

obj. addItems(textList);

value = obj.count();

app.messageBox(value);


 




 clear()

 

 clear는 리스트 위젯에 등록된 모든 아이템의 정보를 지우고 초기화합니다.


 예)

# 리스트 위젯 개체를 얻어옵니다.

obj = canvas.getObject('ListWidget');  

textList = [ '1111', '2222', '3333' ];

obj.addItems(textList);

obj.clear();


 



 

 removeItem( index:항목위치 )

 

 removeItem은 리스트위젯에서 선택한 index위치에 있는 항목을 삭제합니다.


  • index는 리스트 위에서부터 0으로 시작합니다.
  • 삭제된 이후 항목의 index는 1씩 줄어들게 됩니다.


 예)

# 리스트 위젯 개체를 얻어옵니다.

obj = canvas.getObject('ListWidget');  

textList = [ '1111', '2222', '3333', '4444', '5555' ];

obj. addItems(textList);

# index 1 위치의 항목 2222 를 삭제합니다.

obj.removeItem(1);  


 



 

 removeItem( text:항목 문자열 )

 

 removeItem은 리스트위젯에서 text와 동일한 문자열의 항목을 삭제합니다.


  • text와 동일한 문자열이 1개 이상 존재하는 경우 위에서 첫번째만 삭제합니다.
  • 삭제된 이후 항목의 index는 1씩 줄어들게 됩니다.


 예)

# 리스트 위젯 개체를 얻어옵니다.

obj = canvas.getObject('ListWidget');  

textList = [ '1111', '2222', '3333', '4444', '5555' ];

obj. addItems(textList);

# 3333과 동일한 문자열 index 2 위치의 항목 3333 을 삭제합니다.

obj.removeItem('3333');  


 



 

 str itemText( index:항목 위치 )

 

 itemText는 리스트 위젯에서 index 위치에 있는 항목의 문자열을 얻어옵니다.


 예)

# 리스트 위젯 개체를 얻어옵니다.

obj = canvas.getObject('ListWidget');  

textList = [ '1111', '2222', '3333', '4444', '5555' ];

obj. addItems(textList);

text = obj.itemText(0);

app.messageBox(text);


 



 

 int currentIndex()

 

 currentIndex는 리스트 위젯에서 현재 화면에 선택되어진 항목의 index(숫자)를 결과값으로 반환합니다.


 예)

# 리스트 위젯 개체를 얻어옵니다.

obj = canvas.getObject('ListWidget');  

textList = [ '1111', '2222', '3333', '4444', '5555' ];  

obj. addItems(textList);  

# 현재 선택된 index(숫자)를 얻어옵니다.

value = obj.currentIndex();  

app.messageBox(value);  


 



 

 str currentText()

 

 currentText는 리스트 위젯에서 현재 화면에 선택되어진 항목의 문자열(text)를 결과값으로 반환합니다.


 예)

# 리스트 위젯 개체를 얻어옵니다.

obj = canvas.getObject('ListWidget');  

textList = [ '1111', '2222', '3333', '4444', '5555' ];

obj. addItems(textList);

# 현재 선택된 항목의 문자열(text)를 얻어옵니다.

value = obj.currentText();  

app.messageBox(value);


 



 

 setCurrentIndex( index:항목 위치 )

 

 setCurrentIndex는 리스트 위젯의 선택항목 위치를 사용자가 설정한 index로 표시합니다.


  • 리스트 위젯에 setCurrentIndex 스크립트를 쓰지 않으면 처음 구동 시 아무런 선택이 되지 않습니다.
  • setCurrentIndex 스크립르를 사용하면 자동적으로 선택항목이 표시 됩니다.


 예)

obj = canvas.getObject('ListWidget');  # 리스트 위젯 개체를 얻어옵니다.

textList = [ '1111', '2222', '3333', '4444', '5555' ];

obj.addItems(textList);

obj.setCurrentIndex(0);  # 0번 위치의 항목에 선택 표시를 합니다.