5.1.11. 사용자 인터페이스 컴포넌트

사용자 인터페이스 컴포넌트로 텍스트 박스, 날짜/시간 컴포넌트, 메뉴 컴포넌트, 라벨 컴포넌트, 리스트 컴포넌트가 있다.

컴포넌트 생성/소멸

컴포넌트를 생성하기 위해서는 컴포넌트 클래스 구조체가 있어야 한다. 컴포넌트 클래스 구조체는 미리 정의되어 값들이 결정된 구조체로 MC_uicGetClass 함수를 통하여 정의된 구조체를 가져올 수 있다. 컴포넌트 클래스 구조체는 각 컴포넌트 별 로 다르며, 이 컴포넌트 클래스 구조체를 매개 변수로 하여 MC_uicCreate 함수를 호출하면, 컴포넌트 클래스 구조체를 생성할 수 있다. 생성된 컴포넌트는 MC_uicDestroy 로 파괴 된다.

좌표체계

컴포넌트의 위치와 크기는 화면 좌표 체계를 따른다. 왼쪽 상단이 원점(0, 0)이며, 오른쪽, 아래쪽으로 이동하면서 좌표값이 픽셀 단위로 증가한다.

이벤트 처리

“C”에서 제공하는 사용자 인터페이스 컴포넌트는 컨테이너를 제공하고 있지 않기 때문에 컨테이너가 하는 역할을 각 응용 프로그램에서 해주어야 한다. 즉 응용 프 로그램에서 컴포넌트 마다 각 이벤트를 처리하는 함수를 불러주어야 한다.

Clet 의 handleCletEvent 함수 내에서 생성된 각 컴포넌트를 매개 변수로 하여 MC_uicHandleEvent 함수를 호출해 주어야 한다. MC_uicHandleEvent 는 이벤트를 적절 히 처리하고, 이벤트 처리 여부를 돌려준다.

Clet 의 paintClet 함수 내에서는 컴포넌트마다 각 MC_uicPaint 함수를 호출해 주 어야 한다.

콜백 함수와 이벤트 핸들러 함수

MC_uicHandleEvent 에 의해서 이벤트가 처리될때 사용자가 MC_uicSetEventHandler 함수에 의해서 지정한 이벤트 핸들러 함수를 먼저 호출해 준다. 이 호출된 함수가 돌려주는 값에 따라서, MC_uicHandleEvent 함수는 계속 이벤트를 처리할지 안할지 여부를 결정한다. 만일 이벤트를 처리하게 되면, MC_uicHandleEvent 는 이벤트를 처리한 후에 해당되는 이벤트의 MC_uicCallbackProc 를 호출하도록 한다. 어떤 이벤트에 대해서 콜백 함수를 사용할 수 있는지에 대해서는 컴포넌트 마다 다르므로 컴포넌트에 대한 문서를 참조하십시요.

텍스트 박스 컴포넌트

텍스트 박스 컴포넌트는 MC_UicComponent 를 상속 받으며, 사용자에게 문자열을 보여주고, 해당 문자열을 변경할 수 있도록 해주는 컴포넌트이다. 텍스트 박스내 에 넣을수 있는 문자열은 MC_uicGetTextSize 로 알수가 있다. 기본적으로 저장할 수 있는 최대 값은 256 바이트이며, MC_uicSetTextSize 함수로 변경이 가능한다. 사용 가능한 함수는 다음과 같다.

MC_uicInsertText MC_uicDeleteText MC_uicGetMaxTextSize MC_uicSetMaxTextSize MC_uicGetTextSize MC_uicGetText

그외 컴포넌트에서 사용할 수 있는 함수

사용 가능한 콜백 함수는 다음과 같다.

• MC_UIC_CHANGE_CALLBACK : 내부 문자열이 변경되었을 경우
• MC_UIC_KEY_CALLBACK : 키가 눌러졌을 경우

그외 컴포넌트에서 사용할 수 콜백 함수

날짜/시간 컴포넌트

날짜/시간 컴포넌트는 MC_UicComponent 를 상속받으며, 사용자에게 날짜/시간을 보여주고, 그 날짜/시간을 입력받는 함수이다. MC_uicSetTime 함수에 의해서 날짜/시간을 지정할 수 있으며, 지정하지 않는다면 날짜/시간 컴포넌트를 생성한 시간 으로 지정된다. 날짜/시간 컴포넌트는 날짜나 시간,혹은 두 항목다 화면에 출력할 수 있으며, 이는 MC_uicSetTimeMask 함수로 가능한다.

사용 가능한 함수는 다음과 같다.

MC_uicSetTimeMask MC_uicSetTime MC_uicGetTime MC_uicSetTimeLong

그외 컴포넌트에서 사용할 수 있는 함수

사용 가능한 콜백 함수는 다음과 같다.

• MC_UIC_CHANGE_CALLBACK : 내부 시간이 변경되었을 경우

그외 컴포넌트에서 사용할 수 콜백 함수

메뉴 컴포넌트

메뉴 컴포넌트는 MC_UicComponent 를 상속받으며, 화면에 메뉴를 출력하고, 사용자로 부터 입력을 받다. 메뉴 상하/좌우키로 현재 선택 메뉴 항목을 변경하여 지 정하도록 한다.

사용 가능한 함수는 다음과 같다.

• MC_uicAddMenuItem
• MC_uicGetMenuItem
• MC_uicRemoveMenuItem
• MC_uicSetActiveMenuItem
• MC_uicGetActiveMenuItem

그외 컴포넌트에서 사용할 수 있는 함수

사용 가능한 콜백 함수는 다음과 같다.

• MC_UIC_CHANGE_CALLBACK : 내부 선택된 메뉴 항목이 변경되었을 경우

그외 컴포넌트에서 사용할 수 콜백 함수

라벨 컴포넌트

라벨 컴포넌트는 MC_UicComponent 를 상속받으며, 화면에 문자열을 출력해 주는 함수이다. 크기에 맞도록 문자열의 줄바꿈을 해준다. 이 컴포넌트는 다른 컴포넌 트와는 달리 이벤트에 대한 처리를 하지 않는다.

사용 가능한 함수는 다음과 같다.

MC_uicSetLabel

리스트 컴포넌트

리스트 컴포넌트는 MC_UicComponent 를 상속받으며, 화면에 리스트를 출력하고, 사용자로 부터 입력을 받다. 메뉴 상하키로 메뉴 항목을 변경하여 지정하도록 한 다.

사용 가능한 함수는 다음과 같다.

• MC_uicAddListItem
• MC_uicGetListItem
• MC_uicRemoveListItem
• MC_uicSetActiveListItem
• MC_uicGetActiveListItem

그외 컴포넌트에서 사용할 수 있는 함수

사용 가능한 콜백 함수는 다음과 같다.

• MC_UIC_CHANGE_CALLBACK : 내부 선택된 메뉴 항목이 변경되었을 경우

그외 컴포넌트에서 사용할 수 콜백 함수

컴포넌트

컴포넌트 가장 기본이되는 컴포넌트이며, 이벤트에 대한 처리도 하지 않는다. 사용 가능한 함수는 다음과 같다.

MC_uicDestory MC_uicRepaint MC_uicPaint MC_uicGetClassName MC_uicIsInstance MC_uicHandleEvent MC_uicConfigure MC_uicGetGeometry MC_uicSetEnable MC_uicSetExtData MC_uicGetExtData MC_uicSetCallback MC_uicSetEventHandler MC_uicSetFont MC_uicGetFont

사용 가능한 콜백 함수는 다음과 같다.

• MC_UIC_SELECT_CALLBACK : 사용자가 “SELECT”버튼을 눌러서 무엇인가 선택했을 때
• MC_UIC_PAINT_CALLBACK : 컴포넌트가 그려질때
• MC_UIC_DESTORY_CALLBACK : 컴포넌트가 소멸될때

참고 항목

없음

MC_UicComponent

설명

컴포넌트 식별자

프로토타입

typedef M_Int32 MC_UicComponent

MC_UicClass

설명

컴포넌트 클래스 구조체 식별자

프로토타입

typedef M_Int32 MC_UicClass

MC_UicApplicationContext

설명

응용 프로그램 컨택스트 식별자

프로토타입

typedef M_Int32 MC_UicApplicationContext

MC_UicCallbackProc

설명

콜백 함수 타입

프로토타입

typedef void (*MC_UicCallbackProc)(MC_UicComponent cc, void* serverData, M_Int32 clientData)

매개 변수

• cc - 콜백 함수를 호출하는 컴포넌트
• serverData - 부르는 쪽에서 넘기는 데이타; 호출하는 쪽마다 다른다.
• clientData - 콜백 함수를

부작용

없음

참고 항목

없음

MC_UicEventHandlerProc

설명

이벤트 핸들러 함수 타입.

프로토타입

typedef M_Int32 (*MC_UicEventHandlerProc)(MC_UicComponent cc, M_Int32 type, M_Int32 param1, M_Int32 param2)

매개 변수

• cc - 이벤트 핸들러를 호출하는 컴포넌트
• type - 이벤트 타입.
• param1 - 이벤트 매개 변수 1
• param2 - 이벤트 매개 변수 2

반환 값

• 이벤트 처리 여부 1 이면 처리한 것이고, 0 이면 처리하지 않음을 의미

부작용

없음

참고 항목

없음

MC_UIC_MENU_COMPONENT

설명

메뉴 컴포넌트 클래스의 문자열, “MenuComponent”로 정의 되어 있다.

프로토타입

#define MC_UIC_MENU_COMPONENT "MenuComponent"

MC_UIC_DATE_TIME_COMPONENT

설명

데이트, 타임 컴포넌트 클래스의 문자열, “DateTimeComponent”로 정의 되어 있다.

프로토타입

#define MC_UIC_DATE_TIME_COMPONENT "DateTimeComponent"

MC_UIC_TEXT_COMPONENT

설명

텍스트 컴포넌트 클래스의 문자열, “TextComponent”로 정의한다.

프로토타입

#define MC_UIC_TEXT_COMPONENT "TextComponent"

MC_UIC_LABEL_COMPONENT

설명

라벨 컴포넌트 클래스의 문자열, “LabelComponent”로 정의한다.

프로토타입

#define MC_UIC_LABEL_COMPONENT "LabelComponent"

MC_UIC_LIST_COMPONENT

설명

리스트 컴포넌트 클래스의 문자열, “ListComponent”로 정의한다.

프로토타입

#define MC_UIC_LIST_COMPONENT "ListComponent"

MC_UIC_DESTROY_CALLBACK

설명

컴포넌트가 소멸될 때 불리는 콜백 함수의 인덱스 1

프로토타입

#define MC_UIC_DESTORY_CALLBACK 1

MC_UIC_PAINT_CALLBACK

설명

컴포넌트가 칠해질 때 불리는 콜백 함수의 인덱스, 상수 2 로 정의한다.

프로토타입

#define MC_UIC_PAINT_CALLBACK 2

MC_UIC_SELECT_CALLBACK

설명

컴포넌트의 특정 내용이 선택될 때 불리는 콜백 함수의 인덱스, 상수 3 으로 정의 한다.

프로토타입

#define MC_UIC_SELECT_CALLBACK 3

MC_UIC_CHANGE_CALLBACK

설명

컴포넌트의 내부 내용이 변경될 때 불리는 콜백 함수의 인덱스, 상수 4 로 정의한다.

프로토타입

#define MC_UIC_CHANGE_CALLBACK 4

MC_UIC_KEY_CALLBACK

설명

컴포넌트에 사용자가 키를 눌렀을 때 불리는 콜백 함수의 인덱스, 상수 5 로 정의 한다

프로토타입

#define MC_UIC_KEY_CALLBACK 5

MC_GRP_GRAY_TYPE

설명

흑백 타입. 상수값 (1 << 1).

프로토타입

#define MC_GRP_GRAY_TYPE(1 << 1)

MC_GRP_COLOR_TYPE

설명

컬러 타입. 상수값 (1 << 2).

프로토타입

#define MC_GRP_COLOR_TYPE(1 << 2)

MC_ALIGN_LEFT

설명

라벨컴포넌트의 좌측정렬. 상수값 0.

프로토타입

#define MC_ALIGN_LEFT 0

MC_ALIGN_RIGHT

설명

라벨컴포넌트의 우측정렬. 상수값 1.

프로토타입

#define MC_ALIGN_RIGHT 1

MC_ALIGN_CENTER

설명

라벨컴포넌트의 중앙정렬. 상수값 2.

프로토타입

#define MC_ALIGN_CENTER 2

MC_uicCreateApplicationContext

설명

응용프로그램 컨텍스트를 생성한다.

프로토타입

MC_UicApplicationContext MC_uicCreateApplicationContext()

매개 변수

없음

반환 값

생성된 응용프로그램 컨텍스트

부작용

없음

참고 항목

없음

MC_uicGetClass

설명

컴포넌트 클래스 구조체를 가져온다.

문자열에 대응하는 컴포넌트 클래스 구조체를 가져 온다. 현재 지원하는 컴포넌트 클래스 구조체의 문자열은 MC_UIC_MENU_COMPONENT, MC_UIC_DATE_TIME_COMPONENT, MC_UIC_TEXT_COMPONENT, MC_UIC_LABEL_COMPONENT, MC_UIC_LIST_COMPONENT 가 있다.

프로토타입

MC_UicClass MC_uicGetClass(M_Uint8* psz)

매개 변수

• psz - [in] 컴포넌트 클래스를 나타내는 문자열

반환 값

• 컴포넌트 클래스 구조체
• 매개변수(psz)값이 지원되는 컴포넌트 클래스 구조체의 문자열이 아닌 경우 M_E_ERROR 값을 반환

부작용

없음

참고 항목

없음

MC_uicCreate

설명

컴포넌트를 생성한다.

지정한 컴포넌트 클래스로부터 컴포넌트를 생성한다. MC_uicCreateApplicationContext 함수로 부터 생성한 응용 프로그램 컨택스트(Application Context)와 MC_uicGetClass 함수로 가져온 클래스 구조체를 매개 변수로 넘긴다.

프로토타입

MC_UicComponent MC_uicCreate(MC_UicApplicationContext pac, MC_UicClass cls)

매개 변수

• pac - [in] 응용 프로그램 컨텍스트
• cls - [in] 응용 프로그램 컨텍스트

반환 값

성공

• 새로 생성된 컴포넌트 클래스

실패

• M_E_ERROR - 부적합한 매개변수값 사용 및 기타 에러 발생시
• MC_UIC_E_OUT_OF_MEM - 메모리 부족시

부작용

없음

참고 항목

MC_uicCreateApplicationContext

MC_uicDestroy

설명

지정한 컴포넌트를 소멸시킨다.

삭제한 cc 는 더이상 사용되서는 안된다.

프로토타입

void MC_uicDestroy(MC_UicComponent cc)

매개 변수

• cc - [in] 삭제할 컴포넌트

부작용

없음

참고 항목

없음

MC_uicRepaint

설명

지정한 컴포넌트에 대해서 그리기 이벤트를 생성한다.

지정한 컴포넌트 영역에 대해서 paintClet 함수가 호출될 수 있도록 내부 이벤트 를 생성한다. 만일 w, h 가 -1 이면, 지정된 (x, y)좌표에서 컴포넌트의 오른쪽 하단부분까지가 그리기 이벤트가 발생하는 영역이된다.

프로토타입

void MC_uicRepaint(MC_UicComponent cc, M_Int32 x, M_Int32 y, M_Int32 w, M_Int32 h)

매개 변수

• cc - [in] 컴포넌트
• x - [in] 컴포넌트 내의 영역의 x 축 좌표(컴포넌트 좌표 체계)
• y - [in] 컴포넌트 내의 영역의 y 축 좌표(컴포넌트 좌표 체계)
• w - [in] 컴포넌트 내의 영역의 폭
• h - [in] 컴포넌트 내의 영역의 높이

부작용

없음

참고 항목

MC_grpRepaint, MC_uicPaint

MC_uicPaint

설명

지정한 컴포넌트를 그린다.

실제 화면 프레임 버퍼에 컴포넌트의 내용을 그려준다. 이 함수는 응용 프로그램 의 paintClet 함수에서 각각의 컴포넌트 별로 호출되어야 한다. pgc 가 지정하는 클리핑 영역은 변경하지 않고 pgc 의 일부 내용은 컴포넌트에 따라서 변경 될 수 있다.

프로토타입

void MC_uicPaint(MC_UicComponent cc, MC_GrpContext *pgc)

매개 변수

• cc - [in] 컴포넌트
• pgc - [in] 사용할 그래픽 컨텍스트

부작용

없음

참고 항목

없음

MC_uicGetClassName

설명

컴포넌트의 클래스 이름을 얻어 온다.

cc 가 가리키는 컴포넌트에 대응하는 클래스 이름을 “C”문자열로 돌려받다. 돌려 받은 값은 변경될 수 없다.

프로토타입

M_Uint8* MC_uicGetClassName(MC_UicComponent cc)

매개 변수

• cc - [in] 컴포넌트

반환 값

컴포넌트의 클래스 이름

부적합한 매개변수값의 사용으로 인한 반환되는 에러값으로 NULL 값을 반환한다.

부작용

없음

참고 항목

없음

MC_uicIsInstance

설명

컴포넌트가 지정된 클래스에 상속 받은 클래스인지 여부를 돌려준다.

프로토타입

M_Uint32 MC_uicIsInstance(MC_UicComponent cc, M_Uint8* pcls)

매개 변수

• cc - [in] 컴포넌트
• pcls - [in] 컴포넌트 클래스 이름 문자열

반환 값

컴포넌트가 지정된 클래스의 인스턴스이면 1, 그렇지 않으면 0

부작용

없음

참고 항목

없음

MC_uicHandleEvent

설명

컴포넌트 별로 이벤트를 처리한다.

지정한 컴포넌트에게 이벤트를 처리할 것을 요청한다. 이벤트가 처리되었다면 1 을 돌려주고 그렇지 않으면 0 을 돌려준다.

type 과 param1, param2 는 handleCletEvent 함수에서 넘어오는 이벤트 관련 매개 변수를 그대로 넘긴다.

프로토타입

M_Int32 MC_uicHandleEvent(MC_UicCompeont cc, M_Int32 type, M_Int32 param1, M_Int32 param2)

매개 변수

• cc - [in] 컴포넌트
• type - [in] 이벤트 타입
• param1 - [in] 이벤트 매개 변수 1
• param2 - [in] 이벤트 매개 변수 2

반환 값

컴포넌트 내에서 처리 여부

부작용

없음

참고 항목

없음

MC_uicConfigure

설명

컴포넌트의 크기를 위치와 지정한다.

지정된 컴포넌트를 (x, y)가 가르치는 위치에 두고,폭 w, 높이 h 로 크기를 결정 한다. mask & MC_UIC_POS_MASK가 0 이 아니면 (x, y)에 가르치는 위치로 이동이 되며, mask & MC_UIC_SIZE_MASK 가 0 이 아니면 크기 (w, h)로 지정된다.

w 나 h 가 0 이하인 경우는 이 함수는 작동하지 않는다.

프로토타입

void MC_uicConfigure(MC_UicComponent cc, M_Int32 x, M_Int32 y, M_Int32 w, M_Int32 h, M_Int32 mask)

매개 변수

• cc - [in] 컴포넌트
• x - [in] 컴포넌트의 화면상에서의 x 축 좌표
• y - [in] 컴포넌트의 화면상에서의 y 축 좌표
• w - [in] 컴포넌트의 폭
• h - [in] 컴포넌트의 높이
• mask - [in] 컴포넌트 크기만 변경할 것인지 높이만 변경할 것인지 여부; MC_UIC_SIZE_MASK나 MC_UIC_POS_MASK나 두 값이 OR 된 값

부작용

없음

참고 항목

없음

MC_uicGetGeometry

설명

컴포넌트의 크기와 위치를 가져온다.

지정된 컴포넌트의 위치를 px, py 가 가리키는 변수에 저장하고, pw, ph 에 크기를 저장한다. 만일 파라미터 중 하나가 NULL 이면, 해당하는 값을 복사하지 않는다.

프로토타입

void MC_uicGetGeometry(MC_UicComponent cc, M_Int32* px, M_Int32* py, M_Int32* pw, M_Int32* ph)

매개 변수

• cc - [in] 컴포넌트
• px - [out] 컴포넌트의 화면상의 x 값을 저장할 포인터
• py - [out] 컴포넌트의 화면상의 y 값을 저장할 포인터
• pw - [out] 컴포넌트의 폭을 저장할 포인터
• ph - [out] 컴포넌트의 높이를 저장할 포인터

부작용

없음

참고 항목

없음

MC_uicSetEnable

설명

컴포넌트를 입력가능/불가능하게 만든다.

enable 에 따라서 컴포넌트가 입력을 받거나 받을 수 없도록 한다.

기본적으로 컴포넌트가 생성되면 입력을 받지 않는(Enable 이 FALSE 설정됨) 상태 로 생성 된다. 그러므로 입력을 받게 하려면 이 함수를 이용하여 활성화 시켜야 한다.

프로토타입

void MC_uicSetEnable(MC_UicComponent cc, M_Int32 enable)

매개 변수

• cc - [in] 컴포넌트
• enable - [in] 1 이면 입력가능, 0 이면 입력 불가능

부작용

없음

참고 항목

없음

MC_uicSetCallback

설명

컴포넌트에 콜백 함수를 지정한다.

특정 이벤트가 발생하면, 이벤트를 컴포넌트에서 다 처리하고 난 후에 콜백 함수 를 호출한다.

clientData 는 콜백 함수의 세번째 매개 변수가 된다. 콜백 함수가 불려질 특정 이벤트는 다음과 같다.

MC_UIC_DESTROY_CALLBACK MC_UIC_PAINT_CALLBACK MC_UIC_SELECT_CALLBACK MC_UIC_CHANGE_CALLBACK MC_UIC_KEY_CALLBACK

프로토타입

MC_UicCallbackProc MC_uicSetCallback( MC_UicComponent cc, M_Int32 idx, MC_UicCallbackProc proc, M_Int32 clientData)

매개 변수

• cc - [in] 컴포넌트
• idx - [in] 콜백 함수가 불려질 특정 이벤트 MC_UIC_PAINT_CALLBACK,MC_UIC_SELECT_CALLBACK
• proc - [in] 콜백 함수의 포인터
• clientData - [in] 콜백 함수의 매개 변수

반환 값

이전에 지정되었던 콜백 함수. 만일 이전에 지정된 내용이 없다면, NULL 을 돌려 준다.

부작용

없음

참고 항목

없음

MC_uicSetEventHandler

설명

컴포넌트에 이벤트 핸들러를 지정한다.

이벤트 핸들러가 지정되어 있으면, 컴포넌트의 모든 이벤트에 대해서 이벤트 핸들러를 호출해 준다. 이벤트 핸들러의 결과 값에 따라서 이벤트를 계속 처리할지 안 할지 여부를 결정한다.

프로토타입

MC_UicEventHandlerProc MC_uicSetEventHandler( MC_UicComponent cc, MC_UicEventHandlerProc handler)

매개 변수

• cc - [in] 컴포넌트
• handler - [in] 이벤트 핸들러

반환 값

이전에 지정되었던 이벤트 핸들러. 만일 이전에 지정된 내용이 없다면 NULL 을 돌 려준다.

부작용

없음

참고 항목

없음

MC_uicSetFont

설명

컴포넌트의 폰트를 지정한다.

fontid 가 지정하는 폰트 아이디로 컴포넌트의 폰트를 지정한다.

프로토타입

M_Int32 MC_uicSetFont(MC_UicComponent cc, M_Int32 fontid)

매개 변수

• cc - [in] 컴포넌트
• fontid - [in] MC_grpGetFont 의 반환 값으로 폰트 식별자.

반환 값

이전에 지정되었던 폰트 식별자.

부작용

없음

참고 항목

없음

MC_uicGetFont

설명

컴포넌트의 폰트를 돌려준다.

프로토타입

M_Int32 MC_uicGetFont(MC_UicComponent cc)

매개 변수

• cc - [in] 컴포넌트

반환 값

현재 지정된 폰트 식별자.

부작용

없음

참고 항목

없음

MC_uicSetFgColor

설명

컴포넌트의 Foreground 색상을 설정합니다 를 설정합니다.

프로토타입

void MC_uicSetFgColor(MC_UicComponent cc, M_Int32 nColor);

매개 변수

• cc - [in] 컴포넌트
• nColor - 색상값(0xRRGGBB)

반환 값

없음

부작용

없음

참고 항목

없음

MC_uicSetBgColor

설명

컴포넌트의 Background 색상을 설정합니다 를 설정합니다.

프로토타입

void MC_uicSetBgColor(MC_UicComponent cc, M_Int32 nColor);

매개 변수

• cc - [in] 컴포넌트
• nColor - 색상값(0xRRGGBB)

반환 값

없음

부작용

없음

참고 항목

없음

MC_uicSetLabel

설명

라벨컴포넌트의 문자열을 변경 합니다.

지정된 컴포넌트가 레이블 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는 다.

프로토타입

void MC_uicSetLabel(MC_UicComponent cc, M_Uint8 *psz)

매개 변수

• cc - [in] 컴포넌트
• psz - [in] 변경될 문자열

반환 값

없음

부작용

없음

참고 항목

없음

MC_uicGetLabel

설명

라벨 컴포넌트의 문자열을 얻어옵니다.

지정된 컴포넌트가 라벨 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는다.

프로토타입

M_Uint8* MC_uicGetLabel(MC_UicComponent cc)

매개 변수

• cc - [in] 컴포넌트

반환 값

현재 지정되어있는 문자열.

부작용

없음

참고 항목

없음

MC_uicSetlabelAlignment

설명

라벨콤포넌트의 문자열 정렬방식을 설정합니다.

MC_ALIGN_LEFT, MC_ALIGN_RIGHT, MC_ALIGN_CENTER 중 하나의 값을 사용할 수 있으며 각각 좌측정렬, 우측정렬, 중앙정렬을 의미 합니다.

지정된 컴포넌트가 라벨 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는다.

프로토타입

M_Int32 MC_uicSetlabelAlignment(MC_UicComponent cc, M_Int32 align)

매개 변수

• cc - [in] 컴포넌트
• align - [in] 라벨 컴포넌트의 문자열의 정렬방식 MC_ALIGN_LEFT, MC_ALIGN_RIGHT, MC_ALIGN_CENTER 중 하나를 사용합니다.

반환 값

이전에 지정된 값이 넘어 온다.

부작용

없음

참고 항목

없음

MC_uicSetTimeMask

설명

타임 컴포넌트 형태를 지정한다.

(mask & MC_UIC_TIME_MASK)이 0 이 아니면 시간이 출력되고, (mask & MC_UIC_DATE_MASK)이 0 이 아니면 날짜가 출력된다.

지정된 컴포넌트가 타임 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는다.

프로토타입

M_Int32 MC_uicSetTimeMask(MC_UicComponent cc, M_Int32 mask)

매개 변수

• cc - [in] 컴포넌트
• mask - [in] 타임 컴포넌트의 매스크, MC_UIC_TIME_MASK 나 MC_UIC_DATE_MASK 혹은 둘을 OR 한 값.

반환 값

이전에 지정된 값이 넘어 온다.

부작용

없음

참고 항목

없음

MC_uicSetTime

설명

타임 컴포넌트에 시간을 지정한다.

지정된 컴포넌트가 타임 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는다. 이때 pd 는 표준 C 라이브러리 time.h 에서 정의된 tm 구조체 이다.

프로토타입

void MC_uicSetTime(MC_UicComponent cc, struct tm* pd)

매개 변수

• cc - [in] 컴포넌트
• pd - [in] 지정할 날짜. time.h 참조

부작용

없음

참고 항목

없음

MC_uicSetTimeLong

설명

타임 컴포넌트에 시간을 지정한다.

지정된 컴포넌트가 타임 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는다. 이때 time 은 표준 C 라이브러리의 time.h 에서 정의된 time()함수에서 구해진 time_t 형태의 값이다.

프로토타입

void MC_uicSetTimeLong(MC_UicComponent cc, time_t time)

매개 변수

• cc - [in] 컴포넌트
• time - [in] 지정할 날짜와 시간. time.h 참조

부작용

없음

참고 항목

없음

MC_uicGetTime

설명

타임 컴포넌트에서 시간/날짜를 얻어 온다.

전달하는 포인터에 각각 내용을 채워준다. 만일 포인터가 NULL 을 가리키면 해당 되는 값은 복사되지 않는다.

지정된 컴포넌트가 타임 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는다. 받아오는 날짜는 표준 C 라이브러리의 time.h 에 정의된 tm 구조체의 형태이다.

프로토타입

void MC_uicGetTime(MC_UicComponet cc, struct tm* pd)

매개 변수

• cc - [in] 컴포넌트
• pd - [out] 받아올 날짜.

부작용

없음

참고 항목

없음

MC_uicAddMenuItem

설명

메뉴 컴포넌트에 메뉴 아이템을 하나 추가한다.

지정된 컴포넌트가 메뉴 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는다. 넘기는 이미지는 메뉴 항목이 삭제될때 내부에서 파괴한다.

프로토타입

M_Int32 MC_uicAddMenuItem(MC_Component cc, M_Uint8* psz, MC_GrpImage img)

매개 변수

• cc - [in] 컴포넌트
• psz - [in] 메뉴 아이템을 나타내는 문자열
• img - [in] 메뉴 아이템의 이미지

반환 값

메뉴의 인덱스(0 부터 시작된다.)

부작용

없음

참고 항목

없음

MC_uicGetMenuItem

설명

메뉴 아이템을 가져 온다.

지정된 컴포넌트가 메뉴 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는다.

프로토타입

M_Int32 MC_uicGetMenuItem(MC_Component cc, M_Uint32 idx, M_Uint8* psz, M_Int32 buflen, MC_GrpImage* img)

매개 변수

• cc - [in] 컴포넌트
• idx - [in] 가져올 메뉴 아이템의 인덱스
• psz - [out] 메뉴 아이템을 나타나는 문자열이 복사될 버퍼
• buflen - [in] 버퍼의 크기
• img - [out] 메뉴 아이템의 이미지

반환 값

성공

• 1

실패

• 0 이하면 실패
• M_E_SHOFTBUF: psz 으로 넘기는 버퍼 크기가 작은 경우

부작용

없음

참고 항목

없음

MC_uicRemoveMenuItem

설명

지정된 메뉴 아이템을 삭제한다.

idx 가 가리키는 메뉴 아이템을 삭제한다.

지정된 컴포넌트가 메뉴 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는다.

프로토타입

M_Int32 MC_uicRemoveMenuItem(MC_Component cc, M_Uint32 idx)

매개 변수

• cc - [in] 컴포넌트
• idx - [in] 삭제할 메뉴 아이템의 인덱스

반환 값

성공

• 1

실패

• 0

부작용

없음

참고 항목

없음

MC_uicSetActiveMenuItem

설명

지정된 메뉴 아이템을 활성화시킨다.

지정된 컴포넌트가 메뉴 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는다. 만일 idx 값이 메뉴 항목의 범위를 벗어 나면, 이 함수는 아무런 역할을 하지 않 는다. 만일 선택되지 않은 상태로 두려면 idx 을 -1 로 지정하시면 된다.

프로토타입

M_Int32 MC_uicSetActiveMenuItem(MC_Component cc, M_Int32 idx)

매개 변수

• cc - [in] 컴포넌트
• idx - [in] 메뉴 아이템의 인덱스

반환 값

이전에 활성화되었던 메뉴의 인덱스를 넘겨준다.

부작용

없음

참고 항목

없음

MC_uicGetActiveMenuItem

설명

활성화된 메뉴 아이템을 인덱스를 돌려준다.

지정된 컴포넌트가 메뉴 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는다.

프로토타입

M_Int32 MC_uicGetActiveMenuItem(MC_Component cc)

매개 변수

• cc - [in] 컴포넌트

반환 값

활성화된 메뉴 아이템의 인덱스

-1 : 활성화된 메뉴가 없는 경우

부작용

없음

참고 항목

없음

MC_uicInsertText

설명

텍스트 컴포넌트에 문자열을 추가한다.

cc 가 가리키는 텍스트 컴포넌트의 idx 부분부터 시작하여 psz 의 내용을 len 만큼 삽입한다. idx 가 0 이하 이면 맨 앞이 추가되고, M_CuicGetMaxTextSize()로 넘어 오는 값 이상 이면 맨 뒤에 추가가 된다.

문자열은 내부에서 복사되므로 이 함수가 종료되고 나서 psz 가 가리키는 내용은 변경되어도 된다.

지정된 컴포넌트가 텍스트 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는 다.

프로토타입

M_Int32 MC_uicInsertText(MC_Component cc, M_Int32 idx, M_Uint8* psz, M_Int32 len)

매개 변수

• cc - [in] 컴포넌트
• idx - [in] 문자열을 입력할 위치; 0 부터 맨 마지막 문자열까지 된다.
• psz - [in] 복사될 문자열
• len - [in] 문자열의 길이

반환 값

컴포넌트에 복사된 문자열의 길이

메모리가 부족한 경우 len 보다 작은 값이 나올 수 있다.

부작용

없음

참고 항목

없음

MC_uicDeleteText

설명

텍스트 컴포넌트의 특정 부분의 문자열을 삭제한다.

cc 가 가리키는 텍스트 컴포넌트의 idx 부분부터 시작하여 길이가 len 만큼을 삭제한 다.

만일 len 이 -1 이면 idx 부터 문장 끝부분 까지가 삭제된다.

idx 가 내부 문자열의 범위를 벗어 나거나 len 이 0 보다 작으면 이 함수는 아무런 역할을 하지 않는다.

지정된 컴포넌트가 텍스트 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는다.

프로토타입

void MC_uicDeleteText(MC_Component cc, M_Int32 idx, M_Int32 len)

매개 변수

• cc - [in] 컴포넌트
• idx - [in] 삭제할 문자열의 시작 위치
• len - [in] 문자열의 길이

부작용

없음

참고 항목

없음

MC_uicGetMaxTextSize

설명

텍스트 컴포넌트의 최대 문자열 크기를 얻어온다. 바이트 단위의 최대 문자열 크기를 돌려준다.

지정된 컴포넌트가 텍스트 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는다.

프로토타입

M_Int32 MC_uicGetMaxTextSize(MC_Component cc)

매개 변수

• cc - [in] 컴포넌트

반환 값

최대 문자열 크기

부작용

없음

참고 항목

없음

MC_uicSetMaxTextSize

설명

텍스트 컴포넌트의 최대 문자열 크기를 지정한다. 바이트 단위의 최대 문자열 크기를 지정한다.

지정된 컴포넌트가 텍스트 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는다. 기본 크기는 256 바이트 이다.

만일 이함수를 부를때 내부 문자열이 새로 정의된 max 보다 작다면, 내부 버퍼의 내용은 max 크기로 짤려진다.

프로토타입

M_Int32 MC_uicSetMaxTextSize(MC_Component cc, M_Int32 max)

매개 변수

• cc - [in] 컴포넌트
• max - [in] 최대 문자열 크기(바이트 단위)

반환 값

이전의 최대 문자열 크기; 메모리가 부족할때 M_E_NOMEMORY 가 돌려짐

부작용

없음

참고 항목

없음

MC_uicGetTextSize

설명

텍스트 컴포넌트의 내부의 문자열 길이를 얻어 온다.

지정된 컴포넌트가 텍스트 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는 다.

프로토타입

M_Int32 MC_uicGetTextSize(MC_Component cc)

매개 변수

• cc - [in] 컴포넌트

반환 값

현재 문자열 길이

부작용

없음

참고 항목

없음

MC_uicGetText

설명

텍스트 컴포넌트의 내부의 문자열을 돌려준다.

cc 가 가리키는 컴포넌트의 내부 문자열의 idx 의 부분 부터 pszBuf 에 len 만큼 복사해준다.

idx 는 문자열의 범위를 벗어 나지 못하며, 만일 idx 가 0 보다 작은 경우에는 0 으로 보정되며, idx 가 문자열 보다 큰경우에는 아무런 내용도 복사하지 않으며 0 을 돌려준다.

지정된 컴포넌트가 텍스트 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는다.

프로토타입

M_Int32 MC_uicGetText(MC_Component cc, M_Int32 idx, M_Uint8* pszBuf, M_Int32 len)

매개 변수

• cc - [in] 컴포넌트
• idx - [in] 문자열의 시작 인덱스
• psz - [out] 복사될 버퍼
• len - [in] 버퍼의 크기

반환 값

복사된 문자열의 길이

부작용

없음

참고 항목

없음

MC_uicAddListItem

설명

리스트 컴포넌트에 리스트 아이템을 하나 추가한다.

지정된 컴포넌트가 리스트 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는 다.

넘기는 이미지는 리스트 항목이 삭제될 때 내부에서 파괴한다.

프로토타입

M_Int32 MC_uicAddListItem(MC_Component cc, M_Uint8* psz, MC_GrpImage img)

매개 변수

• cc - [in] 컴포넌트
• psz - [in] 리스트 아이템을 나타내는 문자열
• img - [in] 리스트 아이템의 이미지

반환 값

리스트의 인덱스(0 부터 시작된다.)

부작용

없음

참고 항목

없음

MC_uicGetListItem

설명

리스트 아이템을 가져 온다.

지정된 컴포넌트가 리스트 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는 다.

프로토타입

M_Int32 MC_uicGetListItem(MC_Component cc, M_Uint32 idx, M_Uint8* psz, M_Int32 buflen, MC_GrpImage* img)

매개 변수

• cc - [in] 컴포넌트
• idx - [in] 가져올 리스트 아이템의 인덱스
• psz - [out] 리스트 아이템을 나타나는 문자열이 복사될 버퍼
• buflen - [in] 버퍼의 크기
• img - [out] 리스트 아이템의 이미지

반환 값

성공

• 1

실패

• 0 이하면 실패
• M_E_SHOFTBUF - psz 으로 넘기는 버퍼 크기가 작은 경우

부작용

없음

참고 항목

없음

MC_uicRemoveListItem

설명

지정된 리스트 아이템을 삭제한다.

idx 가 가리키는 리스트 아이템을 삭제한다.

지정된 컴포넌트가 리스트 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는 다.

프로토타입

M_Int32 MC_uicRemoveListItem(MC_Component cc, M_Uint32 idx)

매개 변수

• cc - [in] 컴포넌트
• idx - [in] 삭제할 리스트 아이템의 인덱스

반환 값

성공

• 1

실패

• 0

부작용

없음

참고 항목

없음

MC_uicSetActiveListItem

설명

지정된 리스트 아이템을 활성화시킨다.

지정된 컴포넌트가 리스트 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는다. 만일 idx 값이 리스트 항목의 범위를 벗어 나면, 이 함수는 아무런 역할을 하지 않는다. 만일 선택되지 않은 상태로 두려면 idx 을 -1 로 지정하시면 된다.

프로토타입

M_Int32 MC_uicSetActiveListItem(MC_Component cc, M_Int32 idx)

매개 변수

• cc - [in] 컴포넌트
• idx - [in] 리스트 아이템의 인덱스

반환 값

이전에 활성화되었던 리스트의 인덱스를 넘겨준다.

부작용

없음

참고 항목

없음

MC_uicGetActiveListItem

설명

활성화된 리스트 아이템을 인덱스를 돌려준다.

지정된 컴포넌트가 리스트 컴포넌트가 아니면 이 함수는 아무런 역할을 하지 않는 다.

프로토타입

M_Int32 MC_uicGetActiveListItem(MC_Component cc)

매개 변수

• cc - [in] 컴포넌트

반환 값

셩공

• 활성화된 리스트 아이템의 인덱스

실패

• -1 - 활성화된 리스트가 없는 경우

부작용

없음

참고 항목

없음