Custom dialog boxes

A Dialog is used to interrupt the UI flow when you want to display an alarm or an alert message. A Dialog is a full-screen view that is displayed as a transparent layer on top of the current screen.

A Dialog is part of the Cascades framework, so you can customize it in QML. You can build a Dialog using Cascades Control objects, such as a Container or Button.

When you display a Dialog, any other UI components are visible but the user can't touch them. If the Dialog occupies the same space as the other UI components, the other UI components are dimmed.

Multiple Dialog objects can also be layered over one another, with the most recent dialog box displayed on top.

Screen showing a Cascades custom dialog alarm on a device.

A dialog box is a modal window; users must provide a response before they can continue to interact with the UI. Depending on where you position your dialog box, this effect might not be apparent to your user. You should always layer your dialog box over your UI components so that the other UI components are dimmed.

To download the code sample that demonstrates how to create a custom dialog box in QML, see the Cascades QML Cookbook sample in GitHub. To learn how to create a custom dialog box in C++, see the Cascades C++ Cookbook sample in GitHub. You can also follow a tutorial that teaches you how to create a custom dialog box and attach it to your UI.

Last modified: 2015-03-31

Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus