Class Component

package org.kwis.msp.lwc

java.lang.Object
  |
  +--org.kwis.msp.lwc.Component

설명

Direct Known Subclasses:

ButtonComponent, ComboComponent, CommandBarComponent, ContainerComponent, DateFieldComponent, ImageComponent, LabelComponent, ProgressComponent, ScrollbarComponent, TextComponent, TickerComponent

extends Object:

가장 기본이 되는 화면에 보여지는 클래스입니다.

위치과 크기를 가지며, 사용자의 입력을 받아서 적절한 행동을 하는 클래스입니다.

화면에 보여지는 모든 UI 컴포넌트는 이 클래스를 상속 받아서 구현되어야 합니다.

Component 클래스를 상속 받은 자식 클래스들의 상위 부모 컴포넌트 상에서의 위치와 폭과 넓이를 가지며, 배경색과 컴포넌트의 특성(입력 가능인지, 입력 포커스등)을 가집니다.

Component클래스는 항상 상위 부모가 있어야 하며, 상위 부모가 없어도 되는 Component 는 ShellComponent가 됩니다. 즉, 화면에 적어도 하나 이상의 ShellComponent 가 있어야지만, Component가 화면에 보이게 됩니다. 컴포넌트는 addComponent한 후에 다른 부모 컴포넌트에 더이상 addComponent할수 없습니다.

모든 컴포넌트는 자신의 폭과 넓이를 프로그램에 의해서 결정할수 있지만, 때에 따라서는 상위 컴포넌트에 의해서 그 크기가 결정이 됩니다. 예를 들면, FormComponent위에 있는 LabelComponent와 같은 컴포넌트는 내부의 문자열의 길이에 따라서, Component의 크기가 달라집니다.

수행 도중에 사용자가 컴포넌트의 내용을 변경함으로써, 컴포넌트의 크기가 다시 계산될 필요가 있다면, invalidate함수를 호출합니다. 그러면, Component가 화면에 보여질 때나, paintContent함수가 호출될 때에 validate()함수를 호출하며, 이 함수에 의해 하위 컴포넌트까지 다시 모두 적당한 크기가 계산이 됩니다.

컴포넌트는 자신의 적절한 크기를 계산하여 돌려주는 기능을 가집니다. 컴포넌트의 내용에 따라서 적당한 크기를 돌려주며, 이 함수는 상위의 ContainerComponent의 layout함수에서 하위 컴포넌트의 크기를 결정하기 위해서 사용됩니다. 포맷팅을 할 수 있는 컴포넌트(Label, TextField, TextArea)를 위해서 특정 폭을 주었을때 적당한 높이을 얻어오는 함수도 있습니다.

컴포넌트의 크기 결정은 자신이 하는 것이 아니라 상위 컴포넌트가 결정합니다. 그 상위 컴포넌트의 전체 크기는 상위 컴포넌트의 상위 컴포넌트가 합니다. 모든 UI컴포넌트는 맨 마지막 상위 컴포넌트는 항상 ShellComponent가 되어야 합니다.

컴포넌트는 이벤트에 대해서 처리할 책임을 가집니다. 만일 컴포넌트의 CanHandleInput함수가 true를 돌려주면, 그 컴포넌트는 ContainerComponent의 setFocus함수에 의해서 입력 포커스를 가질 수 있으며, 입력 포커스를 가지는 경우에 keyNotify함수가 불릴 수 있습니다. 이외에도 showNotify함수와 focusNotify함수, pointerNotify함수가 불리며, 특히나 화면에 어떤 내용을 칠해야 하는 경우에는 paintContent함수가 불립니다.

keyNotify함수나 pointerNotify함수는 자기 자신이 이벤트를 처리했으면, true를 돌려줍니다. 그러면, 상위 컴포넌트에 키 이벤트가 전달되지 않습니다. 만일 false를 돌려주면, 상위 컴포넌트에 키 이벤트가 전달됩니다.

모든 이벤트에 대해서는 setEventListener함수를 통하여 지정된 이벤트 리스너에게 모든 발생한 이벤트를 알려줍니다. 이 이벤트 리스너가 true로 돌려주는 경우에는 더 이상 이벤트가 처리되지 않고 false로 돌려주는 경우에는 이벤트는 정상적으로 처리 됩니다.

paintContent함수를 구현할 때에는 Graphics내용이 컴포넌트의 위치와 크기에 맞도록 원점과 클리핑 영역이 변경되어서 되어서 넘어 옵니다. 만일 이 클리핑의 내용을 setClip함수로 변경하거나, reset 함수로 재 초기화를 시키면 컴포넌트의 내용이 엉뚱한 곳에 출력되거나 화면에 나중에 나타나는등의 문제가 생길 수 있습니다.

에서 제공하고 있는 정렬형태는

와

입니다. 아래의 경우

이 발생합니다.

LAYOUT_LEFT|LAYOUT_RIGHT

LAYOUT_LEFT|LAYOUT_HCENTER LAYOTU_RIGHT|LAYOUT_HCENTER

- `LAYOUT_TOP`|`LAYOUT_BOTTOM`
- `LAYOUT_TOP`|`LAYOUT_VCENTER`
- `LAYOUT_BOTTOM`|`LAYOUT_VCENTER`

**Since:**
- qtp 1.0

## 필드 요약

- `protected  int bg` — 배경색.
- `protected EventListener evtListener`
- `protected Object evtListenerObj`
- `protected  int fg` — 전경색 기본값은 각 컴포넌트에 따라 다르게 지정됩니다.
- `static int FOCUS_NOTIFY` — 포커스가 왔음을 알리는 상수. 1로 지정되어 있습니다.
- `protected  int h` — 컴포넌트의 높이의 픽셀 크기.
- `protected static int HAS_FOCUS_MASK`
- `protected static int INPUT_MASK`
- `static int KEY_NOTIFY` — 키 관련 이벤트가 생성됨을 알리는 상수. 3로 지정되어 있습니다.
- `static int KEY_PRESSED` — 키가 눌렸을 때 이벤트 타입.
- `static int KEY_RELEASED` — 키가 떼어졌을 때 이벤트 타입.
- `static int KEY_REPEATED` — 키가 반복해서 눌렸을 때 이벤트 타입.
- `static int KEY_TYPED` — 키가 눌렸을때 이벤트 타입.
- `static int LAYOUT_BOTTOM` — Component 의 아래쪽 정렬값.
- `static int LAYOUT_HCENTER` — Component 의 가운데 수평 정렬 값.
- `static int LAYOUT_LEFT` — Component 의 좌측 정렬 값.
- `static int LAYOUT_RIGHT` — Component 의 우측 정렬 값.
- `static int LAYOUT_TOP` — Component 의 위쪽 정렬값.
- `static int LAYOUT_VCENTER` — Component 의 가운데 수직 정렬 값.
- `protected  int mask`
- `protected ContainerComponent parent` — 상위 부모 컴포넌트.
- `static int POINT_DRAGGED` — 포인터 기기가 눌린 상태에서 움직였을때 이벤트 타입.
- `static int POINT_PRESSED` — 포인터 기기가 눌렸을 때 이벤트 타입.
- `static int POINT_RELEASED` — 포인터 기기가 떼어졌을 때 이벤트 타입.
- `static int POINTER_NOTIFY` — 포인터 관련 이벤트가 생성됨을 알리는 상수. 4로 지정되어 있습니다.
- `static int POS_MASK` — 위치 이동이 됨을 알리는 상수.
- `protected static int PREFER_SIZE_MASK`
- `protected  int prefH`
- `protected  int prefW`
- `static int SHOW_NOTIFY` — 보여지거나 가려짐을 알리는 상수. 2로 지정되어 있습니다.
- `static int SIZE_MASK` — 크기 변경이 됨을 알리는 상수.
- `protected static int VALID_MASK`
- `protected  int w` — 컴포넌트의 폭의 픽셀 크기.
- `protected  int x` — 상위 부모 Component로 부터의 x축 픽셀 위치.
- `protected  int y` — 상위 부모 Component로 부터의 y축 픽셀 위치.

## 생성자 요약

- `protected Component ()`

## 메서드 요약

- `protected  void calcPreferredSize (int w)` — 컴포넌트의 적절한 크기를 계산합니다.
- `boolean canHandleInput ()` — 컴포넌트가 입력을 받을 수 있는 여부를 돌려줍니다.
- `void configure (int x, int y, int w, int h, int mask)` — 컴포넌트의 위치나 크기를 변경합니다.
- `void focusNotify (boolean b)` — 포커스를 받으면 호출됩니다.
- `int getBackground ()` — 배경색을 돌려 줍니다.
- `Card getCard ()` — 현재 컴포넌트에 연결된 카드를 돌려줍니다.
- `int getForeground ()` — 전경생을 돌려줍니다.
- `int getHeight ()` — 컴포넌트의 높이를 돌려 줍니다.
- `int getPreferredHeight ()` — 컴포넌트의 적절한 높이를 결정합니다.
- `int getPreferredHeight (int w)` — 컴포넌트의 적절한 높이를 결정합니다.
- `int getPreferredWidth ()` — 컴포넌트의 적절한 폭을 결정합니다.
- `int getWidth ()` — 컴포넌트의 폭을 돌려 줍니다.
- `int getX ()` — x축의 좌표를 돌려줍니다.
- `int getXOnScreen ()` — 화면상에 대응되는 실제 좌표를 구합니다.
- `int getY ()` — y축의 좌표를 돌려줍니다.
- `int getYOnScreen ()` — 화면상에 대응되는 실제 좌표를 구합니다.
- `boolean hasFocus ()` — 컴포넌트가 입력 포커스를 가지고 있는지의 여부를 돌려줍니다.
- `void invalidate ()` — 컴포넌트가 유효한 좌표와 크기를 가지 않음을 알려줍니다.
- `boolean isShown ()` — 현재 컴포넌트가 보이는지 안보이는지 여부를 돌려줍니다.
- `protected  boolean isValid ()` — 컴포넌트가 유효한 좌표와 크기를 가지는지 여부를 돌려줍니다.