openshot-audio
0.1.6
|
#include <juce_DialogWindow.h>
Public Member Functions | |
LaunchOptions () noexcept | |
DialogWindow * | launchAsync () |
DialogWindow * | create () |
Public Attributes | |
String | dialogTitle |
Colour | dialogBackgroundColour |
OptionalScopedPointer< Component > | content |
Component * | componentToCentreAround |
bool | escapeKeyTriggersCloseButton |
bool | useNativeTitleBar |
bool | resizable |
bool | useBottomRightCornerResizer |
This class defines a collection of settings to be used to open a DialogWindow.
The easiest way to open a DialogWindow is to create yourself a LaunchOptions structure, initialise its fields with the appropriate details, and then call its launchAsync() method to launch the dialog.
|
noexcept |
DialogWindow * DialogWindow::LaunchOptions::create | ( | ) |
Creates a new DialogWindow instance with these settings. This method simply creates the window, it doesn't run it modally. In most cases you'll want to use launchAsync() or runModal() instead.
DialogWindow * DialogWindow::LaunchOptions::launchAsync | ( | ) |
Launches a new modal dialog window. This will create a dialog based on the settings in this structure, launch it modally, and return immediately. The window that is returned will be automatically deleted when the modal state is terminated.
When the dialog's close button is clicked, it'll automatically terminate its modal state, but you can also do this programmatically by calling exitModalState (returnValue) on the DialogWindow.
If your content component needs to find the dialog window that it is contained in, a quick trick is to do this:
Component* DialogWindow::LaunchOptions::componentToCentreAround |
If this is not a nullptr, it indicates a component that you'd like to position this dialog box in front of. See the DocumentWindow::centreAroundComponent() method for more info about this parameter.
OptionalScopedPointer<Component> DialogWindow::LaunchOptions::content |
The content component to show in the window. This must not be null! Using an OptionalScopedPointer to hold this pointer lets you indicate whether you'd like the dialog to automatically delete the component when the dialog has terminated.
Colour DialogWindow::LaunchOptions::dialogBackgroundColour |
The background colour for the window.
String DialogWindow::LaunchOptions::dialogTitle |
The title to give the window.
bool DialogWindow::LaunchOptions::escapeKeyTriggersCloseButton |
If true, then the escape key will trigger the dialog's close button.
bool DialogWindow::LaunchOptions::resizable |
If true, the window will be resizable. See ResizableWindow::setResizable()
bool DialogWindow::LaunchOptions::useBottomRightCornerResizer |
Indicates whether to use a border or corner resizer component. See ResizableWindow::setResizable()
bool DialogWindow::LaunchOptions::useNativeTitleBar |
If true, the dialog will use a native title bar. See TopLevelWindow::setUsingNativeTitleBar()