# getCellArray 메서드

#### ![](https://help.grapecity.com.cn/download/thumbnails/72366418/blue%20block.png?version=1\&modificationDate=1648092748000\&api=v2) 메서드 <a href="#getcellarray-fang-fa-fang-fa" id="getcellarray-fang-fa-fang-fa"></a>

&#x20;  SubPage.getCellArray(name)

#### ![](https://help.grapecity.com.cn/download/thumbnails/72366418/blue%20block.png?version=1\&modificationDate=1648092748000\&api=v2) 설명 <a href="#getcellarray-fang-fa-miao-shu" id="getcellarray-fang-fa-miao-shu"></a>

셀 이름으로 셀 인스턴스 집합을 가져옵니다.

#### ![](https://help.grapecity.com.cn/download/thumbnails/72366418/blue%20block.png?version=1\&modificationDate=1648092748000\&api=v2) **매개 변수** <a href="#getcellarray-fang-fa-can-shu-shuo-ming" id="getcellarray-fang-fa-can-shu-shuo-ming"></a>

| 매개변수 | 형식     | 설명       |
| ---- | ------ | -------- |
| name | string | 셀 이름입니다. |

#### ![](https://help.grapecity.com.cn/download/thumbnails/72366418/blue%20block.png?version=1\&modificationDate=1648092748000\&api=v2) **반환값**  <a href="#getcellarray-fang-fa-fan-hui-zhi" id="getcellarray-fang-fa-fan-hui-zhi"></a>

&#x20; [ Cell\[\]](https://doc.forguncy.co.kr/v7/command/javascriptprogramming/javascript-api/class/cellclass)

#### ![](https://help.grapecity.com.cn/download/thumbnails/72366418/blue%20block.png?version=1\&modificationDate=1648092748000\&api=v2) 예제 <a href="#getcellarray-fang-fa-shi-li" id="getcellarray-fang-fa-shi-li"></a>

다음 예제 코드에서는 getCellArray 메서드를 통해 셀 인스턴스 집합을 가져오고 반환된 셀 인스턴스의 길이를 가져옵니다.

```
// 현재 페이지 가져오기
var page = Forguncy.Page;
// 페이지 컨테이너 가져오기
var containerCell = page.getCell("container");
//페이지 컨테이너의 자식 페이지 가져오기
var subPage = containerCell.getContentPage();
//셀 객체 가져오기
var cell = subPage.getCellArray("myCell");
//셀 인스턴스의 길이 가져오기
var len = cell.length;
// 셀 인스턴스의 길이를 보여주는 경고 상자 팝업
alert(len);
```

#### ![](https://help.grapecity.com.cn/download/thumbnails/72366418/blue%20block.png?version=1\&modificationDate=1648092748000\&api=v2) 사용 예제 <a href="#getcellarray-fang-fa-shi-li" id="getcellarray-fang-fa-shi-li"></a>

![](https://help.grapecity.com.cn/download/thumbnails/72366418/%E6%AD%A5%E9%AA%A41.png?version=1\&modificationDate=1648092748000\&api=v2)페이지 1과 페이지 2의 두 페이지를 만듭니다. 페이지 1에서 셀 범위를 선택하고 셀 유형을 페이지 내 컨텐츠가 포함된 셀로 설정하고 이름을 "Container"로 지정하고 하위 페이지를 페이지 2로 설정합니다.

<figure><img src="https://1164392614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzxNQdilex6YN3fZKZhGM%2Fuploads%2FDsnRs3KtF63XQesdJa20%2Fimage.png?alt=media&#x26;token=3d3bbe01-0bd1-4163-953d-10fbeb69bc4e" alt=""><figcaption></figcaption></figure>

![](https://help.grapecity.com.cn/download/thumbnails/72366418/%E6%AD%A5%E9%AA%A42.png?version=1\&modificationDate=1648092748000\&api=v2)페이지 2에서 셀 범위를 선택하여 myCell이라는 이름을 지정합니다.

<figure><img src="https://1164392614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzxNQdilex6YN3fZKZhGM%2Fuploads%2FfmVX3VqjjCmjBZ1cIXnb%2Fimage.png?alt=media&#x26;token=341f3d15-c5b5-4ade-a110-d693ed6f5a5d" alt=""><figcaption></figcaption></figure>

![](https://help.grapecity.com.cn/download/thumbnails/72366418/%E6%AD%A5%E9%AA%A43.png?version=1\&modificationDate=1648092748000\&api=v2)페이지 1에서 셀 범위를 선택하고, 셀 유형을 버튼으로 설정하고, 명령을 \[자바스크립트로 직접 프로그래밍하기]으로 편집하고, JavaScript 코드를 입력합니다.

<figure><img src="https://1164392614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzxNQdilex6YN3fZKZhGM%2Fuploads%2FVxZVOdH4dOswxI0bou4W%2Fimage.png?alt=media&#x26;token=8d44d865-e66b-415d-9945-1868136be4c3" alt=""><figcaption></figcaption></figure>

![](https://help.grapecity.com.cn/download/thumbnails/72366418/%E6%AD%A5%E9%AA%A44.png?version=1\&modificationDate=1648092748000\&api=v2)편집이 완료되면 \[확인]을 클릭하여 대화 상자를 닫습니다.

페이지를 실행하고 페이지에서 단추를 클릭하면 반환된 셀 인스턴스의 길이를 보여 주는 경고 상자가 나타납니다.

<figure><img src="https://1164392614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzxNQdilex6YN3fZKZhGM%2Fuploads%2FxHY17JOTo9rR0JmnxoNy%2Fimage.png?alt=media&#x26;token=22df8dff-2017-4bd4-9fc0-51a9820a5be8" alt=""><figcaption></figcaption></figure>
