# getListView 메서드

## Content


#### Page - getListView Method

Page.getListViews(name, includeSubPage)\
<br>

#### getListView Method 설명

화면에 보이는 ListView 중 하나의 이름을 기반으로 하여 해당 ListView 인스턴스의 속성을 가져옵니다.\
<br>

#### Parameter 설명

| 매개변수 | 타입 | 필수 | 상세 설명 |
| --- | --- | --- | --- |
| name | string | 예 | ListView의 이름을 입력합니다. |
| includeSubPage | boolean | 아니오 | 페이지 내 하위 페이지를 포함하는 컨테이너 또는 탭컨트롤이 존재하는 경우 하위 페이지까지 검색할 지 여부를 결정합니다.<br>기본값은 True이며 의미는 “검색함”입니다. False는 “검색하지 않음”입니다. |

<br>

#### Response 시 반환값

ListView 속성을 반환합니다. 자세한 내용은 ListView\[]를 참고하세요.

> 😄 ListView Method 관련 내용은 준비 중입니다.

#### 활용 예제

아래는 page.getListViews를 사용하는 관련 사용 예제입니다. 페이지 내 Cell 중 컨테이너 유형의 Cell 인스턴스들의 정보를 불러옵니다.<br>

```
  //현재 페이지를 불러옵니다.
  var page = Forguncy.Page;

  //이름이 ListView1이라는 ListView의 인스턴스를 가져옵니다.
  var listview = page.getListView("ListView1");

  //ListView1의 속성 중 이름을 확인합니다.
  var name = listview.getName();
  
  //ListView1의 이름을 화면에 표시합니다.
  alert(name);
```

<br>

#### Forguncy 사용 예제

1.  페이지를 한 개 생성하여 Database Table을 연결하는 ListView를 생성합니다.\
    해당 ListView의 이름을 ListView1이라고 입력합니다.<br>

    ![](https://forguncy-korea.github.io/images/forguncy5/ex-ss_page-getlistview01.png)
2.  해당 페이지에 버튼을 생성하고, “자바스크립트로 직접 프로그래밍하기” 명령으로 코드를 추가합니다.<br>

    ![](https://forguncy-korea.github.io/images/forguncy5/ex-ss_page-getlistview02.png)
3.  프로젝트를 실행하여 버튼을 누르면 getListView에서 화면의 ListView 인스턴스의 속성 중 이름을 화면에 표시합니다.

    ![](https://forguncy-korea.github.io/images/forguncy5/ex-ss_page-getlistview03.gif)

<br>