개요

ChildFrame 은 MainFrame, FrameSet, HFrameSet, VFrameSet, TileFrameSet 하위에 올 수 있는 Frame 입니다.

Form 정보를 formurl 속성으로 갖고 있어 해당 Form의 화면을 로딩하여 보여줍니다.
기본적으로 Form이 로딩될 수 있는 기본 단위 화면입니다.

지원 환경

컴포넌트 구조

생성자

ChildFrame.init( strName, nLeft, nTop, nWidth, nHeight [, nRight, nBottom [,strUrl]] )

var obFrame = new ChildFrame();

obFrame.init( "ChildFrame00", 30, 120, 196, 46, null, null);
obFrame.init( "ChildFrame00", null, null, 300, "400px", "80%", 300, "Base::Form00.xfdl" );

// Create Object  
var objChildFrame = new ChildFrame();  
objChildFrame.init("ChildFrame", 30, 120, 196, 46, null, null);
objChildFrame.init("ChildFrame", null, null, 300, "400px", "80%", 300);
or
var objChildFrame = new ChildFrame("ChildFrame", 30, 120, 196, 46, null, null);
var objChildFrame = new ChildFrame("ChildFrame", null, null, 300, "400px", "80%", 300);
 
// Add Object to Parent Frame  
this.addChild("ChildFrame", objChildFrame); 
 
// Insert Object to Parent Frame  
this.insertChild(1, "ChildFrame", objChildFrame); 
 
// Remove Object form Parent Frame  
this.removeChild("ChildFrame"); 
 
// Show Object  
objChildFrame.show(); 
 
// Destroy Object  
objChildFrame.destroy(); 
objChildFrame = null;

Status

Control

속성

all

ChildFrame 이 포함하고 있는 Frame 를 갖는 속성입니다.

지원 환경

속성 타입

문법

ChildFrame.all

문법 설정

var childframe= Childframe.all[0];

참고

- showModal() 메소드 호출시 ChildFrame을 parent를 설정했다면 해당 목록이 생성됩니다.

autosize

ChildFrame 이 화면에 표시될 때 formurl 속성에 설정된 Form 의 크기에 맞춰질 지 설정하는 속성입니다.

지원 환경

속성 타입

문법

ChildFrame.autosize[= bAutoSize]

문법 설정

bAutoSize ::= 'true' | 'false'

var objFrame = new ChildFrame();

objFrame.init("modal00", 0, 0, 500, 500); objFrame.formurl = "Base::Test00.xfdl";
objFrame.autosize = false;

var vRtn = objFrame.showModal("modal00", this.getOwnerFrame());

참고

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

- autosize 속성은 showModal() 과 같은 메소드로 ChildFrame 을 동적으로 화면에 표시할 때 설정하는 속성입니다.
   ChildFrame 이 화면에 표시되기 전에 설정하여야 하며 화면에 표시된 후에 값을 변경하는 것은 의미가 없습니다.

background

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

지원 환경

속성 타입

문법

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

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

지원 환경

속성 타입

문법

ChildFrame.borderRadius[= strborderradius]

문법 설정

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

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

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

bottom

ChildFrame 을(를) 표시하기 위한 하단 좌표값을 설정하는 속성입니다.

지원 환경

속성 타입

문법

ChildFrame.bottom[= nBottom]

문법 설정

nBottom ::= <nVal> ['px' | '%']

참고

- 좌표값에 단위를 생략할 경우 pixel 값으로 적용됩니다.

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

color

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

지원 환경

속성 타입

문법

ChildFrame.color[= strcolor]

문법 설정

strcolor ::= <NamedColor> | <NumericColor>

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

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

참고

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


◆ web runtime environment 제약

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

cssclass

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

지원 환경

속성 타입

문법

ChildFrame.cssclass[= strcssclass]

문법 설정

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

var objCFrame = this.getOwnerFrame();

objCFrame.cssclass = "TestClass";
objCFrame.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

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

지원 환경

속성 타입

문법

ChildFrame.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.ChildFrame00.cursor = "default";

참고

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

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

dragmovetype

ChildFrame 을 드래그로 이동시킬 때 드래그가 가능한 영역을 설정하는 속성입니다.

지원 환경

속성 타입

문법

ChildFrame.dragmovetype[= enumType]

문법 설정

enumType ::= 'none' | 'normal' | 'all"

ChildFraem00.dragmovetype = "none";

참고

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


◆ Mobile 제약

- 모바일 환경에서 Form 영역의 드래그는 스크롤 액션과 구별할 수 없어 지원하지 않습니다.
   따라서, 모바일 환경은 TitleBar 영역의 드래그만 가능합니다.

활용 예제

• ChildFrame 생성하기

enable

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

지원 환경

속성 타입

문법

ChildFrame.enable[= benable]

문법 설정

benable ::= 'true' | 'false'

this.ChildFrame00.enable = true; 
this.ChildFrame00.enable = false;

참고

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

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

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

enableevent

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

지원 환경

속성 타입

문법

ChildFrame.enableevent[= bEvent]

문법 설정

bEvent ::= 'true' | 'false'

this.ChildFrame00.enableevent = true;  

this.ChildFrame00.enableevent = false;

참고

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

font

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

지원 환경

속성 타입

문법

ChildFrame.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.ChildFrame00.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" 을 설정하면 마지막 텍스트의 기울어진 부분이 잘려서 표시될 수 있습니다.
   웹브라우저에서 텍스트영역을 일반글자 기준으로 처리한 후 기울임을 적용하면서 발생하는 문제입니다.

form

ChildFrame 에 속한 Form 의 오브젝트를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

ChildFrame.form

참고

- formurl 속성에 정의된 Form의 변수, 함수, 컴포넌트에 접근할 때 form 속성을 사용하여야 합니다.

formurl

ChildFrame 에 속할 Form 의 위치정보를 설정하는 속성입니다.

지원 환경

속성 타입

문법

ChildFrame.formurl[= strFormurl]

문법 설정

strFormurl ::= <absolute-url> | <relative-url>

ChildFrame00.formurl = "Base::Form01.xfdl";

height

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

지원 환경

속성 타입

문법

ChildFrame.height[= nHeight]

문법 설정

nHeight ::= <nVal> ['px' | '%']

참고

- 높이값에 단위를 생략할 경우 pixel 값으로 적용됩니다.

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

hotkey

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

지원 환경

속성 타입

문법

ChildFrame.hotkey[= strHotkey]

문법 설정

this.ChildFrame00.hotkey = "G"; 
this.ChildFrame00.hotkey = "CTRL+A"; 
this.ChildFrame00.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

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

지원 환경

속성 타입

문법

ChildFrame.id

문법 설정

참고

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

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

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

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

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

layered

open() 메소드를 사용하여 ChildFrame 을 생성할 때 배경 윈도우를 투명으로 설정하는 속성입니다.

지원 환경

속성 타입

문법

ChildFrame.layered[= bLayered]

문법 설정

bLayered ::= 'true' | 'false'

참고

- open() 메소드를 사용하여 ChildFrame 을 Widget 형태로 실행할 때 투명 배경을 설정하기 위해 사용하는 속성입니다.

- open() 메소드에서 layered 속성값을 설정하지 않으면 "false" 로 적용됩니다.

- ChildFrame 이 생성된 후 변경이 불가능한 속성입니다.

left

ChildFrame 을(를) 표시하기 위한 좌측 좌표값을 설정하는 속성입니다.

지원 환경

속성 타입

문법

ChildFrame.left [=nLeft]

문법 설정

nLeft ::= <nVal> ['px' | '%']

참고

- 좌표값에 단위를 생략할 경우 pixel 값으로 적용됩니다.

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

name

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

지원 환경

속성 타입

문법

ChildFrame.name[= strName]

문법 설정

참고

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

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

-nexa-border

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

지원 환경

속성 타입

문법

ChildFrame.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.ChildFrame00.border = "1px solid #999999";
this.ChildFrame00.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

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

지원 환경

속성 타입

문법

ChildFrame.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.ChildFrame00.edge = "URL('./images/border.png')" 5px 5px;

참고

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

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

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

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

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

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


◆ WRE 제약

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

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

-nexa-rtl-background-image

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

지원 환경

속성 타입

문법

ChildFrame.-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

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

지원 환경

속성 타입

문법

ChildFrame.-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

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

지원 환경

속성 타입

문법

ChildFrame.opacity[= stropacity]

문법 설정

* XCSS
opacity : 0.8;
opacity : 80%;

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

참고

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

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

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

openalign

showModal() 메소드로 ChildFrame 을 팝업창으로 표시할 때 위치를 지정하는 속성입니다.

지원 환경

속성 타입

문법

ChildFrame.openalign[= strAlign]

문법 설정

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

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

참고

- openalign 속성값을 설정하지 않으면 Position 관련 속성값에 맞게 표시되는 위치가 결정됩니다.

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

활용 예제

• 모달창으로 ChildFrame 생성하기

openstatus

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

지원 환경

속성 타입

문법

ChildFrame.openstatus[= stropenstatus]

문법 설정

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

this.ChildFrame00.openstatus = "maximize";

overlaycolor

ChildFrame 이 Modal 로 띄워진 경우에 부모 Frame 전체에 적용될 색을 설정하는 속성입니다.

지원 환경

속성 타입

문법

ChildFrame.overlaycolor[= strcolor]

문법 설정

strcolor ::= <NamedColor> | <NumericColor>

참고

- ChildFrame 이 Modal 로 표시되면 부모 Frame 을 사용할 수 없다는 의미로 오버레이색을 설정하게 됩니다.

progressbardirection

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

지원 환경

속성 타입

문법

ChildFrame.progressbardirection[= enumDirection]

문법 설정

enumDirection ::= 'forward' | 'backward'

참고

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

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

progressbargap

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

지원 환경

속성 타입

문법

ChildFrame.progressbargap[= nSize]

문법 설정

progressbarsize

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

지원 환경

속성 타입

문법

ChildFrame.progressbarsize[= nSize]

문법 설정

progressbarsmooth

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

지원 환경

속성 타입

문법

ChildFrame.progressbarsmooth[= bSmooth]

문법 설정

bSmooth ::= 'true' | 'false'

resizable

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

지원 환경

속성 타입

문법

ChildFrame.resizable[= bResizable]

문법 설정

bResizable ::= 'true' | 'false'

참고

- showModal() 메소드를 사용하여 ChildFrame 이 표시될 경우 resizable 속성값을 설정하지 않으면 false 로 적용됩니다.

- Frame 의 내부에 ChildFrame 이 표시될 경우 resizable 속성값을 설정하지 않으면 true 로 적용됩니다.


◆ web runtime environment 제약

- web runtime environment 에서 open() 메소드 사용하여 ChildFrame 을 표시할 경우 resizable 속성값은 항상 true 로 적용됩니다.

활용 예제

• 모달창으로 ChildFrame 생성하기

right

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

지원 환경

속성 타입

문법

ChildFrame.right [=nRight]

문법 설정

nRight ::= <nVal>['px' | '%']

참고

- 좌표값에 단위를 생략할 경우 pixel 값으로 적용됩니다.

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

rtl

ChildFrame 에서 내부 컨텐츠 또는 컴포넌트의 표시 기준을 설정하는 속성입니다.

지원 환경

속성 타입

문법

ChildFrame.rtl

문법 설정

bRtl ::= undefined | 'true' | 'false'

var vRtl = this.ChildFrame00.rtl;

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- 아랍권 같이 화면의 표시기준이 오른쪽인 환경에서 컨텐츠의 표시 기준을 변경하기 위해 설정하는 속성입니다.

- ChildFrame 부터 Environment 까지 상위의 모든 rtl 속성값이 undefined 이면
   Environment 의 locale 속성에 설정된 국가 및 언어 설정값을 기준으로 rtl 속성이 적용됩니다.
   Environment 의 locale 속성값을 설정하지 않았을 경우 시스템의 국가 및 언어 설정값이 적용됩니다.

showcascadestatustext

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

지원 환경

속성 타입

문법

ChildFrame.showcascadestatustext[= bShow]

문법 설정

bShow ::= 'true' | 'false'

참고

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

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

showcascadetitletext

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

지원 환경

속성 타입

문법

ChildFrame.showcascadetitletext[= bShow]

문법 설정

bShow ::= 'true' | 'false'

참고

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

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

showontaskbar

open() 메소드로 ChildFrame 이 Modeless로 표시될 때 윈도우의 TaskBar 에 표시할 지 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

ChildFrame.showontaskbar[= bShow]

문법 설정

bShow ::= 'true' | 'false'

참고

- showontaskbar 속성값을 설정하지 않으면 표시되는 ChildFrame 이 상위 Frame 을 갖지 않을때만 TaskBar 에 항목을 표시합니다.

showstatusbar

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

지원 환경

속성 타입

문법

ChildFrame.showstatusbar[= bshowstatus]

문법 설정

bshowstatus ::= 'true' | 'false'

this.ChildFrame00.showstatusbar = true;

참고

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

showtitlebar

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

지원 환경

속성 타입

문법

ChildFrame.showtitlebar[= bshowtitlebar]

문법 설정

bshowtitlebar ::= 'true' | 'false'

참고

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

활용 예제

• ChildFrame 정렬하기

showtitleicon

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

지원 환경

속성 타입

문법

ChildFrame.showtitleicon[= bshowtitleicon]

문법 설정

bshowtitleicon ::= 'true' | 'false'

참고

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

statusbar

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

지원 환경

속성 타입

문법

ChildFrame.statusbar

문법 설정

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

참고

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

statusbarheight

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

지원 환경

속성 타입

문법

ChildFrame.statusbarheight[= nHeight]

문법 설정

참고

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

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

statustext

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

지원 환경

속성 타입

문법

ChildFrame.statustext[= strStatustext]

문법 설정

참고

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

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

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

titlebar

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

지원 환경

속성 타입

문법

ChildFrame.titlebar

문법 설정

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

참고

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

활용 예제

• 타이틀바 영역 변경하기

titlebarbuttongap

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

지원 환경

속성 타입

문법

ChildFrame.titlebarbuttongap[= nGap]

문법 설정

참고

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

titlebarbuttonsize

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

지원 환경

속성 타입

문법

ChildFrame.titlebarbuttonsize[= strSize]

문법 설정

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

참고

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

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

titlebarheight

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

지원 환경

속성 타입

문법

ChildFrame.titlebarheight[= nHeight]

문법 설정

참고

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

titletext

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

지원 환경

속성 타입

문법

ChildFrame.titletext[= strTitletext]

문법 설정

참고

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

top

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

지원 환경

속성 타입

문법

ChildFrame.top[= nTop]

문법 설정

nTop ::= <nVal> ['px' | '%']

참고

- 좌표값에 단위를 생략할 경우 pixel 값으로 적용됩니다.

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

topmost

별도의 Window 를 가진 ChildFrame 을 최상위에 표시할지 설정하는 속성입니다.

지원 환경

속성 타입

문법

ChildFrame.topmost[= bTopmost]

문법 설정

bTopmost ::= 'true' | 'false'

참고

- open() 메소드로 ChildFrame 을 Widget 형태로 실행하여 사용할 경우 topmost 값을 true 로 설정하여 항상 최상위에 표시되도록 할 수 있습니다.

- open() 메소드로 ChildFrame 을 Modeless 형태로 실행할 때 topmost 속성을 true 로 설정하면 다른 어플리케이션보다 상위에 표시됩니다.
   ChildFrame 이 표시된 후 topmost 속성이 true 인 어플리케이션이 실행되면 겹쳐서 표시될 수 있습니다.

- showModal() 등의 메소드로 오픈된 별도의 window 를 갖지 않는 팝업창은 topmost 속성을 설정할 수 없습니다.

visible

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

지원 환경

속성 타입

문법

ChildFrame.visible[= bVisible]

문법 설정

bVisible ::= 'true' | 'false'

this.ChildFrame00.visible = true; 
this.ChildFrame00.visible = false;

참고

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

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

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

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

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

width

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

지원 환경

속성 타입

문법

ChildFrame.width[= nWidth]

문법 설정

nWidth ::= <nVal> ['px' | '%']

참고

- 너비값에 단위를 생략할 경우 pixel 값으로 적용됩니다.

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

메서드

addEventHandler

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

지원 환경

문법

ChildFrame.addEventHandler( strEventID, objFunc, objTarget )

파라미터

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

반환

addEventHandlerLookup

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

지원 환경

문법

ChildFrame.addEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

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

반환

참고

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

alert

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

지원 환경

문법

ChildFrame.alert( strText )

파라미터

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

참고

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

clearEventHandler

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

지원 환경

문법

ChildFrame.clearEventHandler( strEventID )

파라미터

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

반환

참고

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

confirm

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

지원 환경

문법

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

파라미터

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

반환

참고

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

destroy

스크립트에서 동적으로 생성한 ChildFrame 을(를) 삭제하는 메소드입니다.

지원 환경

문법

ChildFrame.destroy()

파라미터

var bSucc = this.ChildFrame00.destroy();

반환

참고

- 동적으로 생성한 ChildFrame 을(를) 완전히 삭제하기 위해서는 destroy() 메소드를 호출해야 합니다.

findEventHandler

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

지원 환경