#include <juce_PreferencesPanel.h>
Private Member Functions | |
| void | clickedPage () |
Private Attributes | |
| String | currentPageName |
| std::unique_ptr< Component > | currentPage |
| OwnedArray< DrawableButton > | buttons |
| int | buttonSize |
Detailed Description
A component with a set of buttons at the top for changing between pages of preferences.
This is just a handy way of writing a Mac-style preferences panel where you have a row of buttons along the top for the different preference categories, each button having an icon above its name. Clicking these will show an appropriate prefs page below it.
You can either put one of these inside your own component, or just use the showInDialogBox() method to show it in a window and run it modally.
To use it, just add a set of named pages with the addSettingsPage() method, and implement the createComponentForPage() method to create suitable components for each of these pages.
@tags{GUI}
Constructor & Destructor Documentation
◆ PreferencesPanel()
| juce::PreferencesPanel::PreferencesPanel | ( | ) |
Creates an empty panel.
Use addSettingsPage() to add some pages to it in your constructor.
◆ ~PreferencesPanel()
|
override |
Destructor.
Member Function Documentation
◆ addSettingsPage() [1/2]
| void juce::PreferencesPanel::addSettingsPage | ( | const String & | pageTitle, |
| const Drawable * | normalIcon, | ||
| const Drawable * | overIcon, | ||
| const Drawable * | downIcon ) |
Creates a page using a set of drawables to define the page's icon.
Note that the other version of this method is much easier if you're using an image instead of a custom drawable.
- Parameters
-
pageTitle the name of this preferences page - you'll need to make sure your createComponentForPage() method creates a suitable component when it is passed this name normalIcon the drawable to display in the page's button normally overIcon the drawable to display in the page's button when the mouse is over downIcon the drawable to display in the page's button when the button is down
- See also
- DrawableButton
◆ addSettingsPage() [2/2]
| void juce::PreferencesPanel::addSettingsPage | ( | const String & | pageTitle, |
| const void * | imageData, | ||
| int | imageDataSize ) |
Creates a page using a set of drawables to define the page's icon.
The other version of this method gives you more control over the icon, but this one is much easier if you're just loading it from a file.
- Parameters
-
pageTitle the name of this preferences page - you'll need to make sure your createComponentForPage() method creates a suitable component when it is passed this name imageData a block of data containing an image file, e.g. a jpeg, png or gif. For this to look good, you'll probably want to use a nice transparent png file. imageDataSize the size of the image data, in bytes
◆ clickedPage()
|
private |
◆ createComponentForPage()
|
pure virtual |
Subclasses must override this to return a component for each preferences page.
The subclass should return a pointer to a new component representing the named page, which the panel will then display.
The panel will delete the component later when the user goes to another page or deletes the panel.
◆ getButtonSize()
|
noexcept |
Returns the size of the buttons shown along the top.
◆ paint()
Components can override this method to draw their content.
The paint() method gets called when a region of a component needs redrawing, either because the component's repaint() method has been called, or because something has happened on the screen that means a section of a window needs to be redrawn.
Any child components will draw themselves over whatever this method draws. If you need to paint over the top of your child components, you can also implement the paintOverChildren() method to do this.
If you want to cause a component to redraw itself, this is done asynchronously - calling the repaint() method marks a region of the component as "dirty", and the paint() method will automatically be called sometime later, by the message thread, to paint any bits that need refreshing. In JUCE (and almost all modern UI frameworks), you never redraw something synchronously.
You should never need to call this method directly - to take a snapshot of the component you could use createComponentSnapshot() or paintEntireComponent().
- Parameters
-
g the graphics context that must be used to do the drawing operations.
- See also
- repaint, paintOverChildren, Graphics
Reimplemented from juce::Component.
◆ resized()
|
overridevirtual |
Called when this component's size has been changed.
A component can implement this method to do things such as laying out its child components when its width or height changes.
The method is called synchronously as a result of the setBounds or setSize methods, so repeatedly changing a components size will repeatedly call its resized method (unlike things like repainting, where multiple calls to repaint are coalesced together).
If the component is a top-level window on the desktop, its size could also be changed by operating-system factors beyond the application's control.
- See also
- moved, setSize
Reimplemented from juce::Component.
◆ setButtonSize()
Changes the size of the buttons shown along the top.
◆ setCurrentPage()
Changes the current page being displayed.
◆ showInDialogBox()
| void juce::PreferencesPanel::showInDialogBox | ( | const String & | dialogTitle, |
| int | dialogWidth, | ||
| int | dialogHeight, | ||
| Colour | backgroundColour = Colours::white ) |
Utility method to display this panel in a DialogWindow.
Calling this will create a DialogWindow containing this panel with the given size and title, and will run it modally, returning when the user closes the dialog box.
Member Data Documentation
◆ buttons
|
private |
◆ buttonSize
|
private |
◆ currentPage
|
private |
◆ currentPageName
|
private |
The documentation for this class was generated from the following files:
- /home/runner/work/lmms-fork/lmms-fork/plugins/CarlaBase/carla/source/modules/juce_gui_extra/misc/juce_PreferencesPanel.h
- /home/runner/work/lmms-fork/lmms-fork/plugins/CarlaBase/carla/source/modules/juce_gui_extra/misc/juce_PreferencesPanel.cpp
Generated on for LMMS by
1.16.1