개요

MainFrame 하위에 오는 Frame 으로써 애플리케이션의 화면 배열을 위한 기본단위 화면으로 사용됩니다. 

HFrameSet 을 하위에 FrameSet, HFrameSet, VFrameSet, TileFrameSet, ChildFrame 을 반복적으로 가질 수 있습니다.
또한 수평 방향으로 자동으로 하위 Frame 을 배열할 수 있는 기능이 있습니다.

지원 환경

컴포넌트 구조

생성자

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

var obFrame = new HFrameSet();

obFrame.init( "HFrameSet00", 30, 120, 196, 46, null, null);
obFrame.init( "HFrameSet00", null, null, 300, "400px", "80%", 300);

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

Status

Control

속성

all

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

지원 환경

속성 타입

문법

HFrameSet.all

문법 설정

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

참고

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

background

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

지원 환경

속성 타입

문법

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

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

지원 환경

속성 타입

문법

HFrameSet.borderRadius[= strborderradius]

문법 설정

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

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

* Script ( normal property )
this.HFrameSet00.borderRadius = "10px";
this.HFrameSet00.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

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

지원 환경

속성 타입

문법

HFrameSet.bottom[= nBottom]

문법 설정

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

참고

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

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

color

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

지원 환경

속성 타입

문법

HFrameSet.color[= strcolor]

문법 설정

strcolor ::= <NamedColor> | <NumericColor>

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

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

참고

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


◆ web runtime environment 제약

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

cssclass

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

지원 환경

속성 타입

문법

HFrameSet.cssclass[= strcssclass]

문법 설정

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

var objApp = nexacro.getApplication();

objApp.mainframe.HFramSet00.cssclass = "TestClass";
objApp.mainframe.HFramSet00.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

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

지원 환경

속성 타입

문법

HFrameSet.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.HFrameSet00.cursor = "default";

참고

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

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

enable

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

지원 환경

속성 타입

문법

HFrameSet.enable[= benable]

문법 설정

benable ::= 'true' | 'false'

this.HFrameSet00.enable = true; 
this.HFrameSet00.enable = false;

참고

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

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

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

enableevent

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

지원 환경

속성 타입

문법

HFrameSet.enableevent[= bEvent]

문법 설정

bEvent ::= 'true' | 'false'

this.HFrameSet00.enableevent = true;  

this.HFrameSet00.enableevent = false;

참고

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

font

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

지원 환경

속성 타입

문법

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

frames

HFrameSet 에 등록된 자식 Frame 들을 Collection 형태로 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

HFrameSet.frames

문법 설정

var objApp = nexacro.getApplication();
var objFrame = objApp.mainframe.frame.frames[1];

참고

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

height

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

지원 환경

속성 타입

문법

HFrameSet.height[= nHeight]

문법 설정

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

참고

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

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

hotkey

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

지원 환경

속성 타입

문법

HFrameSet.hotkey[= strHotkey]

문법 설정

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

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

지원 환경

속성 타입

문법

HFrameSet.id

문법 설정

참고

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

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

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

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

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

left

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

지원 환경

속성 타입

문법

HFrameSet.left [=nLeft]

문법 설정

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

참고

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

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

name

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

지원 환경

속성 타입

문법

HFrameSet.name[= strName]

문법 설정

참고

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

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

-nexa-border

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

지원 환경

속성 타입

문법

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

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

지원 환경

속성 타입

문법

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

참고

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

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

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

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

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

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


◆ WRE 제약

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

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

-nexa-rtl-background-image

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

지원 환경

속성 타입

문법

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

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

지원 환경

속성 타입

문법

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

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

지원 환경

속성 타입

문법

HFrameSet.opacity[= stropacity]

문법 설정

* XCSS
opacity : 0.8;
opacity : 80%;

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

참고

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

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

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

progressbardirection

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

지원 환경

속성 타입

문법

HFrameSet.progressbardirection[= enumDirection]

문법 설정

enumDirection ::= 'forward' | 'backward'

참고

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

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

progressbargap

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

지원 환경

속성 타입

문법

HFrameSet.progressbargap[= nSize]

문법 설정

progressbarsize

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

지원 환경

속성 타입

문법

HFrameSet.progressbarsize[= nSize]

문법 설정

progressbarsmooth

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

지원 환경

속성 타입

문법

HFrameSet.progressbarsmooth[= bSmooth]

문법 설정

bSmooth ::= 'true' | 'false'

right

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

지원 환경

속성 타입

문법

HFrameSet.right [=nRight]

문법 설정

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

참고

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

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

separatesize

HFrameSet 에서 자식 Frame 들이 표시되는 너비를 자식 Frame 별로 설정하는 속성입니다.

지원 환경

속성 타입

문법

HFrameSet.separatesize[= strSize]

문법 설정

var objApp = nexacro.getApplication();

objApp.mainframe.HFramSet00.separatesize = "200,*,400,2*";

참고

- separatesize 속성값에 비율을 설정하였을 경우 비율의 기준값은 전체 HFrameSet 너비에서 고정 너비값을 빼고 계산합니다.

  ex) HFrame 너비가 "1000" 이고, separatesize 속성값이 "200,*,400,4*" 일 때
       비율로 처리될 너비는 전체 너비 "1000" 에서 고정너비인 "600"(200+400)을 뺀 "400" 이 되고,
       비율의 기준값은 "400" 에서 비율값인 "5*"(* + 4*)을 나눈 "80"이 기준값이 됩니다.

       따라서 첫번째 자식 Frame 의 너비는 고정값인 "200"
       두번째 자식 Frame 의 너비는 기준값 "80"에 대한 1배 비율인 "80"
       세번째 자식 Frame 의 너비는 고정값인 "400"
       마지막 자식 Frame 의 너비는 기준값 "80"에 대한 4배 비율인 "320" 이 됩니다.

활용 예제

• FrameSet 생성하기

showcascadestatustext

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

지원 환경

속성 타입

문법

HFrameSet.showcascadestatustext[= bShow]

문법 설정

bShow ::= 'true' | 'false'

참고

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

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

showcascadetitletext

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

지원 환경

속성 타입

문법

HFrameSet.showcascadetitletext[= bShow]

문법 설정

bShow ::= 'true' | 'false'

참고

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

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

showstatusbar

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

지원 환경

속성 타입

문법

HFrameSet.showstatusbar[= bshowstatus]

문법 설정

bshowstatus ::= 'true' | 'false'

this.HFrameSet00.showstatusbar = true;

참고

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

showtitlebar

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

지원 환경

속성 타입

문법

HFrameSet.showtitlebar[= bshowtitlebar]

문법 설정

bshowtitlebar ::= 'true' | 'false'

참고

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

showtitleicon

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

지원 환경

속성 타입

문법

HFrameSet.showtitleicon[= bshowtitleicon]

문법 설정

bshowtitleicon ::= 'true' | 'false'

참고

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

statusbar

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

지원 환경

속성 타입

문법

HFrameSet.statusbar

문법 설정

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

참고

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

statusbarheight

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

지원 환경

속성 타입

문법

HFrameSet.statusbarheight[= nHeight]

문법 설정

참고

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

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

statustext

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

지원 환경

속성 타입

문법

HFrameSet.statustext[= strStatustext]

문법 설정

참고

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

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

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

titlebar

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

지원 환경

속성 타입

문법

HFrameSet.titlebar

문법 설정

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

참고

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

활용 예제

• 타이틀바 영역 변경하기

titlebarbuttongap

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

지원 환경

속성 타입

문법

HFrameSet.titlebarbuttongap[= nGap]

문법 설정

참고

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

titlebarbuttonsize

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

지원 환경

속성 타입

문법

HFrameSet.titlebarbuttonsize[= strSize]

문법 설정

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

참고

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

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

titlebarheight

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

지원 환경

속성 타입

문법

HFrameSet.titlebarheight[= nHeight]

문법 설정

참고

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

titletext

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

지원 환경

속성 타입

문법

HFrameSet.titletext[= strTitletext]

문법 설정

참고

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

top

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

지원 환경

속성 타입

문법

HFrameSet.top[= nTop]

문법 설정

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

참고

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

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

visible

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

지원 환경

속성 타입

문법

HFrameSet.visible[= bVisible]

문법 설정

bVisible ::= 'true' | 'false'

this.HFrameSet00.visible = true; 
this.HFrameSet00.visible = false;

참고

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

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

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

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

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

width

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

지원 환경

속성 타입

문법

HFrameSet.width[= nWidth]

문법 설정

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

참고

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

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

메서드

addChild

스크립트로 동적 생성한 Frame 을 HFrameSet 의 자식 Frame 으로 추가하는 메소드입니다.

지원 환경

문법

HFrameSet.addChild( strChildID, objFrame )

파라미터

var objApp = nexacro.getApplication() ;
var objFrame = new FrameSet();

objFrame.init( "FrameSet00", 30, 120, 196, 46 );
objApp.mainframe.frame.addChild( "FrameSet00", objFrame ) ;

반환

참고

- addChild() 메소드는 Frame 과 컨테이너 컴포넌트에서만 제공합니다.

- 스크립트에서 동적으로 생성한 Frame 만 추가할 수 있습니다.
  동적으로 생성한 Frame 이 아닌 경우 오동작이 발생할 수 있습니다.

- 자식 Frame 의 세부 속성은 addChild() 메소드로 자식 Frame 을 추가 후 설정해야 합니다.

- 자식 Frame 으로 추가된 Frame 을 화면에 표시하기 위해서는 show() 메소드를 사용해야 합니다.

- 동적으로 추가된 Frame 을 제거하기 위해서는 removeChild() 메소드를 사용해야 합니다.

- removeChild() 메소드로 제거된 Frame 을 완전히 삭제하기 위해서는 destroy() 메소드를 사용해야 합니다.

addEventHandler

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

지원 환경

문법

HFrameSet.addEventHandler( strEventID, objFunc, objTarget )

파라미터

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

반환

addEventHandlerLookup

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

지원 환경

문법

HFrameSet.addEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

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

반환

참고

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

alert

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

지원 환경

문법

HFrameSet.alert( strText )

파라미터

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

참고

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

clearEventHandler

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

지원 환경

문법

HFrameSet.clearEventHandler( strEventID )

파라미터

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

반환

참고

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

confirm

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

지원 환경

문법

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

파라미터

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

반환

참고

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

destroy

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

지원 환경

문법

HFrameSet.destroy()

파라미터

var bSucc = this.HFrameSet00.destroy();

반환

참고

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

findEventHandler

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

지원 환경

문법

HFrameSet.findEventHandler( strEventID, objFunc, objTarget )

파라미터

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

var nIndex = this.HFrameSet00.findEventHandler( "onmove", this.HFrameSet00_onmove, this );

반환

참고

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

getActiveFrame

HFrameSet 의 자식 Frame 중 활성화 상태인 Frame 오브젝트를 반환하는 메소드입니다.

지원 환경

문법

HFrameSet.getActiveFrame() ;

파라미터

var objApp = nexacro.getApplication() ;
var objActiveFrame = objApp.mainframe.frame.getActiveFrame() ;

반환

참고

- 가장 최근에 활성화되어 최상위에 위치한 Frame 오브젝트를 반환합니다.

getEventHandler

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

지원 환경

문법

HFrameSet.getEventHandler( strEventID, nIdx )

파라미터

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

반환

getNativeHandle

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

지원 환경

문법

HFrameSet.getNativeHandle();

파라미터

var nHwnd = this.parent.getNativeHandle();

반환

getOffsetBottom

부모 Frame 의 Top 위치를 기준으로 HFrameSet 의 bottom 값을 픽셀단위의 숫자로 반환하는 메소드입니다.

지원 환경

문법

HFrameSet.getOffsetBottom();

파라미터

var objApp = nexacro.getApplication();

var nBottom = objApp.mainframe.frame.getOffsetBottom();

반환

참고

- 화면에 표시된 HFrameSet 의 bottom 값을 부모 Frame 의 Top 위치를 기준으로 동적으로 계산합니다.

getOffsetHeight

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

지원 환경

문법

HFrameSet.getOffsetHeight();

파라미터

var objApp = nexacro.getApplication() ;

var nHeight = objApp.mainframe.frame.getOffsetHeight( ) ;

반환

참고

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

활용 예제

• 마지막 좌표값 처리하기

• PopupDiv 배치하기

getOffsetLeft

부모 Frame 의 Left 위치를 기준으로 HFrameSet 의 left 값을 픽셀단위의 숫자로 반환하는 메소드입니다.

지원 환경

문법

HFrameSet.getOffsetLeft();

파라미터

var objApp = nexacro.getApplication();

var nLeft = objApp.mainframe.frame.getOffsetLeft();

반환

참고

- 화면에 표시된 부모 Frame 의 Left 위치를 기준으로 HFrameSet 의 left 값을 동적으로 계산합니다.

getOffsetRight

부모 Frame 의 Left 위치를 기준으로 HFrameSet 의 right 값을 픽셀단위의 숫자로 반환하는 메소드입니다.

지원 환경

문법

HFrameSet.getOffsetLeft();

파라미터

var objApp = nexacro.getApplication();

var nRight = objApp.mainframe.frame.getOffsetRight();

반환

참고

- 화면에 표시된 부모 Frame 의 Left 위치를 기준으로 HFrameSet 의 right 값을 동적으로 계산합니다.

getOffsetTop

부모 Frame 의 Top 위치를 기준으로 HFrameSet 의 top 값을 픽셀단위의 숫자로 반환하는 메소드입니다.

지원 환경

문법

HFrameSet.getOffsetTop();

파라미터

var objApp = nexacro.getApplication();

var nTop = objApp.mainframe.frame.getOffsetTop();

반환

참고

- 화면에 표시된 HFrameSet 의 top 값을 부모 Frame 의 Top 위치를 기준으로 동적으로 계산합니다.

getOffsetWidth

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

지원 환경

문법

HFrameSet.getOffsetWidth();

파라미터

var objApp = nexacro.getApplication() ;

var nWidth = objApp.mainframe.frame.getOffsetWidth( ) ;

반환

참고

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

활용 예제

• 마지막 좌표값 처리하기

• PopupDiv 배치하기

getOwnerFrame

HFrameSet 이 소속된 부모 Frame 을 반환하는 메소드입니다.

지원 환경

문법

HFrameSet.getOwnerFrame()

파라미터

var objFrame = this.getOwnerFrame().getOwnerFrame() ;

반환

init

스크립트로 HFrameSet 을 동적 생성한 후에 초기화하는 메소드입니다.

지원 환경

문법

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

파라미터

var obFrame = new HFrameSet();

obFrame.init( "HFrameSet00", 30, 120, 196, 46, null, null);
obFrame.init( "HFrameSet00", null, null, 300, "400px", "80%", 300);

참고