DialogButtonBox QML Type
ダイアログで使用されるボタンボックス。もっと見る...
Import Statement: | import QtQuick.Controls |
Inherits: |
プロパティ
- alignment : flags
- buttonLayout : enumeration
(since QtQuick.Controls 2.5 (Qt 5.12))
- delegate : Component
- position : enumeration
- standardButtons : enumeration
付属プロパティ
- buttonBox : DialogButtonBox
- buttonRole : enumeration
シグナル
- accepted()
- applied()
(since QtQuick.Controls 2.3 (Qt 5.10))
- clicked(AbstractButton button)
- discarded()
(since QtQuick.Controls 2.3 (Qt 5.10))
- helpRequested()
- rejected()
- reset()
(since QtQuick.Controls 2.3 (Qt 5.10))
メソッド
- AbstractButton standardButton(StandardButton button)
詳細説明
ダイアログやメッセージボックスは通常、そのプラットフォームのインターフェースガイドラインに従った順序でボタンを表示します。異なるプラットフォームでは、ダイアログ・ボタンの並び順が異なることがよくあります。DialogButtonBoxでは、開発者がボタンを追加することができ、ユーザーのプラットフォームに適した順序を自動的に使用します。
ダイアログのほとんどのボタンは、特定の役割に従います。そのような役割には次のようなものがあります:
- ダイアログを受け入れるか拒否するか。
- 助けを求める。
- ダイアログ自体に対するアクションの実行(フィールドのリセットや変更の適用など)。
破壊的な結果を引き起こす可能性のある、ダイアログを却下する別の方法もありえます。
ほとんどのダイアログには、ほとんど標準的といえるボタンがあります(例えば、OK やCancel ボタン)。これらのボタンを標準的な方法で作成すると便利なことがあります。
DialogButtonBoxを使うにはいくつかの方法があります。一つは標準的なボタン(例:OK 、Cancel 、Save )を指定し、ボタンボックスにボタンを設定させる方法です。
DialogButtonBox { standardButtons: DialogButtonBox.Ok | DialogButtonBox.Cancel onAccepted: console.log("Ok clicked") onRejected: console.log("Cancel clicked") }
あるいは、ボタンとその役割を手で指定することもできます:
DialogButtonBox { Button { text: qsTr("Save") DialogButtonBox.buttonRole: DialogButtonBox.AcceptRole } Button { text: qsTr("Close") DialogButtonBox.buttonRole: DialogButtonBox.DestructiveRole } }
通常のボタンと標準的なボタンを混ぜて使うこともできます。
ボタンボックスでボタンがクリックされると、実際に押されたボタンに対してclicked() シグナルが発せられます。さらに、それぞれの役割を持つボタンが押されると、以下のシグナルが自動的に発せられます:
役割 | シグナル |
---|---|
AcceptRole ,YesRole | accepted() |
ApplyRole | applied() |
DiscardRole | discarded() |
HelpRole | helpRequested() |
RejectRole ,NoRole | rejected() |
ResetRole | reset() |
Dialogも参照 。
プロパティの説明
alignment : flags |
このプロパティは、ボタンの配置を保持する。
取り得る値
定数 | 説明 |
---|---|
Qt.AlignLeft | ボタンは左に配置される。 |
Qt.AlignHCenter | ボタンは水平に中央に配置されます。 |
Qt.AlignRight | ボタンは右揃えになります。 |
Qt.AlignTop | ボタンは上側に並んでいます。 |
Qt.AlignVCenter | ボタンは垂直中央に配置されます。 |
Qt.AlignBottom | ボタンは下に配置されます。 |
デフォルトでは、特定の整列は設定されていません。alignmentプロパティを読み取ると、0と比較されるデフォルトのフラグ値が得られます。このプロパティは、undefined
を代入することでこの値にリセットすることができます。この場合、ボタンは利用可能なスペースを埋めるようにリサイズされます。
注: このプロパティは、ボタンの水平レイアウトを前提としています。iOSスタイルを実行する場合、このプロパティがundefined
以外に設定され、ボタンが2つ以上ある場合、DialogButtonBox は垂直レイアウトを使用することに注意してください。それ以外の場合、ボタンは水平に配置されます。
buttonLayout : enumeration |
このプロパティは、ボタンボックスに含まれるボタンを配置する際に使用するボタンレイアウトポリシーを保持します。デフォルト値はプラットフォーム固有です。
利用可能な値
定数 | 説明 |
---|---|
DialogButtonBox.WinLayout | Windows 上のアプリケーションに適したポリシーを使用します。 |
DialogButtonBox.MacLayout | macOS 上のアプリケーションに適したポリシーを使用する。 |
DialogButtonBox.KdeLayout | KDE 上のアプリケーションに適したポリシーを使用する。 |
DialogButtonBox.GnomeLayout | GNOME上のアプリケーションに適切なポリシーを使用する。 |
DialogButtonBox.AndroidLayout | Android 上のアプリケーションに適したポリシーを使用する。 |
このプロパティは、QtQuick.Controls 2.5 (Qt 5.12) で導入されました。
delegate : Component |
このプロパティは、標準ボタンを作成するためのデリゲートを保持します。
standardButtonsも参照してください 。
position : enumeration |
このプロパティは、ボタンボックスの位置を保持します。
注: ボタンボックスがApplicationWindow または Page のヘッダーまたはフッターとして割り当てられている場合、適切な位置が自動的に設定されます。
指定可能な値
定数 | 説明 |
---|---|
DialogButtonBox.Header | ボタンボックスは、ウィンドウまたはページのヘッダーとして、一番上にあります。 |
DialogButtonBox.Footer | ボタ ンボ ッ ク スは、 ウ ィ ン ド ウ ま たはページ フ ッ タ と し て下端に配置 さ れます。 |
デ フ ォ ル ト 値はFooter
です。
Dialog::header とDialog::footerも参照してください 。
standardButtons : enumeration |
こ のプ ロ パテ ィ は、 ボ タ ン ボ ッ ク ス で用い ら れ る 標準ボ タ ンの組み合わせを保持 し ます。
DialogButtonBox { standardButtons: DialogButtonBox.Ok | DialogButtonBox.Cancel onAccepted: console.log("Ok clicked") onRejected: console.log("Cancel clicked") }
ボタンはユーザーのプ ラ ッ ト フ ォームにあわせて適切な順序で配置 さ れます。
可能なフラグ
定数 | 説明 |
---|---|
DialogButtonBox.Ok | AcceptRole で定義された "OK "ボタン。 |
DialogButtonBox.Open | AcceptRole で定義された「開く」ボタン。 |
DialogButtonBox.Save | AcceptRole で定義された「保存」ボタン。 |
DialogButtonBox.Cancel | RejectRole で定義された「キャンセル」ボタン。 |
DialogButtonBox.Close | RejectRole で定義された「閉じる」ボタン。 |
DialogButtonBox.Discard | プラットフォームによって異なるが、DestructiveRole で定義された「破棄」または「保存しない」ボタン。 |
DialogButtonBox.Apply | ApplyRole 。 |
DialogButtonBox.Reset | ResetRole で定義された「リセット」ボタン。 |
DialogButtonBox.RestoreDefaults | ResetRole で定義されている「デフォルトに戻す」ボタン。 |
DialogButtonBox.Help | HelpRole で定義された「ヘルプ」ボタン。 |
DialogButtonBox.SaveAll | AcceptRole で定義された「すべて保存」ボタン。 |
DialogButtonBox.Yes | YesRole で定義された「はい」ボタン。 |
DialogButtonBox.YesToAll | YesRole で定義された「Yes to All」ボタン。 |
DialogButtonBox.No | NoRole で定義された「いいえ」ボタン。 |
DialogButtonBox.NoToAll | NoRole で定義された「No to All」ボタン。 |
DialogButtonBox.Abort | RejectRole で定義された「中止」ボタン。 |
DialogButtonBox.Retry | AcceptRole で定義される「再試行」ボタン。 |
DialogButtonBox.Ignore | AcceptRole で定義された「無視」ボタン。 |
DialogButtonBox.NoButton | 無効なボタン。 |
standardButton()も参照のこと 。
Attached プロパティの説明
DialogButtonBox.buttonBox : DialogButtonBox |
この Attached プロパティは、このボタンを管理するボタンボックスを保持し、ボタンがボタンボックス内にない場合はnull
を保持する。
DialogButtonBox.buttonRole : enumeration |
この Attached プロパティは、ボタンボックス内の各ボタンの役割を保持します。
DialogButtonBox { Button { text: qsTr("Save") DialogButtonBox.buttonRole: DialogButtonBox.AcceptRole } Button { text: qsTr("Close") DialogButtonBox.buttonRole: DialogButtonBox.DestructiveRole } }
利用可能な値
定数 | 説明 |
---|---|
DialogButtonBox.InvalidRole | ボタンは無効です。 |
DialogButtonBox.AcceptRole | ボタンをクリックすると、ダイアログが受理されます(例:OK )。 |
DialogButtonBox.RejectRole | ボタンをクリックすると、ダイアログは拒否されます(例:Cancel)。 |
DialogButtonBox.DestructiveRole | ボタンをクリックすると、破壊的変更(変更の破棄など)が行われ、ダイアログが閉じます。 |
DialogButtonBox.ActionRole | ボタンをクリックすると、ダイアログ内の要素が変更されます。 |
DialogButtonBox.HelpRole | ボタンをクリックすると、ヘルプを要求することができます。 |
DialogButtonBox.YesRole | ボタンは "Yes "のようなボタンです。 |
DialogButtonBox.NoRole | ボタンは "No "のようなボタンです。 |
DialogButtonBox.ResetRole | ボタンはダイアログのフィールドをデフォルト値にリセットします。 |
DialogButtonBox.ApplyRole | ボタンは現在の変更を適用する。 |
シグナルの説明
accepted() |
このシグナルは、AcceptRole
またはYesRole
で定義されたボタンがクリックされたときに発せられます。
注意: 対応するハンドラはonAccepted
です。
rejected()、clicked()、helpRequested()も参照してください 。
|
clicked(AbstractButton button) |
このシグナルは、ボタンボックス内のbutton がクリックされたときに発せられます。
注: 対応するハンドラはonClicked
です。
accepted()、rejected()、helpRequested()も 参照。
|
helpRequested() |
rejected() |
このシグナルは、RejectRole
またはNoRole
で定義されたボタンがクリックされたときに発せられます。
注: 対応するハンドラはonRejected
です。
accepted()、helpRequested()、clicked()も参照 。
|
メソッド・ドキュメント
AbstractButton standardButton(StandardButton button) |
指定された標準のbutton を返し、存在しない場合はnull
を返します。
standardButtonsも参照してください 。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。