개요

Cell 은 Grid 가 출력되는 최소단위로 Band 내에서 고유한 위치에 표시되는 오브젝트입니다.

지원 환경

- 각 Cell 은 해당 Band 내에서 고유한 Cell 인덱스를 갖습니다.
   Cell 인덱스는 각 Band 별로 왼쪽에서 오른쪽으로 차례로 Cell 에 부여됩니다.
   SubRow 가 있으면 왼쪽에서 오른쪽으로 Cell 인덱스를 부여한 후 다음 SubRow 에 부여됩니다.
   MergeCell 과 SubCell 은 병합된 영역 전체가 첫번째 Cell 의 Cell 인덱스를 공유합니다.
  
- Cell 인덱스는 바인드 된 DataSet 의 데이터 갯수와는 관계가 없으며, Grid 에 정의된 포맷과 관계가 있습니다.
  
- SubCell 은 관련 메소드(getSubCellProperty() 등)를 사용하여 각 Cell 을 별도의 Cell 로 처리할 수 있습니다.
   SubCell 의 각 Cell 은 별도의 SubCell 인덱스를 갖습니다.
   MergeCell 은 전체 Cell 을 하나의 Cell 로 처리하며 각 Cell 을 별도로 처리할 수 없습니다.
  
- Cell 의 일부 속성은 DataSet 의 Column 을 바인드 하거나 Expression 수식을 설정할 수 있습니다.
   Expression 수식에는 바인드 된 DataSet 의 메소드, Column ID, 접근가능한 영역에 정의된 함수 등을 사용할 수 있습니다.
  
- Expression 수식에 아래의 예약어를 사용하면 수식 실행 시 예약어에 상응하는 값으로 대체됩니다.
  > this : 수식이 정의된 Cell 오브젝트. ( Form 의 지시어가 아닙니다.)
  > comp : Cell 을 갖는 Grid 컴포넌트.
  > dataset : Grid 에 바인드된 DataSet 컴포넌트.
  > currow : 수식이 계산하고 있는 행(Row) 의 인덱스.
  > [Column ID] : 수식이 계산하고 있는 행(Row) 의 DataSet Column 값.
  > Grid 에 바인드 된 DataSet 의 속성과 메소드.
      ex) "dataset.rowcount", "dataset.colcount", "dataset.rowposition", "dataset.getCount()" 등

Status

Control

속성

accessibilityaction

GridCellControl에 선택상자 이동 시 accessibilitydescreadtype 속성에 따라 스크린 리더의 음성 출력 대상으로 포함할 action 정보를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.accessibilityaction[= strAction]

문법 설정

this.GridCellControl00.accessibilityaction = "Accessibility Action Message"; 
this.GridCellControl00.accessibilityaction = "Select by direction key";

참고

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

- 컴포넌트에 선택상자 이동 시 사용자가 추가적인 정보를 얻기 위해 필요한 동작을 안내하는 용도로 사용합니다. 
  예를 들어 컴포넌트 특성에 따라 다음과 같이 속성값을 설정할 수 있습니다.
  
  - CheckBox 컴포넌트의 경우 아래와 같은 안내문을 accessibilityaction 속성값으로 설정할 수 있습니다.
  "선택 상태를 전환하려면 스페이스 바를 누릅니다."
  
  - WebBrowser, WebView 컴포넌트의 경우 스크린 리더 사용자를 위한 안내문을 accessibilityaction 속성값으로 설정할 수 있습니다.
  "웹 브라우저 컴포넌트 내 콘텐츠를 이용하기 위해서는 가상커서를 해제해 주세요."
  그리고 WebBrowser, WebView 컴포넌트를 벗어났을 때 필요한 안내문을 accessibilityleavemessage 속성값으로 설정합니다.
  "가상커서를 설정해 주세요"

accessibilitydesclevel

GridCellControl 에 선택상자 이동 시 하위 컴포넌트의 접근성 출력여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.accessibilitydesclevel[= enumLevel]

문법 설정

enumLevel ::= 'all' | 'self' | 'child' | 'none'

this.GridCellControl00.accessibilitydesclevel = "all";

참고

- accessibilitydesclevel 속성값을 설정하지 않으면 "all" 로 적용됩니다.

- Button 과 같이 자식 컴포넌트가 없는 컴포넌트는 "all" 또는 "child" 로 설정 시 "self" 로 적용됩니다.

- Div 와 같은 컨테이너 컴포넌트는 "child" 설정 시 실제 컨텐츠의 접근성만을 출력합니다.

- accessibilitydesclevel 속성은 선택상자의 이동에 영향을 주지 않으므로 방향키로 선택상자가 GridCellControl 에 이동되게 하지 않으려면 accessibilityenable 속성을 설정하여야 합니다.

accessibilitydescription

GridCellControl에 선택상자 이동 시 accessibilitydescreadtype 속성에 따라 스크린 리더의 음성 출력 대상으로 포함할 description 정보를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.accessibilitydescription[= strDescription]

문법 설정

this.GridCellControl00.accessibilitydescription = "Option";

참고

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

accessibilityenable

GridCellControl 에 선택상자 이동 시 접근성 관련 속성값 출력여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.accessibilityenable[= bEnable]

문법 설정

bEnable ::= 'true' | 'false'

this.GridCellControl00.accessibilityenable = false;

참고

- accessibilityenable 속성값을 설정하지 않으면 true 로 적용됩니다.

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

- 선택상자 이동 시 컴포넌트의 ARIA-LABEL + Status + Role 순서로 정보가 조합되어 접근성으로 출력됩니다.
   각 정보의 조합순서는 스크린 리더의 종류에 따라 달라질 수 있습니다.
   > ARIA-LABEL : Environment 의 accessibilitydescreadtype 속성에 설정된 속성값이 반영됩니다.
   > Status : GridCellControl 의 현재 상태가 반영됩니다.
   > Role : accessibilityrole 속성값이 반영됩니다. accessibilityrole 속성값을 설정하지 않으면 GridCellControl 의 고유 Role 이 반영됩니다.

- accessibilityenable 속성값이 false 일 때 데스크탑 환경에서 방향키 외의 방법으로 선택상자를 GridCellControl 로 이동시키면 스크린 리딩 프로그램에서 임의의 값을 출력할 수 있습니다.


◆ 컨테이너 컴포넌트 선택상자 이동 제약

아래와 같은 환경에서 컨테이너 컴포넌트로 선택상자가 이동하지 않고 컨테이너 컴포넌트 내에 배치된 컴포넌트로 이동합니다.
- Android, iOS/iPadOS 운영체제에서 실행 시 (Div, PopupDiv, TabpageControl, View)
- Windows 운영체제에서 센스리더 가상커서 사용 시 (Div, PopupDiv, View)

accessibilitylabel

Cell에 선택상자 이동 시 accessibilitydescreadtype 속성에 따라 스크린 리더의 음성 출력 대상으로 포함할 label 정보를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.accessibilitylabel[= strLabel]

문법 설정

this.Grid00.setCellProperty( "body", 0, "accessibilitylabel", "OK Button" );
this.Grid00.setCellProperty( "body", 0, "accessibilitylabel", "[@static00]" );
this.Grid00.setCellProperty( "body", 0, "accessibilitylabel", "[@static00][@static01]" );
this.Grid00.setCellProperty( "body", 0, "accessibilitylabel", "[@static00][@static01] OK Button" );

참고

- enableaccessibility 속성값이 true인 경우만 적용되는 속성입니다.

- accessibilitydescreadtype 속성값에 "label"이 포함되었으나 accessibilitylabel 속성값을 설정하지 않으면 스크린 리더의 음성 출력 대상에 포함하지 않습니다.

accessibilityrole

GridCellControl에 선택상자 이동 시 스크린 리더가 읽어주는 Role 정보를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.accessibilityrole[= enumRole]

문법 설정

enumRole ::= 'none' | 'alert' | 'application' | 'button' | 'calendar' | 'chart' | 'checkbox' | 'columnheader' | 'combobox' | 'datepicker' | 'edit' | 'fileupload' | 'form' | 'frame' | 'grid' | 'gridcell' | 'groupbox' | 'heading' | 'heading1' | 'heading2' | 'heading3' | 'heading4' | 'heading5' | 'heading6' | 'image' | 'link' | 'listbox' | 'menubar' | 'progressbar' | 'radio' | 'rowheader' | 'scrollbar' | 'spin' | 'static' | 'statusbar' | 'tab' | 'tabpage' | 'textarea' | 'titlebar' | 'toolbar' | 'tooltip' | 'treegrid' | 'treeitem' | 'webbrowser'

this.GridCellControl00.accessibilityrole = "none"; 
this.GridCellControl00.accessibilityrole = "button";

참고

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

- accessibilityenable 속성값을 설정하지 않으면 GridCellControl의 기본 Role 로 적용됩니다.

- 추가적인 속성값이 필요한 Role 설정 시 GridCellControl에 해당 속성이 없으면 스크린 리더에 따라 정상적으로 정보를 읽지 못할 수 있습니다.

autosizecol

Column 의 너비가 자동조절 되는 방식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.autosizecol[= enumType]

문법 설정

enumType ::= 'none' | 'default' | 'limitmin' | 'limitmax'

this.Grid00.setCellProperty( "body", 0, "autosizecol", "default" );

참고

- autosizecol 속성값을 설정하지 않으면 "default"로 적용됩니다.

- autofittype 속성값이 "col" 일 경우 autosizecol 속성값은 무시됩니다.

- Cell 의 autosizecol 속성은 Grid 의 autosizingtype 속성이 설정되어 있을 경우에만 적용됩니다.

- Grid 의 autosizingtype 속성값과 autosizebandtype 속성값에 따라 Column 의 너비를 결정하는 Cell 이 정해집니다.

autosizerow

Row 의 높이가 자동조절 되는 방식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.autosizerow[= enumType]

문법 설정

enumType ::= 'none' | 'default' | 'limitmin' | 'limitmax'

this.Grid00.setCellProperty( "body", 0, "autosizerow", "default" );

참고

- autosizerow 속성값을 설정하지 않으면 "default"로 적용됩니다.

- Cell 의 autosizerow 속성은 Grid 의 autosizingtype 속성이 설정되어 있을 경우에만 적용됩니다.

- Grid 의 autosizingtype 속성값과 autosizebandtype 속성값에 따라 Row 의 높이를 결정하는 Cell 이 정해집니다.

background

Cell 의 배경 영역을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.background[= strbackground]

문법 설정

strBackground ::= [<bg-image> | <linear-gradient>] [<background-origin> [<background-clip>]] [<background-color>]

<bg-image> ::= 'none' | <imageurl> [<repeat-style>] [<position>]
   <imageurl> ::= 'URL(' <Theme-Image> | <Web-Image> ')'
   <repeat-style> ::= 'repeat-x' | 'repeat-y' | 'repeat' | 'no-repeat'
   <position> ::= <horizontal-position> <vertical-position> ['/' <background-size>]
      <horizontal-position> ::= 'left' | 'center' | 'right' | <pos-percentage> '%'
      <vertical-position> ::= 'top' | 'center' | 'bottom' | <pos-percentage> '%'
      <background-size> ::= 'auto' | 'cover' | 'contain' | (<length> 'px' | <percentage> '%') {1,2}

<linear-gradient> ::= 'linear-gradient(' [<angle> , ] <color-stop> ')'
   <angle> ::= 'to left' | 'to right' | 'to top' | 'to bottom' | 'to left top' | 'to left bottom' | 'to right top' | 'to right bottom'
   <color-stop> ::= <startcolor-stop> [<listcolor-stop>] <endcolor-stop>
      <startcolor-stop> ::= <color> [<percentage>'%']
      <endcolor-stop> ::= <color> [<percentage>'%']
      <listcolor-stop> ::= <color> [<percentage>'%"] [,<listcolor-stop>]*
         <color> ::= <NamedColor> | <NumericColor>

<background-origin> ::= 'border-box' | 'padding-box'
<background-clip> ::= 'border-box' | 'padding-box'
<background-color> ::= <NamedColor> | <NumericColor>

* XCSS
background : #ffffaa;
background : url('./images/smiley.gif') no-repeat center center #ffffaa;
background : linear-gradient( red , blue , yellow );

* Script ( normal property )
this.Grid00.setCellProperty( "body", 0, "background", "#ffffaa");
this.Grid00.setCellProperty( "body", 0, "background", "URL('./images/smiley.gif') no-repeat center center #ffffaa);
this.Grid00.setCellProperty( "body", 0, "background", "linear-gradient( red , blue , yellow )");
this.Grid00.setCellProperty( "body", 0, "background", "linear-gradient( #FF0000 , rgb(0,0,255) , rgb(255,255,0))");

참고

- background 속성값을 설정하지 않으면 undefined 가 설정되고, "transparent" 로 동작합니다.

- TypeDefinition 영역의 Services 에 정의된 사용자 Prefix 는 테마 또는 XCSS 에서 이미지경로로 사용할 수 없습니다.
   사용자 Prefix 는 스크립트 또는 넥사크로 스튜디오 에서 속성값으로 설정 시 사용할 수 있습니다.

- 배경의 기준영역과 표시영역은 <background-origin>, <background-clip> 값으로 각각 설정합니다.
   Cell 은 top/right/bottom/left 테두리(Border) 모두를 표시하지 않고, right 와 bottom 만으로 인접한 Cell 과 테두리를 연결하는 방식으로 처리합니다.
   따라서 특정 Cell 의 left 는 왼쪽 Cell 의 right 로 대체되고, top 은 윗쪽 Cell 의 bottom 으로 대체됩니다.
   배경 영역 설정 시 이와 같은 특성을 고려하여야 합니다.

- 배경 이미지를 중앙에 위치시키려면 <position> 값을 "center" 또는 "center center" 로 설정하여야 합니다.

- 배경이미지와 배경색을 모두 설정하면 배경색 위에 이미지가 표시됩니다.
   그라데이션과 배경색을 모두 설정하면 배경색 위에 그라데이션이 표시됩니다.

- 그라데이션과 배경이미지를 동시에 설정할 수 없습니다.
   두 값을 동시에 설정 시 오동작이 발생할 수 있습니다.

border-radius

Cell 의 모서리 모양을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.borderRadius[= strborderradius]

문법 설정

strborderradius ::= <horizontal-radius>{4} ['/' <vertical-radius>{4}]

* XCSS
border-radius : 10px;
border-radius : 5px 6px 10px / 5px 10px;

* Script ( normal property )
this.Grid00.setCellProperty( "body", 0, "borderRadius", "10px");
this.Grid00.setCellProperty( "body", 0, "borderRadius", "5px 6px 10px / 5px 10px");

참고

- border-radius 속성값을 설정하지 않으면 undefined 가 설정되고, "0px" 로 동작합니다. 

- 스크립트로 접근 시 속성명은 "borderRadius" 를 사용해야 합니다.

- <horizontal-radius>와 <vertical-radius>는 "/" 문자로 구분하여 입력합니다.

- Calendar, Combo 와 같이 하위 컨트롤이 존재하는 컴포넌트는 하위컨트롤에도 border-radius 속성을 설정해야 정상적으로 모서리가 표시됩니다.


◆ NRE 제약

- border-radius 속성을 설정하면 모든 테두리가 같은 색으로 적용됩니다.
   -nexa-border 속성에서 top 에 적용된 색이 모든 테두리에 적용됩니다.

calendarautoselect

Cell 의 edittype 속성값이 "date" 일 경우 편집영역이 활성화 되면 텍스트를 전체선택 할지 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendarautoselect[= bAutoselect]

문법 설정

bAutoselect ::= 'true' | 'false'

this.Grid00.setCellProperty( "body", 0, "calendarautoselect", "true" );

참고

- calendarautoselect 속성값을 설정하지 않으면 false 로 적용됩니다.


◆ web runtime environment 제약

- 마우스 또는 터치에 의해 편집영역이 활성화 될 때는 텍스트 전체선택이 정상동작합니다.
  그러나 setFocus() 메소드에 의해 편집영역이 활성화 될 때는 텍스트 전체선택이 되지 않을 수 있습니다.

calendarbackgroundcol

Cell이 Calendar 형식일 때 Calendar 의 특정날짜에 배경색을 표시하기 위해 calendardataset 속성에 설정된 Dataset 오브젝트의 Column을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendarbackgroundcol[= strColumnID]

문법 설정

this.Grid00.setCellProperty( "body", 0, "calendarbackgroundcol", "column0')";

참고

- calendardataset 속성에 설정된 Dataset 오브젝트의 Column만 설정할 수 있습니다.
- calendardatecol 속성에 설정된 특정날짜에 calendarbackgroundcol 에 설정된 배경색이 적용됩니다.

calendarbordercol

Cell이 Calendar 형식일 때 Calendar 의 특정날짜에 테두리을 표시하기 위해 calendardataset 속성에 설정된 Dataset 오브젝트의 Column을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendarbordercol[= strColumnID]

문법 설정

this.Grid00.setCellProperty( "body", 0, "calendarbordercol", "column0')";

참고

- calendardataset 속성에 설정된 Dataset 오브젝트의 Column만 설정할 수 있습니다. 
- calendardatecol 속성에 설정된 특정날짜에 calendarbordercol 에 설정된 테두리값을 적용됩니다.

calendarbuttonsize

Cell 이 Calendar 형식일 때 표시되는 드롭다운 버튼의 크기를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendarbuttonsize[= strSize]

문법 설정

strSize ::= <strWidth> [ ' ' <strHeight> ]

this.Grid00.setCellProperty( "body", 0, "calendarbuttonsize", "30");
this.Grid00.setCellProperty( "body", 0, "calendarbuttonsize", "30 20");

참고

- calendarbuttonsize 속성값을 설정하지 않으면 Grid 의 cellcalendarbuttonsize 속성값이 적용됩니다.

- <strWidth> 값과 <strHeight> 값은 공백문자로 구분하여 문자열로 설정합니다.

calendardataset

Cell이 Calendar 형식일 때 Calendar 에 특정날짜를 표시하기 위해 Dataset 오브젝트 ID를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendardataset[= strDatasetID]

문법 설정

this.Grid00.setCellProperty( "body", 0, "calendardataset", "Dataset00')";

참고

- Dataset 오브젝트에는 calendardatecol, calendarbackgroundcol, calendarbordercol, calendartextcolorcol 속성에 설정할 수 있는 Column 이 있어야 합니다.
   > calendardatecol : 특정날짜의 데이터가 있는 Column을 설정합니다.
   > calendarbackgroundcol : 특정날짜의 배경색 데이터가 있는 Column을 설정합니다.
   > calendarbordercol : 특정날짜의 테두리 데이터가 있는 Column을 설정합니다.
   > calendartextcolorcol : 특정날짜의 날짜색 데이터가 있는 Column을 설정합니다.

calendardatecol

Cell이 Calendar 형식일 때 Calendar 에 특정날짜를 표시하기 위해 calendardataset 속성에 설정된 Dataset 오브젝트의 Column을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendardatecol[= strColumnID]

문법 설정

this.Grid00.setCellProperty( "body", 0, "calendardatecol", "column0')";

참고

- calendardataset 속성에 설정된 Dataset 오브젝트의 Column만 설정할 수 있습니다.
- calendardatecol 속성에 설정된 특정날짜에 calendarbackgroundcol, calendarbordercol, calendartextcolorcol 에 설정된 효과가 적용됩니다.

calendardateformat

Cell 의 displaytype 속성값이 "date" 또는 "calendarcontrol" 일 경우 표시되는 날짜의 형식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendardateformat[= strFormat]

문법 설정

strFormat ::= <maskchar> | 'LONGDATE' | 'SHORTDATE'

<maskchar> ::= [<Year>] [<Month>] [<Day>] [<Week>] [<Hour>] [<Minute>] [<Second>] [<MiliSec>]


* <maskchar>는 날짜와 시간을 표시하기 위한 마스크 문자의 조합으로 각 요소의 순서변경과 생략이 가능합니다.

this.Grid00.setCellProperty( "body", 0, "calendardateformat", "yyyy-MM-dd ddd");
this.Grid00.setCellProperty( "body", 0, "calendardateformat", "yyyy-MM-dd ddd HH:mm:ss");

참고

- calendardateformat 속성값을 설정하지 않으면 "yyyy-MM-dd ddd"로 적용됩니다.

- Cell 이 편집가능한 상태일 때 표시되는 날짜 형식은 calendareditformat 속성에 설정합니다.

- 정의된 마스크 문자 이외의 문자를 설정하는 경우 화면에 그대로 표시되며 해당 문자를 편집할 수 없습니다.


◆ Mobile 제약

- calendartype 속성값이 "normal" 이고 calendarpopuptype 속성값이 "system" 이거나 설정하지 않았을 경우 calendardateformat 속성값이 적용되지 않습니다.
   모바일 환경에 따라 브라우저 또는 시스템의 날짜형식이 적용됩니다.
   브라우저 또는 시스템의 날짜형식이 적용될 때 사용자가 설정한 calendardateformat 속성값을 변경시키지 않습니다.


◆ Excel Export 제약

- Excel 은 "LONGDATE" 를 지원하지 않으므로 "LONGDATE" 를 설정하여도 "SHORTDATE" 로 Export 됩니다.

- Excel Export 시 특정 locale 은 지원되지 않습니다.
  "ar_AE","ar_BH","ar_DZ","ar_EG","ar_IQ","ar_JO","ar_KW","ar_LB","ar_LY","ar_MA","ar_OM","ar_QA","ar_SA","ar_SY","ar_TN","ar_YE","de_DE","he_IL" 등

calendardaysize

Cell 이 Calendar 형식일 때 팝업으로 표시되는 달력의 각 날짜영역크기를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendardaysize[= strSize]

문법 설정

strSize ::= <strWidth> [<strHeight>]

this.Grid00.setCellProperty( "body", 0, "calendardaysize", "10 10");

참고

- <strWidth> 값과 <strHeight> 값은 공백문자로 구분하여 문자열로 설정합니다.

calendardisplayinvalidtext

Cell 이 Calendar 형식일 때 바인드 된 데이터값이 유효하지 않으면 대체되어 표시할 문자열을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendardisplayinvalidtext[= enumType]

문법 설정

this.Grid00.setCellProperty( "body", 0, "calendardisplayinvalidtext", "Data Error')";

참고

- calendardisplayinvalidtext 속성값을 설정하지 않으면 undefined 가 설정되고 "invalid value" 로 동작합니다.

- calendardisplayinvalidtype 속성값이 "invalidtext" 일 때만 적용되는 속성입니다.

calendardisplayinvalidtype

Cell 이 Calendar 형식일 때 바인드 된 데이터값이 유효하지 않으면 대체되어 표시할 형식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendardisplayinvalidtype[= nHeight]

문법 설정

enumType ::= 'default' | 'none' | 'invalidtext'

this.Grid00.setCellProperty( "body", 0, "calendardisplayinvalidtype", "none" );

참고

- calendardisplayinvalidtype 속성값을 설정하지 않으면 "default" 로 적용됩니다.

- 바인드 된 데이터가 NaN, ±Infinity, 유효하지 않은 값 일 때 적용되는 속성입니다.

calendardisplaynulltext

Cell 의 calendardisplaynulltype 속성값이 "nulltext" 일 경우 Cell 에 표시할 텍스트를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendardisplaynulltext[= strText]

문법 설정

this.Grid00.setCellProperty( "body", 0, "calendardisplaynulltext", "No Data");

참고

- Cell 에 포커스가 없을 때 대체 텍스트가 표시됩니다.

활용 예제

• 데이터가 없는 경우 Calendar 대신 대체 텍스트 표시하기

calendardisplaynulltype

Cell 의 displaytype 속성값이 "date" 또는 "calendarcontrol" 이고 바인드 된 값이 "null" 인 경우 Cell 에 표시되는 값을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendardisplaynulltype[= enumType]

문법 설정

enumType ::= 'none' | 'default' | 'nulltext' | 'nullmask'

this.Grid00.setCellProperty( "body", 0, "calendardisplaynulltype", "default");

활용 예제

• 데이터가 없는 경우 Calendar 대신 대체 텍스트 표시하기

calendareditformat

Cell 의 edittype 속성값이 "date" 일 경우 입력받는 날짜의 형식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendareditformat[= strFormat]

문법 설정

strFormat ::= <maskchar> | 'LONGDATE' | 'SHORTDATE'

<maskchar> ::= [<Year>] [<Month>] [<Day>] [<Hour>] [<Minute>] [<Second>]


* <maskchar>는 날짜와 시간을 입력하기 위한 마스크 문자의 조합으로 각 요소의 순서변경과 생략이 가능합니다.

this.Grid00.setCellProperty( "body", 0, "calendareditformat", "yyyy-MM-dd");
this.Grid00.setCellProperty( "body", 0, "calendareditformat", "yyyy-MM-dd HH:mm:ss");

참고

- calendareditformat 속성값을 설정하지 않으면 "yyyy-MM-dd"로 적용됩니다.

- Cell 에 포커스가 없을 때 표시되는 날짜 형식은 calendardateformat 속성에 설정합니다.

- 정의된 마스크 문자 이외의 문자를 설정하는 경우 화면에 그대로 표시되며 해당 문자를 편집할 수 없습니다.


◆ Mobile 제약

- calendartype 속성값이 "normal" 이고 calendarpopuptype 속성값이 "system" 이거나 설정하지 않았을 경우 calendareditformat 속성값이 적용되지 않습니다.
   모바일 환경에 따라 브라우저 또는 시스템의 날짜형식이 적용됩니다.
   브라우저 또는 시스템의 날짜형식이 적용될 때 사용자가 설정한 calendareditformat 속성값을 변경시키지 않습니다.

calendarheadformat

Cell 이 Calendar 형식일 때 팝업달력의 상단에 표시되는 년/월의 순서를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendarheadformat[= strFormat]

문법 설정

strFormat ::= 'yyyy.MM' | 'MM.yyyy'

this.Grid00.setCellProperty( "body", 0, "calendarheadformat", "MM.yyyy");

참고

- calendarheadformat 속성값을 설정하지 않거나 허용하지 않는 값을 설정하면 "yyyy.MM" 으로 적용됩니다.

calendarheadheight

Cell 이 Calendar 형식일 때 팝업달력에서 년/월이 표시되는 Head 영역의 높이를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendarheadheight[= nHeight]

문법 설정

this.Grid00.setCellProperty( "body", 0, "calendarheadheight", "60");

calendarpopupsize

Cell 이 Calendar 형식일 때 팝업으로 표시되는 달력의 크기를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendarpopupsize[= strSize]

문법 설정

strSize ::= <strWidth> [ ' ' <strHeight> ]

this.Grid00.setCellProperty( "body", 0, "calendarpopupsize", "500 400");

참고

- calendarpopupsize 속성값을 설정하지 않으면 Grid 의 cellcalendarpopupsize 속성값이 적용됩니다.

- <strWidth> 값과 <strHeight> 값은 공백문자로 구분하여 문자열로 설정합니다.

calendarpopuptype

Cell 이 Calendar 형식일 때 팝업달력(DatePicker)이 표시되는 방식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendarpopuptype[= enumType]

문법 설정

enumType ::= 'none' | 'normal' | 'center' | 'system'

this.Grid00.setCellProperty("body", 0, "calendarpopuptype", "system')";

참고

- calendarpopuptype 속성값을 설정하지 않으면 Grid 의 cellcalendarpopuptype 속성값이 적용됩니다.

- calendartype 속성값이 "normal" 일때만 적용되며 모바일환경 같은 특별한 경우에 제한적으로 사용해야 하는 속성입니다.

- 다중 모니터의 경우 Grid 가 표시되고 있는 모니터를 기준으로 팝업달력이 표시됩니다.

calendarshowmonthspin

Cell 이 Calendar 형식일 때 팝업달력의 상단에 월 변경버튼을 표시할 지 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendarshowmonthspin[= bShow]

문법 설정

bShow ::= 'true' | 'false'

this.Grid00.setCellProperty( "body", 0, "calendarshowmonthspin", "true')";

참고

- calendarshowmonthspin 속성값을 설정하지 않으면 "false"로 적용됩니다.

calendarshowyearspin

Cell 이 Calendar 형식일 때 팝업달력의 상단에 연도 변경버튼을 표시할 지 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendarshowyearspin[= bShow]

문법 설정

bShow ::= 'true' | 'false'

this.Grid00.setCellProperty( "body", 0, "calendarshowyearspin", "true')";

참고

- calendarshowyearspin 속성값을 설정하지 않으면 "false"로 적용됩니다.

calendartextcolorcol

Cell이 Calendar 형식일 때 Calendar 의 특정날짜에 날짜색을 표시하기 위해 calendardataset 속성에 설정된 Dataset 오브젝트의 Column을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendartextcolorcol[= strColumnID]

문법 설정

this.Grid00.setCellProperty( "body", 0, "calendartextcolorcol", "column0')";

참고

- calendardataset 속성에 설정된 Dataset 오브젝트 의 Column만 설정할 수 있습니다. 
- calendardatecol 속성에 설정된 특정날짜에 calendartextcolorcol 에 설정된 날짜색이 적용됩니다.

calendartype

Cell 이 Calendar 형식일 때 Calendar가 화면에 표시되는 형식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendartype[= enumType]

문법 설정

enumType ::= 'normal' | 'monthonly' | 'spin'

this.Grid00.setCellProperty("body", 0, "calendartype", "normal";

참고

- calendartype 속성값을 설정하지 않으면 "normal"로 적용됩니다.

calendarusetrailingday

Cell 이 Calendar 형식일 때 팝업달력의 시작/끝 여백에 전/후 달의 날짜를 표시할지 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendarusetrailingday[= bTrail]

문법 설정

bTrail ::= 'true' | 'false'

this.Grid00.setCellProperty( "body", 0, "calendarusetrailingday", "true')";

참고

- calendarusetrailingday 속성값을 설정하지 않으면 "false"로 적용됩니다.

- calendarusetrailingday 속성값을 "false"로 설정하면 전/후 달의 날짜가 표시되지 않고 선택할 수 없습니다.

calendarweekformat

Cell 이 Calendar 형식일 때 팝업달력에 요일이 표시되는 형식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.calendarweekformat[= strFormat]

문법 설정

this.Grid00.setCellProperty("body", 0, "calendarweekformat","S M T W T F S')";

checkboxfalsevalue

Cell 이 CheckBox 형식일 때 False 로 처리되는 값을 문자열로 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.checkboxfalsevalue[= strValue]

문법 설정

this.Grid00.setCellProperty( "body", 0, "checkboxfalsevalue", "F')";

참고

- checkboxfalsevalue 속성값을 설정하지 않으면 false 또는 0 값으로 적용됩니다.

- Cell 의 edittype 속성값이 "checkbox" 일 때 Cell 에 표시되는 CheckBox 에 적용됩니다.
   Cell 의 displaytype 속성값이 "checkboxcontrol" 일 때 Cell 에 표시되는 CheckBox 에 적용됩니다.

- Cell 의 CheckBox 에 클릭등의 방법으로 체크해제하면 바인드 된 Column 에 checkboxfalsevalue 속성값이 저장됩니다.

- checkboxtruevalue 속성값과 checkboxfalsevalue 속성값이 같으면 checkboxtruevalue 속성값이 우선 적용됩니다.

checkboxsize

Cell 이 CheckBox 형식일 때 CheckBox 의 크기를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.checkboxsize[= nSize]

문법 설정

this.Grid00.setCellProperty( "body", 0, "checkboxsize", "25')";

참고

- Cell 의 edittype 속성값이 "checkbox" 이거나 "tree" 일 때 Cell 에 표시되는 CheckBox 에 적용됩니다.
   Cell 의 displaytype 속성값이 "checkboxcontrol" 이거나 "treeitemcontrol" 일 때 Cell 에 표시되는 CheckBox 에 적용됩니다.

- checkboxsize 속성값을 설정하지 않으면 Grid 의 cellcheckboxsize 속성값이 적용됩니다.
   checkboxsize, cellcheckboxsize 속성을 모두 설정하지 않으면 테마에 정의된 CheckBox 이미지 크기에 맞게 적용됩니다.

- 테마에서 CheckBox 이미지 크기는 GridCellControl 하위의 cellcheckbox 셀렉터에 정의됩니다.

- 테마에 정의된 CheckBox 이미지 크기보다 checkboxsize 속성값을 작게 설정할 경우 이미지가 잘려서 표시됩니다.

checkboxtruevalue

Cell 이 CheckBox 형식일 때 True 로 처리되는 값을 문자열로 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.checkboxtruevalue[= strValue]

문법 설정

this.Grid00.setCellProperty( "body", 0, "checkboxtruevalue", "T')";

참고

- checkboxtruevalue 속성값을 설정하지 않으면 true 또는 1 값으로 적용됩니다.

- Cell 의 edittype 속성값이 "checkbox" 일 때 Cell 에 표시되는 CheckBox 에 적용됩니다.
   Cell 의 displaytype 속성값이 "checkboxcontrol" 일 때 Cell 에 표시되는 CheckBox 에 적용됩니다.

- Cell 의 CheckBox 에 클릭등의 방법으로 체크설정하면 바인드 된 Column 에 checkboxtruevalue 속성값이 저장됩니다.

- checkboxtruevalue 속성값과 checkboxfalsevalue 속성값이 같으면 checkboxtruevalue 속성값이 우선 적용됩니다.

col

Cell 에 정의된 Column 인덱스 값이 저장된 읽기전용 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.col

참고

- Column 인덱스는 Cell 이 표시되는 위치를 나타냅니다.

- 같은 Column 위치의 Cell 은 Head, Body, Summary 밴드에 관계없이 동일한 값을 갖습니다.

- Grid 에서 탭키 입력 시 포커스가 Cell 을 이동하는 순서와 일치합니다.

- 넥사크로 스튜디오의 Grid Contents Editor 에서 디자인 시 자동으로 설정되는 속성입니다.

color

Cell 에 표시되는 텍스트의 색상을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.color[= strcolor]

문법 설정

strcolor ::= <NamedColor> | <NumericColor>

* XCSS
color : #999999;
color : rgb ( 255, 0, 0 );
color : red;

* Script ( normal property )
this.Grid00.setCellProperty( "body", 0, "color", "#999999')";
this.Grid00.setCellProperty( "body", 0, "color", "rgb(255,0,0)')";
this.Grid00.setCellProperty( "body", 0, "color", "red')";

참고

- color 속성값을 설정하지 않으면 undefined 가 설정되고, "#000000" 으로 동작합니다.


◆ web runtime environment 제약

- XCSS 를 사용하지 않고 rgba(), hsl(), hsla() 메소드를 속성에 직접 설정할 경우 브라우저 버전에 따라 적용되지 않을 수 있습니다.

colspan

Cell 에 병합된 Column 의 갯수가 저장된 읽기전용 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.colspan

참고

- 병합(Merge) 된 Cell 이 아닐 경우 "1" 값을 갖습니다.

- 병합(Merge) 된 Cell 이 있는 Column 은 Head 영역을 드래그하여 Column 순서를 바꿀 수 없습니다.

comboautoselect

Cell 이 Combo 형식일 때 편집영역이 활성화 되면 텍스트를 전체선택 할지 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.comboautoselect[= bAutoselect]

문법 설정

bAutoselect ::= 'true' | 'false'

this.Grid00.setCellProperty( "body", 0, "comboautoselect", "true" );

참고

- comboautoselect 속성값을 설정하지 않으면 false 로 적용됩니다.

- Cell 이 Combo 형식일 때 편집영역이 활성화 되려면 edittype 속성값이 "combo" 이고, combotype 속성값이 "dropdown" 이외의 값이어야 합니다.


◆ web runtime environment 제약

- 마우스 또는 터치에 의해 편집영역이 활성화 될 때는 텍스트 전체선택이 정상동작합니다.
  그러나 setFocus() 메소드에 의해 편집영역이 활성화 될 때는 텍스트 전체선택이 되지 않을 수 있습니다.

combobuttonsize

Cell 이 Combo 형식일 때 표시되는 드롭다운 버튼의 크기를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.combobuttonsize[= strSize]

문법 설정

strSize ::= <strWidth> [ ' ' <strHeight> ]

this.Grid00.setCellProperty( "body", 0, "combobuttonsize", "30')";
this.Grid00.setCellProperty( "body", 0, "combobuttonsize", "30 20')";

참고

- combobuttonsize 속성값을 설정하지 않으면 Grid 의 cellcombobuttonsize 속성값이 적용됩니다.

- <strWidth> 값과 <strHeight> 값은 공백문자로 구분하여 문자열로 설정합니다.

combocodecol

Cell 이 Combo 형식일 때 Cell 의 아이템 리스트에서 코드값으로 사용될 Column 을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.combocodecol[= strColumnID]

문법 설정

this.Grid00.setCellProperty( "body", 0, "combocodecol", "column0')";

참고

- Cell 의 edittype 속성값이 "combo" 일 경우 적용되는 속성입니다.
   Cell 의 displaytype 속성값이 "combotext" 또는 "combocontrol" 일 경우 적용되는 속성입니다.

- combocodecol 속성은 Body 밴드 영역의 Cell 에만 적용되는 속성입니다.

- combocodecol 속성을 설정하지 않으면 내부적으로 combodatacol 속성값을 사용합니다.

- combocodecol 속성에 설정된 Column 의 값은 아이템 리스트에 표시되지 않고 각 아이템의 코드값으로 처리됩니다.
   combodatacol 속성에 설정된 Column 의 값은 아이템 리스트에 표시되며 각 아이템의 데이터값으로 처리됩니다.

- 아이템 리스트의 코드값은 아이템을 구분하는 유일값으로 중복값을 가질 수 없습니다.
   만일 중복된 코드값이 존재할 경우 중복코드값의 첫번째 아이템이 항상 선택처리됩니다.
   
- Cell 에서 선택된 아이템의 코드값은 Cell 의 text 속성에 저장되고 Grid 에 바인딩 된 DataSet 에 반영됩니다.
   Cell 에는 선택된 코드값에 해당하는 아이템 리스트의 데이터값이 텍스트로 표시됩니다.

combodatacol

Cell 이 Combo 형식일 때 Cell 의 아이템 리스트에서 데이터값으로 사용될 Column 을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.combodatacol[= strColumnID]

문법 설정

this.Grid00.setCellProperty( "body", 0, "combodatacol", "column1')";

참고

- Cell 의 edittype 속성값이 "combo" 일 경우 적용되는 속성입니다.
   Cell 의 displaytype 속성값이 "combotext" 또는 "combocontrol" 일 경우 적용되는 속성입니다.

- combodatacol 속성은 Body 밴드 영역의 Cell 에만 적용되는 속성입니다.

- combodatacol 속성을 설정하지 않으면 내부적으로 combocodecol 속성값을 사용합니다.

- combodatacol 속성에 설정된 Column 의 값은 아이템 리스트에 표시되며 각 아이템의 데이터값으로 처리됩니다.
   combocodecol 속성에 설정된 Column 의 값은 아이템 리스트에 표시되지 않고 각 아이템의 코드값으로 처리됩니다.

- 아이템 리스트의 코드값은 아이템을 구분하는 유일값으로 중복값을 가질 수 없습니다.
   만일 중복된 코드값이 존재할 경우 중복코드값의 첫번째 아이템이 항상 선택처리됩니다.
   
- Cell 에서 선택된 아이템의 코드값은 Cell 의 text 속성에 저장되고 Grid 에 바인딩 된 DataSet 에 반영됩니다.
   Cell 에는 선택된 코드값에 해당하는 아이템 리스트의 데이터값이 텍스트로 표시됩니다.

combodataset

Cell 이 Combo 형식일 때 Cell 의 아이템 리스트를 구성할 DataSet 의 ID를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.combodataset[= strDatasetID]

문법 설정

this.Grid00.setCellProperty( "body", 0, "combodataset", "Dataset00')";

참고

- Cell 에서 Combo 아이템 리스트를 사용하기 위해서는 combocodecol 과 combodatacol 중 한개 속성과 combodataset 속성을 설정하여야 합니다.

- combodataset 속성에 설정한 DataSet 이 존재하지 않거나 데이터가 없을 경우 아이템 리스트가 정상적으로 표시되지 않습니다.

- combodataset 속성은 Body 밴드 영역의 Cell 에만 적용되는 속성입니다.

활용 예제

• ComboControl 내에서 선택한 항목의 스타일 바꾸어 표시하기

combodisplaynulltext

Cell 이 Combo 형식일 때 바인드 된 값과 일치하는 아이템이 없을 경우 표시할 텍스트를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.combodisplaynulltext[= strText]

문법 설정

this.Grid00.setCellProperty( "body", 0, "combodisplaynulltext", "No Data')";

참고

- Combo 아이템의 코드값에 현재 Cell 에 바인드된 값이 없는 상태에서
  Cell 에 포커스가 없고, combodisplaynulltype 속성값이 "nulltext" 일 때 대체 텍스트가 표시됩니다.

combodisplaynulltype

Cell 이 Combo 형식일 때 바인드 된 값과 일치하는 아이템이 없을 경우 표시되는 값의 종류를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.combodisplaynulltype[= enumType]

문법 설정

enumType ::= 'none' | 'nulltext'

this.Grid00.setCellProperty( "body", 0, "combodisplaynulltype", "nulltext" );

참고

- combodisplaynulltype 속성값을 설정하지 않으면 "none" 으로 적용됩니다.

combodisplayrowcount

Cell 이 Combo 형식일 때 아이템 리스트에 한번에 표시될 아이템의 갯수를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.combodisplayrowcount[= nRowNum]

문법 설정

this.Grid00.setCellProperty( "body", 0, "combodisplayrowcount", "5')";

참고

- combodisplayrowcount 속성값을 설정하지 않으면 undefined 로 적용됩니다.

- combodisplayrowcount 속성값 보다 아이템의 갯수가 작으면 아이템 갯수에 맞게 리스트가 표시됩니다.

- combodisplayrowcount 속성값 보다 아이템의 갯수가 많으면 아이템 리스트에 스크롤이 표시됩니다.

- Combo 하단에 아이템 3개를 표시할 공간이 없다면 아이템 리스트가 Combo 상단에 표시됩니다.
  상/하단 모두 아이템 3개를 표시할 공간이 없다면 더 넓은 방향으로 리스트가 표시됩니다.

comboimemode

Cell 이 Combo 형식일 때 편집창에서 사용될 기본 입력 언어를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.comboimemode[= enumImemode]

문법 설정

enumImemode ::= 'none' | 'alpha' | 'alpha,full' | 'hangul' | 'hangul,full' | 'katakana' | 'katakana,full' | 'hiragana' | 'direct'

this.Grid00.setCellProperty( "body", 0, "comboimemode", "alpha" );

참고

- comboimemode 속성값을 설정하지 않으면 "none" 으로 적용됩니다.

- Cell 이 포커스를 받아 편집창이 활성화 될 때 IME가 재설정됩니다.

- 일부 환경에서만 지원하는 속성이므로 상단의 지원환경을 확인하시기 바랍니다.
   > Windows NRE, Android NRE에서만 지원하는 속성입니다.
   > macOS NRE, iOS/iPadOS NRE, WRE에서는 지원하지 않는 속성입니다.

comboitemheight

Cell 이 Combo 형식일 때 아이템 리스트의 각 행높이를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.comboitemheight[= nHeight]

문법 설정

this.Grid00.setCellProperty( "body", 0, "comboitemheight", "30')";

참고

- comboitemheight 속성을 설정하지 않으면 글자 크기를 기준으로 행의 높이를 자동 계산합니다.

combopopupsize

Cell 이 Combo 형식일 때 팝업으로 표시되는 아이템 리스트의 크기를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.combopopupsize[= strSize]

문법 설정

strSize ::= <strWidth> [ ' ' <strHeight> ]

this.Grid00.setCellProperty( "body", 0, "combopopupsize", "500 400')";

참고

- combopopupsize 속성값을 설정하지 않으면 Grid 의 cellcombopopupsize 속성값이 적용됩니다.

- <strWidth> 값과 <strHeight> 값은 공백문자로 구분하여 문자열로 설정합니다.

combopopuptype

Cell 이 Combo 형식일 때 아이템 리스트가 표시되는 방식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.combopopuptype[= enumType]

문법 설정

enumType ::= 'none' | 'normal' | 'center'

this.Grid00.setCellProperty( "body", 0, "combopopuptype", "center')";

참고

- combopopuptype 속성값을 설정하지 않으면 Grid 의 cellcombopopuptype 속성값이 적용됩니다.

- 모바일환경 같은 특별한 경우에 제한적으로 사용해야 하는 속성입니다.

- 다중 모니터의 경우 Grid 가 표시되고 있는 모니터를 기준으로 아이템 리스트가 표시됩니다.

comboscrollbarsize

Cell 이 Combo 형식일 때 아이템 리스트에 표시되는 스크롤바의 너비를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.comboscrollbarsize[= nWidth]

문법 설정

this.Grid00.setCellProperty( "body", 0, "comboscrollbarsize", "20" );

참고

- comboscrollbarsize 속성값을 설정하지 않으면 Grid 의 cellcomboscrollbarsize 속성값이 적용됩니다.

- scrollbarsize 속성값을 변경하면 스크롤바 내부버튼의 높이와 너비가 같이 변경됩니다.

combotype

Cell 이 Combo 형식일 때 동작하는 방법을 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.combotype[= enumType]

문법 설정

enumType ::= 'dropdown' | 'search' | 'filter' | 'filterlike' | 'caseisearch' | 'caseifilter' | 'caseifilterlike'

this.Grid00.setCellProperty( "body", 0, "combotype", "caseifilter')";

참고

- combotype 속성값을 설정하지 않으면 "dropdown" 으로 적용됩니다.

- combotype 속성값에 관계없이 Cell 의 드롭버튼(DropButton) 클릭 시 전체 아이템이 있는 아이템 리스트가 표시됩니다.

- combotype 속성을 "dropdown" 이외의 값으로 설정하면 검색/필터 기능이 활성화 됩니다.
   검색/필터 기능은 사용자의 입력을 돕기위한 기능으로 아이템 후보값을 편집 영역과 리스트 창을 통해 표시합니다.

- 아이템 리스트에서 마우스나 키보드에 의해 아이템을 선택하면 입력이 종료된 것으로 처리합니다.

controlautosizingtype

Cell 이 컨트롤 형식일 때 Cell 크기에 맞게 컨트롤 크기를 자동 조절할 지 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.controlautosizingtype[= enumType]

문법 설정

enumType ::= 'none' | 'width' | 'height' | 'both'

this.Grid00.setCellProperty( "body", 0, "controlautosizingtype", "width')";

참고

- controlautosizingtype 속성값을 설정하지 않으면 "both" 로 적용됩니다.

- Cell 이 CheckBox 형태이면 controlautosizingtype 속성값은 적용되지 않습니다.
   checkboxsize 속성값 또는 아이콘 크기에 맞게 내부 컨트롤의 크기가 설정됩니다.

- 내부 컨트롤이 Calendar 또는 Combo 형태일 때 드롭다운 버튼의 크기를 고정하려면 calendarbuttonsize 또는 combobuttonsize 속성값을 설정하여야 합니다.
  드롭다운 버튼의 크기를 설정하지 않으면 내부 컨트롤의 크기에 맞게 드롭다운 버튼의 크기가 자동 설정됩니다.

- controlautosizingtype 속성값이 "both" 가 아닐 경우 내부 컨트롤이 잘려서 표시될 수 있습니다.
  이 때, autosizerow 또는 autosizecol 속성값을 "limitmin" 으로 설정하면 내부 컨트롤이 잘려서 표시되는 것을 방지할 수 있습니다.

cssclass

Cell 의 Style을 XCSS 파일에 정의된 class로 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.cssclass[= strcssclass]

문법 설정

strcssclass ::= <ClassName> [ , &ltClassName> ]*

this.Grid00.setCellProperty( "body", 0, "cssclass", "TestClass" );
this.Grid00.setCellProperty( "body", 0, "cssclass", "TestClass,TestClass2" );

참고

- XCSS 에 정의된 ".classname" 형식에서 "." 를 제외하고 "classname" 만 설정합니다.

- Style 에 적용되는 방식은 XCSS Attribute 지정과 동일하게 XCSS 내의 순서대로 적용됩니다.

- Status 를 적용하고자 할 경우는 "classname" 에 Status 를 붙여서 사용합니다.

- ',' 를 사용하여 class 를 다중으로 지정하게 되면 class 가 중첩되어 적용됩니다.
   중첩된 class 의 내용에 중복이 있다면 XCSS 내의 순서상 마지막으로 기술된 것이 적용됩니다.


◆ web runtime environment 제약

- web runtime environment 는 cssclass 명의 첫문자가 숫자일 경우 속성값이 적용되지 않으므로 주의하여야 합니다.

활용 예제

• cssclass 속성값을 여러 개 지정하기

• 소계 이름과 배경색 설정하기

cursor

Cell 영역내에서 표시될 마우스 포인터의 종류를 설정하는 속성입니다.

지원 환경

속성 타입

문법

GridCellControl.cursor[= strCursor]

문법 설정

strCursor ::= 'none' | 'auto' | 'default' | 'copy' | 'crosshair' | 'help' | 'move' | 'not-allowed' | 'pointer' | 'progress' | 'text' | 'wait' | 'ew-resize' | 'e-resize' | 'w-resize' | 'ns-resize' | 'n-resize' | 's-resize' | 'nesw-resize' | 'ne-resize' | 'sw-resize' | 'nwse-resize' | 'nw-resize' | 'se-resize'

* XCSS
cursor : default;

* Script ( normal property )
this.Grid00.setCellProperty( "body", 0, "cursor", "default" );