QML-тип DialogHeader

Заголовок для использования в типе Dialog. Подробнее…

Строка импорта:	import Sailfish.Silica 1.0
Наследуется от:	BackgroundItem

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

Свойства

• acceptText : string
• background : bool
• cancelText : string
• defaultAcceptText : string
• defaultCancelText : string
• dialog : Item
• divider : bool
• extraContent : Item
• leftMargin : real
• monochrome : bool
• reserveExtraContent : bool
• rightMargin : real
• spacing : real
• title : string

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

Тип DialogHeader реализует заголовок в стиле ОС Аврора для использования в типе Dialog.

В заголовке отображаются кнопки «Подтвердить» и «Отменить», при нажатии на которые диалог может быть принят или отклонён. Заголовок страницы может быть добавлен ниже области заголовка с помощью свойства title.

Например:

import QtQuick 2.2
import Sailfish.Silica 1.0

ApplicationWindow {
    initialPage: Component {
        Page {
            Button {
                text: "Удалить файл"
                anchors.centerIn: parent
                onClicked: pageStack.push(dialog)
            }
        }
    }

    Component {
        id: dialog

        Dialog {
            DialogHeader {
                id: header
                title: "Подтвердить удаление"
            }
            Label {
                text: "Действительно удалить этот файл?"
                anchors.top: header.bottom
                x: Theme.horizontalPageMargin
                color: Theme.highlightColor
            }
        }
    }
}

См. также Dialog.

Описание свойств

acceptText : string

Содержит текст, отображаемый в правой части заголовка.

По умолчанию значение данного свойства привязано к значению свойства defaultAcceptText.

См. также defaultAcceptText.

background : bool

Определяет, включён ли фон кнопок заголовка диалогового окна. При истинном значении фон заголовка диалогового окна становится видимым. Значение по умолчанию: false.

cancelText : string

Содержит текст, отображаемый в правой части заголовка.

См. также defaultCancelText.

defaultAcceptText : string

Содержит значение по умолчанию для свойства acceptText. Значение данного свойства является локализованным переводом «Подтвердить».

defaultCancelText : string

Содержит значение по умолчанию для свойства cancelText. Значение данного свойства является локализованным переводом «Отменить».

dialog : Item

Указывает на объект типа Dialog, к которому будет добавлен DialogHeader.

Если свойство dialog не задано, то заголовок будет применен к ближайшему родителю типа Dialog.

divider : bool

Определяет видимость линии между кнопками действий и заголовком.

Значение по умолчанию: true.

extraContent : Item

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

См. также reserveExtraContent.

leftMargin : real

Отступ между левым краем заголовка и его содержимым. Значение по умолчанию: Theme.horizontalPageMargin.

monochrome : bool

Определяет, является ли цвет фона заголовка диалогового окна монохромным. При истинном значении цвет фона заголовка диалогового окна становится монохромным, в противном случае — цветным. Свойство работает только в том случае, если DialogHeader::background имеет значение true. Значение по умолчанию: false.

reserveExtraContent : bool

Если данное свойство принимает значение true, то резервируется место в заголовке диалога для элемента extraContent. Обычно кнопки «Отменить» и «Подтвердить» занимают всё доступное пространство. Если свойство reserveExtraContent истинно, то кнопки отмены и принятия не будут использовать больше места, чем необходимо для отображения своих меток. По умолчанию данное свойство имеет значение true, если extraContent имеет один или несколько дочерних элементов.

См. также extraContent.

rightMargin : real

Отступ между левым краем заголовка и его содержимым. Значение по умолчанию: Theme.horizontalPageMargin.

spacing : real

Резервирует пространство под заголовком. По умолчанию используется значение Theme.paddingLarge, которое является рекомендуемым пробелом между заголовком и содержимым диалога.

title : string

Содержит название диалога.