각각의 메뉴에 대한 보다 자세한
설명은 "Help"의 "Documentation"을
참고하기 바란다.

이제 간단한 프로그램을 하나
만들면서 PilotMAG의 기능을 익혀보자. 지금부터
만드는 프로그램을 간단히 설명하면, Hello라는
폼에서 OK라는 버튼을 누르면 I love you라는 다른
폼으로 이동하고, 그 폼에서 다시 OK를 누르면
Hello라는 폼으로 다시 돌아오는 프로그램이다. 이
프로그램으로 폼 사이의 이동에 관한 기법을
익할 수 있을 것이다.

4. 프로그램 제작

메뉴 가운데 "File"항목 중
"New Project"를 누르면, 프로젝트 이름과
경로를 지정하라고 한다.
(여기서는 "sample"이라는 이름으로
프로젝트 이름을 정하겠다.)
프로젝트 이름과 경로를 지정하면 메인 폼이
하나 만들어지고 왼쪽에는 프로젝트 이름과
속성을 나타내는 창이 하나 생긴다.
(이 창을 앞으로 "속성창"이라 부르겠다.)

왼쪽에 있는 속성창의 세부항목에 대한 개괄적인
설명은 다음과 같다.

Application : Application에 대한
기본적인 정보를 포함, 프로그램 설명과 개발자
ID, 프로그램 아이콘을 설정할 수 있음.
Forms : 프로그램에서 사용되는 Form에 대한 정보를
표시
Units : 프로그램의 C소스를 나타냄
Resource : 프로그램의 헤더와 리소스 파일에 대한
정보를 표시

가. 폼 제작

폼은 속성창 위에 어디든지
마우스를 올려놓고 마우스 오른쪽 버튼을 눌러
나오는 팝업메뉴에서 New Form을 선택하거나, 아이콘을
클릭함으로써 만들 수 있다.

만들어진 폼에는 원하는 리소스를 배치할 수
있으며, 각각의 속성값은 각 리소스를 클릭하여
선택한 뒤, "Properities"탭을 선택하여
변경할 수 있다. 예를 들어 폼의 제목을 바꾸고
싶다면 다음 그림과 같은 순으로 하면 된다.

① 폼을 눌러 활성화시킨 후, ②
Properities를 눌러 아래와 같은 화면이 나오면, Label
text의 값을 변경해주면 폼의 제목이 바뀌는 것을
알 수 있다. 이처럼 폼이면 폼, 버튼이면 버튼을
먼저 선택하고 Properities탭을 누르면, 각각의
속성값을 변화시킬 수 있다.

마찬가지로 "Object Identifier"
항목을 다른 이름으로 변경하는 것도 가능하다.

여기서는 Form의 Label Text를 Hello로
바꿔 보자. Hello라고 입력한 뒤 엔터키를 치면
아래와 같이 리소스창에 폼 타이틀이 "Hello"로
바뀌는 것을 볼 수 있다.

그리고 ① 메뉴바의 Grid 아이콘을
눌러 그리드를 On 시키고, ② button을 옮긴 후, ③
Button의 라벨을 OK로 바꾼다.

자 이제 두번째 I love you라는 폼을
만들 차례이다.

아이콘을 눌러 폼을 또 하나 만든다. Object
ID가 Form1006인 새로운 폼이 하나 만들어졌다.

① 버튼 아이콘을 눌러 폼에 버튼을
추가하고, ② 위치를 잡은 후, ③ Button의 라벨을
OK로 바꾼다.

만들어진 폼을 확인하려면,
속성창의 Project 탭을 누른 후, Forms 왼쪽의 +를
눌러 노드를 확장시킨 후, 해당 폼 이름을
마우스로 클릭하면 된다. 이렇게 하면 각 폼에
해당되는 내용이 리소스창에 뜬다.

자, 이제 Hello폼과 I love you 폼,
서로간의 이동을 위해 C소스를 직접 만져줄 때가
됐다.

나. 프로그래밍

① Units의 노드를 확장시키면 sample.c라는
소스 파일이 나타날 것이다. 이 소스파일을
더블클릭하면 편집기 창에 sample.c라는 소스
파일이 편집가능한 상태로 불러진다. 이 소스
파일은 프로젝트를 만들면 자동으로 생성된다.
이렇게 만들어지는 소스 파일은 기본적인 내용을
포함하고 있기 때문에, 필요한 기능을 추가하고
변경하는 방식으로 프로그램을 짜나가면 된다.

② 소스 파일의 내용을 보자면,
프로그램이 SDK 3.5를 사용하고 있을 경우에는
#include <PalmOS.h> 와 #include <PalmCompatibility.h>라는
명령을 통해 헤더파일을 지정하고, SDK 1.0 ~ 3.1을
사용하는 경우에는 #include <Pilot.h>라는
명령을 통해 헤더파일을 지정함을 알 수 있다.
자신이 현재 사용하는 SDK에 맞게 변경해 주면
된다. 사용하지 않는 명령어 앞에는 "//"를
붙여 주석으로 만들어 주자.
다음으로 #include "@IncludeFile@.h"를 자신의
프로젝트 이름에 맞게 고쳐준다. 여기서는
프로젝트 이름이 sample이므로 #include "sample.h"라고
하면 되겠다. 참고로 속성창의 Resource항목에 이미
sample.h라는 파일이 있는데 이것은 단지 이름만
있는 파일일 뿐 아무 내용이 없는 파일이다(나중에
설명하게 되겠지만, 컴파일 단계에서 Generate
Resource명령을 내리면 비로소 sample.h가 생성된다).

이제 Hello 폼과 I love you 폼의 버튼을
눌렀을 때(이벤트가 발생했을 때), 어떻게
처리할지를 추가해주면 된다.
아래 소스파일 중 추가하거나 변경한 내용은
붉은 글씨로 나타냈다. 그러므로 붉은 글씨로 된
부분만 추가/변경해주면 된다.

//—————————————————————————
// PilotMAG Main
//
//
// (c) John Smith 01/01/99
//—————————————————————————
// This file is only start up code, it is not generated by
PilotMAG.
// You can edit this file by your self, to made your own
start up file.
// Originally located at: c:\Programs Files\Monte Soft\PilotMAG\PilotMAG.ptr
//—————————————————————————

// Main Include file for SDK 3.5
#include <PalmOS.h>
#include <PalmCompatibility.h>

// Main Include file for SDK 1.0, SDK 2.0, SDK 3.0, SDK 3.1
//#include <Pilot.h>

#include "sample.h" // Change this to: #include "YourProjectName.h"

static int StartApplication(void);
static void EventLoop(void);
static void StopApplication(void);
static Boolean frmMainEventH(EventPtr event);
static Boolean Form1006EH(EventPtr
event);

//—————————————————————————
DWord PilotMain (Word cmd, Ptr cmdPBP, Word launchFlags)
{
int error;

if (cmd == sysAppLaunchCmdNormalLaunch)
        {
        error =
StartApplication(); // Application start code
        if (error)

                return
error;
        EventLoop();
// Event loop
        StopApplication
(); // Application stop code
        }
        return 0;
}

//—————————————————————————
static int StartApplication(void)
{
FrmGotoForm(Form1004);
return 0;
}

//—————————————————————————
static void EventLoop(void)
{
short err;
int formID;
FormPtr form;
EventType event;

do
        {
        EvtGetEvent(&event,
200);
        if (SysHandleEvent(&event))

                continue;
        if (MenuHandleEvent((void
*)0, &event, &err))

                continue;
        if (event.eType
== frmLoadEvent)

                {

                formID
= event.data.frmLoad.formID;

                form
= FrmInitForm(formID);

                FrmSetActiveForm(form);

                switch
(formID)

                        {

                        case
Form1004:

                                FrmSetEventHandler(form,
(FormEventHandlerPtr) frmMainEventH);

                                break;

                        case Form1006:
                           

     FrmSetEventHandler(form, (FormEventHandlerPtr)
Form1006EH);
                           

     break;

                        }

                }
        FrmDispatchEvent(&event)

;
        }
        while(event.eType
!= appStopEvent);
}

//—————————————————————————
static void StopApplication(void)
{
//Insert stop code here
FrmSaveAllForms();
FrmCloseAllForms();
}

//—————————————————————————
static Boolean frmMainEventH(EventPtr event)
{
FormPtr form;
int handled = 0;

switch (event->eType)
        {
        case
frmOpenEvent:

                form
= FrmGetActiveForm();

                FrmDrawForm(form);

                handled
= 1;

                break;
        case
ctlSelectEvent:

                if
(event->data.ctlEnter.controlID == Button1005 )

                        {

                        FrmGotoForm(Form1006);

                        handled
= 1;

                        }

                break;
        case nilEvent:

                handled
= 1;

                break;
        }
return handled;
}

//—————————————————————————
static Boolean Form1006EH(EventPtr event)
{
FormPtr form;
int handled = 0;

switch (event->eType)
        {
        case frmOpenEvent:
                form = FrmGetActiveForm();
                FrmDrawForm(form);
                handled = 1;
                break;
        case ctlSelectEvent:
                if (event->data.ctlEnter.controlID
== Button1007 )
                        {
                        FrmGotoForm(Form1004);
                        handled = 1;
                        }
                break;
        case nilEvent:
                handled = 1;
                break;
        }
return handled;
}

다. 컴파일과 링크

이제 남은 것은 컴파일과 링크인데,
PilotMAG에서는 전과정을 한번에 처리할 수 있다.
바로 Build Pilot Application의 단축키인 <F8>키를
누르기만 하면 된다. 물론 각 부분별로 나누어
진행하는 것도 가능하다. 다음 그림은 <F8>을
눌러, 팜상에서 실행 가능한 .prc파일을 한번에
만드는 것을 보여준다.

중간에 컴파일과 링크를 멈추려면 아이콘(평상시에는
안보이며, 컴파일하는 동안만 나타남)을 누르면
되는데, 이때 남게되는 임시 파일들은 지워주는
것이 좋다(Project 메뉴 중 Clean Project를 이용하면
된다).

라. 팜에 프로그램을 설치

자 이제 sample.prc파일이 생성되었다.
팜에 프로그램을 설치하는 것은 아이콘을
눌러 Install Tool을 실행시킨 후 핫싱크 버튼을
누르면 된다.

5. 몇가지 팁

• 팜 프로그래밍을 처음 하는
  사람이라면 C:\Program Files\Monte Soft\PilotMAG\Samples
  아래에 있는 샘플 프로그램들을 분석해
  보는 것도 의미가 있다. 이 샘플
  프로그램들은 팜 프로그램들에서 사용되는
  기초적인 동작들(가령 폼 간의 이동,
  팝업메뉴의 제작)을 포함하고 있기 때문에
  프로그래밍을 공부하는데 좋은 자료라고
  생각한다.
• 웬만한 기능들은 모두 오른쪽
  마우스 팝업 메뉴에 포함되어 있기때문에
  오른쪽 마우스 버튼을 사용하면 편하다.
• 상하 화살표등의 특수문자는
  리소스 중 Label을 이용하면 된다. 속성 중
  폰트를 Symbol7으로 하고, Label Text에 \001에서
  \004까지 넣으면 된다. 폰트를 바꿔가며
  시험해 보면 더 많은 특수문자를 사용할 수
  있을 것이다.
• 팝업메뉴를 작성할 때, Menu의
  속성 중 Item Caption항목에 -를 입력하면
  메뉴사이를 구분하는 선이 생길 것이다.
• "Project" – "Create from
  Template"메뉴를 사용하면 기존에 많이
  쓰이는 리소스 형태를 템플릿으로 만들어
  놓은 것을 알 수 있다. 이를 가져다가
  조금씩 변경해서 사용하면 보다 편하게
  폼을 디자인 할 수 있을 것이다. 또한 아래
  그림과 같이 자기가 만든 폼 디자인을
  템플릿으로 저장할 수도 있다.

6. 맺음말

지금까지 간단하게나마 PilotMAG의
기능을 살펴보았다. 사용자에 따라서 더 많은
기능을 활용할 수 있으리라 생각한다. 이 문서가
팜 프로그래밍에 처음 입문하는 분들께
조금이나마 도움이 되기를 바란다.