QObject Class

멤버 함수 문서

[explicit invokable] QObject::QObject(QObject *parent = nullptr)

부모 객체가 있는 객체를 생성합니다 parent.

객체의 부모는 객체의 소유자로 볼 수 있습니다. 예를 들어 dialog box 는 포함된 OK 및 Cancel 버튼의 부모입니다.

부모 객체의 소멸자는 모든 자식 객체를 소멸합니다.

parent 을 nullptr 으로 설정하면 부모가 없는 객체가 생성됩니다. 객체가 위젯인 경우 최상위 창이 됩니다.

parent(), findChild() 및 findChildren()도 참조하세요 .

[virtual noexcept] QObject::~QObject()

개체를 삭제하여 모든 하위 개체를 삭제합니다.

객체와 주고받는 모든 신호가 자동으로 연결이 끊어지고 객체에 대해 보류 중인 모든 게시 이벤트가 이벤트 대기열에서 제거됩니다. 그러나 QObject 하위 클래스를 직접 삭제하는 것보다 deleteLater()를 사용하는 것이 더 안전한 경우가 많습니다.

deleteLater()도 참조하세요 .

[noexcept] bool QObject::blockSignals(bool block)

block 이 참이면 이 객체에서 방출되는 신호가 차단됩니다(즉, 신호를 방출해도 연결된 어떤 것도 호출되지 않습니다). block 이 거짓이면 이러한 차단이 발생하지 않습니다.

반환 값은 signalsBlocked()의 이전 값입니다.

이 개체에 대한 신호가 차단된 경우에도 destroyed() 신호가 전송됩니다.

차단된 상태에서 방출되는 신호는 버퍼링되지 않습니다.

signalsBlocked() 및 QSignalBlocker 을참조하세요 .

[virtual protected] void QObject::childEvent(QChildEvent *event)

이 이벤트 핸들러는 하위 클래스에서 다시 구현하여 자식 이벤트를 수신할 수 있습니다. 이벤트는 event 매개변수로 전달됩니다.

QEvent::ChildAdded 및 QEvent::ChildRemoved 이벤트는 자식이 추가되거나 제거될 때 객체에 전송됩니다. 두 경우 모두 자식이 QObject 이거나 isWidgetType()가 true 을 반환하면 QWidget 이 될 수 있습니다( ChildAdded 의 경우 자식이 아직 완전히 구성되지 않았고 ChildRemoved 의 경우 이미 소멸되었을 수 있기 때문입니다).

QEvent::ChildPolished 이벤트는 자식이 폴리싱되거나 폴리싱된 자식이 추가될 때 위젯에 전송됩니다. 자식 폴리싱 이벤트를 받으면 일반적으로 자식의 구성이 완료된 것입니다. 그러나 이것이 보장되는 것은 아니며 위젯의 생성자가 실행되는 동안 여러 개의 폴리시 이벤트가 전달될 수 있습니다.

모든 자식 위젯에 대해 ChildAdded 이벤트 1개, ChildPolished 이벤트 0개 이상, ChildRemoved 이벤트 1개를 받습니다.

자식이 추가된 후 즉시 제거되면 ChildPolished 이벤트는 생략됩니다. 자식이 생성 및 소멸하는 동안 여러 번 폴리싱되는 경우 동일한 자식에 대해 매번 다른 가상 테이블을 사용하여 여러 개의 자식 폴리싱 이벤트를 받을 수 있습니다.

event()도 참조하세요 .

const QObjectList &QObject::children() const

자식 객체 목록을 반환합니다. QObjectList 클래스는 <QObject> 헤더 파일에 다음과 같이 정의되어 있습니다:

typedef QList<QObject*> QObjectList;

가장 먼저 추가된 자식은 목록의 first 객체이고 마지막으로 추가된 자식은 목록의 last 객체이며, 즉 새 자식이 마지막에 추가됩니다.

QWidget 자식이 raised 또는 lowered 인 경우 목록 순서가 변경됩니다. 위젯이 올라간 위젯은 목록의 마지막 객체가 되고, 내려간 위젯은 목록의 첫 번째 객체가 됩니다.

findChild(), findChildren(), parent() 및 setParent()도 참조하세요 .

[static] QMetaObject::Connection QObject::connect(const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type = Qt::AutoConnection)

sender 객체의 signal 에서 receiver 객체의 method 로의 지정된 type 연결을 생성합니다. 나중에 연결을 끊는 데 사용할 수 있는 연결 핸들을 반환합니다.

매개변수가 유효하지 않은 등 연결을 만들 수 없는 경우 연결 핸들은 유효하지 않습니다. QMetaObject::Connection 을 부울로 캐스팅하여 유효한지 확인할 수 있습니다.

이 함수는 connect(const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type) 와 같은 방식으로 작동하지만 QMetaMethod 을 사용하여 신호와 메서드를 지정합니다.

connect(const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)도 참조하세요 .

[static] QMetaObject::Connection QObject::connect(const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type = Qt::AutoConnection)

sender 객체의 signal 에서 receiver 객체의 method 로의 지정된 type 연결을 생성합니다. 나중에 연결을 끊는 데 사용할 수 있는 연결에 대한 핸들을 반환합니다.

예를 들어 signal 및 method 을 지정할 때는 SIGNAL() 및 SLOT() 매크로를 사용해야 합니다:

QLabel *label = new QLabel;
QScrollBar *scrollBar = new QScrollBar;
QObject::connect(scrollBar, SIGNAL(valueChanged(int)),
                 label,  SLOT(setNum(int)));

이 예에서는 레이블에 항상 현재 스크롤 막대 값이 표시되도록 합니다. 신호 및 슬롯 매개변수에는 변수 이름을 포함해서는 안 되며 유형만 포함해야 합니다. 예를 들어 다음은 작동하지 않고 거짓을 반환합니다:

// WRONG
QObject::connect(scrollBar, SIGNAL(valueChanged(int value)),
                 label, SLOT(setNum(int value)));

신호는 다른 신호에 연결할 수도 있습니다:

class MyWidget : public QWidget
{
    Q_OBJECT

public:
    MyWidget();

signals:
    void buttonClicked();

private:
    QPushButton *myButton;
};

MyWidget::MyWidget()
{
    myButton = new QPushButton(this);
    connect(myButton, SIGNAL(clicked()),
            this, SIGNAL(buttonClicked()));
}

이 예제에서 MyWidget 생성자는 개인 멤버 변수의 신호를 릴레이하고 MyWidget 과 관련된 이름으로 사용할 수 있도록 합니다.

하나의 신호는 여러 슬롯과 신호에 연결할 수 있습니다. 하나의 슬롯에 여러 개의 신호를 연결할 수 있습니다.

신호가 여러 슬롯에 연결된 경우 신호가 방출될 때 연결한 순서와 동일한 순서로 슬롯이 활성화됩니다.

이 함수는 신호를 슬롯에 성공적으로 연결하면 연결 핸들을 나타내는 QMetaObject::Connection 을 반환합니다. 예를 들어 QObject 에서 signal 또는 method 의 존재를 확인할 수 없거나 서명이 호환되지 않는 경우와 같이 연결을 만들 수 없는 경우 연결 핸들은 유효하지 않습니다. 핸들을 부울로 캐스팅하여 핸들이 유효한지 확인할 수 있습니다.

기본적으로 모든 연결에 대해 하나의 신호가 전송되며, 중복 연결의 경우 두 개의 신호가 전송됩니다. disconnect () 호출 한 번으로 이러한 모든 연결을 끊을 수 있습니다. Qt::UniqueConnection type 을 전달하면 중복 연결이 아닌 경우에만 연결이 이루어집니다. 이미 중복(동일한 객체의 동일한 슬롯에 정확히 동일한 신호)이 있는 경우 연결이 실패하고 잘못된 QMetaObject::Connection 을 반환합니다.

선택적 type 매개변수는 설정할 연결 유형을 설명합니다. 특히 특정 신호를 슬롯에 즉시 전달할지 아니면 나중에 전달하기 위해 대기열에 넣을지를 결정합니다. 신호가 큐에 대기 중인 경우, 매개변수는 Qt의 메타 객체 시스템에 알려진 유형이어야 합니다. 왜냐하면 Qt는 인수를 복사하여 백그라운드에서 이벤트에 저장해야 하기 때문입니다. 큐에 대기 중인 연결을 사용하려고 할 때 오류 메시지가 표시되는 경우

QObject::connect: Cannot queue arguments of type 'MyType'
(Make sure 'MyType' is registered using qRegisterMetaType().)

오류 메시지가 표시되면 연결을 설정하기 전에 qRegisterMetaType()를 호출하여 데이터 유형을 등록하세요.

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

disconnect(), sender(), qRegisterMetaType(), Q_DECLARE_METATYPE() 및 문자열 기반 연결과 함수 기반 연결의 차이점도참조하세요 .

[static] template <typename PointerToMemberFunction, typename Functor> QMetaObject::Connection QObject::connect(const QObject *sender, PointerToMemberFunction signal, Functor functor)

이 함수는 connect()를 오버로드합니다.

sender 객체의 signal 에서 functor 로의 연결을 생성하고 연결에 대한 핸들을 반환합니다.

신호는 헤더에 신호로 선언된 함수여야 합니다. 슬롯 함수는 신호에 연결할 수 있는 모든 함수나 함수가 될 수 있습니다. 신호에 슬롯 함수만큼의 인수가 있는 경우 슬롯 함수를 주어진 신호에 연결할 수 있습니다. 신호와 슬롯의 해당 인자 유형 사이에 암시적 변환이 존재해야 합니다.

예시:

void someFunction();
QPushButton *button = new QPushButton;
QObject::connect(button, &QPushButton::clicked, someFunction);

람다 표현식도 사용할 수 있습니다:

QByteArray page = ...;
QTcpSocket *socket = new QTcpSocket;
socket->connectToHost("qt-project.org", 80);
QObject::connect(socket, &QTcpSocket::connected, [=] () {
        socket->write("GET " + page + "\r\n");
    });

발신자가 파괴되면 연결이 자동으로 끊어집니다. 그러나 신호가 방출될 때 함수 내에서 사용된 모든 객체가 여전히 살아있어야 한다는 점에 주의해야 합니다.

따라서 QObject 를 수신자/컨텍스트로 사용하는 connect()의 오버로드를 사용하는 것이 좋습니다. QT_NO_CONTEXTLESS_CONNECT 매크로를 정의하여 컨텍스트 없는 오버로드의 사용을 비활성화할 수 있습니다.

과부하된 함수는 qOverload 을 통해 해결할 수 있습니다.

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

QMetaObject::Connection QObject::connect(const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type = Qt::AutoConnection) const

이 함수는 connect()를 오버로드합니다.

sender 객체에서 이 객체의 method 로 signal 를 연결합니다.

connect(sender, signal, this, method, type)와 동일합니다.

모든 연결은 신호를 방출하므로 중복 연결은 두 개의 신호를 방출합니다. disconnect ()를 사용하여 연결을 끊을 수 있습니다.

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

disconnect()도 참조하세요 .

[static] template <typename PointerToMemberFunction, typename Functor> QMetaObject::Connection QObject::connect(const QObject *sender, PointerToMemberFunction signal, const QObject *context, Functor functor, Qt::ConnectionType type = Qt::AutoConnection)

이 함수는 connect()를 오버로드합니다.

sender 객체의 signal 에서 functor 로의 지정된 type 연결을 생성하여 context 의 특정 이벤트 루프에 배치하고 연결에 대한 핸들을 반환합니다.

신호는 헤더에 신호로 선언된 함수여야 합니다. 슬롯 함수는 신호에 연결할 수 있는 모든 함수나 함수가 될 수 있습니다. 신호에 슬롯 함수만큼의 인수가 있는 경우 슬롯 함수를 주어진 신호에 연결할 수 있습니다. 신호와 슬롯의 해당 인자 유형 사이에 암시적 변환이 존재해야 합니다.

예시:

void someFunction();
QPushButton *button = new QPushButton;
QObject::connect(button, &QPushButton::clicked, this, someFunction, Qt::QueuedConnection);

람다 표현식도 사용할 수 있습니다:

QByteArray page = ...;
QTcpSocket *socket = new QTcpSocket;
socket->connectToHost("qt-project.org", 80);
QObject::connect(socket, &QTcpSocket::connected, this, [=] () {
        socket->write("GET " + page + "\r\n");
    }, Qt::AutoConnection);

발신자 또는 컨텍스트가 파괴되면 연결이 자동으로 끊어집니다. 하지만 신호가 방출될 때 함수 내에서 사용된 모든 객체가 여전히 살아있는지 주의해야 합니다.

과부하된 함수는 qOverload 의 도움을 받아 해결할 수 있습니다.

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

[static] template <typename PointerToMemberFunction> QMetaObject::Connection QObject::connect(const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method, Qt::ConnectionType type = Qt::AutoConnection)

이 함수는 connect()를 오버로드합니다.

sender 객체의 signal 에서 receiver 객체의 method 로의 지정된 type 연결을 생성합니다. 나중에 연결을 끊는 데 사용할 수 있는 연결에 대한 핸들을 반환합니다.

신호는 헤더에 신호로 선언된 함수여야 합니다. 슬롯 함수는 신호에 연결할 수 있는 모든 멤버 함수가 될 수 있습니다. 신호에 슬롯 수만큼의 인수가 있고 신호와 슬롯에 해당하는 인수의 유형 사이에 암시적 변환이 있는 경우 슬롯을 주어진 신호에 연결할 수 있습니다.

예시:

QLabel *label = new QLabel;
QLineEdit *lineEdit = new QLineEdit;
QObject::connect(lineEdit, &QLineEdit::textChanged,
                 label,  &QLabel::setText);

이 예는 라벨에 항상 현재 줄 편집 텍스트가 표시되도록 합니다.

하나의 신호는 여러 슬롯과 신호에 연결할 수 있습니다. 하나의 슬롯에 여러 개의 신호를 연결할 수 있습니다.

신호가 여러 슬롯에 연결된 경우 신호가 방출될 때 연결한 순서와 동일한 순서로 슬롯이 활성화됩니다.

이 함수는 신호를 슬롯에 성공적으로 연결하면 연결 핸들을 반환합니다. 예를 들어 QObject 가 signal 의 존재를 확인할 수 없는 경우(신호로 선언되지 않은 경우)와 같이 연결을 만들 수 없는 경우 연결 핸들은 유효하지 않습니다. QMetaObject::Connection 를 부울로 캐스팅하여 유효한지 확인할 수 있습니다.

기본적으로 모든 연결에 대해 하나의 신호가 전송되며, 중복 연결의 경우 두 개의 신호가 전송됩니다. disconnect () 호출 한 번으로 이러한 모든 연결을 끊을 수 있습니다. Qt::UniqueConnection type 을 전달하면 중복 연결이 아닌 경우에만 연결이 이루어집니다. 이미 중복(동일한 객체의 동일한 슬롯에 정확히 동일한 신호)이 있는 경우 연결이 실패하고 잘못된 QMetaObject::Connection 을 반환합니다.

선택 사항인 type 매개변수는 설정할 연결 유형을 설명합니다. 특히 특정 신호가 슬롯에 즉시 전달되는지 아니면 나중에 전달하기 위해 대기열에 추가되는지를 결정합니다. 신호가 큐에 대기 중인 경우, 매개변수는 Qt의 메타 객체 시스템에 알려진 유형이어야 합니다. 왜냐하면 Qt는 인수를 복사하여 백그라운드에서 이벤트에 저장해야 하기 때문입니다. 큐에 대기 중인 연결을 사용하려고 할 때 오류 메시지가 표시되는 경우

QObject::connect: Cannot queue arguments of type 'MyType'
(Make sure 'MyType' is registered using qRegisterMetaType().)

로 인자 유형을 선언해야 합니다. Q_DECLARE_METATYPE

오버로드된 함수는 qOverload 를 사용하여 해결할 수 있습니다.

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

문자열 기반 연결과 함수 기반 연결의 차이점도참조하세요 .

[virtual protected] void QObject::connectNotify(const QMetaMethod &signal)

이 가상 함수는 이 객체에서 signal 에 무언가가 연결되었을 때 호출됩니다.

signal 을 특정 신호와 비교하려면 다음과 같이 QMetaMethod::fromSignal()을 사용할 수 있습니다:

if (signal == QMetaMethod::fromSignal(&MyObject::valueChanged)) {
    // signal is valueChanged
}

connect() 및 disconnectNotify()도 참조하세요 .

[virtual protected] void QObject::customEvent(QEvent *event)

이 이벤트 핸들러는 하위 클래스에서 다시 구현하여 사용자 정의 이벤트를 수신할 수 있습니다. 사용자 정의 이벤트는 QEvent::Type 열거형의 QEvent::User 항목만큼 큰 유형 값을 가진 사용자 정의 이벤트로, 일반적으로 QEvent 서브클래스입니다. 이벤트는 event 매개변수로 전달됩니다.

event() 및 QEvent 을참조하세요 .

[slot] void QObject::deleteLater()

이 객체를 삭제하도록 예약합니다.

제어가 이벤트 루프로 돌아갈 때 객체가 삭제됩니다. 이 함수가 호출될 때 이벤트 루프가 실행되고 있지 않은 경우(예: QCoreApplication::exec() 이전에 개체에서 deleteLater()가 호출된 경우), 이벤트 루프가 시작되면 개체가 삭제됩니다. 메인 이벤트 루프가 중지된 후에 deleteLater()가 호출되면 객체는 삭제되지 않습니다. 실행 중인 이벤트 루프가 없는 스레드에 있는 객체에서 deleteLater()가 호출되면 스레드가 완료되면 객체가 삭제됩니다.

새 이벤트 루프에 들어갔다가 나오는 경우(예: 모달 대화 상자를 여는 경우)에는 지연된 삭제가 수행되지 않으며, 개체를 삭제하려면 컨트롤이 deleteLater()가 호출된 이벤트 루프로 돌아와야 한다는 점에 유의하세요. 이는 이전의 중첩된 이벤트 루프가 아직 실행 중일 때 삭제된 객체에는 적용되지 않습니다: Qt 이벤트 루프는 새로운 중첩된 이벤트 루프가 시작되자마자 해당 객체를 삭제합니다.

Qt가 QCoreApplication::exec() 또는 QEventLoop::exec()를 통해 이벤트 디스패처를 구동하지 않는 상황에서는 지연된 삭제가 자동으로 처리되지 않습니다. 이 시나리오에서 지연된 삭제를 보장하기 위해 다음 해결 방법을 사용할 수 있습니다:

const auto *eventDispatcher = QThread::currentThread()->eventDispatcher();
QObject::connect(eventDispatcher, &QAbstractEventDispatcher::aboutToBlock,
    QThread::currentThread(), []{
        if (QThread::currentThread()->loopLevel() == 0)
            QCoreApplication::sendPostedEvents(nullptr, QEvent::DeferredDelete);
    }
);

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

destroyed() 및 QPointer 을참조하세요 .

[signal] void QObject::destroyed(QObject *obj = nullptr)

이 신호는 obj 개체가 소멸되기 직전, QPointer 인스턴스가 통지된 후 즉시 발신되며 차단할 수 없습니다.

이 신호가 전송된 후 모든 객체의 하위 객체는 즉시 소멸됩니다.

deleteLater() 및 QPointer도 참조하세요 .

[static] bool QObject::disconnect(const QMetaObject::Connection &connection)

연결을 끊습니다.

connection 주소가 유효하지 않거나 이미 연결이 끊어진 경우 아무 작업도 수행하지 않고 false를 반환합니다.

connect()도 참조하세요 .

[static] bool QObject::disconnect(const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)

객체 sender 의 method 에서 객체 receiver 의 signal 연결을 끊습니다. 연결이 성공적으로 끊어지면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

이 함수는 disconnect(const QObject *sender, const char *signal, const QObject *receiver, const char *method) 과 동일한 가능성을 제공하지만 QMetaMethod 을 사용하여 연결을 끊을 신호와 메서드를 나타냅니다.

또한 이 함수는 다음과 같은 경우 거짓을 반환하고 연결이 끊어진 신호와 슬롯이 없습니다:

1. signal 발신자 클래스 또는 그 부모 클래스의 멤버가 아닌 경우.
2. method 수신자 클래스 또는 그 부모 클래스의 멤버가 아닌 경우.
3. signal 인스턴스는 신호가 아님을 나타냅니다.

불일치를 방지하려면 connect()에서 반환한 연결 핸들을 저장하고 disconnect() 호출에 사용하세요.

QMetaMethod()는 "모든 신호" 또는 "수신 객체의 모든 슬롯"이라는 의미로 와일드카드로 사용할 수 있습니다. 같은 방식으로 nullptr 는 "모든 수신 객체"라는 의미로 receiver 에 사용할 수 있습니다. 이 경우 메서드도 QMetaMethod()여야 합니다. sender 매개변수는 절대 nullptr 이 아니어야 합니다.

disconnect(const QObject *sender, const char *signal, const QObject *receiver, const char *method)도 참조하세요 .

[static] bool QObject::disconnect(const QObject *sender, const char *signal, const QObject *receiver, const char *method)

객체 sender 의 method 에서 객체 receiver 의 signal 연결을 끊습니다. 연결이 성공적으로 끊어지면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

관련된 객체 중 하나가 파괴되면 신호 슬롯 연결이 제거됩니다.

disconnect()는 일반적으로 다음 예시에서 볼 수 있듯이 세 가지 방식으로 사용됩니다.

1. 객체의 신호에 연결된 모든 연결을 끊습니다:

   disconnect(myObject, nullptr, nullptr, nullptr);

   비정적 오버로드 함수와 동일하게

   myObject->disconnect();

2. 특정 신호에 연결된 모든 것을 연결 해제합니다:

   disconnect(myObject, SIGNAL(mySignal()), nullptr, nullptr);

   비정적 과부하 기능과 동등함.

   myObject->disconnect(SIGNAL(mySignal()));

3. 특정 수신기 연결 해제:

   disconnect(myObject, nullptr, myReceiver, nullptr);

   비정적 과부하 기능과 동등함

   myObject->disconnect(myReceiver);

불일치를 방지하려면 connect()에서 반환한 연결 핸들을 저장하고 disconnect() 호출에 사용하세요.

nullptr 는 각각 "모든 신호", "모든 수신 대상" 또는 "수신 대상의 모든 슬롯"을 의미하는 와일드카드로 사용할 수 있습니다.

sender 은 nullptr 이 될 수 없습니다(한 번의 호출로 두 개 이상의 객체에서 신호 연결을 끊을 수 없습니다).

signal 이 nullptr 인 경우 receiver 및 method 을 모든 신호에서 연결 해제합니다. 그렇지 않으면 지정된 신호만 연결이 끊어집니다.

receiver 가 nullptr 인 경우 signal 에 연결된 모든 연결을 끊습니다. 그렇지 않은 경우 receiver 이외의 객체의 슬롯은 연결이 끊어지지 않습니다.

method 가 nullptr 인 경우 receiver 에 연결된 모든 것을 연결 해제합니다. 그렇지 않은 경우 method 라는 이름의 슬롯만 연결 해제되고 다른 모든 슬롯은 그대로 유지됩니다. receiver 이 빠진 경우 method 은 nullptr 이어야 하므로 모든 개체의 특정 이름의 슬롯을 연결 해제할 수 없습니다.

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

connect()도 참조하세요 .

bool QObject::disconnect(const QObject *receiver, const char *method = nullptr) const

이 함수는 disconnect()를 오버로드합니다.

receiver 의 method 에서 이 객체의 모든 신호 연결을 끊습니다.

불일치를 방지하려면 connect()에서 반환한 연결 핸들을 저장하고 disconnect() 호출에 사용하세요.

관련된 객체 중 하나가 파괴되면 신호 슬롯 연결이 제거됩니다.

bool QObject::disconnect(const char *signal = nullptr, const QObject *receiver = nullptr, const char *method = nullptr) const

이 함수는 disconnect()에 과부하를 줍니다.

receiver 의 method 에서 signal 의 연결을 끊습니다.

불일치를 방지하려면 connect()에서 반환한 연결 핸들을 저장하고 disconnect() 호출에 사용하세요.

관련된 객체 중 하나가 파괴되면 신호 슬롯 연결이 제거됩니다.

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

[static] template <typename PointerToMemberFunction> bool QObject::disconnect(const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method)

이 함수는 disconnect()를 오버로드합니다.

sender 객체의 method 에서 receiver 객체의 signal 연결을 끊습니다. 연결이 성공적으로 끊어지면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

관련된 객체 중 하나가 파괴되면 신호 슬롯 연결이 제거됩니다.

disconnect()는 일반적으로 다음 예시에서 볼 수 있듯이 세 가지 방식으로 사용됩니다.

1. 객체의 신호에 연결된 모든 연결을 끊습니다:

   disconnect(myObject, nullptr, nullptr, nullptr);

2. 특정 신호에 연결된 모든 연결을 끊습니다:

   disconnect(myObject, &MyObject::mySignal(), nullptr, nullptr);

3. 특정 수신기 연결 해제: 특정 수신기 연결 해제:

   disconnect(myObject, nullptr, myReceiver, nullptr);

4. 특정 신호에서 특정 슬롯으로 연결된 연결을 끊습니다:

   QObject::disconnect(lineEdit, &QLineEdit::textChanged,
                    label,  &QLabel::setText);

nullptr 는 각각 "모든 신호", "모든 수신 대상" 또는 "수신 대상의 모든 슬롯"을 의미하는 와일드카드로 사용할 수 있습니다.

sender 은 nullptr 이 될 수 없습니다(한 번의 호출로 두 개 이상의 객체에서 신호를 끊을 수 없습니다).

signal 이 nullptr 인 경우 receiver 및 method 을 모든 신호에서 연결 해제합니다. 그렇지 않으면 지정된 신호만 연결이 끊어집니다.

receiver 가 nullptr 인 경우 signal 에 연결된 모든 연결을 끊습니다. 그렇지 않은 경우 지정된 수신기의 슬롯만 연결이 끊어집니다. disconnect()에 널이 아닌 receiver 을 사용하면 컨텍스트 객체로 receiver 와 연결되었던 슬롯 함수도 연결이 끊어집니다.

method 가 nullptr 인 경우 receiver 에 연결된 모든 슬롯의 연결을 끊습니다. 그렇지 않은 경우 method 라는 이름의 슬롯만 연결이 끊어지고 다른 모든 슬롯은 그대로 유지됩니다. receiver 이 생략된 경우 method 은 nullptr 이어야 하므로 모든 개체의 특정 이름의 슬롯을 연결 해제할 수 없습니다.

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

connect()도 참조하세요 .

[virtual protected] void QObject::disconnectNotify(const QMetaMethod &signal)

이 가상 함수는 이 객체에서 signal 에서 연결이 끊어졌을 때 호출됩니다.

signal 을 특정 신호와 비교하는 방법에 대한 예는 connectNotify()를 참조하세요.

이 객체에서 모든 신호가 연결이 끊어진 경우(예: disconnect()의 신호 인수가 nullptr), disconnectNotify()는 한 번만 호출되고 signal 는 잘못된 QMetaMethod (QMetaMethod::isValid()는 false)를 반환합니다.

disconnect() 및 connectNotify()도 참조하세요 .

void QObject::dumpObjectInfo() const

이 객체에 대한 신호 연결 등에 대한 정보를 디버그 출력에 덤프합니다.

dumpObjectTree()도 참조하십시오 .

void QObject::dumpObjectTree() const

자식 트리를 디버그 출력에 덤프합니다.

dumpObjectInfo()도 참조하십시오 .

QList<QByteArray> QObject::dynamicPropertyNames() const

setProperty()를 사용하여 객체에 동적으로 추가한 모든 프로퍼티의 이름을 반환합니다.

[virtual] bool QObject::event(QEvent *e)

이 가상 함수는 객체에 대한 이벤트를 수신하고 e 이벤트가 인식되어 처리된 경우 true를 반환해야 합니다.

event() 함수를 다시 구현하여 객체의 동작을 사용자 지정할 수 있습니다.

처리하지 않은 모든 이벤트에 대해 상위 이벤트 클래스 구현을 호출해야 합니다.

예시:

class MyClass : public QWidget
{
    Q_OBJECT

public:
    MyClass(QWidget *parent = nullptr);
    ~MyClass();

    bool event(QEvent* ev) override
    {
        if (ev->type() == QEvent::PolishRequest) {
            // overwrite handling of PolishRequest if any
            doThings();
            return true;
        } else  if (ev->type() == QEvent::Show) {
            // complement handling of Show if any
            doThings2();
            QWidget::event(ev);
            return true;
        }
        // Make sure the rest of events are handled
        return QWidget::event(ev);
    }
};

installEventFilter(), timerEvent(), QCoreApplication::sendEvent() 및 QCoreApplication::postEvent()도 참조하세요 .

[virtual] bool QObject::eventFilter(QObject *watched, QEvent *event)

이 개체가 watched 개체에 대한 이벤트 필터로 설치된 경우 이벤트를 필터링합니다.

이 함수를 다시 구현할 때 event 을 필터링하여 더 이상 처리되지 않도록 하려면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

예시:

class MainWindow : public QMainWindow
{public: MainWindow();protected: bool eventFilter(QObject*obj, QEvent *ev) override;private:    QTextEdit *textEdit; }; MainWindow::MainWindow() { textEdit = new QTextEdit; setCentralWidget(textEdit);  textEdit->installEventFilter(this); }bool MainWindow::eventFilter(QObject*obj, QEvent *event) { if (obj== textEdit) { if (event->type()== QEvent::KeyPress) { QKeyEvent *keyEvent =  static_cast<QKeyEvent*>(event);            qDebug() << "Ate key press" << keyEvent->key();
           반환 참; } else { 반환 거짓; } } else { // 이벤트를 부모 클래스에 전달 반환 QMainWindow::eventFilter(obj, event); } }

위 예제에서 처리되지 않은 이벤트가 베이스 클래스의 eventFilter() 함수로 전달되는 것을 볼 수 있는데, 이는 베이스 클래스가 자체 내부 용도로 eventFilter()를 재구현했을 수 있기 때문입니다.

QEvent::ShortcutOverride 같은 일부 이벤트는 전파를 방지하기 위해 accept()를 호출하여 명시적으로 수락해야 합니다.

installEventFilter()도 참조하십시오 .

template <typename T> T QObject::findChild(QAnyStringView name, Qt::FindChildOptions options = Qt::FindChildrenRecursively) const

이 객체의 자식 중 T형으로 형변환할 수 있고 name 또는 그러한 객체가 없는 경우 nullptr 을 반환합니다. null name 인수는 모든 객체를 일치시킵니다. 널이 아닌 비어 있는 name 은 objectName 이 비어 있는 객체만 일치시킵니다. options 에서 FindDirectChildrenOnly 옵션을 지정하지 않는 한 검색은 재귀적으로 수행됩니다.

검색과 일치하는 자식이 두 개 이상 있는 경우 가장 직접적인 조상이 반환됩니다. 가장 직계 자식이 여러 개 있는 경우 children()의 첫 번째 자식이 반환됩니다. 이 경우 findChildren()를 사용하여 모든 하위 항목의 전체 목록을 가져오는 것이 좋습니다.

이 예에서는 버튼이 부모의 직계 자식이 아니더라도 parentWidget 의 "button1" 라는 자식 QPushButton 을 반환합니다:

QPushButton *button = parentWidget->findChild<QPushButton *>("button1");

이 예는 parentWidget 의 QListWidget 자식을 반환합니다:

QListWidget *list = parentWidget->findChild<QListWidget *>();

이 예는 parentWidget (직접 부모)의 "button1" 라는 이름의 QPushButton 자식을 반환합니다:

QPushButton *button = parentWidget->findChild<QPushButton *>("button1", Qt::FindDirectChildrenOnly);

이 예는 직접 부모인 parentWidget 의 QListWidget 자식을 반환합니다:

QListWidget *list = parentWidget->findChild<QListWidget *>(Qt::FindDirectChildrenOnly);

findChildren()도 참조하십시오 .

[since 6.7] template <typename T> T QObject::findChild(Qt::FindChildOptions options = Qt::FindChildrenRecursively) const

이 함수는 오버로드된 함수입니다.

T 유형으로 형변환할 수 있는 이 객체의 자식을 반환하거나, 그러한 객체가 없는 경우 nullptr 을 반환합니다. options 에서 FindDirectChildrenOnly 옵션을 지정하지 않는 한 검색은 재귀적으로 수행됩니다.

검색과 일치하는 자식이 두 개 이상 있는 경우 가장 직접적인 조상이 반환됩니다. 가장 직계 자식이 여러 개 있는 경우 children()의 첫 번째 자식이 반환됩니다. 이 경우 findChildren()를 사용하여 모든 자식의 전체 목록을 가져오는 것이 좋습니다.

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

findChildren()도 참조하세요 .

template <typename T> QList<T> QObject::findChildren(QAnyStringView name, Qt::FindChildOptions options = Qt::FindChildrenRecursively) const

이 객체의 모든 자식 중 T 타입으로 형 변환할 수 있는 name 을 반환하거나, 그러한 객체가 없는 경우 빈 리스트를 반환합니다. name 인수가 널이면 모든 객체가 일치하고, 빈이면 objectName 이 비어 있는 객체만 일치합니다. options 에서 FindDirectChildrenOnly 옵션을 지정하지 않는 한 검색은 재귀적으로 수행됩니다.

다음 예는 지정된 parentWidget 이라는 이름의 widgetname 의 하위 QWidget목록을 찾는 방법을 보여줍니다:

QList<QWidget *> widgets = parentWidget.findChildren<QWidget *>("widgetname");

이 예는 parentWidget 의 자식인 모든 QPushButton을 반환합니다:

QList<QPushButton *> allPButtons = parentWidget.findChildren<QPushButton *>();

이 예는 parentWidget 의 직계 자식인 QPushButton을 모두 반환합니다:

QList<QPushButton *> childButtons = parentWidget.findChildren<QPushButton *>(Qt::FindDirectChildrenOnly);

findChild()도 참조하십시오 .

[since 6.3] template <typename T> QList<T> QObject::findChildren(Qt::FindChildOptions options = Qt::FindChildrenRecursively) const

이것은 오버로드된 함수입니다.

이 객체의 모든 자식 중 T형으로 형변환할 수 있는 객체를 반환하거나, 그러한 객체가 없는 경우 빈 목록을 반환합니다. options 에서 FindDirectChildrenOnly 옵션을 지정하지 않는 한 검색은 재귀적으로 수행됩니다.

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

findChild()도 참조하십시오 .

template <typename T> QList<T> QObject::findChildren(const QRegularExpression &re, Qt::FindChildOptions options = Qt::FindChildrenRecursively) const

이 함수는 findChildren()을 오버로드합니다.

이 객체의 자식 중 T 유형으로 캐스팅할 수 있고 정규식 re 과 일치하는 이름을 가진 객체를 반환하거나 그러한 객체가 없는 경우 빈 목록을 반환합니다. options 에서 FindDirectChildrenOnly 옵션을 지정하지 않는 한 검색은 재귀적으로 수행됩니다.

bool QObject::inherits(const char *className) const

className이 객체가 className 을 상속하는 클래스의 인스턴스이거나 QObject 을 상속하는 서브클래스인 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

클래스는 자신을 상속하는 것으로 간주됩니다.

예시:

QTimer *timer = new QTimer;         // QTimer inherits QObject
timer->inherits("QTimer");          // returns true
timer->inherits("QObject");         // returns true
timer->inherits("QAbstractButton"); // returns false

// QVBoxLayout inherits QObject and QLayoutItem
QVBoxLayout *layout = new QVBoxLayout;
layout->inherits("QObject");        // returns true
layout->inherits("QLayoutItem");    // returns true (even though QLayoutItem is not a QObject)

객체를 캐스팅하기 위해 객체가 특정 클래스의 인스턴스인지 확인해야 하는 경우 qobject_cast<Type *>(object)를 대신 사용하는 것이 좋습니다.

metaObject() 및 qobject_cast()도 참조하세요 .

void QObject::installEventFilter(QObject *filterObj)

이 개체에 이벤트 필터 filterObj 를 설치합니다. 예를 들어

monitoredObj->installEventFilter(filterObj);

이벤트 필터는 이 개체로 전송되는 모든 이벤트를 수신하는 개체입니다. 필터는 이벤트를 중지하거나 이 개체로 전달할 수 있습니다. 이벤트 필터 filterObj 는 eventFilter() 함수를 통해 이벤트를 수신합니다. eventFilter () 함수는 이벤트를 필터링(즉, 중지)해야 하는 경우 참을 반환해야 하며, 그렇지 않으면 거짓을 반환해야 합니다.

하나의 개체에 여러 개의 이벤트 필터가 설치되어 있는 경우 가장 마지막에 설치된 필터가 먼저 활성화됩니다.

filterObj 이 개체에 대해 이미 설치되어 있는 경우 이 함수는 이 개체를 이동하여 마지막에 설치된 것처럼 작동합니다.

다음은 모니터링되는 객체의 키 누름을 수집하는 KeyPressEater 클래스입니다:

class KeyPressEater : public QObject
{ Q_OBJECT .. .protected: bool eventFilter(QObject*obj, QEvent *event) override; };bool KeyPressEater::eventFilter(QObject*obj, QEvent *event) { if (event->type()==. QEvent::KeyPress) { QKeyEvent *keyEvent =  static_cast<QKeyEvent *>(event);        qDebug("Ate key press %d", keyEvent->key());
       return true; } else { // 표준 이벤트 처리 반환 QObject::eventFilter(obj, event); } }

두 위젯에 설치하는 방법은 다음과 같습니다:

KeyPressEater *keyPressEater = new KeyPressEater(this);
QPushButton *pushButton = new QPushButton(this);
QListView *listView = new QListView(this);

pushButton->installEventFilter(keyPressEater);
listView->installEventFilter(keyPressEater);

예를 들어 QShortcut 클래스는 이 기술을 사용하여 단축키 누름을 가로챕니다.

필터링 객체는 이 객체와 동일한 스레드에 있어야 합니다. filterObj 이 다른 스레드에 있으면 이 함수는 아무 작업도 수행하지 않습니다. 이 함수를 호출한 후 filterObj 또는 이 객체가 다른 스레드로 이동하면 두 객체가 다시 동일한 스레드 선호도를 가질 때까지 이벤트 필터가 호출되지 않습니다( 제거되지 않음 ).

removeEventFilter(), eventFilter() 및 event()도 참조하세요 .

[since 6.4] bool QObject::isQuickItemType() const

객체가 QQuickItem 인 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

이 함수를 호출하는 것은 inherits("QQuickItem") 을 호출하는 것과 동일하지만 훨씬 빠릅니다.

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

[protected] bool QObject::isSignalConnected(const QMetaMethod &signal) const

signal 이 하나 이상의 수신기에 연결되어 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

signal 는 이 객체의 시그널 멤버여야 하며, 그렇지 않으면 동작이 정의되지 않습니다.

static const QMetaMethod valueChangedSignal = QMetaMethod::fromSignal(&MyObject::valueChanged);
if (isSignalConnected(valueChangedSignal)) {
    QByteArray data;
    data = get_the_value();       // expensive operation
    emit valueChanged(data);
}

위의 코드 스니펫에서 볼 수 있듯이 이 함수를 사용하면 초기화 비용이 많이 들거나 아무도 듣지 않는 신호를 방출하는 것을 피할 수 있습니다. 그러나 멀티스레드 애플리케이션에서는 이 함수가 반환된 후 신호가 방출되기 전에 연결이 변경될 수 있습니다.

bool QObject::isWidgetType() const

객체가 위젯인 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

이 함수를 호출하는 것은 inherits("QWidget") 을 호출하는 것과 동일하지만 훨씬 빠릅니다.

bool QObject::isWindowType() const

객체가 창인 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

이 함수를 호출하는 것은 inherits("QWindow") 을 호출하는 것과 동일하지만 훨씬 빠릅니다.

void QObject::killTimer(int id)

타이머 식별자 id 로 타이머를 종료합니다.

타이머 식별자는 타이머 이벤트가 시작되면 startTimer()에 의해 반환됩니다.

timerEvent() 및 startTimer()도 참조하세요 .

[since 6.8] void QObject::killTimer(Qt::TimerId id)

이 함수는 오버로드된 함수입니다.

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

[virtual] const QMetaObject *QObject::metaObject() const

이 객체의 메타 객체에 대한 포인터를 반환합니다.

메타 객체에는 클래스 이름, 슈퍼클래스 이름, 속성, 시그널 및 슬롯 등 QObject 을 상속하는 클래스에 대한 정보가 포함됩니다. Q_OBJECT 매크로를 포함하는 모든 QObject 하위 클래스에는 메타 객체가 있습니다.

메타 객체 정보는 신호/슬롯 연결 메커니즘과 프로퍼티 시스템에서 필요합니다. inherits () 함수 역시 메타 객체를 사용합니다.

실제 객체 인스턴스에 대한 포인터가 없지만 클래스의 메타 객체에 액세스하려는 경우 staticMetaObject 을 사용할 수 있습니다.

예시:

QObject *obj = new QPushButton;
obj->metaObject()->className();             // returns "QPushButton"

QPushButton::staticMetaObject.className();  // returns "QPushButton"

staticMetaObject 를참조하세요 .

bool QObject::moveToThread(QThread *targetThread)

이 객체와 그 자식에 대한 스레드 선호도를 변경하고 성공하면 true 을 반환합니다. 객체에 부모가 있는 경우 객체를 이동할 수 없습니다. 이벤트 처리는 targetThread 에서 계속됩니다.

개체를 메인 스레드로 이동하려면 QApplication::instance()를 사용하여 현재 애플리케이션에 대한 포인터를 검색한 다음 QApplication::thread()를 사용하여 애플리케이션이 있는 스레드를 검색합니다. 예를 들어

myObject->moveToThread(QApplication::instance()->thread());

targetThread 가 nullptr 인 경우 이 객체와 그 자식에 대한 모든 이벤트 처리는 더 이상 스레드와 연결되지 않으므로 중지됩니다.

개체에 대한 모든 활성 타이머가 재설정됩니다. 타이머는 먼저 현재 스레드에서 중지되었다가 targetThread 에서 동일한 간격으로 다시 시작됩니다. 따라서 스레드 간에 개체를 계속 이동하면 타이머 이벤트가 무기한 연기될 수 있습니다.

스레드 선호도가 변경되기 직전에 QEvent::ThreadChange 이벤트가 이 객체로 전송됩니다. 이 이벤트를 처리하여 특별한 처리를 수행할 수 있습니다. 이 객체에 게시되는 모든 새 이벤트는 nullptr 이 아닌 경우 targetThread 에서 처리되며, nullptr 인 경우 더 이상 스레드와 연결되지 않으므로 이 객체 또는 그 자식에 대한 이벤트 처리가 이루어질 수 없음을 유의하세요.

thread()도 참조하세요 .

[private signal] void QObject::objectNameChanged(const QString &objectName)

이 신호는 객체의 이름이 변경된 후에 발생합니다. 새 객체 이름은 objectName 로 전달됩니다.

QObject::objectName도 참조하세요 .

QObject *QObject::parent() const

부모 객체에 대한 포인터를 반환합니다.

setParent() 및 children()도 참조하세요 .

QVariant QObject::property(const char *name) const

객체의 name 속성 값을 반환합니다.

해당 프로퍼티가 존재하지 않으면 반환된 변형은 유효하지 않습니다.

사용 가능한 모든 프로퍼티에 대한 정보는 metaObject() 및 dynamicPropertyNames()를 통해 제공됩니다.

setProperty(), QVariant::isValid(), metaObject() 및 dynamicPropertyNames()도 참조하세요 .

[protected] int QObject::receivers(const char *signal) const

signal 에 연결된 수신기 수를 반환합니다.

슬롯과 신호 모두 신호의 수신기로 사용할 수 있고 동일한 연결을 여러 번 할 수 있으므로 수신기 수는 이 신호의 연결 수와 동일합니다.

이 함수를 호출할 때 SIGNAL() 매크로를 사용하여 특정 신호를 전달할 수 있습니다:

if (receivers(SIGNAL(valueChanged(QByteArray))) > 0) {
    QByteArray data;
    get_the_value(&data);       // expensive operation
    emit valueChanged(data);
}

isSignalConnected()도 참조하세요 .

void QObject::removeEventFilter(QObject *obj)

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

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

이벤트 필터 활성화 중(예: eventFilter() 함수에서)에도 이벤트 필터를 제거하는 것이 항상 안전합니다.

installEventFilter(), eventFilter() 및 event()도 참조하세요 .

[protected] QObject *QObject::sender() const

신호에 의해 활성화된 슬롯에서 호출된 경우 신호를 보낸 객체에 대한 포인터를 반환하고, 그렇지 않으면 nullptr 을 반환합니다. 포인터는 이 객체의 스레드 컨텍스트에서 이 함수를 호출하는 슬롯이 실행되는 동안에만 유효합니다.

발신자가 소멸되거나 슬롯이 발신자의 신호에서 연결이 끊어지면 이 함수가 반환하는 포인터는 유효하지 않게 됩니다.

senderSignalIndex()도 참조하세요 .

[protected] int QObject::senderSignalIndex() const

sender()가 반환하는 클래스의 멤버인 현재 실행 중인 슬롯을 호출한 신호의 메타 메서드 인덱스를 반환합니다. 신호에 의해 활성화된 슬롯 외부에서 호출되면 -1이 반환됩니다.

기본 매개변수가 있는 신호의 경우, 이 함수는 connect()와 함께 사용된 매개변수에 관계없이 항상 모든 매개변수가 포함된 인덱스를 반환합니다. 예를 들어 destroyed(QObject *obj = \nullptr) 신호는 매개변수가 있는 경우와 없는 경우 두 개의 다른 인덱스가 있지만 이 함수는 항상 매개변수가 있는 인덱스를 반환합니다. 다른 파라미터를 사용하여 신호를 오버로드할 때는 적용되지 않습니다.

sender(), QMetaObject::indexOfSignal() 및 QMetaObject::method()도 참조하세요 .

void QObject::setObjectName(const QString &name)

객체의 이름을 name 로 설정합니다.

objectName()도 참조하세요 .

[since 6.4] void QObject::setObjectName(QAnyStringView name)

이 함수는 오버로드된 함수입니다.

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

void QObject::setParent(QObject *parent)

객체를 parent 의 자식으로 만듭니다.

parent() 및 children()도 참조하세요 .

bool QObject::setProperty(const char *name, const QVariant &value)

객체의 name 속성 값을 value 으로 설정합니다.

속성이 Q_PROPERTY 을 사용하여 클래스에서 정의된 경우 성공하면 참을 반환하고 그렇지 않으면 거짓을 반환합니다. 속성이 Q_PROPERTY 를 사용하여 정의되지 않아 메타 객체에 나열되지 않은 경우 동적 속성으로 추가되고 false가 반환됩니다.

사용 가능한 모든 속성에 대한 정보는 metaObject() 및 dynamicPropertyNames()을 통해 제공됩니다.

동적 속성은 property()를 사용하여 다시 쿼리할 수 있으며 속성 값을 유효하지 않은 QVariant 으로 설정하여 제거할 수 있습니다. 동적 속성 값을 변경하면 QDynamicPropertyChangeEvent 이 개체에 전송됩니다.

참고: "_q_"로 시작하는 동적 프로퍼티는 내부용으로 예약되어 있습니다.

property(), metaObject(), dynamicPropertyNames() 및 QMetaProperty::write()도 참조하세요 .

[since 6.6] bool QObject::setProperty(const char *name, QVariant &&value)

이 함수는 setProperty를 오버로드합니다.

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

[noexcept] bool QObject::signalsBlocked() const

신호가 차단된 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

신호는 기본적으로 차단되지 않습니다.

blockSignals() 및 QSignalBlocker 을참조하세요 .

int QObject::startTimer(int interval, Qt::TimerType timerType = Qt::CoarseTimer)

이것은 timerType 유형의 타이머와 interval 밀리초의 타임아웃을 시작하는 오버로드된 함수입니다. 이는 호출과 동일합니다:

startTimer(std::chrono::milliseconds{interval}, timerType);

timerEvent(), killTimer(), QChronoTimer, 및 QBasicTimer도 참조하세요 .

int QObject::startTimer(std::chrono::nanoseconds interval, Qt::TimerType timerType = Qt::CoarseTimer)

과부하가 걸린 기능입니다.

타이머를 시작하고 타이머 식별자를 반환하거나 타이머를 시작할 수 없는 경우 0을 반환합니다.

타이머 이벤트는 killTimer()가 호출될 때까지 매 interval 마다 발생합니다. interval 이 std::chrono::duration::zero() 과 같으면 처리할 창 시스템 이벤트가 더 이상 없을 때마다 타이머 이벤트가 한 번씩 발생합니다.

가상 timerEvent() 함수는 타이머 이벤트가 발생하면 QTimerEvent 이벤트 매개변수 클래스와 함께 호출됩니다. 타이머 이벤트를 가져오려면 이 함수를 다시 구현하세요.

여러 타이머가 실행 중인 경우 QTimerEvent::id() 메서드를 사용하여 어떤 타이머가 활성화되었는지 확인할 수 있습니다.

예시:

class MyObject : public QObject
{ Q_OBJECTpublic: MyObject(QObject *parent = nullptr);protected: void timerEvent(QTimerEvent *event) override; }; MyObject::MyObject(QObject *부모) : QObject(parent) { using namespace std::chrono_literals; startTimer(50ms); startTimer(5s); startTimer(10min); startTimer(1h); }void MyObject::timerEvent(QTimerEvent *event){
    qDebug() << "Timer ID:" << event->id();

타이머의 정확도는 기본 운영 체제 및 하드웨어에 따라 달라질 수 있습니다.

timerType 인수를 사용하면 타이머의 정확도를 사용자 지정할 수 있습니다. 다양한 타이머 유형에 대한 자세한 내용은 Qt::TimerType 을 참조하세요. 대부분의 플랫폼은 20밀리초의 정확도를 지원하며, 일부 플랫폼은 더 높은 정확도를 제공합니다. Qt가 요청된 타이머 이벤트 수를 전달할 수 없는 경우, 일부 이벤트는 자동으로 삭제됩니다.

QTimer 및 QChronoTimer 클래스는 이벤트 대신 싱글샷 타이머와 타이머 신호를 사용하는 높은 수준의 프로그래밍 인터페이스를 제공합니다. QChronoTimer 보다 더 가볍지만 타이머 ID를 직접 사용하는 것보다 덜 서투른 QBasicTimer 클래스도 있습니다.

    QObject *obj;
    ...
    const auto id = Qt::TimerId{obj->startTimer(100ms)};
    if (id != Qt::TimerId::Invalid)
        // The timer has been started successfully

timerEvent(), killTimer(), QChronoTimer, 및 QBasicTimer도 참조하세요 .

QThread *QObject::thread() const

객체가 있는 스레드를 반환합니다.

moveToThread()도 참조하세요 .

[virtual protected] void QObject::timerEvent(QTimerEvent *event)

이 이벤트 핸들러는 서브클래스에서 재구현하여 객체에 대한 타이머 이벤트를 수신할 수 있습니다.

QChronoTimer 는 타이머 기능에 대한 상위 수준의 인터페이스와 타이머에 대한 보다 일반적인 정보를 제공합니다. 타이머 이벤트는 event 매개변수로 전달됩니다.

startTimer(), killTimer() 및 event()도 참조하세요 .

[static] QString QObject::tr(const char *sourceText, const char *disambiguation = nullptr, int n = -1)

선택적으로 disambiguation 문자열과 복수가 포함된 문자열의 경우 n 값을 기반으로 sourceText 의 번역 버전을 반환하고, 적절한 번역 문자열이 없는 경우 QString::fromUtf8(sourceText)을 반환합니다.

예:

void SpreadSheet::setupMenuBar()
{
    QMenu *fileMenu = menuBar()->addMenu(tr("&File"));
    ...

동일한 sourceText 이 동일한 컨텍스트 내에서 다른 역할에 사용되는 경우 추가 식별 문자열이 disambiguation (기본값은nullptr )으로 전달될 수 있습니다.

예:

MyWindow::MyWindow()
{
    QLabel *senderLabel = new QLabel(tr("Name:"));
    QLabel *recipientLabel = new QLabel(tr("Name:", "recipient"));
    ...

Qt의 번역 메커니즘 전반에 대한 자세한 설명은 번역을 위한 소스 코드 작성하기를, 모호성 해소에 대한 정보는 동일 텍스트 모호성 해 소를 참조하십시오.

QCoreApplication::translate() 및 Qt XML로 국제화를참조하십시오 .