Тип действия QML

Action предоставляет абстрактное действие пользовательского интерфейса, которое может быть привязано к элементам. Подробнее...

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

Свойства

• checkable : bool
• checked : bool
• enabled : bool
• exclusiveGroup : ExclusiveGroup
• iconName : строка
• iconSource : url
• shortcut : keysequence
• text : строка
• tooltip : строка

Сигналы

• toggled(checked)
• triggered(QObject *source)

Методы

• void trigger(QObject *source)

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

Во многих приложениях многие общие команды могут быть вызваны через меню, кнопки на панели инструментов и сочетания клавиш. Поскольку пользователь ожидает, что каждая команда будет выполняться одинаковым образом, независимо от используемого пользовательского интерфейса, полезно представлять каждую команду как действие.

Действие может быть привязано к пункту меню и кнопке на панели инструментов, и они будут автоматически синхронизироваться. Например, в текстовом процессоре, если пользователь нажимает кнопку «Полужирный» на панели инструментов, пункт меню «Полужирный» будет автоматически помечен.

QtQuick Controls поддерживает действия в Button, ToolButton и MenuItem.

    ...
    Action {
        id: copyAction
        text: "&Copy"
        shortcut: StandardKey.Copy
        iconName: "edit-copy"
        enabled: (!!activeFocusItem && !!activeFocusItem["copy"])
        onTriggered: activeFocusItem.copy()
    }

    Action {
        id: cutAction
        text: "Cu&t"
        shortcut: StandardKey.Cut
        iconName: "edit-cut"
        enabled: (!!activeFocusItem && !!activeFocusItem["cut"])
        onTriggered: activeFocusItem.cut()
    }

    Action {
        id: pasteAction
        text: "&Paste"
        shortcut: StandardKey.Paste
        iconName: "edit-paste"
        enabled: (!!activeFocusItem && !!activeFocusItem["paste"])
        onTriggered: activeFocusItem.paste()
    }

    toolBar: ToolBar {
        RowLayout {
            anchors.fill: parent
            anchors.margins: spacing
            Label {
                text: UI.label
            }
            Item { Layout.fillWidth: true }
            CheckBox {
                id: enabler
                text: "Enabled"
                checked: true
            }
        }
    }

    menuBar: MenuBar {
        Menu {
            title: "&File"
            MenuItem {
                text: "E&xit"
                shortcut: StandardKey.Quit
                onTriggered: Qt.quit()
            }
        }
        Menu {
            title: "&Edit"
            visible: tabView.currentIndex == 2
            MenuItem { action: cutAction }
            MenuItem { action: copyAction }
            MenuItem { action: pasteAction }
        }
        Menu {
            title: "&Help"
            MenuItem {
                text: "About..."
                onTriggered: aboutDialog.open()
            }
        }
    }
    ...

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

checkable : bool

Определяет, может ли пункт меню быть помечен или переключен. По умолчанию false.

См. также checked и exclusiveGroup.

checked : bool

Если действие checkable, это свойство отражает его состояние выбора. По умолчанию false. Его значение также равно false, когда checkable равно false.

См. также toggled и exclusiveGroup.

enabled : bool

Определяет, является ли действие активным и может ли оно быть выполнено. По умолчанию true.

См. также trigger() и triggered.

exclusiveGroup : ExclusiveGroup

Если действие checkable, к нему можно прикрепить ExclusiveGroup. Все действия, использующие одну и ту же группу исключения, становятся взаимно исключающими, что означает, что только последнее отмеченное действие фактически будет помечено.

По умолчанию null, что означает, что поведение исключения не ожидается.

См. также checkable и checked.

iconName : строка

Устанавливает имя значка для действия. Это выберет значок с заданным именем из текущей темы.

По умолчанию пустая строка.

Примечание: Это свойство требует QApplication.

iconSource : url

Устанавливает URL-адрес файла или ресурса значка для действия. По умолчанию пустой URL.

shortcut : keysequence

Сочетание клавиш, привязанное к действию. Keysequence может быть строкой или стандартной клавишей.

По умолчанию пустая строка.

Action {
    id: copyAction
    text: qsTr("&Copy")
    shortcut: StandardKey.Copy
}

text : строка

Текст для действия. Этот текст будет отображаться в качестве текста кнопки или в качестве заголовка в пункте меню.

Мемоники поддерживаются путем добавления префикса & к букве сочетания клавиш. Например, "\&Open" привяжет сочетание клавиш Alt-O к пункту меню "Open". Обратите внимание, что не все платформы поддерживают мемоники.

По умолчанию пустая строка.

tooltip : строка

Подсказка, которая будет отображаться при наведении указателя мыши на элемент управления, связанный с этим действием. Не все элементы управления поддерживают всплывающие подсказки на всех платформах, особенно MenuItem.

По умолчанию пустая строка.

Документация по сигналам

toggled(checked)

Вызывается всякий раз, когда свойство checked действия изменяется. Это обычно происходит одновременно с triggered.

Соответствующий обработчик onToggled.

triggered(QObject *source)

Вызывается, когда пункт меню или связанное с ним действие активированы. Включает объект, который инициировал событие, если это применимо (например, Button или MenuItem). Вам не нужно вызывать этот сигнал, вместо этого используйте trigger().

Соответствующий обработчик onTriggered.

Документация по методам

void trigger(QObject *source)

Вызовет сигнал triggered, если действие включено. Вы можете указать объект источника, если действие будет полезно знать источник запуска (например, для аналитики). Также вызовет сигнал toggled, если оно checkable.