QCoreApplication Class

멤버 함수 문서

QCoreApplication::QCoreApplication(int &argc, char **argv)

Qt Core 애플리케이션을 생성합니다. Qt Core 애플리케이션이란 그래픽 사용자 인터페이스가 없는 애플리케이션을 말합니다. 이러한 애플리케이션은 콘솔에서 사용되거나 서버 프로세스로 실행됩니다.

argc 및 argv 인수는 애플리케이션에 의해 처리되며, arguments() 함수를 통해 보다 편리한 형태로 제공됩니다.

[virtual noexcept] QCoreApplication::~QCoreApplication()

QCoreApplication 객체를 삭제합니다.

[private signal] void QCoreApplication::aboutToQuit()

이 신호는 애플리케이션이 메인 이벤트 루프에서 빠져나가려는 순간, 예를 들어 이벤트 루프 레벨이 0으로 떨어질 때 발생합니다. 이는 애플리케이션 내부에서 ` quit()`를 호출한 후나, 사용자가 전체 데스크톱 세션을 종료할 때 발생할 수 있습니다.

이 신호는 애플리케이션이 마지막 순간에 정리 작업을 수행해야 할 때 특히 유용합니다. 이 상태에서는 사용자 상호작용이 불가능하다는 점에 유의하십시오.

quit()도 참조하십시오 .

[static] void QCoreApplication::addLibraryPath(const QString &path)

라이브러리 경로 목록의 맨 앞에 path 을 추가하여, 해당 경로에서 라이브러리를 가장 먼저 검색하도록 합니다. path 이 비어 있거나 이미 경로 목록에 포함된 경우, 경로 목록은 변경되지 않습니다.

기본 경로 목록은 하나 또는 두 개의 항목으로 구성됩니다. 첫 번째 항목은 플러그인 설치 디렉터리인 INSTALL/plugins 이며, 여기서 INSTALL 는 Qt가 설치된 디렉터리입니다. 두 번째 항목은 애플리케이션 자체의 디렉터리(현재 디렉터리가아님 )이지만, 이는 QCoreApplication 객체가 인스턴스화된 후에만 적용됩니다.

QCoreApplication 의 인스턴스가 소멸되면 라이브러리 경로는 기본값으로 재설정됩니다.

removeLibraryPath(), libraryPaths() 및 setLibraryPaths()도 참조하십시오 .

[static] QString QCoreApplication::applicationDirPath()

애플리케이션 실행 파일이 포함된 디렉터리를 반환합니다.

예를 들어, Qt를 C:\Qt 디렉터리에 설치한 상태에서 regexp 예제를 실행하면, 이 함수는 "C:/Qt/examples/tools/regexp"를 반환합니다.

macOS 및 iOS에서는 이 함수가 실제로 실행 파일이 포함된 디렉터리를 가리키게 되며, 이 디렉터리는 애플리케이션 번들 내부에 있을 수도 있습니다(애플리케이션이 번들로 구성된 경우).

Android에서는 이 함수가 실제로 실행 파일이 들어 있는 디렉터리를 가리키게 되며, 이 디렉터리는 애플리케이션 APK 내부에 있을 수도 있습니다(압축되지 않은 라이브러리 지원으로 빌드된 경우).

applicationFilePath()도 참조하십시오 .

[static] QString QCoreApplication::applicationFilePath()

애플리케이션 실행 파일의 파일 경로를 반환합니다.

예를 들어, Qt를 /usr/local/qt 디렉터리에 설치한 상태에서 regexp 예제를 실행하면, 이 함수는 "/usr/local/qt/examples/tools/regexp/regexp"를 반환합니다.

applicationDirPath()도 참조하십시오 .

[static noexcept] qint64 QCoreApplication::applicationPid()

애플리케이션의 현재 프로세스 ID를 반환합니다.

[static] QStringList QCoreApplication::arguments()

명령줄 인수의 목록을 반환합니다.

일반적으로 arguments().at(0)은 프로그램 이름이고, arguments().at(1)은 첫 번째 인자이며, arguments().last()는 마지막 인자입니다. Windows에 대한 아래 참고 사항을 확인하십시오.

이 함수를 호출하는 데는 시간이 오래 걸리므로, 명령줄을 파싱할 때는 결과를 변수에 저장해야 합니다.

Windows에서는 수정된 argv/argc 매개변수가 생성자에 전달된 경우에만 argc 및 argv 매개변수를 기반으로 목록이 생성됩니다. 이 경우 인코딩 문제가 발생할 수 있습니다.

그렇지 않은 경우, arguments()는 GetCommandLine()의 반환값을 바탕으로 생성됩니다. 이로 인해 Windows에서 arguments().at(0)이 반환하는 문자열이 애플리케이션을 시작하는 데 사용된 정확한 프로그램명이 아닐 수도 있습니다.

applicationFilePath() 및 QCommandLineParser도 참조하십시오 .

[since 6.5] Qt::PermissionStatus QCoreApplication::checkPermission(const QPermission &permission)

지정된 항목의 상태를 확인합니다. permission

결과가 ` Qt::PermissionStatus::Undetermined `인 경우, 사용자의 의도를 파악하기 위해 ` requestPermission()`를 통해 권한을 요청해야 합니다.

이 함수는 Qt 6.5에서 도입되었습니다.

requestPermission() 및 애플리케이션 권한항목도 참조하십시오 .

[static] bool QCoreApplication::closingDown()

애플리케이션 객체가 소멸 중인 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.

startingUp()도 참조하십시오 .

[override virtual protected] bool QCoreApplication::event(QEvent *e)

QObject::event(QEvent *e)를 재구현합니다.

[static] QAbstractEventDispatcher *QCoreApplication::eventDispatcher()

메인 스레드의 이벤트 디스패처 객체에 대한 포인터를 반환합니다. 해당 스레드에 이벤트 디스패처가 없는 경우, 이 함수는 ` nullptr`을 반환합니다.

setEventDispatcher()도 참조하십시오 .

[static] int QCoreApplication::exec()

메인 이벤트 루프로 진입하여 exit()이 호출될 때까지 대기합니다. exit()에 전달된 값을 반환합니다( quit()을 통해 exit()이 호출된 경우 이 값은 0입니다).

이 함수를 호출해야 이벤트 처리가 시작됩니다. 메인 이벤트 루프는 윈도우 시스템으로부터 이벤트를 수신하여 이를 애플리케이션 위젯에 전달합니다.

애플리케이션이 유휴 처리를 수행하도록 하려면(대기 중인 이벤트가 없을 때마다 특수한 함수를 실행함으로써), 타임아웃을 0ns로 설정한 QChronoTimer 를 사용하십시오. 더 정교한 유휴 처리 방식은 processEvents()을 사용하여 구현할 수 있습니다.

일부 플랫폼에서는 exec() 호출이 반환되지 않을 수 있으므로, 애플리케이션의 main() 함수에 정리 코드를 넣는 대신 aboutToQuit() 신호에 연결하는 것을 권장합니다. 예를 들어, Windows에서 사용자가 로그오프하면 시스템은 Qt가 모든 최상위 창을 닫은 후에 프로세스를 종료합니다. 따라서 exec() 호출 후 main() 함수의 끝 부분에서 애플리케이션이 이벤트 루프를 종료하고 코드를 실행할 시간이 있을 것이라는 보장은 없습니다.

quit(), exit(), processEvents(), QApplication::exec()도 참조하십시오 .

[static slot] void QCoreApplication::exit(int returnCode = 0)

애플리케이션이 반환 코드를 반환하며 종료되도록 지시합니다.

이 함수가 호출된 후, 애플리케이션은 메인 이벤트 루프를 벗어나 exec() 호출에서 반환됩니다. exec() 함수는 returnCode 를 반환합니다. 이벤트 루프가 실행 중이 아닐 경우, 이 함수는 아무 작업도 수행하지 않습니다.

관례에 따라, returnCode 의 값이 0이면 성공을 의미하며, 0이 아닌 값은 오류를 나타냅니다.

항상 QueuedConnection 을 사용하여 신호를 이 슬롯에 연결하는 것이 좋습니다. 제어권이 메인 이벤트 루프로 들어가기 전(예: "int main"이 exec()을 호출하기 전)에 이 슬롯에 연결된(큐에 추가되지 않은) 신호가 발생하면, 슬롯은 아무런 효과도 발휘하지 못하며 애플리케이션은 종료되지 않습니다. 큐에 등록된 연결을 사용하면 제어 흐름이 메인 이벤트 루프로 진입한 후에야 슬롯이 호출되도록 보장할 수 있습니다.

동일한 이름의 C 라이브러리 함수와는 달리, 이 함수는 호출자에게 반환된다는 점에 유의하십시오. 즉, 이벤트 처리가 중지되는 것입니다.

또한 이 함수는 스레드 안전하지 않다는 점에 유의하십시오. 이 함수는 메인 스레드( QCoreApplication 객체가 이벤트를 처리하는 스레드)에서만 호출되어야 합니다. 다른 스레드에서 애플리케이션의 종료를 요청하려면 QCoreApplication::quit()를 사용하거나, 대신 메인 스레드에서 QMetaMethod::invokeMethod()를 사용하여 이 함수를 호출하십시오.

quit() 및 exec()도 참조하십시오 .

void QCoreApplication::installNativeEventFilter(QAbstractNativeEventFilter *filterObj)

메인 스레드에서 애플리케이션이 수신하는 모든 네이티브 이벤트에 대해 이벤트 필터 filterObj 를 설치합니다.

이벤트 필터 ` filterObj `는 메인 스레드에서 수신된 모든 네이티브 이벤트에 대해 호출되는 ` nativeEventFilter()` 함수를 통해 이벤트를 수신합니다.

QAbstractNativeEventFilter::nativeEventFilter() 함수는 이벤트를 필터링(즉, 중지)해야 하는 경우 true를 반환해야 합니다. 정상적인 Qt 처리가 계속되도록 하려면 false를 반환해야 합니다. 그러면 네이티브 이벤트는 QEvent 로 변환되어 표준 Qt event 필터링(예: QObject::installEventFilter())을 통해 처리될 수 있습니다.

여러 이벤트 필터가 설치된 경우, 가장 마지막에 설치된 필터가 먼저 활성화됩니다.

이식성을 극대화하려면 가능한 한 항상 QEvent 및 QObject::installEventFilter()를 사용해야 합니다.

QObject::installEventFilter()도 참조하십시오 .

[static] bool QCoreApplication::installTranslator(QTranslator *translationFile)

translationFile 번역 파일을 번역에 사용될 번역 파일 목록에 추가합니다.

여러 개의 번역 파일을 설치할 수 있습니다. 번역은 설치된 순서의 역순으로 검색되므로, 가장 최근에 설치된 번역 파일이 먼저 검색되고, 가장 먼저 설치된 번역 파일이 마지막에 검색됩니다. 일치하는 문자열이 포함된 번역이 발견되는 즉시 검색이 중단됩니다.

QTranslator 를 설치하거나 제거하거나, 설치된 QTranslator 를 변경하면 QCoreApplication 인스턴스에 대해 LanguageChange 이벤트가 발생합니다. QApplication 인스턴스는 이 이벤트를 모든 최상위 위젯으로 전파하며, 여기서 changeEvent를 재구현하여 tr() 함수를 통해 사용자에게 표시되는 문자열을 각 속성 설정자(property setter)에 전달함으로써 사용자 인터페이스를 다시 번역할 수 있습니다. Qt Widgets Designer 에서 생성된 사용자 인터페이스 클래스는 호출할 수 있는 retranslateUi() 함수를 제공합니다.

이 함수는 성공 시 true 를, 실패 시 false 를 반환합니다.

removeTranslator(), translate(), QTranslator::load() 및 ‘동적 언어 변경에 대비하기’항목도 참조하십시오 .

[static noexcept] QCoreApplication *QCoreApplication::instance()

애플리케이션의 QCoreApplication (또는 QGuiApplication/QApplication) 인스턴스에 대한 포인터를 반환합니다.

인스턴스가 할당되지 않은 경우 nullptr 가 반환됩니다.

데이터 경합 주의 사항: 호출자 코드가 C++20으로 컴파일되지 않은 경우, 보조 스레드에서 QCoreApplication 인스턴스의 존재 여부를 확인하는 데 이 함수를 사용해서는 안 됩니다.

[static] bool QCoreApplication::isSetuidAllowed()

UNIX 플랫폼에서 해당 애플리케이션이 setuid를 실행할 수 있는 경우 true를 반환합니다.

QCoreApplication::setSetuidAllowed()도 참조하십시오 .

[static] QStringList QCoreApplication::libraryPaths()

애플리케이션이 라이브러리를 동적으로 로드할 때 검색할 경로 목록을 반환합니다.

QCoreApplication 가 생성되면 이 함수의 반환값이 변경될 수 있습니다. QCoreApplication 를 생성하기 전에 이 함수를 호출하는 것은 권장되지 않습니다. 애플리케이션 실행 파일의 디렉터리(작업 디렉터리가아님 )가 알려진 경우, 이 목록에 포함됩니다. 이를 알리려면 QCoreApplication 를 생성해야 하며, 이 객체는 argv[0] 를 사용하여 해당 경로를 찾습니다.

Qt는 기본 라이브러리 경로를 제공하지만, qt.conf 파일을 사용하여 경로를 설정할 수도 있습니다. 이 파일에 지정된 경로는 기본값보다 우선합니다. qt.conf 파일이 애플리케이션 실행 파일의 디렉터리에 있는 경우, QCoreApplication 가 생성될 때까지 파일이 발견되지 않을 수 있다는 점에 유의하십시오. 이 함수를 호출할 때 파일이 발견되지 않으면 기본 라이브러리 경로가 사용됩니다.

이 목록에는 플러그인이 존재하는 경우 해당 플러그인의 설치 디렉터리가 포함됩니다(플러그인의 기본 설치 디렉터리는 INSTALL/plugins 이며, 여기서 INSTALL 은 Qt가 설치된 디렉터리입니다). QT_PLUGIN_PATH 환경 변수의 콜론(:)으로 구분된 항목은 항상 추가됩니다. 플러그인 설치 디렉터리(및 그 존재 여부)는 애플리케이션 실행 파일의 디렉터리가 확인되면 변경될 수 있습니다.

setLibraryPaths(), addLibraryPath(), removeLibraryPath(), QLibrary 및 Qt 플러그인 생성 방법도참조하십시오 .

[virtual] bool QCoreApplication::notify(QObject *receiver, QEvent *event)

event 를 receiver 로 전송합니다: receiver->event(event). 수신자의 이벤트 핸들러에서 반환된 값을 반환합니다. 이 함수는 어떤 스레드에서든 어떤 객체로든 전송된 모든 이벤트에 대해 호출된다는 점에 유의하십시오.

특정 유형의 이벤트(예: 마우스 및 키 이벤트)의 경우, 수신자가 해당 이벤트에 관심이 없는 경우(즉, ` false`를 반환하는 경우), 이벤트는 수신자의 부모 객체로 전파되며, 최상위 객체에 도달할 때까지 계속 전파됩니다.

이벤트를 처리하는 방법에는 다섯 가지가 있으며, 이 가상 함수를 재구현하는 것은 그중 하나일 뿐입니다. 다섯 가지 접근 방식은 다음과 같습니다:

1. paintEvent(), mousePressEvent() 등을 재구현하는 방법입니다. 이는 가장 일반적이고, 가장 쉬우며, 가장 기능이 제한적인 방법입니다.
2. 이 함수를 재구현하는 방법. 이 방법은 매우 강력하여 완전한 제어를 제공하지만, 한 번에 하나의 하위 클래스만 활성화될 수 있습니다.
3. QCoreApplication::instance()에 이벤트 필터를 설치하는 방법. 이러한 이벤트 필터는 모든 위젯에 대한 모든 이벤트를 처리할 수 있으므로 notify()를 재구현하는 것만큼 강력합니다. 게다가 애플리케이션 전체에 적용되는 이벤트 필터를 여러 개 가질 수도 있습니다. 전역 이벤트 필터는 disabled widgets 에 대한 마우스 이벤트까지 감지합니다. 단, 애플리케이션 이벤트 필터는 메인 스레드에 존재하는 객체에 대해서만 호출된다는 점에 유의하십시오.
4. QObject::event()을 재구현하는 방법( QWidget 에서와 같이). 이렇게 하면 Tab 키 누름 이벤트를 받을 수 있으며, 위젯별 이벤트 필터보다 먼저 해당 이벤트를 확인할 수 있습니다.
5. 객체에 이벤트 필터를 설치합니다. 이러한 이벤트 필터는 포커스 위젯을 변경하지 않는 한, Tab 및 Shift+Tab 키 입력 이벤트를 포함한 모든 이벤트를 수신합니다.

향후 방향: Qt 7에서는 메인 스레드 외부에 존재하는 객체에 대해서는 이 함수가 호출되지 않을 예정입니다. 해당 기능이 필요한 애플리케이션은 당분간 이벤트 검사 요구 사항을 충족할 다른 해결책을 찾아야 합니다. 이 변경 사항은 메인 스레드로 확대될 수 있으며, 이 경우 이 함수는 더 이상 사용되지 않게 될 것입니다.

QObject::event() 및 installNativeEventFilter()도 참조하십시오 .

[static] void QCoreApplication::postEvent(QObject *receiver, QEvent *event, int priority = Qt::NormalEventPriority)

event 이벤트를 이벤트 큐에 추가하고, receiver 객체를 이벤트의 수신자로 지정하며, 즉시 반환합니다.

이벤트는 힙에 할당되어야 합니다. 이벤트 큐가 이벤트에 대한 소유권을 가져가며, 이벤트가 게시된 후 이를 삭제하기 때문입니다. 이벤트가 게시된 후에는 해당 이벤트에 접근하는 것이 안전하지 않습니다.

제어가 메인 이벤트 루프로 돌아오면, 큐에 저장된 모든 이벤트는 notify() 함수를 사용하여 전송됩니다.

이벤트는 priority 순서대로 내림차순으로 정렬됩니다. 즉, priority 값이 높은 이벤트가 priority 값이 낮은 이벤트보다 먼저 큐에 들어갑니다. priority 는 INT_MAX와 INT_MIN 사이의 모든 정수 값(두 값 포함)일 수 있습니다. 자세한 내용은 Qt::EventPriority 을 참조하십시오. priority 값이 동일한 이벤트는 게시된 순서대로 처리됩니다.

QObject::connect(thread, &QThread::finished, worker, &QObject::deleteLater);

참고: 이 함수는 스레드 안전합니다.

sendEvent(), notify(), sendPostedEvents() 및 Qt::EventPriority도 참조하십시오 .

[static] void QCoreApplication::processEvents(QEventLoop::ProcessEventsFlags flags = QEventLoop::AllEvents)

지정된 flags 에 따라 호출 스레드의 대기 중인 이벤트 일부를 처리합니다.

이 함수의 사용은 권장되지 않습니다. 대신, 시간이 오래 걸리는 작업은 GUI 스레드에서 보조 스레드로 옮기고, 중첩된 이벤트 루프 처리는 완전히 피하는 것이 좋습니다. 이벤트 처리가 정말로 필요한 경우, 대신 ` QEventLoop `를 사용하는 것을 고려하십시오.

이벤트 루프 없이 이 함수를 지속적으로 호출하는 로컬 루프를 실행하는 경우, ` DeferredDelete ` 이벤트는 처리되지 않습니다. 이는 ` DeferredDelete ` 이벤트에 의존하여 정상적으로 작동하는 위젯(예: ` QToolTip`)의 동작에 영향을 줄 수 있습니다. 대안으로는 해당 로컬 루프 내부에서 ` sendPostedEvents()`를 호출하는 방법이 있습니다.

이 함수를 호출하면 호출한 스레드에 대한 이벤트만 처리되며, 처리 가능한 모든 이벤트가 처리된 후에 반환됩니다. 처리 가능한 이벤트란 함수 호출 전에 대기열에 추가된 이벤트를 의미합니다. 즉, 함수 실행 중에 게시된 이벤트는 다음 이벤트 처리 단계까지 대기열에 남아 있게 됩니다.

참고: 이 함수는 스레드 안전합니다.

관련 항목: exec(), QTimer, QChronoTimer, QEventLoop::processEvents(), sendPostedEvents().

[static, since 6.7] void QCoreApplication::processEvents(QEventLoop::ProcessEventsFlags flags, QDeadlineTimer deadline)

deadline 의 유효 기간이 만료되거나 처리할 이벤트가 더 이상 없을 때까지, 둘 중 먼저 발생하는 시점까지 호출 스레드의 대기 중인 이벤트를 처리합니다.

이 함수의 사용은 권장되지 않습니다. 대신, 긴 작업은 GUI 스레드에서 보조 스레드로 옮기고, 중첩된 이벤트 루프 처리는 완전히 피하는 것이 좋습니다. 이벤트 처리가 정말로 필요한 경우, 대신 ` QEventLoop `를 사용하는 것을 고려하십시오.

이 함수를 호출하면 호출 스레드의 이벤트만 처리됩니다.

참고: 이 함수는 스레드 안전합니다.

이 함수는 Qt 6.7에서 도입되었습니다.

exec(), QTimer, QChronoTimer 및 QEventLoop::processEvents()도 참조하십시오 .

[static] void QCoreApplication::processEvents(QEventLoop::ProcessEventsFlags flags, int ms)

호출 스레드에 대한 대기 중인 이벤트를 ms 밀리초 동안 처리하거나, 처리할 이벤트가 더 이상 없을 때까지 처리하며, 두 경우 중 더 짧은 시간을 기준으로 합니다.

이는 다음 호출과 동일합니다:

QCoreApplication::processEvents(flags, QDeadlineTimer(ms));

[static slot] void QCoreApplication::quit()

응용 프로그램의 종료를 요청합니다.

예를 들어, 응용 프로그램의 창 중 하나를 닫을 수 없는 경우 등, 응용 프로그램이 종료를 차단하면 이 요청이 무시될 수 있습니다. 응용 프로그램은 응용 프로그램 수준에서 ` QEvent::Quit ` 이벤트를 처리하거나, 개별 창에 대해 ` QEvent::Close ` 이벤트를 처리함으로써 이에 영향을 줄 수 있습니다.

종료가 중단되지 않으면 응용 프로그램은 반환 코드 0(성공)으로 종료됩니다.

중단될 가능성 없이 애플리케이션을 종료하려면 exit()을 직접 호출하십시오. 이 메서드는 스레드 안전하지 않다는 점에 유의하십시오.

QueuedConnection 를 사용하여 신호를 이 슬롯에 항상 연결하는 것이 좋습니다. 제어권이 메인 이벤트 루프로 들어가기 전(예: "int main"이 exec()를 호출하기 전)에 이 슬롯에 연결된(큐에 저장되지 않은) 신호가 발생하면, 슬롯은 아무런 효과를 발휘하지 못하며 애플리케이션은 종료되지 않습니다. 큐에 추가된 연결을 사용하면 제어 흐름이 메인 이벤트 루프로 진입한 후에야 슬롯이 호출되도록 보장할 수 있습니다.

예시:

QPushButton *quitButton = new QPushButton("Quit");
QObject::connect(quitButton, &QPushButton::clicked, &app, &QCoreApplication::quit, Qt::QueuedConnection);

스레드 안전성 참고 사항: 이 함수는 어떤 스레드에서든 호출하여 현재 실행 중인 메인 애플리케이션 루프를 스레드 안전하게 종료시킬 수 있습니다. 그러나 QCoreApplication 객체가 동시에 소멸되고 있는 경우에는 스레드 안전성이 보장되지 않습니다.

참고: 이 함수는 스레드 안전합니다.

참조: exit() 및 aboutToQuit().

[static] void QCoreApplication::removeLibraryPath(const QString &path)

라이브러리 경로 목록에서 ` path `을 제거합니다. ` path `이 비어 있거나 경로 목록에 포함되어 있지 않은 경우, 목록은 변경되지 않습니다.

QCoreApplication 의 인스턴스가 소멸되면 라이브러리 경로는 기본값으로 재설정됩니다.

addLibraryPath(), libraryPaths() 및 setLibraryPaths()도 참조하십시오 .

void QCoreApplication::removeNativeEventFilter(QAbstractNativeEventFilter *filterObject)

이 객체에서 이벤트 filterObject 를 제거합니다. 해당 이벤트 필터가 설치되어 있지 않은 경우 이 요청은 무시됩니다.

이 객체가 소멸되면 이 객체에 대한 모든 이벤트 필터가 자동으로 제거됩니다.

이벤트 필터가 활성화된 상태(예: nativeEventFilter() 함수 내에서)라 하더라도 이벤트 필터를 제거하는 것은 항상 안전합니다.

installNativeEventFilter()도 참조하십시오 .

[static] void QCoreApplication::removePostedEvents(QObject *receiver, int eventType = 0)

receiver 에 대해 postEvent()을 사용하여 게시된, 지정된 eventType 의 모든 이벤트를 제거합니다.

이벤트는 디스패치되지 않고 큐에서 제거됩니다. 이 함수를 호출할 필요는 절대 없습니다. 만약 호출할 경우, 이벤트를 강제로 제거하면 receiver 가 하나 이상의 불변 조건을 위반할 수 있음을 유의하십시오.

receiver 가 nullptr 인 경우, eventType 의 이벤트가 모든 객체에 대해 제거됩니다. eventType 가 0인 경우, receiver 의 모든 이벤트가 제거됩니다. eventType 가 0인 상태에서 이 함수를 호출해서는 안 됩니다.

참고: 이 함수는 스레드 안전합니다.

[static] bool QCoreApplication::removeTranslator(QTranslator *translationFile)

이 애플리케이션에서 사용하는 번역 파일 목록에서 번역 파일 ` translationFile `을 제거합니다. (파일 시스템에서 해당 번역 파일을 삭제하지는 않습니다.)

이 함수는 성공 시 true 를 반환하고, 실패 시 false를 반환합니다.

installTranslator(), translate(), QObject::tr()도 참조하십시오 .

[since 6.5] template <typename Functor> void QCoreApplication::requestPermission(const QPermission &permission, Functor &&functor)

지정된 permission 에 대한 요청을 수행합니다.

요청이 준비되면, functor 는 functor(const QPermission &permission) 형태로 호출되며, permission 는 요청의 결과를 설명합니다.

functor 는 독립형 또는 정적 멤버 함수일 수 있습니다:

qApp->requestPermission(QCameraPermission{}, &permissionUpdated);

또는 람다일 수 있습니다:

qApp->requestPermission(QCameraPermission{}, [](const QPermission &permission) {
});

사용자가 요청된 permission 에 대해 애플리케이션에 명시적으로 권한을 부여하거나, 해당 플랫폼에서 permission 가 사용자 인증을 필요로 하지 않는 것으로 확인된 경우, 상태는 Qt::PermissionStatus::Granted 가 됩니다.

사용자가 애플리케이션에 요청된 permission 권한을 명시적으로 거부하거나, permission 권한이 해당 플랫폼의 애플리케이션에 접근할 수 없거나 적용되지 않는 것으로 알려진 경우, 상태는 Qt::PermissionStatus::Denied 가 됩니다.

요청 결과는 절대 Qt::PermissionStatus::Undetermined 가 되지 않습니다.

이 함수는 Qt 6.5에서 도입되었습니다.

checkPermission() 및 애플리케이션 권한도 참조하십시오 .

[since 6.5] template <typename Functor> void QCoreApplication::requestPermission(const QPermission &permission, const QObject *context, Functor functor)

context 컨텍스트에서 지정된 permission 를 요청합니다.

요청이 준비되면, functor 는 functor(const QPermission &permission) 로 호출되며, permission 는 요청의 결과를 설명합니다.

functor 는 독립형 함수이거나 정적 멤버 함수일 수 있습니다:

qApp->requestPermission(QCameraPermission{}, context, &permissionUpdated);

람다:

qApp->requestPermission(QCameraPermission{}, context, [](const QPermission &permission) {
});

context 객체 내의 슬롯:

qApp->requestPermission(QCameraPermission{}, this, &CamerWidget::permissionUpdated);

functor 는 context 객체의 스레드에서 호출됩니다. 요청이 완료되기 전에 context 가 소멸되면, functor 는 호출되지 않습니다.

사용자가 애플리케이션에 요청된 permission 권한을 명시적으로 부여하거나, 해당 플랫폼에서 permission 가 사용자 인증을 필요로 하지 않는 것으로 확인된 경우, 상태는 Qt::PermissionStatus::Granted 가 됩니다.

사용자가 요청된 permission 에 대해 애플리케이션에 명시적으로 거부하거나, permission 가 해당 플랫폼의 애플리케이션에 접근할 수 없거나 적용되지 않는 것으로 알려진 경우, 상태는 Qt::PermissionStatus::Denied 가 됩니다.

요청 결과는 절대 Qt::PermissionStatus::Undetermined 가 되지 않습니다.

이 함수는 Qt 6.5에서 도입되었습니다.

checkPermission() 및 애플리케이션 권한도 참조하십시오 .

[static] bool QCoreApplication::sendEvent(QObject *receiver, QEvent *event)

notify() 함수를 사용하여 이벤트 event 를 수신자 receiver 로 직접 전송합니다. 이벤트 핸들러에서 반환된 값을 반환합니다.

이벤트가 전송된 후에도 해당 이벤트는 삭제되지 않습니다. 일반적인 방법은 스택에 이벤트를 생성하는 것입니다. 예를 들면 다음과 같습니다.

QMouseEvent event(QEvent::MouseButtonPress, localPos, globalPos, Qt::LeftButton, Qt::LeftButton, Qt::NoModifier);
QCoreApplication::sendEvent(mainWindow, &event);

postEvent() 및 notify()도 참조하십시오 .

[static] void QCoreApplication::sendPostedEvents(QObject *receiver = nullptr, int event_type = 0)

QCoreApplication::postEvent()를 통해 이전에 큐에 추가된, receiver 객체에 대한 이벤트 중 이벤트 유형이 event_type 인 모든 이벤트를 즉시 디스패치합니다.

창 시스템에서 발생하는 이벤트는 이 함수가 아닌 processEvents()에 의해 처리됩니다.

receiver 가 nullptr 인 경우, event_type 의 이벤트가 모든 객체에 대해 전송됩니다. event_type 가 0인 경우, 모든 이벤트가 receiver 에 대해 전송됩니다.

참조: postEvent()

[static] void QCoreApplication::setAttribute(Qt::ApplicationAttribute attribute, bool on = true)

on 가 true인 경우 attribute 속성을 설정하고, 그렇지 않은 경우 해당 속성을 지웁니다.

참조: testAttribute().

[static] void QCoreApplication::setEventDispatcher(QAbstractEventDispatcher *eventDispatcher)

메인 스레드의 이벤트 디스패처를 ` eventDispatcher`로 설정합니다. 이는 아직 이벤트 디스패처가 설치되지 않은 경우에만 가능합니다. 즉, ` QCoreApplication `가 인스턴스화되기 전이어야 합니다. 이 메서드는 해당 객체의 소유권을 가져옵니다.

eventDispatcher()도 참조하십시오 .

[static] void QCoreApplication::setLibraryPaths(const QStringList &paths)

QLibrary 를 사용하여 플러그인을 불러올 때 검색할 디렉터리 목록을 paths 로 설정합니다. 기존의 모든 경로는 삭제되며, 경로 목록은 paths 에 지정된 경로와 애플리케이션 경로로 구성됩니다.

QCoreApplication 인스턴스가 소멸되면 라이브러리 경로는 기본값으로 재설정됩니다.

libraryPaths(), addLibraryPath(), removeLibraryPath() 및 QLibrary도 참조하십시오 .

[static] void QCoreApplication::setSetuidAllowed(bool allow)

allow 가 true인 경우, UNIX 플랫폼에서 애플리케이션이 setuid로 실행되도록 허용합니다.

allow 가 false(기본값)이고 Qt가 애플리케이션이 실제 사용자 ID와 다른 유효 사용자 ID로 실행되고 있음을 감지하면, QCoreApplication 인스턴스가 생성될 때 애플리케이션이 중단됩니다.

Qt는 공격 표면이 넓기 때문에 setuid 프로그램에 적합한 솔루션이 아닙니다. 그러나 역사적인 이유로 인해 일부 애플리케이션은 이러한 방식으로 실행되어야 할 수도 있습니다. 이 플래그를 설정하면 Qt가 이러한 상황을 감지했을 때 애플리케이션을 중단하지 않게 되며, QCoreApplication 인스턴스를 생성하기 전에 반드시 설정해야 합니다.

isSetuidAllowed()도 참조하십시오 .

[static] bool QCoreApplication::startingUp()

애플리케이션 객체가 아직 생성되지 않은 경우 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다.

closingDown()도 참조하십시오 .

[static] bool QCoreApplication::testAttribute(Qt::ApplicationAttribute attribute)

attribute 속성이 설정되어 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

setAttribute()도 참조하십시오 .

[static] QString QCoreApplication::translate(const char *context, const char *sourceText, const char *disambiguation = nullptr, int n = -1)

설치된 번역 파일을 조회하여 sourceText 에 대한 번역 텍스트를 반환합니다. 번역 파일은 가장 최근에 설치된 파일부터 첫 번째로 설치된 파일까지 역순으로 검색됩니다.

QObject::tr()는 이 기능을 보다 편리하게 제공합니다.

context 는 일반적으로 클래스 이름(예: "MyDialog")이며, sourceText 는 영어 텍스트이거나 식별을 위한 짧은 텍스트입니다.

disambiguation 는 동일한 컨텍스트 내에서 서로 다른 역할에 동일한 ` sourceText `가 사용될 때를 위한 식별 문자열입니다. 기본값은 ` nullptr`입니다.

컨텍스트, 모호성 해소 및 주석에 대한 자세한 내용은 QTranslator 및 QObject::tr() 문서를 참조하십시오.

n 는 복수형을 지원하기 위해 %n 과 함께 사용됩니다. 자세한 내용은 QObject::tr()을 참조하십시오.

번역 파일 중 어느 것도 context 내의 sourceText 에 대한 번역을 포함하지 않는 경우, 이 함수는 sourceText 에 해당하는 QString 를 반환합니다.

이 함수는 가상 함수가 아닙니다. QTranslator 을 상속하여 대체 번역 기법을 사용할 수 있습니다.

참고: 이 함수는 스레드 안전합니다.

QObject::tr(), installTranslator(), removeTranslator() 및 Internationalization and Translations도 참조하십시오 .