Тип QML Connections

Описание обобщённых подключений к сигналам. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• enabled : bool
• ignoreUnknownSignals : bool
• target : Object

Подробное описание

Объект Connections создаёт подключение к QML-сигналу.

При подключении к сигналам в QML обычно создаётся обработчик «on<Signal>», реагирующий на получение сигнала, например так:

MouseArea {
    onClicked: { foo(parameters) }
}

Однако, в некоторых случаях, например, когда:

• Требуется несколько подключений к одному сигналу
• Создаются подключения вне области отправки сигнала
• Подключаются к целевым объектам, не определённым в QML

В этих случаях вместо этого можно использовать тип Connections.

Например, вышеприведённый код можно изменить, используя объект Connections, так:

MouseArea {
    Connections {
        onClicked: foo(parameters)
    }
}

В более общем случае, объект Connections может быть дочерним элементом любого объекта, отличного от отправителя сигнала:

MouseArea {
    id: area
}
// ...

Connections {
    target: area
    onClicked: foo(parameters)
}

См. также Qt QML.

Документация свойств

enabled : bool

Это свойство определяет, принимает ли элемент события изменения.

По умолчанию, это свойство true.

Это свойство было добавлено в Qt 5.7.

ignoreUnknownSignals : bool

Обычно, подключение к несуществующему сигналу приводит к ошибкам во время выполнения.

Если это свойство установлено в значение true, такие ошибки игнорируются. Это полезно, если вы планируете подключаться к различным типам объектов, обрабатывая разные наборы сигналов для каждого объекта.

target : Object

Это свойство содержит объект, отправляющий сигнал.

Если это свойство не установлено, target по умолчанию устанавливается в родителя Connection.

Если установлено в null, подключение не создаётся, и все обработчики сигналов игнорируются до тех пор, пока target не будет установлено не равным null.