ICT Corporation
튜토리얼 · Chapter 2

첫 프로젝트 — 버튼 클릭으로 로그 찍기

새 프로젝트를 만들어 화면에 버튼 하나를 놓고, 그 버튼을 누르면 for 반복문으로 로그를 10번 찍는 가장 단순한 예제를 완성합니다. 이 과정을 따라 하면 QMachineStudio 의 핵심 개발 흐름 — 화면 배치 → 이벤트를 함수에 연결 → 함수에 코드 작성 → 실행 → 로그 확인 — 을 한 번에 익힐 수 있습니다.

QMachineStudio 는 텍스트 파일을 직접 편집하는 방식이 아니라, Solution Explorer 트리에서 함수·스텝을 추가하고 선택한 항목의 코드만 편집합니다. 이 개념이 낯설다면 시작하기 의 "개발 방식" 절을 먼저 읽어 보세요.

1. 프로젝트 생성

  1. File → New 로 새 프로젝트를 만듭니다. 이름은 FirstProject 로 합니다.
  2. 생성이 끝나면 Solution Explorer 에 화면을 담는 View 모듈과 동작을 담는 Run 모듈이 함께 만들어집니다. 이 예제에서는 화면(View) 모듈만 사용합니다.

2. 화면에 버튼 추가

  1. Solution Explorer 에서 View 모듈의 화면 항목을 더블클릭해 디자이너(View Module)를 엽니다.
  2. 컨트롤 팔레트에서 Button 을 화면 위로 끌어다 놓습니다. 사용할 수 있는 컨트롤 종류는 UI 컨트롤 레퍼런스 에서 확인할 수 있습니다.
  3. 버튼을 선택하고 표시 텍스트(예: Run Log)와 이름(예: btnRunLog)을 지정합니다.

3. 버튼 Click 을 함수에 연결

버튼이 눌렸을 때 실행할 동작은 함수로 작성하고, 그 함수를 버튼의 클릭 이벤트에 연결합니다. QMachineStudio 에서 버튼 클릭이 함수를 호출하려면 버튼의 Action 속성이 RunEvent 여야 합니다.

  1. 버튼을 선택하고 우측 Property Editor 에서 Action 속성을 RunEvent 로 설정합니다. Action 의 기본값은 None 이며, RunEvent 일 때만 클릭 시 OnClickEvent 함수가 실행됩니다. ShowPage · RunManual 등 다른 값으로 두면 클릭이 그 동작으로 처리되고 OnClickEvent 는 호출되지 않습니다.
  2. Action 이 RunEvent 인 상태에서 버튼을 더블클릭합니다. XMachineEvent 항목의 OnClickEvent 에 지정된 함수가 아직 없으면 함수가 자동으로 생성되고 그 함수의 편집 탭이 열립니다. (함수 이름을 직접 정하려면 OnClickEvent 속성에 이름(예: OnRunLogClick)을 먼저 입력한 뒤 더블클릭합니다.)
  3. 이렇게 만들어진 함수는 Solution Explorer 의 해당 View 모듈 Functions 아래에 노드로 추가됩니다. 나중에 노드를 우클릭해 Rename · Delete 할 수 있습니다.

이벤트 함수는 호출될 때 버튼 이름과 태그 등(string sender, int tag, array params)을 자동으로 전달받습니다. 이 예제에서는 인자를 사용하지 않습니다.

4. for 반복문으로 로그 작성

열린 함수 편집 탭에 다음 코드를 작성합니다. 변수 i 를 선언하고, for 로 1부터 10까지 반복하며 매번 로그를 한 줄씩 남깁니다.

xscript
int i;
 
for(i, 1, 10)
{
    Log("count = {0}", i);
}
  • for(변수, 시작, 끝) 은 범위형 반복문으로, 끝값을 포함합니다. 위 코드는 i 가 1부터 10까지 총 10번 반복합니다.
  • Log("...{0}...", 값) 은 로그를 출력하며, {0} 자리에 뒤의 값이 들어갑니다. 여기서는 count = 1 부터 count = 10 까지 10줄이 출력됩니다.

5. 빌드와 실행

  1. Build → Save All & Make (F6) 로 저장 후 빌드합니다. 하단 Output 패널에 에러가 없는지 확인합니다. (결과 패널은 Output · Error · Search 참고)
  2. Build → Run (F5) 으로 런타임을 시작합니다. 작성한 화면이 실행됩니다.
  3. 화면의 Run Log 버튼을 누릅니다.

6. Log Manager 로 로그 확인

버튼을 누르면 Log("count = {0}", i) 가 실행되어 10줄의 로그가 남습니다. 이 런타임 로그는 동반 도구인 ICT Log Manager 로 확인합니다.

  1. Log Manager 를 실행하고 실시간 수신을 시작하거나, 저장된 로그 파일을 엽니다. (자세한 방법은 Log Manager 개요 와 실시간 로그 · 파일 열기 참고)
  2. 로그 목록에서 count = 1 부터 count = 10 까지 10줄이 순서대로 보이면 성공입니다.
  3. 줄이 많을 때는 Log Manager 의 찾기 · 필터 로 count 를 검색해 빠르게 확인할 수 있습니다.

무엇을 배웠나

  • 화면(View)에 컨트롤을 배치하고, 버튼 Action 을 RunEvent 로 두어 클릭 이벤트(OnClickEvent)를 함수에 연결하는 방법
  • 함수를 트리에 노드로 추가하고 그 노드의 코드만 편집하는 QMachineStudio 의 개발 방식
  • 범위형 for(i, 1, 10) 반복문과 Log("...{0}...", 값) 출력
  • 런타임 로그를 Log Manager 로 확인하는 방법

다음 단계