개요

애플리케이션의 기본 화면을 구성합니다.

내부적으로 TitleBarControl 과 StatusBarControl 을 기본으로 갖고 있습니다. 
하위 구성요소로 FrameSet,  HFrameSet, VFrameSet, TileFrameSet, ChildFrame 중 한개를 가질 수 있습니다.

지원 환경

컴포넌트 구조

Status

Control

속성

all

MainFrame 에 등록된 Frame 을 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

MainFrame.all

문법 설정

var objApp = nexacro.getApplication();
var objFrames = objApp.mainframe.[Frame구조].all;

참고

- all 속성은 Collection 접근방식을 사용할 수 있습니다.
  MainFrame.all[0], MainFrame.all["ChildFrame0"], MainFrame.all.length 등의 방법을 사용합니다.

background

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

지원 환경

속성 타입

문법

MainFrame.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 : "URL('./images/smiley.gif')" no-repeat center center /auto #ffffaa;
background : "URL('./images/smiley.gif')" no-repeat center center /15px 15% #ffffaa;
background : linear-gradient( red , blue , yellow );
background : linear-gradient( #FF0000 , rgb(0,0,255) , rgb(255,255,0));
background : "URL('./images/smiley.gif')" border-box border-box #ffffaa;

* Script ( normal property )
this.MainFrame00.background = "#ffffaa";
this.MainFrame00.background = ""URL('./images/smiley.gif')" no-repeat center center #ffffaa";
this.MainFrame00.background = ""URL('./images/smiley.gif')" no-repeat center center /auto #ffffaa";
this.MainFrame00.background = ""URL('./images/smiley.gif')" no-repeat center center /15px 15% #ffffaa";
this.MainFrame00.background = "linear-gradient( red , blue , yellow )";
this.MainFrame00.background = "linear-gradient( #FF0000 , rgb(0,0,255) , rgb(255,255,0))";
this.MainFrame00.background = ""URL('./images/smiley.gif')" border-box border-box #ffffaa";

참고

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

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

- 배경의 기준영역과 표시영역은 <background-origin>, <background-clip> 값으로 각각 설정합니다.

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

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

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

border-radius

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

지원 환경

속성 타입

문법

MainFrame.borderRadius[= strborderradius]

문법 설정

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

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

* Script ( normal property )
this.MainFrame00.borderRadius = "10px";
this.MainFrame00.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 에 적용된 색이 모든 테두리에 적용됩니다.

color

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

지원 환경

속성 타입

문법

MainFrame.color[= strcolor]

문법 설정

strcolor ::= <NamedColor> | <NumericColor>

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

* Script ( normal property )
this.MainFrame00.color = "#999999";
this.MainFrame00.color = "rgb(255,0,0)";
this.MainFrame00.color = "red";

참고

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


◆ web runtime environment 제약

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

cssclass

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

지원 환경

속성 타입

문법

MainFrame.cssclass[= strcssclass]

문법 설정

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

var objApp = nexacro.getApplication();

objApp.mainframe.cssclass = "TestClass";
objApp.mainframe.cssclass = "TestClass,TestClass2";

참고

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

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

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

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


◆ web runtime environment 제약

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

cursor

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

지원 환경

속성 타입

문법

MainFrame.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.MainFrame00.cursor = "default";

참고

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

- disable 상태인 서브컨트롤이 있는 컴포넌트의 경우 마우스 포인터는 서브컨트롤 영역에서
   서브컨트롤의 disable status값이 적용되지 않고, 컴포넌트의 enable status 설정값이 적용됩니다.
   서브컨트롤과 컴포넌트가 모두 disable 상태일 때는 parent 의 enable status 설정값이 적용됩니다.

enable

MainFrame 의 사용가능 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.enable[= benable]

문법 설정

benable ::= 'true' | 'false'

this.MainFrame00.enable = true; 
this.MainFrame00.enable = false;

참고

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

- enable 속성값이 false 이면 컴포넌트가 화면에 표시되지만 포커스나 입력을 받을 수 없습니다.

- Div 와 같은 컨테이너 컴포넌트의 enable 속성값을 false 로 설정하면 자식 컴포넌트도 모두 Disable 됩니다.

enableevent

MainFrame 에서 이벤트를 발생시킬지 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.enableevent[= bEvent]

문법 설정

bEvent ::= 'true' | 'false'

this.MainFrame00.enableevent = true;  

this.MainFrame00.enableevent = false;

참고

- enableevent 속성을 false 로 설정하면 이벤트 발생으로 인한 처리속도 지연과 화면 깜빡임을 방지할 수 있습니다.

font

MainFrame 에서 사용하는 폰트를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.font[= strfont]

문법 설정

strfont ::= [<font-style>] [<font-weight>] <font-size> ['/'<line-height>] <font-family>

<font-style> ::= 'normal' | 'italic'
<font-weight> ::= 'normal' | 'bold' | '100' | '200' | '300' | '400' | '500' | '600' | '700' | '800' | '900'
<font-size> ::= <nSize> 'px'|'pt'|'em'|'rem'
<line-height> ::= 'normal' | <nValue> | <nPixel>'px' | <nPercent>'%'
<font-family> ::= <font-name> [',' <font-name>]*

* XCSS
font : bold 12pt/30px arial, sans-serif;

* Script ( normal property )
this.MainFrame00.font = "bold 12pt/30px arial, sans-serif";

참고

- font 속성값을 설정하지 않으면 undefined 가 설정되고, "12pt/normal Verdana" 로 동작합니다.

- font 속성의 폰트 크기가 변경되면 <line-height> 에 적용된 값에 따라 줄간격이 변경될 수 있습니다.

- <font-weight> 를 수치로 설정 시 "400" 값이 일반적인 굵기로 적용되고, "700" 값이 "bold" 로 적용됩니다.
   폰트에 수치값에 해당하는 폰트굵기가 없다면 "400" 과 "700" 중 가까운 값으로 표시됩니다.

- UserFont 사용 시 환경별로 지원하는 포맷정보는 "Appendix > Supported UserFont" 항목을 참고하세요.


◆ WRE 제약

- -nexa-text-align 속성값이 "right" 일 때 font 속성에 "italic" 을 설정하면 마지막 텍스트의 기울어진 부분이 잘려서 표시될 수 있습니다.
   웹브라우저에서 텍스트영역을 일반글자 기준으로 처리한 후 기울임을 적용하면서 발생하는 문제입니다.

frame

MainFrame 에 등록된 Frame 을 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

MainFrame.frame

문법 설정

var objApp = nexacro.getApplication();
var objFrame = objApp.mainframe.frame.name;

height

MainFrame 을 표시하기 위한 높이를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.height[= nheight]

문법 설정

nheight ::= <nVal> ['px']

var objApp = nexacro.getApplication();

objApp.mainframe.height = 10;
objApp.mainframe.height = "10px";

참고

- 높이값에 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

hotkey

MainFrame 의 기본 액션을 수행하기 위한 단축키를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.hotkey[= strHotkey]

문법 설정

this.MainFrame00.hotkey = "G"; 
this.MainFrame00.hotkey = "CTRL+A"; 
this.MainFrame00.hotkey = "CTRL+ALT+X";

참고

(1) 컴포넌트 기본 액션

hotkey 속성값 설정 시 컴포넌트의 기본 액션이 수행됩니다. 컴포넌트 기본 액션은 다음과 같습니다.
- onclick : Button, CheckBox
- 포커스 이동 (접근성 설정 시) : GroupBox, Static
- onsetfocus : 나머지 Frame 오브젝트 및 컴포넌트
* GroupBox, Static 컴포넌트는 접근성 설정 환경이 아닌 경우 hotkey 속성은 처리되지 않습니다.

(2) 예외 조건

(2-1) 같은 hotkey 속성값을 가진 컴포넌트가 있을 때
Form 내에 같은 hotkey 속성값을 가진 컴포넌트가 2개 이상 있는 경우 components 속성 인덱스 순서에 따라 먼저 생성된 컴포넌트의 hotkey 속성만 처리됩니다.

(2-2) 단축키가 설정된 입력장치를 사용할 때
단축키 설정 기능이 있는 입력장치를 사용하는 경우 입력장치에서 설정된 단축키와 같은 값을 hotkey 속성값으로 설정하면 hotkey 속성은 처리되지 않습니다.
예를 들어 "CTRL+M" 키 입력을 ENTER 키 입력으로 변환해 처리하는 키보드를 사용한다면 hotkey 속성값을 "CTRL+M"으로 설정하고 해당 키를 입력해도 기본 액션이 수행되지 않습니다.

(2-3) 상위 프레임 또는 Form이 활성화되지 않았을 때
hotkey 속성은 상위 프레임 또는 Form이 활성화된 경우에만 동작합니다. 

(2-4) enable 속성값이 false 일 때
컴포넌트의 enable 속성값이 false이면 hotkey 속성은 처리되지 않습니다.

(2-5) hotkeycolumn 속성값을 설정했을 때
Menu 컴포넌트의 hotkey 속성값과 hotkeycolumn 속성값을 같은 속성값으로 설정하면 hotkeycolumn 속성은 처리되지 않습니다.

활용 예제

• 특정 키 입력 시 onclick 이벤트 처리하기

id

MainFrame의 고유 식별자를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.id

문법 설정

참고

-  addChild나 insertChild 메소드를 사용하여 컴포넌트를 등록할때 parent 가 자식컴포넌트를 구별하기 위한 고유한 key값입니다.

- 속성명이나 메소드명과 같은 예약어를 id 속성값으로 설정할 경우 오류가 발생할 수 있습니다.

- 컴포넌트의 속성은 아니지만 편의를 위하여 넥사크로 스튜디오에서 설정할 수 있는 기능이 제공됩니다.

- name 속성은 사용자가 지정한 컴포넌트의 이름으로 논리적으로 중복이 가능합니다.

- 넥사크로 스튜디오에서 컴포넌트를 생성하거나 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.

layered

MainFrame 의 윈도우를 투명으로 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.layered[= bLayered]

문법 설정

bLayered ::= 'true' | 'false'

참고

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

- 동적으로 변경이 불가능 한 속성입니다.

left

MainFrame 을 표시하기 위한 좌측 좌표값을 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.left[= nleft]

문법 설정

nleft ::= <nVal> ['px']

var objApp = nexacro.getApplication();

objApp.mainframe.left = 10;
objApp.mainframe.left = "10px";

참고

- 좌표값에 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

- Windows NRE 와 macOS NRE 만 적용되는 속성입니다.

letter-spacing

MainFrame 에 표시되는 문자의 간격(자간)을 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.letterSpacing[= strspace]

문법 설정

strspace ::= 'normal' | <nVal> ['px']

* XCSS
letter-spacing : 2px ;

* Script ( normal property )
this.MainFrame00.letterSpacing = "2px";

참고

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

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

name

MainFrame 의 이름을 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.name[= strName]

문법 설정

참고

- name 속성은 사용자가 지정한 컴포넌트의 이름으로 논리적으로 중복이 가능합니다.

- 넥사크로 스튜디오에서 컴포넌트를 생성하거나 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.

-nexa-border

MainFrame 의 테두리를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.border[= strborder]

문법 설정

strborder ::= <line-width> <line-style> <color> [,<line-width> <line-style> <color>]{3}

<line-width> ::= 'thin' | 'medium' | 'thick' | <nWidth> 'px'
<line-style> ::= 'none' | 'hidden' | 'dotted' | 'dashed' | 'solid' | 'double' | 'groove' | 'ridge' | 'inset' | 'outset'
<color> ::= <NamedColor> | <NumericColor>

1회 입력 : top/right/bottom/left 에 모두 적용됩니다.
2회 입력 : top/bottom, right/left 에 첫번째 값부터 각각 적용됩니다.
3회 입력 : top, right/left, bottom 에 첫번째 값부터 각각 적용됩니다.
4회 입력 : top, right, bottom, left 에 첫번째 값부터 각각 적용됩니다.

* 2회~4회 입력은 border-radius 속성값이 설정되지 않은 경우만 적용됩니다.

* XCSS
-nexa-border : 1px solid #999999;
-nexa-border : 1px solid #999999, 1px solid #999999, 1px solid #999999, 1px solid #999999;

* Script ( normal property )
this.MainFrame00.border = "1px solid #999999";
this.MainFrame00.border = "1px solid #999999, 1px solid #999999, 1px solid #999999, 1px solid #999999";

참고

- -nexa-border 속성값을 설정하지 않으면 undefined 가 설정되고, "medium none #999999" 로 동작합니다.

- <line-style> 이 "double" 일 때 두 줄을 다른 색으로 설정할 수 없습니다.
   <color> 에 설정된 색이 두 줄에 모두 적용됩니다.

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


◆ Nexacro Runtime Environment 제약

- 각 테두리의 색상이나 두께를 다르게 설정했을 경우 top > right > bottom > left 순으로 겹쳐서 표시됩니다.

- <line-style> 에 "double","groove","ridge","inset","outset" 값을 설정해도 적용되지 않습니다.

- <line-width> 에 "thin","medium","thick" 값을 설정해도 적용되지 않습니다.


◆ Web Runtime Environment 제약

- 각 테두리의 색상이나 두께를 다르게 설정했을 경우 웹브라우저에 따라 테두리가 겹쳐지는 순서가 다르게 처리될 수 있습니다.

- 각 테두리의 색상이나 두께를 다르게 설정했을 경우 border-radius 속성값이 설정되어 있으면 
   두께는 각 테두리 별로 따로 적용되고, 색상은 top 에 설정된 색이 적용됩니다.

- 각 테두리의 색상이나 두께를 다르게 설정했을 경우 border-radius 속성값이 설정되어 있어도
   일부 브라우저는 각 테두리의 색상이나 두께가 각각 적용됩니다.

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

-nexa-edge

MainFrame 의 테두리(Border) 안쪽에 표시될 Edge 이미지를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.edge[= stredge]

문법 설정

stredge ::= 'none' | <image> [<fixedwidth>'px' <fixedheight>'px']

<image> ::= 'URL("' <Theme-Image> | <Web-Image> '")'

* XCSS
-nexa-edge : "URL('./images/border.png')" 5px 5px;

* Script ( normal property )
this.MainFrame00.edge = "URL('./images/border.png')" 5px 5px;

참고

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

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

- MainFrame 내부에 테두리 형태로 이미지를 표시하고자 할 때 사용하는 속성입니다.

- -nexa-edge 속성값을 설정하면 이미지의 상/하/좌/우 일정 영역(<fixedwidth>,<fixedheight> 값)을 고정하고 안쪽 사각형 영역을 Stretch 하여 처리합니다.

- background 속성에 의해 배경색 또는 이미지가 설정되어 있어도 -nexa-edge 속성에 설정된 이미지가 제일 위에 표시됩니다.

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


◆ WRE 제약

- <fixedwidth>,<fixedheight> 값이 이미지 사이즈의 1/2 을 초과할 경우 브라우저별로 보이는 형태가 다를 수 있습니다.

- CSS3 스펙을 지원하지 않는 브라우저 버전에서는 정상적으로 표시되지 않을 수 있습니다.

-nexa-rtl-background-image

MainFrame 의 rtl 속성이 true 로 적용될 때 배경에 표시될 이미지를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.-nexa-rtl-background-image

문법 설정

strRtlBgImage ::= "URL(' " <Theme-Image> | <Web-Image> " ')"

* XCSS
-nexa-rtl-background-image : URL("http://localhost/Test.jpg");
-nexa-rtl-background-image : URL("theme://images/Test.jpg");

참고

- rtl 속성에 의해 표시기준이 변경되면 반전된 이미지를 적용하려 할 때 사용하는 속성입니다.

- XCSS 에서만 설정할 수 있는 속성으로 스크립트로 값을 변경할 수 없습니다.
   XCSS 에 -nexa-rtl-background-image 속성값을 설정하지 않으면 background 속성에 설정된 이미지가 적용됩니다.

- TypeDefinition 영역의 Services 에 정의된 사용자 Prefix 는 테마 또는 XCSS 에서 이미지경로로 사용할 수 없습니다.

- 배경이미지가 적용되는 영역은 컴포넌트의 클라이언트 영역입니다.

- background 속성에 배경색이 설정되어 있을 경우 배경색 위에 이미지가 표시됩니다.

- 그라데이션과 배경이미지를 동시에 설정할 수 없습니다.
   background 속성에 그라데이션이 설정되어 있을 경우 오동작이 발생할 수 있습니다.

-nexa-rtl-edge-image

MainFrame 의 rtl 속성이 true 로 적용될 때 테두리(Border) 안쪽에 표시될 Edge 이미지를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.-nexa-rtl-edge-image

문법 설정

strRtlEgImage ::= "URL(' " <Theme-Image> | <Web-Image> " ')"

* XCSS
-nexa-rtl-edge-image : URL("http://localhost/Test.jpg");
-nexa-rtl-edge-image : URL("theme://images/Test.jpg")

참고

- rtl 속성에 의해 표시기준이 변경되면 반전된 이미지를 적용하려 할 때 사용하는 속성입니다.

- XCSS 에서만 설정할 수 있는 속성으로 스크립트로 값을 변경할 수 없습니다.
   XCSS 에 -nexa-rtl-edge-image 속성값을 설정하지 않으면 -nexa-edge 속성에 설정된 이미지가 적용됩니다.

- TypeDefinition 영역의 Services 에 정의된 사용자 Prefix 는 테마 또는 XCSS 에서 이미지경로로 사용할 수 없습니다.

- 배경이미지가 적용되는 영역은 컴포넌트의 클라이언트 영역입니다.

- background 또는 -nexa-rtl-background-image 속성에 의해 배경색 또는 이미지가 설정되어 있어도 -nexa-rtl-edge-image 속성에 설정된 이미지가 제일 위에 표시됩니다.


◆ web runtime environment 제약

- CSS3 스펙을 지원하지 않는 브라우저 버전에서는 정상적으로 표시되지 않을 수 있습니다.

opacity

MainFrame 영역의 투명도를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.opacity[= stropacity]

문법 설정

* XCSS
opacity : 0.8;
opacity : 80%;

* Script ( normal property )
this.MainFrame00.opacity = "0.8";
this.MainFrame00.opacity = 0.8;
this.MainFrame00.opacity = "80%";

참고

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

- Div 와 같이 자식 컴포넌트를 가질 수 있는 컴포넌트에 opacity 속성을 적용하면 자식 컴포넌트도 함께 적용됩니다.

- 부모와 자식 컴포넌트에 각각 opacity 속성이 설정되어 있으면 자식 컴포넌트의 투명도는 부모의 투명도에 추가적으로 적용됩니다.
   예를 들어 부모의 opacity가 0.5 이고 자식의 opacity가 0.4 이면 결과적으로 자식 컴포넌트는 0.2 의 투명도가 적용됩니다.

openalign

어플리케이션이 실행될 때 전체화면에서 표시될 위치를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.openalign[= strAlign]

문법 설정

strAlign ::= [<hAlign>] [<vAlign>]

<hAlign> ::= 'left' | 'center' | 'right'
<vAlign> ::= 'top' | 'middle' | 'bottom'

참고

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

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

openstatus

MainFrame 의 창 크기를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.openstatus[= stropenstatus]

문법 설정

stropenstatus ::= 'normal' | 'minimize' | 'maximize'

this.MainFrame00.openstatus = "maximize";

progressbardirection

MainFrame 의 StatusBar 에 표시되는 ProgressBar 의 진행방향을 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.progressbardirection[= enumDirection]

문법 설정

enumDirection ::= 'forward' | 'backward'

참고

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

- 진행중인 통신 상태는 StatusBar 의 ProgressBar 를 통해 확인할 수 있습니다.

progressbargap

MainFrame 의 StatusBar 에 표시되는 ProgressBar 의 오른쪽 공간 크기를 설정하는 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.progressbargap[= nSize]

문법 설정

progressbarsize

MainFrame 의 StatusBar 에 표시되는 ProgressBar 의 너비를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.progressbarsize[= nSize]

문법 설정

progressbarsmooth

MainFrame 의 StatusBar 에 표시되는 ProgressBar 의 진행바가 연속된 형태로 표시될 지 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.progressbarsmooth[= bSmooth]

문법 설정

bSmooth ::= 'true' | 'false'

resizable

MainFrame 의 리사이즈 가능 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.resizable[= bResizable]

문법 설정

bResizable ::= 'true' | 'false'

참고

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

showcascadestatustext

MainFrame 의 StatusBar 에 하위 Frame 과 Form 의 statustext 속성값을 모두 표시할 지 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.showcascadestatustext[= bShow]

문법 설정

bShow ::= 'true' | 'false'

참고

- MainFrame 의 showstatusbar 속성값이 "true" 일 경우만 적용됩니다.

- MainFrame 보다 상위 Frame 의 StatusBar 는 상위 Frame 의 showcascadestatustext 속성값에 따라 표시됩니다.

showcascadetitletext

MainFrame 의 TitleBar 에 하위 Frame 과 Form 의 titletext 속성값을 모두 표시할 지 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.showcascadetitletext[= bShow]

문법 설정

bShow ::= 'true' | 'false'

참고

- MainFrame 의 showtitlebar 속성값이 "true" 일 경우만 적용됩니다.

- MainFrame 보다 상위 Frame 의 TtileBar 는 상위 Frame 의 showcascadetitletext 속성값에 따라 표시됩니다.

showstatusbar

MainFrame 에 StatusBar 표시 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.showstatusbar[= bshowstatus]

문법 설정

bshowstatus ::= 'true' | 'false'

this.MainFrame00.showstatusbar = true;

참고

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

showtitlebar

MainFrame 의 TitleBar 표시 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.showtitlebar[= bshowtitlebar]

문법 설정

bshowtitlebar ::= 'true' | 'false'

참고

- TitleBar 에는 MainFrame을(를) 최소화, 최대화, 종료할 수 있는 버튼이 있습니다.

showtitleicon

MainFrame 의 타이틀바에 아이콘 표시 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.showtitleicon[= bshowtitleicon]

문법 설정

bshowtitleicon ::= 'true' | 'false'

참고

- Theme 의 TitleBarControl > titleicon > -nexa-icon 속성에 설정된 아이콘 이미지를 아이콘으로 표시합니다.

statusbar

MainFrame 의 상태바 오브젝트를 갖는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.statusbar

문법 설정

var objApp = nexacro.getAppplication();
var objStatusBar = objApp.mainframe.statusbar;

참고

- MainFrame 의 showstatusbar 속성값이 "true" 일 경우만 상태바 오브젝트가 생성됩니다.

statusbarheight

MainFrame 의 StatusBar 높이를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.statusbarheight[= nHeight]

문법 설정

참고

- showstatubar 속성값이 "true" 일 경우 적용되는 속성입니다.

미지정시 기본값 : default : undefinded
값이 undefinded 일 경우  메인프레임은 30으로, 메인프레임이 아닌 프레임들은 20으로 동작

statustext

MainFrame 의 StatusBar 에 표시될 텍스트를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.statustext[= strStatustext]

문법 설정

참고

- showcascadestatustext 속성값이 true 이면 하위 Frame 또는 Form 의 statustext 속성값을 MainFrame 의 StatusBar 에 함께 표시합니다.
   MainFrame 하위에 여러개의 Frame 이 있을 경우엔 현재 활성화 된 Frame 의 statustext 속성값이 표시됩니다.

 
◆ WRE 제약
 
- Chrome, Firefox, Opera, Edge 브라우저는 보안상의 이유로 StatusBar 의 텍스트 변경을 지원하지 않습니다.

- 현재 StatusBar 의 텍스트를 변경할 수 있는 브라우저도 향후 기능이 차단될 수 있습니다.

titlebar

MainFrame 의 타이틀바 오브젝트를 갖는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.titlebar

문법 설정

var objApp = nexacro.getApplication();
var objTitleBar = objApp.mainframe.titlebar

참고

- MainFrame 의 showtitlebar 속성값이 "true" 일 경우만 타이틀바 오브젝트가 생성됩니다.

활용 예제

• 타이틀바 영역 변경하기

titlebarbuttongap

MainFrame 의 TitleBar 에 표시되는 시스템 버튼의 간격을 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.titlebarbuttongap[= nGap]

문법 설정

참고

- showtitlebar 속성값이 "true" 일 때 적용되는 속성입니다.

titlebarbuttonsize

MainFrame 의 타이틀바에 표시되는 시스템 버튼의 크기을 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.titlebarbuttonsize[= strSize]

문법 설정

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

참고

- showtitlebar 속성값이 "true" 일 때 적용되는 속성입니다.

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

titlebarheight

MainFrame 의 TitleBar 높이를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.titlebarheight[= nHeight]

문법 설정

참고

- titlebarheight 속성값을 설정하지 않으면 undefined 로 적용됩니다.
   undefined 가 적용되면 MainFrame 은 "30px" 로  표시되고, 다른 Frame 은 "20px" 로 표시됩니다.

titletext

MainFrame 의 TitleBar 에 표시될 텍스트를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.titletext[= strTitletext]

문법 설정

참고

- showcascadetitletext  속성값이 "true"이면 하위 Frame 또는 Form 의 titletext 속성값을 MainFrame 의 TitleBar 에 함께 표시합니다.
  MainFrame 하위에 여러개의 Frame 이 있을 경우 현재 활성화 된 Frame 의 titletext 속성값이 표시됩니다.

top

MainFrame 을 표시하기 위한 상단 좌표값을 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.top[= ntop]

문법 설정

ntop ::= <nVal> ['px']

var objApp = nexacro.getApplication();

objApp.mainframe.top = 10;
objApp.mainframe.top = "10px";

참고

- 좌표값에 "px" 문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

- Windows NRE 와 macOS NRE 만 적용되는 속성입니다.

visible

MainFrame 이(가) 화면에 표시될지 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.visible[= bVisible]

문법 설정

bVisible ::= 'true' | 'false'

this.MainFrame00.visible = true; 
this.MainFrame00.visible = false;

참고

- visible 속성값을 변경하는 즉시 컴포넌트의 표시 여부가 화면에 반영됩니다.

- visible 속성값이 "false"이면 컴포넌트가 화면에 표시되지 않고, 포커스를 받을 수 없으므로 입력이나 사용이 불가능합니다.

- Div 와 같은 컨테이너 컴포넌트의 visible 속성값을 "false"로 설정하면 자식 컴포넌트도 함께 화면에 표시되지 않습니다.

- visible 속성값이 "false"이어도 컴포넌트는 존재하기 때문에 스크립트로 제어가 가능합니다.

- 넥사크로 스튜디오에서는 visible 속성값을 'false'로 설정해도 디자인화면에서 사라지지 않습니다.

width

MainFrame 을 표시하기 위한 너비를 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.width[= nwidth]

문법 설정

nwidth ::= <nVal> ['px']

var objApp = nexacro.getApplication();

objApp.mainframe.width = 10; objApp.mainframe.width = "10px";

참고

- 너비값에 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

word-spacing

MainFrame 에 표시되는 텍스트의 단어 사이 간격을 설정하는 속성입니다.

지원 환경

속성 타입

문법

MainFrame.wordSpacing[= strwordspacing]

문법 설정

strWordSpacing ::= 'normal' | <nVal>'px'

* XCSS
word-spacing : 30px;

* Script ( normal property )
this.MainFrame00.wordSpacing = "30px";

참고

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

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

메서드

addEventHandler

MainFrame 의 특정 이벤트에 핸들러 함수를 추가하는 메소드입니다.

지원 환경

문법

MainFrame.addEventHandler( strEventID, objFunc, objTarget )

파라미터

this.MainFrame00_onmove = function( obj:nexacro.MainFrame,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.MainFrame00.addEventHandler( "onmove", this.MainFrame00_onmove, this);

반환

addEventHandlerLookup

함수를 검색하여 MainFrame 의 특정 이벤트에 핸들러 함수로 추가하는 메소드입니다.

지원 환경

문법

MainFrame.addEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

this.MainFrame00_onmove = function( obj:nexacro.MainFrame,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.MainFrame00.addEventHandlerLookup( "onmove", "MainFrame00_onmove", this);

반환

참고

- strFunc 이름의 함수를 objTarget 영역부터 상위로 올라가며 검색합니다.
  검색된 함수가 있다면 이벤트에 핸들러 함수로 추가합니다.

alert

MainFrame 의 경고 대화상자를 표시하는 메소드입니다.

지원 환경

문법

MainFrame.alert( strText )

파라미터

var objFrame = this.getOwnerFrame();
objFrame.alert( "Warning" );

참고

- MainFrame 의 중앙에 대화상자를 표시합니다.

clearEventHandler

특정 이벤트에 등록된 핸들러 함수를 모두 제거하는 메소드입니다.

지원 환경

문법

MainFrame.clearEventHandler( strEventID )

파라미터

var nCnt = this.MainFrame00.clearEventHandler( "onmove" );

반환

참고

- 특정 핸들러 함수만 제거하려면 removeEventHandler() 메소드를 사용하여야 합니다.

confirm

MainFrame 의 선택 대화상자를 표시하는 메소드입니다.

지원 환경

문법

MainFrame.confirm( strText [,strCaption [,strType]] )

파라미터

var objFrame = this.getOwnerFrame();
objFrame.confirm( "Exit ?" );
objFrame.confirm( "Exit ?",  "Title Text");
objFrame.confirm( "Exit ?",  "Title Text", "question" );

반환

참고

- MainFrame 의 중앙에 선택 대화상자를 표시합니다.

findEventHandler

MainFrame 의 특정 이벤트에서 핸들러 함수를 찾아 인덱스를 반환하는 메소드입니다.

지원 환경

문법

MainFrame.findEventHandler( strEventID, objFunc, objTarget )

파라미터

this.MainFrame00_onmove = function( obj:nexacro.MainFrame,  e:nexacro.MoveEventInfo ) { //수행할 스크립트 };

var nIndex = this.MainFrame00.findEventHandler( "onmove", this.MainFrame00_onmove, this );

반환

참고

- 핸들러 함수의 인덱스는 0 부터 시작합니다.

getEventHandler

MainFrame 의 특정 이벤트에서 지정된 인덱스에 해당하는 핸들러 함수를 반환하는 메소드입니다.

지원 환경

문법

MainFrame.getEventHandler( strEventID, nIdx )

파라미터

var objFunc = MainFrame00.getEventHandler( "onmove", 0 );

반환

getNativeHandle

MainFrame이 속한 윈도우 핸들(HWND)값을 반환하는 메소드입니다.

지원 환경

문법

MainFrame.getNativeHandle();

파라미터

var nHwnd = this.parent.getNativeHandle();

반환

getOffsetHeight

MainFrame 의 높이를 픽셀단위의 숫자로 반환하는 메소드입니다.

지원 환경

문법

MainFrame.getOffsetHeight();

파라미터

var objApp = nexacro.getApplication();

var nWidth = objApp.mainframe.getOffsetHeight();

반환

참고

- 화면에 표시된 MainFrame 의 높이를 동적으로 계산합니다.

활용 예제

• 마지막 좌표값 처리하기

• PopupDiv 배치하기

getOffsetWidth

MainFrame 의 너비를 픽셀단위의 숫자로 반환하는 메소드입니다.

지원 환경

문법

MainFrame.getOffsetWidth();

파라미터

var objApp = nexacro.getApplication();

var nWidth = objApp.mainframe.getOffsetWidth();

반환

참고

- 화면에 표시된 MainFrame 의 너비를 동적으로 계산합니다.

활용 예제

• 마지막 좌표값 처리하기

• PopupDiv 배치하기

insertEventHandler

MainFrame 의 특정 이벤트에 핸들러 함수를 지정한 위치에 삽입하는 메소드입니다.

지원 환경

문법

MainFrame.insertEventHandler( strEventID, nIndex, objFunc, objTarget )

파라미터

this.MainFrame00_onmove = function( obj:nexacro.MainFrame,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };

var nIndex = this.MainFrame00.insertEventHandler( "onmove", 0, this.MainFrame00_onmove, this);

반환

참고

- 첫번째 핸들러 함수의 인덱스는 0 입니다.

removeEventHandler

MainFrame 의 특정 이벤트에서 핸들러 함수를 제거하는 메소드입니다.

지원 환경

문법

MainFrame.removeEventHandler( strEventID, objFunc, objTarget )

파라미터

this.MainFrame00_onmove = function( obj:nexacro.MainFrame,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.MainFrame00.removeEventHandler( "onmove", this.MainFrame00_onmove, this);

반환

참고

- 핸들러 함수가 제거되면 핸들러 함수의 인덱스가 0 번부터 재조정됩니다.

- 이벤트에 등록된 핸들러 함수를 모두 제거하려면 clearEventHandler() 메소드를 사용하여야 합니다.

removeEventHandlerLookup

MainFrame 의 특정 이벤트에서 검색된 함수와 동일한 핸들러 함수를 제거하는 메소드입니다.

지원 환경

문법

MainFrame.removeEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

this.MainFrame00_onmove = function( obj:nexacro.MainFrame,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.MainFrame00.removeEventHandlerLookup( "onmove", "MainFrame00_onmove", this);

반환

참고

- 핸들러 함수가 제거되면 핸들러 함수의 인덱스가 0 번부터 재조정됩니다.

- 이벤트에 등록된 핸들러 함수를 모두 제거하려면 clearEventHandler() 메소드를 사용하여야 합니다.

setEventHandler

MainFrame 의 특정 이벤트에서 첫번째 핸들러 함수를 변경하는 메소드입니다.

지원 환경

문법

MainFrame.setEventHandler( strEventID, objFunc, objTarget )

파라미터

this.MainFrame00_onmove = function( obj:nexacro.MainFrame,  e:nexacro.MoveEventInfo ) { //수행할 스크립트 };
var nIndex = this.MainFrame00.setEventHandler( "onmove", this.MainFrame00_onmove, this );

반환

참고

- 인덱스가 0 번인 핸들러 함수를 새로운 함수로 대체합니다.

- 인덱스가 0 번인 핸들러 함수가 없다면 0 번 인덱스에 새로운 함수를 핸들러 함수로 추가합니다.

setEventHandlerLookup

MainFrame 의 특정 이벤트에서 첫번째 핸들러 함수를 검색된 함수로 변경하는 메소드입니다.

지원 환경