인생 코딩

Qt의 메타-오브젝트 시스템(meta-object system)은 객체간 통신을 위한 시그널-슬롯 매커니즘과, 런타임 타입 정보, 동적 속성 시스템을 제공한다.

메타-오브젝트 시스템은 아래 세 가지를 기반으로 한다:

1. QObject 클래스 : 객체를 위한 기반 클래스를 제공하여 메타-오브젝트 시스템의 이점을 이용할 수 있게 한다.

2. Q_OBJECT 매크로 : 클래스의 private 섹션 안에 선언되며, 동적 속성과 시그널 슬롯 등의 메타-오브젝트 기능을 사용할 수 있게 한다.

3. Meta-Object Compiler(moc) : QObject의 자식 클래스들에게 필요한 메타-오브젝트 구현 코드를 제공한다.

moc 툴은 C++ 헤더, 소스 파일 읽어 Q_OBJECT 매크로가 포함된 클래스를 찾고,

이를 찾으면 각 클래스에 대해 메타-오브젝트 코드를 포함하는 또다른 C++ 소스 파일을 생성해낸다.

이렇게 생성된 소스파일은 인클루드, 컴파일되고 클래스 구현과 링크되어 사용된다.

예) 헤더파일에 Q_OBJECT 매크로가 있는 클래스가 있다면,

메타-오브젝트를 이용할 수 있는 코드들을 추가한 새로운 헤더 파일을 만들어내고,

이 헤더 파일을 include한 새로운 C++ 구현 파일이 생겨 빌드시에는 이를 컴파일하고 링크하여 사용한다.

참고

https://doc.qt.io/qt-6/metaobjects.html

https://coding-chobo.tistory.com/9

QSQLITE DB에서 regexp를 사용하려면,

커넥션 열 때 setConnectOptions("QSQLITE_ENABLE_REGEXP=1"); 을 설정해 주어야 한다.

bool DB::connectDatabase()
{
    QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE", "connName");
    db.setConnectOptions("ISC_DPB_LC_CTYPE=UTF-8");
    db.setConnectOptions("QSQLITE_ENABLE_REGEXP=1");
    db.setDatabaseName(":memory:");
    if (!db.isValid())
    {
        qDebug() << "addDatabase failed.(db is not valid)";
        return false;
    }
    if (!db.isOpen())
    {
        if (!db.open())
        {
            qDebug() << QString("DB Open Failed - connName : %1, dbname : %2").arg("connName").arg(":memory:");
            QSqlDatabase::removeDatabase("connName");
            return false;
        }
    }
    return true;
}

데이터를 조회할 때는, 아래와 같이 사용한다.

한글로 시작하는 데이터 조회

SELECT * FROM tablename WHERE `columnName` REGEXP '^[ㄱ-ㅎ가-힣]';

영어로 시작하는 데이터 조회

SELECT * FROM tablename WHERE `columnName` REGEXP '^[a-zA-Z]';

숫자로 시작하는 데이터 조회

SELECT * FROM tablename WHERE `columnName` REGEXP '^[0-9]';

일본어로 시작하는 데이터 조회

SELECT * FROM tablename WHERE `columnName` REGEXP '^[ぁ-んァ-ヶー一-龠]' ;

중국어로 시작하는 데이터 조회

SELECT * FROM tablename WHERE `columnName` REGEXP '^[一-龥]';

샘플 코드

void DB::select() {
    QSqlDatabase DB = QSqlDatabase::database("connName");    

    QSqlQuery sql(DB);
    QString query = "SELECT * FROM tablename WHERE `subject` REGEXP '^[ㄱ-ㅎ가-힣]'";
    bool re = sql.exec(query);
    while (sql.next()) {
        qDebug() << sql.value(0).toString();
    }    
}

1. 디렉토리가 비어있는지 체크

Qt 5.9 이후부터는 QDir 클래스의 isEmpty() 함수로 체크 가능하다.

QString directoryPath = "C:\Directory";
QDir dir(directoryPath);
if (dir.isEmpty())
	qDebug() << directoryPath << " is Empty!";
else
	qDebug() << directoryPath << " is not Empty!";

2. 디렉토리 안 파일 개수 카운팅

QDir 클래스의 count() 함수로 카운팅 가능하다.

다만, .(현재폴더) ..(부모 폴더) 두개가 자동으로 포함되어 카운팅 되기 때문에, 이들을 빼주어야 한다.

QString directoryPath = "C:\Directory";
QDir dir(directoryPath);
dir.setFilter( QDir::AllEntries | QDir::NoDotAndDotDot ); // 현재, 부모 폴더 빼주기
qDebug() << directoryPath << " contains << dir.count() << " files.";

읽기 전용 파일은 덮어쓰거나, 삭제가 안된다. 

이 때, 파일 퍼미션을 설정해서 읽기 전용 속성을 제거할 수 있다.

(파일에 쓰기 권한을 주면, 덮어쓰기나 삭제가 가능해진다.)

읽기 전용(Read Only) 파일에 쓰기 권한 주기

// C++ code
#include <QFile>

void removeReadOnly(QString filepath)
{
    QFile file(filepath);
    file.setPermissions(file.permissions() |
                        QFileDevice::WriteOwner |
                        QFileDevice::WriteUser |
                        QFileDevice::WriteGroup |
                        QFileDevice::WriteOther);
}

QPushButton의 background color를 설정하고/가져오는 방법입니다.

1. QPushButton의 background color 설정하기

QColor color(Qt::red);
ui->pushButton->setStyleSheet(QString("background-color: %1;").arg(color.name()));

2. QPushButton의 background color 가져오기

// C++ code
QColor Panel::buttonColor() const
{
    return ui->pushButton->palette().background().color();
}

QMessageBox 안에 html 태그를 포함한 텍스트를 쓰고 싶은 경우가 있다.

예) <strong> 태그를 써서 특정 글자를 진하게 표현하고 싶다던가, <h4> 등의 제목 태그를 쓰고 싶다던가, <br/> 태그를 써서 줄바꿈을 하고 싶다던가..

이럴 때에는 setTextFormat(Qt::RichText); 함수로, 텍스트 포맷을 RichText로 설정해 주면 된다.

QMessageBox msg(this);
msg.setIcon(QMessageBox::Information);
msg.setTextFormat(Qt::RichText);
msg.setWindowTitle(tr("Title"));
msg.setText(tr("<strong>Hello!</strong><br/>World!");
msg.setStandardButtons(QMessageBox::Yes | QMessageBox::No);
if (msg.exec() == QMessageBox::Yes) {
	// do something on Yes
}
else {
	// do something on No
}

가끔, 위젯의 상태를 변경하지만, 변경시 발생하는 시그널은 블럭해야 하는 경우가 있다.

(변경 시그널은 발생시키지 않아야 하는 경우 = 변경 시그널에 connect 되어 있는 함수를 실행하면 안되는 경우)

이럴 경우, SignalBlocker를 사용하면 된다.

방법 1. blockSignals 함수 사용

blockSignals(True) 와 blockSignals(False) 사이에서 실행되는 코드는 signal을 발생시키지 않는다.

아래는 checkBox에서, 시그널을 블럭하면서 체크 상태를 바꾸는 예이다.

# Python code
self.checkBox.blockSignals(True)
self.checkBox.toggle()
self.checkBox.blockSignals(False)

방법 2. QSignalBlocker 사용

위와 동일한 기능을 하는 QSignalBlocker라는 클래스를 사용할 수도 있다. 

중괄호 안에서 QSignalBlocker를 생성하면, 해당 범위 안에서 시그널을 막아준다.

• 시그널 블럭 대상 : QSignalBlocker 인자로 넘어온 오브젝트 (예: 체크박스)
• 시그널 블럭 범위 : QSignalBlocker 생성 후, 중괄호가 끝날때까지 (QSignalBlocker 가 생성된 후, 소멸되기 전까지 시그널을 막음)

// C++ code
#include <QSignalBlocker>

ui->checkBox->setChecked(true); // 시그널 발생함

if (wantToBlockSignal) 
{
    const QSignalBlocker blocker(ui->checkBox);	// if문 범위 내에서, ui->checkBox의 시그널을 block한다
    ui->checkBox->setChecked(false); // 시그널 발생 안함
}

ui->checkBox->setChecked(true); // 시그널 발생함

참고 : https://doc.qt.io/qt-5/qobject.html#blockSignals

GUI(Graphical User Interface)란?

그래픽 아이콘의 클릭을 통해 기기와 상호작용 하는 방식이다. 문자 입/출력으로 상호작용하는 CLI(Command Line Interface) 방식보다 쉬운 인터페이스를 만들고자 등장하였다.

GUI 라이브러리란?

GUI(Graphical User Interface) 환경에서 실행되는 응용 프로그램의 화면 출력부를 구현하기 위하여 사용되는 라이브러리이다.

쉽게 말하면, 그래픽 기반의 어플리케이션을 만들기 위한 많은 부분을 구현하여 라이브러리로 제공하는 것이다. 혹은 GUI 프레임워크라 부르는 것들도 있다.

(라이브러리와 프레임워크는 엄밀히는 다른 용어로, 이 둘을 구분하기 위해서는 제어의 역전이 일어나는가를 따지기도 하는데.. 일단은 둘 다 남이 만들어놓은 코드를 가져다 쓸 수 있다라는 점에서 동일하다고 간주하도록 하겠다.)

GUI 라이브러리의 종류

GUI 라이브러리의 종류는 크게 운영체제에 종속이 되는가/되지 않는가로 구분할 수 있다.

1. 운영체제에 종속

Microsoft Windows

• Windows API - 윈도우에서 제공되는 기본 API 세트. C언어 함수들을 기반으로, C++ 객체와 COM 개체를 사용할 수 있다.
• MFC - C++ 라이브러리. Windows API를 기반으로 한다.
• WTL - MS에서 제공하는 ATL 기반의 경량 GUI 라이브러리. 이쪽은 MFC와 달리 오픈 소스이다.
• .NET Framework WinForms / WPF(Windows Presentation Foundation)
  • .NET Framework 플랫폼에는 Windows Forms와 WPF의 두 가지 GUI 라이브러리가 포함되어 있다.
  • Windows Forms는 쉬운 난이도 덕분에 초보자가 접하기에도 용이하다. 또한 C#은 C++과는 비교도 되지 않는 높은 생산성을 자랑하는 언어이며, 기존 윈도용 C/C++ 프로젝트나 라이브러리와의 연동도 수월하므로 일단 핵심 코드는 그대로 둔 채 껍데기부터 차차 교체할 수도 있다.
  • WPF(Windows Presentation Foundation)은 무료 오픈소스 그래픽 라이브러리로, .Net Framework 3.0의 일부로 처음 출시되었다.

macOS & iOS

• Cocoa API - Apple 운영 체제용 어플리케이션을 제작할 때 사용하는 프레임워크이다. 
• SwiftUI - iOS, tvOS, macOS, 및 watchOS용 유저 인터페이스 개발을 위한 크로스 플랫폼 프레임워크이다. Apple이 2019년 첫 출시한 이후 가파르게 진화하고 있다. 

2. 운영체제 비 종속

Java

Java 언어를 위하여 개발된 GUI 라이브러리. 다른 GUI 라이브러리의 Java 언어 바인딩은 여기에 추가하지 않는다.

• AWT / Swing - Java 런타임 기본 내장 GUI 라이브러리.
• JavaFX - AWT와 Swing을 대체하기 위해 만들어진 표준 GUI 라이브러리.
• SWT - 이클립스에서 사용된다. 홈페이지

크로스 플랫폼

다양한 운영체제/동작 환경을 지원하는 라이브러리들이다. 상용으로 쓰려면 라이선스를 확인해야 한다.

참고

https://namu.wiki/w/GUI%20%EB%9D%BC%EC%9D%B4%EB%B8%8C%EB%9F%AC%EB%A6%AC

https://en.wikipedia.org/wiki/Graphical_user_interface

https://en.wikipedia.org/wiki/Windows_Presentation_Foundation

https://cocoacasts.com/swiftui-fundamentals-what-is-swiftui

https://www.slant.co/topics/983/~best-cross-platform-gui-toolkits#12