Qt 로 만들자: 디렉토리 보기

파일 관리자의 가장 기본이 되는 기능은 단연 디렉토리 보기일 것이다. 이번에는 Qt 에서 제공하는 기능을 가지고 <디렉토리 보기> 를 만들어 보자.

1. 요구 사항

• 현재 보고 있는 디렉토리의 절대 경로를나타내기
• 디렉토리를 트리구조로 나타내기
• 디렉토리를 구성하고 있는 서브-디렉토리와 파일들을 나타내기

2. 코드 작성

2.1 프로젝트 작성

• 프로젝트 이름: DirLister
• 메인 클래스 이름: DirLister
• 메인 클래스 유형: QMainWindow

2.2 헤더 분석(dirlister.h)

Colored By Color Scripter™

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34

#ifndef DIRLISTER_H #define DIRLISTER_H #include <QMainWindow> #include <QtWidgets> #include <QFileSystemModel> /**  * @brief 디렉토리 구조와 내용을 보여준다  */ class DirLister : public QMainWindow {     Q_OBJECT public:     DirLister(QWidget *parent = 0);     ~DirLister(); private:     QLineEdit *_locationLine;       ///< 위치     QFileSystemModel *_dirModel;    ///< 디렉토리 구조용 파일 시스템 모델     QTreeView *_dirView;            ///< 디렉토리 구조용 트리뷰     QFileSystemModel *_entryModel;  ///< 디렉토리 내용용 파일 시스템 모델     QTreeView *_entryView;          ///< 디렉토리 내용용 트리뷰     void initMenus();     void initWidgets(); private slots:     void  dirActivated(const QModelIndex &current); }; #endif // DIRLISTER_H

22 번째 줄: Qt 는 모델/뷰 아케텍쳐를 사용한다. 모델을 통하여 데이터를 조직화하고, 뷰를 통하여 데이터를 표현한다. QFileSystemModel 은 파일 시스템에 대한 모델이다. 이를 위해 <QFileSystemModel> 을 포함할 필요가 있다. 사실 <QtWidgets> 를 포함한다면 <QFileSystemModel> 을 따로 포함할 필요는 없다.

23 번째 줄: QTreeView 는 모델을 트리 형태로 표현하는 뷰이다.

출처: Qt 도움말(QTreeView)

31 번째 줄: QModelIndex 은 모델에 있는 특정 데이터를 가리킨다.

2.3 소스 분석(dirlister.cpp)

2.3.1 생성자와 소멸자

Colored By Color Scripter™

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

/**  * @brief DirLister 생성자  * @param parent 부모 위젯  */ DirLister::DirLister(QWidget *parent)     : QMainWindow(parent) {     initMenus();    // 메뉴 초기화     initWidgets();  // 위젯 초기화 } /**  * @brief DirLister 소멸자  */ DirLister::~DirLister() { }

메뉴와 위젯을 초기화한다.

2.3.2 initMenus()

Colored By Color Scripter™

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

/**  * @brief 메뉴를 초기화한다  */ void DirLister::initMenus() {     // '파일' 메뉴 생성     QMenu *fileMenu = new QMenu(tr("파일(&F)"));     // '끝내기' 항목 추가     fileMenu->addAction(tr("끝내기(&x)"), this, SLOT(close()),                         QKeySequence::Quit);     // '파일' 메뉴 추가     menuBar()->addMenu(fileMenu); }

'파일' 메뉴를 생성하고, '끝내기' 항목을 추가한다.

2.3.3 initWidgets()

Colored By Color Scripter™

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24

/**  * @brief 위젯을 초기화한다  */ void DirLister::initWidgets() {     // '위치' 한줄편집기 생성     _locationLine = new QLineEdit;     // 읽기 전용으로     _locationLine->setReadOnly(true);     // '위치' 레이블 생성     QLabel *locationText = new QLabel(tr("위치(&L)"));     // 단축키를 '위치' 한줄편집기와 연결     locationText->setBuddy(_locationLine);     // 디렉토리 구조용 파일 시스템 모델 생성     _dirModel = new QFileSystemModel;     // 디렉토리, 모든 드라이브. '.' 과 '..' 는 제외     _dirModel->setFilter(QDir::AllDirs | QDir::Drives | QDir::NoDotAndDotDot);     // 위치 위젯 가로로 배치     QHBoxLayout *hboxLayout = new QHBoxLayout;     hboxLayout->addWidget(locationText);     hboxLayout->addWidget(_locationLine);

'위치' 레이블과 한줄 편집기를 가로로 배치한다.

14 번째 줄: QLabel::setBuddy() 는 QLabel 에 지정된 단축키를 누를 때 촛점을 받을 위젯을 설정한다. 지금의 경우 Alt-L 을 누르면, 한줄 편집기로 촛점이 옮겨진다.

16~19 번째 줄: 파일 시스템 모델을 생성하고, 드라이브와 디렉토리를 검색한다. 단 '.' 과 '..' 은 제외한다. QFileSystemModel::setFilter() 는 검색하고자 하는 조건을 설정한다. 주의할 점은 QDir::AllDirs 는 반드시 포함해야 한다. 그렇지 않으면 디렉토리 구조가 올바르게 검색되지 않는다.

Colored By Color Scripter™

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27

// 드라이브 또는 '/' 디렉토리 내용을 읽음     foreach (QFileInfo info, QDir::drives())     {         QEventLoop loop;         connect(_dirModel, &_dirModel->directoryLoaded, &loop, &loop.quit);         // 읽을 디렉토리 설정         _dirModel->setRootPath(info.filePath());         loop.exec();     }     QString currentDir = QDir::currentPath();     // 현재 디렉토리 구성 요소를 따라 디렉토리 내용을 읽음     for (int i = 0; i != -1;)     {         i = currentDir.indexOf("/", i + 1);         QString dir = currentDir.mid(0, i);         if (_dirModel->rootPath() != dir)         {             QEventLoop loop;             connect(_dirModel, &_dirModel->directoryLoaded, &loop, &loop.quit);             _dirModel->setRootPath(dir);             loop.exec();         }     }

현재 디렉토리의 구조를 따라 모두 수동으로 검색한다. 이 작업은 현재 디렉토리를 화면에 올바르게 표시하기 위해 필요하다. QFileSystemModel 은 QFileSystemModel::setRootPath() 를 호출하면 검색을 시작한다. 하지만, 이렇게 하면 현재 디렉토리가 화면 밖으로 밀리는 경우가 생긴다. 이를 방지하기 위해 부모 디렉토리를 차례로 검색하는 것이다.

예를 들어, QFileSystemModel::setRootPath("x:/path/to/dir") 을 호출하면, 다음 순서로 검색한다.

1. x:/path/to/dir
2. x:/
3. x:/path
4. x:/path/to 

이후에 다른 항목들이 추가될 때, 예를 들어, x:/path/to/above, 현재 디렉토리보다 앞쪽에 추가되면, 현재 디렉토리는 뒤로 밀리면서, 뷰의 밖에 위치할 수 있다.

따라서 애초에 루트부터 부모디렉토리까지 디렉토리를 검색해서 추가해주면, 이 문제를 피할 수 있다.

2 번째 줄: QFileInfo 는 파일 관련 정보를 담고 있다. QDir 클래스는 디렉토리 관련 기능을 제공하는 클래스이다. QDir::drives() 는 드라이브의 목록을 돌려준다. 드라이브가 지원되지 않는 OS 의 경우에는 '/' 를 돌려준다.

4 번째 줄: QEventLoop 는 이벤트 루프를 지역적으로 실행할 수 있도록 한다.

5 번째 줄: 일반적으로 connect() 는 SIGNAL() 과 SLOT() 매크로를 이용하지만, Qt5 에서는 이것외에도 멤버 함수에 대한 함수 포인터도 지원한다. 이 방법의 장점은 시그널과 슬롯을 컴파일 타임에 확인할 수 있다는 것이다. 기존의 SIGNAL/SLOT 방법은 컴파일 타임에 확인하지 못하고, 런타임에 디버깅 메세지로 오류가 출력이 되기 때문에 종종 문제가 된다. 그리고 기나긴 인자 목록을 나열하지 않아도 되는 것도 좋은 점이다.

8 번째 줄: QFileSystemModel::setRootPath() 를 호출하여 주어진 디렉토리를 검색하도록 한다. 모두 검색하였으면 directoryLoaded() 시그널이 발생한다.

9 번째 줄: QEventLoop::exec() 는 이벤트 루프로 진입하여 QEventLoop::quit() 슬롯이 호출되면 루프를 빠져 나온다.

12 번째 줄: QDir::currentPath() 는 현재 디렉토리를 경로를 알려주는 정적 멤버 함수이다.

16 번째 줄: QString::indexOf() 는 주어진 문자열은 주어진 위치에서부터 찾아서, 그 위치를 돌려준다.

17 번째 줄: QString::mid() 는 주어진 위치에서부터 주어진 길이만큼의 문자열을 돌려준다.

19 번째 줄: QFileSystemModel::rootPath() 는 현재 설정된 root path 를 돌려준다. QFileSystemModel::setRootPath()는 같은 디렉토리를 설정하면 directoryLoaded() 시그널이 발생하지 않으므로, 현재 root path 를 반드시 확인해야 한다. 그렇지 않으면 이벤트 루프에서 무한 대기한다.

Colored By Color Scripter™

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26

// 디렉토리 구조용 트리뷰 생성     _dirView = new QTreeView;     // 모델 설정     _dirView->setModel(_dirModel);     // 헤더 숨김     _dirView->setHeaderHidden(true);     // 두번째 이후 모든 컬럼 숨김     for (int i = _dirModel->columnCount() - 1; i > 0; --i)         _dirView->setColumnHidden(i, true);     connect(_dirView, &_dirView->activated, this, &this->dirActivated);     connect(_dirView, &_dirView->clicked, this, &this->dirActivated);     // 디렉토리 내용용 파일 시스템 모델 생성     _entryModel = new QFileSystemModel;     // 모든 디렉토리, 파일. '.' 과 '..' 은 제외     _entryModel->setFilter(QDir::AllDirs | QDir::Files | QDir::NoDotAndDotDot);     _entryModel->setRootPath("");     // 디렉토리 내용용 트리뷰 생성     _entryView = new QTreeView;     // 모델 설정     _entryView->setModel(_entryModel);     // 펼치기/감추기 아이콘 숨김     _entryView->setRootIsDecorated(false);     // 더블 클릭 무시     _entryView->setExpandsOnDoubleClick(false);

디렉토리 구조용 모델과 트리뷰, 디렉토리 내용용 모델과 트리뷰를 생성한다.

4 번째 줄: QTreeView::setModel() 는 트리뷰로 나타낼 모델을 설정한다.

6 번째 줄: QTreeView::setHeaderHidden() 은 Name, Size, Type 같은 헤더를 숨긴다.

8 번째 줄: QTreeView::columnCount() 은 컬럼의 갯수를 돌려준다.

9 번째 줄: QTreeView::setColumnHidden() 은 주어진 위치의컬럼을 숨긴다.

10~11 번째 줄: QTreeView::activate() 시그널은 항목을 더블 클릭하거나 항목에서 엔터를 누르는 경우에 발생한다. QTreeView::clicked() 는 항목을 클릭했을 때 발생한다.

24 번째 줄: QTreeView::setRootIsDecorated() 는 펼치기/접기 아이콘을 나타낼지를 결정한다.

26 번째 줄: QTreeView::setExpandsOnDoubleClick() 은 더블 클릭했을 때, 가지를 펼칠지를 결정한다.

Colored By Color Scripter™

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

// 스플리터 생성     QSplitter *splitter = new QSplitter;     splitter->addWidget(_dirView);     splitter->setStretchFactor(0, 0);     splitter->addWidget(_entryView);     splitter->setStretchFactor(1, 1);     // 위치와 스플리터 세로 배치     QVBoxLayout *vboxLayout = new QVBoxLayout;     vboxLayout->addLayout(hboxLayout);     vboxLayout->addWidget(splitter);     // 중앙 위젯 생성     QWidget *w = new QWidget;     w->setLayout(vboxLayout);     // 중앙 위젯 설정     setCentralWidget(w);

2 번째 줄: QSplitter 는 위젯을 사이에 크기 조절 막대를 삽입하여 관리하는 위젯이다.

3 번째 줄: QSplitter::addWidget() 은 위젯을 추가한다.QSplitter::setOrientation() 으로 설정하지 않으면, 가로 방향이 추가된다.

4 번째 줄: QSplitter::setStrectchFactor()는 주어진 위젯의 크기 인자를 설정한다. 0 은 최소 크기이다. 예를 들어 세 개의 위젯이 각각 1, 2, 3 의  크기 인자를 가진다면, 각각 1/6, 2/6, 3/6 의 크기를 나누어 가진다.

Colored By Color Scripter™

1 2 3 4 5 6 7

// 디렉토리 구조용 트리뷰에 촛점 설정     _dirView->setFocus();     // 현재 디렉토리를 현재 인덱스로 설정     _dirView->setCurrentIndex(_dirModel->index(QDir::currentPath()));     // 현재 인덱스 활성화     dirActivated(_dirView->currentIndex()); }

시작했을 때 디렉토리 구조가 촛점을 갖고, 현재 디렉토리가 선택되도록 한다.

4 번째 줄: QAbstractItemView::setCurrentIndex() 는 현재 인덱스를 설정한다. QFileSystemModel::index() 는 주어진 경로에 대한 인덱스를 돌려준다.

6 번째 줄: QAbstractItemView::currentIndex() 은 현재 인덱스를 돌려준다.

2.3.4 dirActivated()

Colored By Color Scripter™

1 2 3 4 5 6 7 8 9 10 11 12 13 14

/**  * @brief 디렉토리가 활성화되었을 때 호출됨  * @param index 활성화된 인덱스  */ void DirLister::dirActivated(const QModelIndex &index) {     // 인덱스로부터 파일 경로를 얻음     QString path(_dirModel->filePath(index));     // 위치 텍스트를 경로로 설정     _locationLine->setText(QDir::toNativeSeparators(path));     // 디렉토리 내용용 트리뷰에 디렉토리 내용 표시     _entryView->setRootIndex(_entryModel->index(path)); }

디렉토리가 활성화(activated)되거나 디렉토리를 클릭(clicked) 했을 때 호출된다. 선택된 인덱스에 따라 위치 한줄 편집기에 현재 절대 경로를 설정하고, 디렉토리 내용이 보이게 한다.

8 번째 줄: QFileSystemModel::filePath() 은 주어진 인덱스에 해당하는 파일 경로를 돌려준다.

11 번째 줄: QDir::toNativeSeparators() 는 주어진 경로의 디렉토리 구분자를 OS 에 맞게 바꾼다. Qt 는 내부적으로 디렉토리 구분자로 '/' 를 쓴다. 하지만 Windows 나 OS/2 같은 경우에는 '\' 를 쓰므로, OS 에 맞게 바꾼다.

13 번째 줄: QTreeView::setRootIndex() 는 루트 인덱스를 설정한다. 루트 인덱스를 설정하면 해당 인덱스의 자식 인덱스만을 표현한다. 참고로 디렉토리 내용은 QListView 가 아니라 QTreeView 로 나타낸다는 것을 기억하자.

3. 마무리하면서...

파일 관리자의 가장 기본적인 요소인 <디렉토리 보기> 를 구현해보았다. Qt 자체에 관련 기능이 충실히 구현되어 있기 때문에 어렵지 않게 구현할 수 있었다.

이를 조금만 더 활용한다면 간단한 파일 관리자 정도는 금방 만들 수 있을 것이다.

다음은 <디렉토리 보기> 의 실행 화면이다.

전체 소스는 여기에서 확인하자.

https://github.com/komh/qtex/tree/master/DirLister