Overview  Package   Class  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES
SUMMARY:  INNER | FIELD | CONSTR | METHOD DETAIL:  FIELD | CONSTR | METHOD

org.kwis.msp.lwc
Class Component

java.lang.Object
  |
  +--org.kwis.msp.lwc.Component
Direct Known Subclasses:
ButtonComponent, ComboComponent, CommandBarComponent, ContainerComponent, DateFieldComponent, ImageComponent, LabelComponent, ProgressComponent, ScrollbarComponent, TextComponent, TickerComponent
public abstract class Component
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 함수로 재 초기화를 시키면 컴포넌트의 내용이 엉뚱한 곳에 출력되거나 화면에 나중에 나타나는등의 문제가 생길 수 있습니다.

정렬 조합 규칙

Component에서 제공하고 있는 정렬형태는 LAYOUT_LEFT와 LAYOUT_RIGHT,LAYOUT_HCENTER,LAYOUT_TOP, LAYOUT_BOTTOM,LAYOUT_VCENTER입니다. 아래의 경우 IllegalArgumentException이 발생합니다.

Since:
qtp 1.0

Field Summary
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축 픽셀 위치.
 
Constructor Summary
protected Component()
           
 
Method Summary
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()
          컴포넌트가 유효한 좌표와 크기를 가지는지 여부를 돌려줍니다.