SetConfig (init method)

시트 초기화시 필요한 속성을 설정합니다.
ibsheet.cfg 에서의 설정보다 우선 처리 됩니다.
초기화 이후 재설정이 필요한 경우에는 반드시 Refresh 인자를 1(true)로 설정하여야 설정한 속성들이 적용되며, 이 경우 해당 시트의 데이터는 모두 초기화 되므로 사용시 반드시 조회 이전에 호출해야 합니다.

Syntax

ObjId.SetConfig([Cfg], Refresh);

Info

Parameter Type Required Description
Cfg Object 필수 전달되는 인자의 형식은 json 타입으로 설정 하고자 하는 정보를 json 형태로 구성하여 전달합니다. (자세한 사항은 아래 표 참조)
Refresh Boolean 선택 설정 후 갱신 처리 여부 (Default: 0)

Enum

Name Type Required Description
Alternate Boolean 선택 DataAlternateBackColor 사용여부 (Default: 1)
AutoCloseDialog Boolean 선택 콤보목록, 달력팝업, 액션메뉴 팝업의 자동닫기 여부 설정 (Default: 0)
자동닫기 설정시 MouseOut 시점에 자동으로 닫히게 됩니다.
AutoFitColWidth String or Array 선택 FitColWidth에 대한 적용 시점 설정입니다. 적용하고자 하는 설정값을 구분자 | 로 연결하여 설정합니다. (Default : "")
- search : 조회 및 로드 시점
- resize : 시트 Resize 시점
- init : 초기화 및 RemoveAll 호출시점
- colhidden : 컬럼 숨김/보임 시점
AutoSumCalcMode Number 선택 별합된 셀에 대한 합계 계산 처리 방법 설정 (0 : 모든 셀에 대한 합계 계산 (Default), 1 : 병합된 셀의 부속셀은 제외하고 계산)
CachePageCount Number 선택 페이지 캐싱 개수
ChildGrid Object 선택 트리구조에서 하위 그리드생성시 사용할 초기화 정보
ChildPage Number 선택 트리구조에서 자식행의 페이지 단위 개수 (Default: 0)
ClearFilterOff Boolean 선택 필터행 셀에 값이 있고 사용안함으로 변경했을 때, 필터행의 셀값 삭제 유무
ClearRowBackColorUID Boolean 선택 상태값에 따라 행 색상이 변경되었을 때, 저장함수 호출 이후 행 배경색 상태
ClickHeaderMapping Boolean 선택 셀 클릭시 매핑되는 헤더를 표시할지 여부 (0: 표시하지 않음(Default), 1: 표시)
ClickHeaderMappingColor String 선택 셀 클릭시 매핑되는 헤더 표시 색상 (Default: “#eef0de”)
ColPage Number 선택 한번에 표시할 컬럼의 개수 (Default: 사용안함)
CountFormat Number 선택 건수 정보의 출력 포맷 (세부 사항은 SetCountFormat 메서드 참조)
CountPosition Number 선택 건수 정보 출력 위치 (0 : 사용안함 (Default), 1 : 좌측 상단, 2 : 우측 상단, 3 : 좌측 하단, 4 : 우측 하단)
ComboMaxHeight Number 선택 콤보리스트 최대 높이 설정
Convert2ByteChar Number 선택 전각문자 입력시 반각으로 치환하는 기능 설정
CopyEdit Boolean 선택 값 복사 할때 포맷을 포함할지 여부 설정
CookieInfoSave Boolean 선택 컬럼의 위치, 컬럼너비, 컬럼 정렬 등에 대한 정보를 쿠키에 저장하는 기능
CurrentColInfo String 선택 설정하고자 하는 컬럼 정보 문자열
DataRowHeight Number 선택 데이터 행의 기본 행 높이 (단위:px)
DataRowMerge Boolean 선택 전체행의 가로머지 허용여부 (0: 머지 허용하지 않음 (Default), 1: 머지 허용 함)
DeferredHScroll Boolean 선택 가로 스크롤에 대한 지연 처리 모드 사용 여부 (0 : 사용 안함 (Default), 1 : 사용 함)
DeferredVScroll Boolean 선택 세로 스크롤에 대한 지연 처리 모드 사용 여부 (0 : 사용 안함 (Default), 1 : 사용 함)
DragCell Boolean 선택 드래그시 셀 단위 드래그 여부 설정 (0: 행 단위 드래깅 (Default), 1: 셀 단위 드래깅)
DragMode Number 선택 드래그 처리 방법
* -1 : 드래그 사용 안함
* 0 : 일반(셀 또는 행 범위 셀렉션), Ctrl 키 이용: 행 드래깅 (Default)
* 1 : 일반(행 드래깅), Ctrl 키 이용(셀 또는 행 범위 셀렉션)
DragRowSection Boolean 선택 드래그 대상 단위 설정 (0 : 셀 단위 (Default), 1 : 행 단위)
EditArrowBehavior Number 선택 편집모드 상태에서 방향 키 입력에 대한 동작 방법
- 0 : 좌,우,상,하 모두 셀 이동 하지 않음
- 1 : 상,하만 셀 이동 처리 (Default)
- 2 : 좌,우만 셀 이동 처리
- 3 : 좌,우,상,하
EditEnterBehavior String 선택 편집모드 상태에서 Enter 키 입력에 대한 동작 방법
- tab : 편집 완료 후 오른쪽 셀로 포커스 이동 (Default)
- down : 편집 완료 후 아래 셀로 포커스 이동
- newline : 줄바꿈되어 개행 처리 됨
- none : 편집 완료 후 포커스 유지
- editTab : 편집 완료 후 다음 편집 가능한 셀로 이동
EditTabInsert Boolean 선택 MultiLineText 셀에 Tab키 입력 활성화 여부 (0 : 사용 안함 (Default), 1 : 사용함)
EnhancedFloatSum Number 선택 AutoSum 타입에서의 부동 소수점 보정 사용여부 (0 : 사용 안함 (Default), 1 : 사용함)
ExportMode Number 선택 엑셀 다운로드시 서버모듈, 클라이언트모듈 설정 클라이언트 모듈의 경우 ibexcel.js 파일 필요
- 1 : 서버모듈 (Default)
- 2 : 클라이언트모듈(IE10 이상부터 지원)
- 3 : 클라이언트모듈 -> 서버모듈 (ibexcel.js가 없으면 서버모듈로 동작)
FastRender Boolean 선택 전체 헤더 체크 할 경우 reRender 시 빠른 조회 사용 여부 (단, 화면 깜빡임이 일어남 , Default : 1)
FilterDateType Boolean 선택 날짜 형식 필터에 달력팝업 사용여부 설정 (0 : 달력팝업 사용안함 (Default), 1 : 달력팝업 사용)
FilterOperator String 선택 필터링시 컬럼간 연산자 설정 (and : 논리 곱 연산 (Default), or : 논리 합 연산)
FilterRow Boolean 선택 필터행 사용 여부 (0 : 사용 안함 (Default), 1 : 사용함)
FitSizeColHeaderMode Boolean 선택 컬럼에 대한 FitSize 처리시 컬럼간 셀병합이 되어있는 헤더를 포함하여 처리할지 여부 설정 (0 : 포함하여 처리 (Default), 1 : 제외하고 처리)
FitSizeColMode Boolean 선택 헤더의 컬럼 사이를 더블클릭시 처리되는 FitSize 처리 모드 설정 (0 : 화면에 보여지는 행 범위 내에서 처리 (Default), 1 : 전체 행 범위에서 처리)
FocusSumRow Boolean 선택 합계행의 셀에 대한 Focus 허용 여부 설정 (0 : 포커스 허용 안함 (Default), 1 : 포커스 허용)
FrozenCol Number 선택 좌측 고정컬럼의 수 (Default: 0)
FrozenColRight Number 선택 우측 고정컬럼의 수 (Default: 0)
GroupRow Boolean 선택 그룹행 사용 여부 (0 : 그룹행 사용 안함 (Default), 1 : 그룹행 사용함)
GroupSort Boolean 선택 그룹핑시 기준컬럼에 대한 Sort 처리여부 설정 (0 : Sort 처리 없이 현재 상태로 그룹핑, 1 : Sort 처리 후 그룹핑 (Default))
HeaderCheckMode Boolean 선택 전체체크 선택시 필터링된 행만 체크합니다 (0 : 모든행에 대한 처리 (Default), 1 : 필터링된 행에 대한 처리)
HeaderCheckSync Boolean 선택 헤더의 전체체크박스에 대한 자동 설정/해제 기능 (0: 사용 안함 (Default), 1: 사용함)
HeaderMergeMode Boolean 선택 헤더의 머지 방식 서정 (0: ColMerge 속성 설정값에 상관없이 머지 처리(Default), 1: ColMerge 속성에 따라 머지 처리)
HeaderRowHeight number 선택 헤더 행의 높이 (단위:px)
ibEditTitle String 선택 셀의 타이틀 값 설정 (default: ”ibEdit”)
ImageStatus Boolean 선택 상태값을 이미지로 표시할지 여부여부 (0: 입력, 수정, 삭제 Text로 표시 (Default), 1: 입력, 수정, 삭제 이미지로 표시)
InvalidInputBehavior Number 선택 편집 완료시점에 입력값이 invalid 인 경우에 대한 처리 방법 설정
* 0 : alert 메시지 후 해당 셀 편집상태 유지 (Default)
* 1 : alert 메시지 후 해당 셀 편집종료(입력값 취소 처리)
* 2 : alert 메시지 후 해당 셀 편집상태 유지 (입력값 취소 처리)
InvalidInputCallBack function 선택 편집 완료시점에 입력값이 invalid 인 경우에 콜백설정
JustCheck Boolean 선택 체크박스 타입에서 셀 클릭이 아닌 체크박스 클릭에 대해서만 선택/취소가 가능하도록 설정 (0: 셀 클릭시 체크 (Default), 1: 체크박스 클릭시 체크)
JustCheckSize Number 선택 JustCheck가 true인 경우 셀 내에서 체크 박스로 간주될 크기 설정
KeyFieldPosition String 선택 필수 입력 표시 위치 설정 (Left: 왼쪽에 표기 (Default), Right: 오른쪽에 표기)
MaxSort Number 선택 헤더클릭을 이용한 연계 소팅 최대 개수를 설정 (Default: 3)
MergeSheet Number 선택 머지 종류 (Default: 0) SetMergeSheet Method 참고
MouseHoverMode Number 선택 시트내의 행 또는 셀에 MouseOver에 대한 Hover 방식을 설정 (0: 사용 안함 (Default), 1: 셀단위 Hover, 2: 행단위 Hover)
NewRowDeleteMode Boolean 선택 “입력” 상태인 행의 삭제 컬럼 체크시 confirm 메시지 사용 여부 설정 (0: 사용 안함 (Default), 1: 사용함)
NextPageCall Number 선택 다음 페이지 호출 시점 백분율
NoFocusMode Boolean 선택 포커스 행 표시 사용여부 설정 (0: 포커스 행 표시함(Default), 1: 포커스 행 표시하지 않음)
NullLastOnAscOrder Number 선택 오름차순 기준으로 소트시 공백 문자의 위치 설정. 내림차순의 경우 반대로 정렬됩니다 (0: 맨 앞에 정렬 (Default), 1: 맨 뒤에 정렬)
Page Number 선택 한번에 표시할 행의 개수 (Default: 20)
PagingPosition Number 선택 페이지 내비게이션이 출력 되는 위치 설정 (0: 사용 안함 (Default), 1: 좌측, 2: 우측)
PopupCheckEditMode Boolean 선택 컬럽팝업 메뉴를 통한 값 설정시 편집가능여부에 따른 처리 여부 (0: 편집가능여부와 무관하게 처리, 1: 편집가능한 경우에만 처리 (Default))
PrevColumnMergeMode Number 선택 LazyLoad 방식인 경우 앞컬럼 머지 방식 설정 (0: 페이지 전체, 1: 페이지내 (Default))
ScrollOverSheet Number 선택 시트 내의 마우스 휠을 이용한 스크롤 이벤트를 부모 element로 전달 여부 (Default: 0)
SelectionRowsMode Boolean 선택 GetSelectionRows 시 포커스행 포함 여부 (Default: 0)
SelectionSummary String 선택 선택영역 요약 정보 표시 설정
SearchMode Number 선택 조회 방식 설정
- 0 : smGeneral – 일반 조회 모드
- 1 : smClientPaging – 페이징 모드
- 2 : smLazyLoad – Lazy Load 모드 (Default)
- 3 : smServerPaging – 실시간 서버 처리 모드 (스크롤링 방식)
- 4 : smServerPaging2 – 실시간 서버 처리 모드 (페이지 인덱스 방식)
SearchXMLbyColOrder Boolean 선택 XML 로딩시 데이터 로드하는 순서를 결정 (0 : 컬럼 생성시의 순서대로 로드 (Default), 1 : 현재 보이는 컬럼의 위치를 기준으로 로드)
SeqColMerge Boolean 선택 데이터 행 머지에 Seq 컬럼을 같이 머지할지 여부 (0 : Seq컬럼 머지 안함 (Default), 1 : Seq 컬럼 머지 사용)
SizeMode Number 선택 사이즈 방식 설정
- 0 : 설정된 높이값으로 처리 (Default)
- 1 : 스크롤 없이 높이 자동 설정
- 2 : 스크롤 없이 너비 자동 설정
- 3 : 스크롤 없이 높이/너비 자동 설정
- 4 : 설정한 높이 이전까지 스크롤 없이 높이 자동 설정
SmartResize Boolean 선택 OnResize를 OnSmartResize 동작처럼 변환
이 값을 1로 설정하면 OnSmartResize이벤트는 발생하지 않고 OnResize이벤트가 OnSmartResize 이벤트 처럼 0.3초단위로 동작합니다.
0 : 사용 안함 (Default), 1 : 사용함
SortEventMode Boolean 선택 OnSort 이벤트 발생시 정렬된 모든 컬럼의 정보를 반환 할지 여부 (0 : 마지막 정렬 컬럼만 반환 (Default), 1 : 정렬된 모든 컬럼 반환)
SPage Number 선택 서버 요청 페이지 단위 행의 개수
SumPosition Boolean 선택 합계행 위치 (0 : 하단 고정 (Default), 1 : 상단 고정)
TabStop Boolean 선택 시트가 포함된 페이지에서 Tab키 에 의한 Tab 이동시 시트를 포함할지 여부 (0 : Tab키를 사용하여 시트로 이동 불가능, 1 : Tab키 사용하여 시트로 이동 가능 (Default))
TableCaption String 선택 datatable caption 태그 설정 값
TableSummary String 선택 datatable summary 태그 설정 값
ToolTip Boolean 선택 셀의 풍선도움말을 표시합니다 (0 : 풍선 도움말 미표시 (Default), 1 : 풍선도움말 표시)
ToolTipText String 선택 헤더 영역에서의 툴팁에 표시할 문자열
TouchScrolling Number 선택 터치스크롤 방식 설정 (0 : 사용안함 (Default), 1 : 일반 사용, 2 : 지연 이동)
TreeDragIconMode Number 선택 트리구조에서 드래그시 드래그 위치 아이콘 표시 모드 (0 : 이동이 가능한 위치에맞게아이콘 표시 (Default), 1 : 이동이 가능한 위치와 상관없이 아이콘 표시)
TreeNodeIcon Boolean 선택 트리 노드 아이콘 사용 여부 (0 : 아이콘 사용하지 않음 (Default), 1 : 아이콘 사용)
TreeNodeToggleMode Number 선택 마우스 입력을 통한 Tree 노드 토글시 처리 방법 (0 : 토글 후 해당 셀에 포커스이동 처리 방법 (Default), 1 : 셀의 포커스 이동 없이 토글 처리 방법)
UpdateMergeCells Boolean 선택 머지된 데이터를 수정시 전체 머지 영역의 데이터 수정 여부 (0 : 사용 안함 (Default), 1 : 사용함)
UseChildGrid Boolean 선택 트리구조 사용시 ChildGrid 사용여부 (0 : 사용 안함 (Default), 1 : 사용함)
UseDefaultSortImage Boolean 선택 소트 기능 헤더에 기본 소트 이미지 표시 여부 (0 : 사용 안함 (Default), 1 : 사용함)
UseEditMask Boolean 선택 편집시 사용자포맷, 날짜에 대한 IBMaskEdit 사용 여부 (0 : 사용 안함 (Default), 1 : 사용함)
UseFindDialog Boolean 선택 찾기 팝업 다이얼로그 사용 여부 (0 : 사용 안함, 1 : 사용함 (Default))
UseGroupActionMenu Boolean 선택 그룹행에서 컨텍스트 메뉴 사용 여부 설정 (SetGroupActionMenu 참조)
0 : 사용 안함 (Default), 1 : 사용함
UseHeaderActionMenu Boolean 선택 헤더 컨텍스트 메뉴 사용 여부 설정
헤더메뉴를 사용함으로 설정하고 헤더메뉴를 설정하지 않는경우 자동으로 기본 메뉴가 출력됩니다. (SetHeaderActionMenu 참조)
0 : 사용 안함 (Default), 1 : 사용함
UseHeaderSortCancel Boolean 선택 헤더 클릭을 통한 컬럼 Sort 처리시 취소 모드 사용 여부
- 0 : 사용 안함 (Default) - 헤더 클릭시 Asc / Desc 순으로 처리
- 1 : 사용함 - 헤더 클릭시 Asc / Desc / 취소 순으로 처리
UseHiddenFilter Boolean 선택 필터 행 없이 필터링 사용 여부 설정 (SetFilterValue 참조)
0 : 사용 안함 (Default), 1 : 사용함 (필터행이 보이지 않아도 SetFilterValue를 사용 할 수 있게 설정)
UseJsonTreeLevel Boolean 선택 Json 형식의 데이터 구조에서 트리형식 구성시 Level 속성을 이용하여 구성할지 여부 설정 (0 : Level 속성 사용 안함 (Default), 1 : Level 속성 사용)
UseNoDataRow Number 선택 조회된 데이터가 없는 경우, 조회된 데이터가 없습니다 문구 표시 여부 설정 (0 : 사용안함, 1 : 사용 (Default))
UsePivotDialog Boolean 선택 피벗 설정 팝업 다이얼로그 사용 여부 (0 : 사용안함, 1 : 사용 (Default))
VscrollMode Number 선택 세로스크롤바 표시 설정 (0 : Auto (Default), 1 : 고정)

Returns

none

Example

// Page 50의 LazyLoad 방식 + 헤더 머지 설정
mySheet.SetConfig({
  "SearchMode": 2,
  "Page": 50,
  "MergeSheet": 5
});

Since

version desc
7.0.0.0
7.0.4.2 TabStop 속성 추가
7.0.8.0 AutoFitColWidth, MouseHoverMode 속성 추가
7.0.11.0 PopupCheckEditMode 속성 추가
7.0.12.2 Refresh 인자 추가
7.0.13.5 FitSizeColHeaderMode, FilterOperator 속성 추가
7.0.13.6 UseHeaderActionMode 의 오름차순 정렬, 내림차순 정렬 기본 메뉴 추가
7.0.13.10 InvalidInputBehavior 속성 추가
7.0.13.11 DeferredHScroll, DeferredVScroll 속성 추가
7.0.13.14 CachePageCount 속성 추가
7.0.13.17 ImageStatus 속성 추가
7.0.13.22 AutoSumCalcMode 속성 추가
7.0.13.26 GroupSort 속성 추가
7.0.13.30 CurrentColInfo 속성 추가
7.0.13.33 UseEditMask 속성 추가
7.0.13.34 UseFindDialog, UsePivotDialog 속성 추가
7.0.13.48 UseHeaderSortCancel 속성 추가
7.0.13.51 FocusSumRow 속성 추가
7.0.13.52 TreeNodeToggleMode 속성 추가
7.0.13.54 InvalidInputCallBack 속성 추가
7.0.13.56 TreeNodeIcon 속성 추가
7.0.13.59 Spage 속성 추가
7.0.13.61 TableCaption, TableSummary 속성 추가
7.0.13.63 ExportMode 속성 추가
7.0.13.77 Alternate 속성 추가
7.0.13.107 NullLastOnAscOrder 속성 추가
7.0.13.108 Convert2ByteChar, ScrollOverSheet 속성 추가
7.0.13.109 EnhancedFloatSum 속성 추가
7.0.13.110 EditTabInsert, UpdateMergeCells 속성 추가
7.0.13.111 HeadercheckSync 속성 추가
7.0.13.112 JustCheck, JustCheckSize 속성 추가
7.0.13.147 FastRender 속성 추가
7.0.13.160 CopyEdit 속성 추가