본문으로 건너뛰기

setFocusedCell()

설명​

지정된 셀에 포커스를 설정합니다

사용법​

setFocusedCell(cell: string, scroll?: boolean): void;

매개변수​

  • cell - (필수) 포커스를 설정할 셀의 id
  • scroll - (선택 사항) Spreadsheet를 해당 셀로 스크롤할지 여부이며, 기본값은 true입니다

예제​

const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
    // config parameters
});
spreadsheet.parse(data);

spreadsheet.selection.setFocusedCell("D4");

상세 정보​

이 메서드는 지정된 셀을 활성 셀로 만들고, 다시 그려진 후 키보드 포커스를 해당 셀로 이동합니다. 키보드 포커스가 다음 위치에 있는 경우에는 이동하지 않습니다:

  • Spreadsheet 외부의 요소
  • 키보드로 이동한 툴바, 메뉴 또는 시트 탭
  • 열려 있는 셀 에디터

키보드 포커스가 페이지 body에 있는 경우(예: 페이지를 로드한 직후) 이 메서드는 포커스를 셀로 이동합니다.

다른 API 메서드 등으로 활성 셀을 변경하는 경우에도 동일한 규칙이 적용됩니다.

beforeFocusSet 이벤트 핸들러가 false를 반환하면 활성 셀이 변경되지 않으며 키보드 포커스도 이동하지 않습니다.

selection: false 구성 옵션 또는 selection.disable() 메서드로 선택이 비활성화된 동안에는 이 메서드가 아무 작업도 하지 않습니다.

변경 로그: 셀로 키보드 포커스를 이동하는 기능이 v6.0.4에서 추가됨

관련 문서:

Need more help?Contact Support