# getCellByLocation 메서드

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

&#x20;  Page.getCellByLocation(cellLocation)

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

셀의 위치 정보를 통해 셀 개체를 가져옵니다.

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

| 매개변수         | 형식                                                                                                                                | 위치           |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| cellLocation | [CellLocationInfo](https://doc.forguncy.co.kr/v7/command/javascriptprogramming/javascript-api/forguncyinterface/celllocationinfo) | 셀의 위치 정보입니다. |

CellLocationInfo는 다음과 같이 정의됩니다.

```
interface CellLocationInfo{
//0부터 시작하는 셀의 행 인덱스
Row: number;
//0부터 시작하는 셀의 열 인덱스
Column: number;
// 셀이 위치한 페이지
PageName: string;
}
```

#### &#x20;![](https://help.grapecity.com.cn/download/thumbnails/72366016/blue%20block.png?version=1\&modificationDate=1648092739000\&api=v2) **반환값**  <a href="#getcellbylocation-fang-fa-fan-hui-zhi" id="getcellbylocation-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/72366016/blue%20block.png?version=1\&modificationDate=1648092739000\&api=v2) 예제입니다 <a href="#getcellbylocation-fang-fa-shi-li" id="getcellbylocation-fang-fa-shi-li"></a>

다음 예제 코드에서는 getCellByLocation 메서드를 사용하여 셀 개체를 가져오고 셀 배경색을 설정합니다.

```
// 현재 페이지 가져오기
var page = Forguncy.Page;
//셀 객체 가져오기
var cell = page.getCellByLocation({
Row: 2,
Column: 3,
PageName: "페이지 1"
});
//셀의 배경색을 빨간색으로 설정
var setColor = cell.setBackColor("red");
```

#### Forguncy 사용 예제

1. 아래 그림 과 같이 Forguncy에서 페이지를 생성하고, 셀의 위치를 알아볼 수 있게 아무 내용이나 입력합니다.
2. 버튼을 생성하고, 해당 바튼의 “명령 편집”을 실행하여, “자바스크립트로 직접 프로그래밍하기” 명령을 생성합니다.

   ![](https://forguncy-korea.github.io/images/forguncy5/ex-ss_page-getcellbylocation01.png)\ <br>
3. 해당 프로젝트를 실행한 후, 버튼을 클릭하면 아래와 같이 Row 2, Column 3 위치에 배경색상이 변경됩니다.

   ![](https://forguncy-korea.github.io/images/forguncy5/ex-ss_page-getcellbylocation02.gif)\ <br>
4. Forguncy에서는 A Column을 0, 1 Row를 0으로 Index 값을 가지며, 이를 기준으로 Cell의 위치를 계산합니다.\
   그러므로 A1는 Index(0, 0), B2는 Index (1, 1)이 되는 방식입니다. 그러므로 Column 3, Row 2는 D3가 됩니다.

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

<br>
