Getting Started on the Commandline/ko

This article may require cleanup to meet the Qt Wiki's quality standards. Reason: Auto-imported from ExpressionEngine. Please improve this article if you can. Remove the {{cleanup}} tag and add this page to Updated pages list after it's clean.

Qt로 프로그래밍 시작하기

크로스 플랫폼 GUI 툴킷 Qt의 세계에 오신 것을 환영합니다. 이 문서에서는 간단한 메모장을 짜면서 Qt에 대하여 알아 볼 것입니다. 이 문서를 읽고 나면 다른 부분의 미리보기나 API 문서를 더 쉽게 볼 수 있을 것이고, 개발하려는 프로그램에 필요한 정보를 더 빨리 찾을 수 있을 것입니다.

작은 메모장

이 첫 예제에서는 창 하나를 열고, 그 안에 텍스트 편집기를 만들고 보여 줄 것입니다. GUI를 사용하는 가장 간단한 Qt 프로그램입니다.

코드:

#include <QApplication>
#include <QTextEdit>

int main(int argv, char *'''args)
{
 QApplication app(argv, args);

 QTextEdit textEdit;
 textEdit.show();

 return app.exec();
}

한 줄 한 줄 코드를 읽어 봅시다. 맨 첫 두 줄에서는 이 예제에 필요한 QApplication QTextEdit 헤더 파일을 불러옵니다. 모든 Qt 클래스는 그 클래스 이름과 같은 이름으로 된 헤더 파일에 포함되어 있습니다.

여섯번째 줄에서는 QApplication 개체를 만듭니다. 이 개체는 프로그램 전역 자원을 관리하며 GUI가 있는 Qt 프로그램을 실행시키는 데 필요합니다. Qt는 명령행 인자를 지원하므로 argv와 args가 필요합니다.

여덟번째 줄에서는 QTextEdit 개체를 만듭니다. 텍스트 편집기는 GUI의 구성 요소이며, Qt에서는 GUI의 구성 요소를 위젯이라고 부릅니다. 위젯의 예를 들면 스크롤 바, 레이블, 라디오 단추 등이 있습니다. 대화 상자나 프로그램 주 창처럼 다른 위젯을 포함할 수도 있습니다.

아홉번째 줄에서는 텍스트 편집기에 창틀을 씌워 화면에 표시합니다. 모든 위젯은 다른 위젯을 포함하는 컨테이너의 역할을 합니다. 예를 들어 QMainWindow 같은 위젯은 도구 모음, 메뉴, 상태 표시줄, 다른 위젯을 포함합니다. 그래서 위젯 하나를 한 창에 표시할 수 있습니다. 기본적으로 위젯은 표시되지 않으므로, show() 함수를 호출하면 위젯이 나타납니다.

열한번째 줄에서는 QApplication 이벤트 루프를 시작합니다. Qt 프로그램이 실행될 때에는 이벤트가 프로그램의 위젯으로 전달됩니다. 이벤트의 예는 마우스 입력, 키보드 입력 등입니다. 텍스트 편집기 위젯에 텍스트를 입력할 때, 키보드 입력 이벤트가 발생하며 입력된 텍스트가 표시됩니다.

프로그램을 실행하려면 명령 프롬프트를 열고, .cpp 파일이 들어 있는 디렉터리로 이동하십시오. 다음 셸 명령을 입력하면 프로그램을 빌드합니다.

qmake -project
qmake
make

이 명령을 실행하면 part1 디렉터리에 실행 파일이 생깁니다. (Windows 환경에서는 make 대신 nmake를 입력해야 할 수도 있습니다. 이 경우 part1/debug 또는 part1/release 폴더에 실행 파일이 생깁니다.) qmake는 Qt의 빌드 도구이며, 설정 파일을 인자로 받습니다. -project 인자를 주었을 때에는 프로젝트 설정 파일을 생성합니다. .pro 확장자를 가지는 설정 파일이 있으면 qmake는 프로그램을 빌드하는 Makefile을 생성합니다. .pro 파일을 만드는 법은 나중에 배울 것입니다.

더 배우기

창과 창의 크기: 창과 대화상자 위젯

• 이벤트와 이벤트 처리: 이벤트 시스템

종료 버튼 추가하기

진짜 프로그램은 위젯 하나만으로 만들 수 없습니다. 이번에는 텍스트 편집기에 QPushButton 추가해 볼 것입니다. 이 단추를 누르면 메모장을 끝냅니다.

코드를 봅시다.

#include <QtGui>

int main(int argv, char **args)
{
 QApplication app(argv, args);

QTextEdit textEdit;
 QPushButton quitButton("Quit");

QObject::connect(&quitButton, SIGNAL (clicked()), qApp, SLOT (quit()));

QVBoxLayout layout;
 layout.addWidget(&textEdit);
 layout.addWidget(&quitButton);

QWidget window;
 window.setLayout(&layout);

window.show();

return app.exec();
}

첫 번째 줄에는 QtGui 있으며, 모든 Qt GUI 클래스를 포함합니다.

열 번째 줄은 Qt의 시그널과 슬롯을 사용하여, 닫기 단추*를 눌렀을 때 프로그램이 끝나도록 합니다. 슬롯은 런타임에서 이름을 문자열로서 호출할 수 있는 함수입니다. 시그널은 호출되었을 때 연결되어 있는 슬롯을 부르는 함수로, 시그널을 슬롯에 연결하고, 시그널을 내보낸다는 말을 사용합니다.

quit() QApplication 의 슬롯으로, 프로그램을 종료합니다. clicked() QPushButton 시그널로, 눌렀을 때 내보냅니다. 정적 함수 QObject::connect 시그널과 슬롯을 연결합니다. SIGNAL ()과 SLOT() 매크로는 연결할 시그널과 슬롯의 함수를 인자로 받는 매크로입니다. 시그널을 보내고 받는 개체의 포인터도 전달해야 합니다.

열 두번째 줄은 QVBoxLayout 만듭니다. 앞에서 이야기했듯이 위젯에는 또 다른 위젯이 들어갈 수 있습니다. 자식 위젯의 크기와 위치를 수동으로 지정할 수도 있으나, 레이아웃을 사용하면 더 쉽습니다. 레이아웃 위젯은 자식 위젯의 크기와 위치를 관리합니다. 여기에서 사용한 QVBoxLayout 자식 위젯을 수직으로 배치합니다.

13, 14번째 줄은 레이아웃에 텍스트 편집기와 단추를 추가합니다. 17번째 줄은 위젯에 레이아웃을 지정합니다.

더 배우기

시그널과 슬롯: 시그널과 슬롯

• 레이아웃: 레이아웃 관리, 위젯과 레이아웃, 레이아웃 예제
• Qt에 포함된 위젯: Qt 위젯 갤러리, 위젯 예제

QWidget 상속받기

프로그램을 끝낼 때 사용자가 진짜로 프로그램을 끝내고 싶은 지 물어봐야 할 때도 있습니다. 이 예제에서는 QWidget 하위 클래스를 만들고 *닫기 단추*에 연결할 슬롯을 정의합니다.

코드를 봅시다:

class Notepad : public QWidget
{
 Q_OBJECT

public:
 Notepad();

private slots:
 void quit();

private:
 QTextEdit *textEdit;
 QPushButton *quitButton;
};

클래스 정의의 맨 위에는 Q_OBJECT 매크로가 들어가야 하며, 이는 이 클래스가 QObject임을 알려 줍니다. 이 매크로를 사용하려면 QObject 상속받아야 합니다. QObject 표준 C++ 클래스에 일부 기능을 추가합니다. 예를 들어 클래스 이름과 슬롯 이름을 실행 시간에 조회할 수 있습니다. 슬롯의 인자도 조회할 수 있으며 호출할 수 있습니다.

13번째 줄에서는 슬롯 quit()를 정의합니다. slots 매크로를 사용하여 정의할 수 있습니다. quit() 슬롯은 인자가 없는 시그널에 연결할 수 있습니다.

GUI를 구성하고 main() 함수에서 슬롯을 연결하는 대신, Notepad 클래스의 생성자를 사용할 것입니다.

Notepad::Notepad()
{
 textEdit = new QTextEdit;
 quitButton = new QPushButton(tr("Quit"));

connect(quitButton, SIGNAL (clicked()), this, SLOT (quit()));

QVBoxLayout '''layout = new QVBoxLayout;
 layout->addWidget(textEdit);
 layout->addWidget(quitButton);

 setLayout(layout);

 setWindowTitle(tr("Notepad"));
}

클래스 정의에서 볼 수 있듯이, QObject, quitButton)를 참조할 때에는 포인터를 사용합니다. 규칙으로, 항상 QObject 힙에 할당하고 절대 복사하지 마십시오.

이제 사용자에게 보이는 문자열을 tr()로 감쌀 것입니다. 영어와 한국어처럼 한 개 이상의 언어로 프로그램을 표시할 때 필요합니다. 여기에서는 다루지 않겠지만, '더 보기'에서 Qt Linguist에 대해서 더 알아보십시오.

h3. 더 보기 tr()과 국제화: Qt Linguist 설명서, 번역을 고려하여 소스 코드 작성하기, Hello tr() 예제, Qt와 국제화

• QObject와 Qt 개체 모델: 개체 모델
• qmake와 Qt 빌드 시스템: qmake 설명서

.pro 파일 만들기

이 예제에서는 qmake의 -project 옵션 대신 직접 .pro 파일을 만들 것입니다.

 HEADERS = notepad.h
 SOURCES = notepad.cpp  main.cpp

다음 셸 명령을 실행하면 빌드할 수 있습니다.

 qmake
 make

QMainWindow 사용하기

많은 프로그램은 QMainWindow 사용합니다. 자체 레이아웃을 가지고 있어서 메뉴 표시줄, 도킹 위젯, 도구 모음, 상태 표시줄 등을 포함할 수 있습니다. QMainWindow 중심 영역에는 아무 위젯이나 배치할 수 있으며, 여기에 텍스트 편집 컨트롤을 추가할 것입니다.

새로운 Notepad 클래스 정의를 봅시다.

#include <QtGui>

class Notepad : public QMainWindow
{
 Q_OBJECT

public:
 Notepad();

private slots:
 void open();
 void save();
 void quit();

private:
 QTextEdit *textEdit;

QAction *openAction;
 QAction *saveAction;
 QAction *exitAction;

QMenu '''fileMenu;
};

문서를 열고 저장하는 슬롯을 더 추가하였으며, 다음 절에서 다룰 것입니다.

주 창에서는 여러 위젯에서 한 슬롯을 호출할 수도 있습니다. 예를 들면 메뉴 항목과 도구 모음 항목입니다. 이를 더 쉽게 처리하기 위해서, Qt는 QAction 제공합니다. 여러 위젯에 포함시킬 수 있으며, 슬롯에 연결할 수 있습니다. QMenu QToolBar 같은 QAction 사용하여 메뉴 항목과 도구 모음 단추를 만들 수 있습니다. 어떻게 사용하는지 잠깐 알아볼 것입니다.

앞에서 다룬 것처럼 Notepad 클래스의 생성자로 GUI를 설정합니다.

Notepad::Notepad()
{
 saveAction = new QAction(tr("&Open"), this);
 saveAction = new QAction(tr("&Save"), this);
 exitAction = new QAction(tr("E&xit"), this);

 connect(openAction, SIGNAL (triggered()), this, SLOT (open()));
 connect(saveAction, SIGNAL (triggered()), this, SLOT (save()));
 connect(exitAction, SIGNAL (triggered()), qApp, SLOT (quit()));

 fileMenu = menuBar()->addMenu(tr("&File"));
 fileMenu->addAction(openAction);
 fileMenu->addAction(saveAction);
 fileMenu->addSeparator();
 fileMenu->addAction(exitAction);

 textEdit = new QTextEdit;
 setCentralWidget(textEdit);

 setWindowTitle(tr("Notepad"));
}

QAction 위젯에 나타날 텍스트를 인자로 하여 생성됩니다. 이 경우에는 메뉴 항목 텍스트입니다. 도구 모음에 추가할 동작이라면 아이콘 추가할 수 있습니다.

메뉴 항목이 눌리면 동작을 호출하며, 연결된 슬롯이 실행됩니다.

h3. 더 보기 주 창과 주 창 클래스: 프로그램 주 창, 주 창 예제

• MDI 프로그램: QMdiArea, MDI 예제

저장하고 불러오기

이 예제에서는 앞 절에서 추가한 open()과 save() 슬롯의 기능을 구현할 것입니다.

open() 슬롯의 코드입니다.

QString fileName = QFileDialog::getOpenFileName(this, tr("Open File"), "",
 tr("Text Files ('''.txt);;C++ Files ('''.cpp '''.h)"));

if (fileName != "") {
 QFile file(fileName);
 if (!file.open(QIODevice::ReadOnly)) {
 QMessageBox::critical(this, tr("Error"),
 tr("Could not open file"));
 return;
 }
 QString contents = file.readAll().constData();
 textEdit->setPlainText(contents);
 file.close();
}

첫 단계는 사용자가 열 파일 이름을 물어보는 것입니다. Qt의 QFileDialog 클래스는 사용자가 파일을 선택할 수 있는 대화 상자를 표시합니다. 위 그림은 쿠분투에서 실행한 파일 대화 상자입니다. 정적 함수 getOpenFileName() 모달 파일 대화상자를 표시하며, 사용자가 파일을 선택할 때까지 값을 반환하지 않습니다. 사용자가 선택을 취소하면 빈 문자열, 파일을 선택하면 파일의 경로를 반환합니다.

파일 이름이 있으면 open() 파일을 열 것입니다. 파일을 열 수 있으면 true를 반환합니다. 오류 처리에 대해서 알아 보려면 '더 보기'를 참고하십시오. 파일을 열 수 없으면 QMessageBox 사용하여 오류 메시지를 표시합니다. 더 자세한 사항은 QMessageBox 클래스 문서를 참고하십시오.

실제 데이터를 읽는 역할은 readAll() 함수가 담당합니다. 이 함수는 파일의 모든 데이터를 QByteArray 저장합니다. constData() 함수는 배열에 들어 있는 데이터를 const char 형태로 반환하며, 이는 QString 생성자에 인자로 넘겨줄 수 있습니다. 이제 텍스트 편집기에 파일 내용을 보여 주며, 파일을 닫기 위해서 close() 함수를 호출합니다.

이제 save() 슬롯을 봅시다.

QString fileName = QFileDialog::getSaveFileName(this, tr("Save File"), "",
 tr("Text Files ('''.txt);;C++ Files ('''.cpp '''.h)"));

if (fileName != "") {
 QFile file(fileName);
 if (!file.open(QIODevice::WriteOnly)) {
 // error message
 } else {
 QTextStream stream(&file);
 stream << textEdit->toPlainText();
 stream.flush();
 file.close();
 }
}

텍스트 편집기의 내용을 파일로 쓸 때에는 QFile 둘러싸는 QTextStream 클래스를 사용합니다. QFile write() 함수는 생(raw) 데이터(char)만 받아들이며, QTextStream은 QString을 파일에 바로 쓸 수 있습니다.