Combined color chooser: a "Color" (HSV gradient + RGB/Hex entry + Save/Done) tab and a "Swatches" tab (saved palette + recent colors). More...

#include <Malena/Graphics/Controls/ColorChooser.h>

Inheritance diagram for ml::ColorChooser:

[legend]

Public Types
using	Flag = DraggableManifest::Flag
enum class	Layout { Tabbed , Stacked , GradientOnly , SwatchesOnly }
using	manifest_type
	The manifest type, used by `GatherFlags` and `GatherStates` to locate this class's flag and state declarations.
using	manifest_type
	The manifest type, used by `GatherFlags` and `GatherStates` to locate this class's flag and state declarations.
using	State = DraggableManifest::State
using	State
	The enum type this manager stores flags for.

Public Member Functions
	ColorChooser ()
void	addComponent (Core &child)
template<typename E, typename = std::enable_if_t<std::is_enum_v<E>>>
void	addComponent (Core &child, E layer)
	Register a child at a layer identified by any enum value.
void	addComponent (Core &child, int layer)
template<typename T>
void	addComponent (T &child, bool fill=false)
	Add a child component to this panel.
template<typename... Children>
void	addComponents (Children &... children)
	Register multiple child components at the default layer.
template<typename E, typename... Children, typename = std::enable_if_t<std::is_enum_v<E>>>
void	addComponents (E layer, Children &... children)
	Variadic shared-layer registration with an enum layer key.
template<typename... Children>
void	addComponents (int layer, Children &... children)
	Register multiple child components at a shared layer.
void	addRef (Core &child)
	Alias for `addUntracked()`. Kept for compatibility.
void	addUntracked (Core &child)
	Add a child that will NOT follow the panel when it moves.
template<class T>
void	center (T &obj)
	Center this object within `obj` (both axes).
template<class T>
void	centerHorizonally (T &obj)
	Center this object horizontally within `obj`.
void	centerText (sf::Text &obj)
	Center an `sf::Text` object within this object's bounds.
template<class T>
void	centerVertically (T &obj)
	Center this object vertically within `obj`.
bool	checkFlag (State state) const
	Return the current value of a flag.
void	clear ()
	Remove all child components from this panel.
void	clearDragBounds ()
	Remove any previously set drag bounds.
sf::Color	color () const
void	disableFlag (State state)
	Set a flag to `false`.
void	draw (sf::RenderTarget &target, sf::RenderStates states) const override
	Draw this graphic to an SFML render target.
void	enableFlag (State state)
	Set a flag to `true`.
unsigned int	getCornerPointCount () const
	Return the current per-corner vertex count.
Color	getFillColor () const
virtual Vector2f	getGeometricCenter () const
sf::FloatRect	getGlobalBounds () const override
	Return the axis-aligned bounding box in world space.
const Transform &	getInverseTransform () const
Layout	getLayout () const
FloatRect	getLocalBounds () const
Vector2f	getOrigin () const
Color	getOutlineColor () const
float	getOutlineThickness () const
virtual sf::Vector2f	getPoint (std::size_t index) const override
	Return the position of a single vertex.
virtual std::size_t	getPointCount () const override
	Return the total number of shape vertices.
sf::Vector2f	getPosition () const override
	Return the current world-space position.
float	getRadius () const
	Return the current corner arc radius.
virtual sf::RenderStates	getRenderStates () const
Angle	getRotation () const
Vector2f	getScale () const
const sf::Vector2f &	getSize () const
	Return the current size of the rectangle.
std::enable_if_t<!std::is_void_v< T >, T >	getState () const
	Return the current state value.
std::enable_if_t<!std::is_void_v< T >, T >	getState () const
	Return the current state value.
const Texture *	getTexture () const
const IntRect &	getTextureRect () const
const Transform &	getTransform () const
	Graphic ()
template<typename U>
	Graphic (const U &obj)
	Construct from an existing SFML object of type `U`.
bool	isEffectivelyVisible () const
	True only if this component and every ancestor are visible.
bool	isEnabled () const
bool	isOpen () const
bool	isScrolling ()
	Return `true` while a `moveTo` or `moveDistance` animation is in progress.
bool	isSettingsLocked () const
	Return `true` if `applySettings()` is currently blocked.
std::enable_if_t<!std::is_void_v< T >, bool >	isState (T state) const
	Return `true` if currently in `state`.
std::enable_if_t<!std::is_void_v< T >, bool >	isState (T state) const
	Return `true` if currently in `state`.
bool	isThemeLocked () const
	Return `true` if this component ignores theme changes.
bool	isVisible () const
void	lockSettings ()
	Prevent `applySettings()` from taking effect.
void	lockTheme ()
	Prevent automatic re-styling when the global theme changes.
void	move (Vector2f offset)
void	moveDistance (sf::Vector2f distance, float seconds=1.f)
	Animate by a relative offset from the current position.
void	moveTo (sf::FloatRect position, float seconds=1.f)
	Animate to a position defined by a `FloatRect` origin.
void	moveTo (sf::Vector2f position, float seconds=1.f)
	Animate to an absolute world-space position.
void	onBlur (std::function< void()> callback, bool overwrite=true)
	Register a no-argument callback invoked when this component loses keyboard focus.
void	onBlur (std::function< void(const std::optional< sf::Event > &)> callback, bool overwrite=true)
	Register a callback invoked when this component loses keyboard focus, receiving the raw SFML event.
void	onClick (std::function< void()> callback, bool overwrite=true)
	Register a no-argument callback invoked when this component is clicked.
void	onClick (std::function< void(const std::optional< sf::Event > &event)> callback, bool overwrite=true)
	Register a callback invoked when this component is clicked, receiving the raw SFML event.
void	onColorChanged (std::function< void(const sf::Color &)> cb)
void	onColorSelected (std::function< void(const sf::Color &)> cb)
void	onFocus (std::function< void()> callback, bool overwrite=true)
	Register a no-argument callback invoked when this component gains keyboard focus.
void	onFocus (std::function< void(const std::optional< sf::Event > &)> callback, bool overwrite=true)
	Register a callback invoked when this component gains keyboard focus, receiving the raw SFML event.
void	onHover (std::function< void()> callback, bool overwrite=true)
	Register a no-argument callback invoked when the mouse enters this component's bounds.
void	onHover (std::function< void(const std::optional< sf::Event > &event)> callback, bool overwrite=true)
	Register a callback invoked when the mouse enters this component's bounds, receiving the raw SFML event.
void	onKeypress (std::function< void()> callback, bool overwrite=true)
	Register a no-argument callback invoked when a key is pressed while this component has focus.
void	onKeypress (std::function< void(const std::optional< sf::Event > &)> callback, bool overwrite=true)
	Register a callback invoked when a key is pressed while this component has focus, receiving the raw SFML event.
void	onKeyRelease (std::function< void()> callback, bool overwrite=true)
	Register a no-argument callback invoked when a key is released while this component has focus.
void	onKeyRelease (std::function< void(const std::optional< sf::Event > &)> callback, bool overwrite=true)
	Register a callback invoked when a key is released while this component has focus, receiving the raw SFML event.
void	onMouseMoved (std::function< void()> callback, bool overwrite=true)
	Register a no-argument callback invoked whenever the mouse moves anywhere in the window.
void	onMouseMoved (std::function< void(const std::optional< sf::Event > &)> callback, bool overwrite=true)
	Register a callback invoked whenever the mouse moves anywhere in the window, receiving the raw SFML event.
void	onMousePressed (std::function< void()> callback, bool overwrite=true)
	Register a no-argument callback invoked when a mouse button is pressed anywhere in the window.
void	onMousePressed (std::function< void(const std::optional< sf::Event > &)> callback, bool overwrite=true)
	Register a callback invoked when a mouse button is pressed, receiving the raw SFML event.
void	onMouseReleased (std::function< void()> callback, bool overwrite=true)
	Register a no-argument callback invoked when a mouse button is released anywhere in the window.
void	onMouseReleased (std::function< void(const std::optional< sf::Event > &)> callback, bool overwrite=true)
	Register a callback invoked when a mouse button is released, receiving the raw SFML event.
void	onScroll (std::function< void()> callback, bool overwrite=true)
	Register a no-argument callback invoked when the mouse wheel is scrolled while the cursor is over this component.
void	onScroll (std::function< void(const std::optional< sf::Event > &)> callback, bool overwrite=true)
	Register a callback invoked when the mouse wheel is scrolled while the cursor is over this component, receiving the SFML event.
std::enable_if_t<!std::is_void_v< T > >	onStateEnter (std::function< void(T)> callback)
	Register a callback invoked after each state transition.
std::enable_if_t<!std::is_void_v< T > >	onStateEnter (std::function< void(T)> callback)
	Register a callback invoked after each state transition.
std::enable_if_t<!std::is_void_v< T > >	onStateExit (std::function< void(T)> callback)
	Register a callback invoked before each state transition.
std::enable_if_t<!std::is_void_v< T > >	onStateExit (std::function< void(T)> callback)
	Register a callback invoked before each state transition.
void	onTextEntered (std::function< void()> callback, bool overwrite=true)
	Register a no-argument callback invoked when a unicode character is entered while this component has focus.
void	onTextEntered (std::function< void(const std::optional< sf::Event > &)> callback, bool overwrite=true)
	Register a callback invoked when a unicode character is entered while this component has focus, receiving the raw SFML event.
void	onUnhover (std::function< void()> callback, bool overwrite=true)
	Register a no-argument callback invoked when the mouse leaves this component's bounds.
void	onUnhover (std::function< void(const std::optional< sf::Event > &event)> callback, bool overwrite=true)
	Register a callback invoked when the mouse leaves this component's bounds, receiving the raw SFML event.
void	onUpdate (std::function< void()> callback, bool overwrite=false)
	Register a no-argument callback invoked every frame.
void	onUpdate (std::function< void(const std::optional< sf::Event > &)> callback, bool overwrite=false)
	Register a callback invoked every frame, receiving the SFML event.
void	onWindowFocusGained (std::function< void()> callback, bool overwrite=false)
	Register a no-argument callback invoked when the application window gains OS focus.
void	onWindowFocusGained (std::function< void(const std::optional< sf::Event > &)> callback, bool overwrite=false)
	Register a callback invoked when the application window gains OS focus, receiving the raw SFML event.
void	onWindowFocusLost (std::function< void()> callback, bool overwrite=false)
	Register a no-argument callback invoked when the application window loses OS focus.
void	onWindowFocusLost (std::function< void(const std::optional< sf::Event > &)> callback, bool overwrite=false)
	Register a callback invoked when the application window loses OS focus, receiving the raw SFML event.
virtual void	onWindowResize (unsigned int, unsigned int)
void	onWindowResized (std::function< void()> callback, bool overwrite=false)
	Register a no-argument callback invoked when the application window is resized.
void	onWindowResized (std::function< void(const std::optional< sf::Event > &)> callback, bool overwrite=false)
	Register a callback invoked when the application window is resized, receiving the raw SFML event.
	operator const sf::Drawable & () const
	Implicit conversion to a const `sf::Drawable` reference.
virtual void	process (const std::string &key, const std::optional< sf::Event > &event)
	Invoke all callbacks registered for `key`.
template<typename ENUM_TYPE>
void	process (ENUM_TYPE eventName, const std::optional< sf::Event > &event)
	Invoke all callbacks registered for `eventName`.
template<typename ENUM_TYPE>
void	publish (ENUM_TYPE event, FilterCallback filter=[](EventReceiver &){ return true;}, SystemCallback resolve=nullptr, SystemCallback reject=nullptr)
	Fire an enum-keyed event to all matching subscribers.
bool	removeComponent (Core &child)
	Remove a child component from this panel.
void	rotate (Angle angle)
void	scale (Vector2f factor)
template<class T>
void	setAbove (T &obj, float spacing=0)
	Position this object immediately above `obj`.
void	setActive (bool active) override
template<class T>
void	setBelow (T &obj, float spacing=0)
	Position this object immediately below `obj`.
void	setColor (const sf::Color &c)
void	setCornerPointCount (unsigned int count)
	Set the number of vertices per corner arc.
void	setDragBounds (const sf::FloatRect &bounds)
	Constrain drag movement to an axis-aligned bounding rectangle.
void	setEnabled (bool enabled)
void	setFillColor (Color color)
void	setFlag (State state, bool status)
	Set a flag to an explicit value.
void	setFramerate (float framerate)
	Set the assumed framerate for movement interpolation.
void	setLayout (Layout layout)
template<class T>
void	setLeftOf (T &obj, float spacing=0)
	Position this object immediately to the left of `obj`.
void	setMaxSwatches (int max)
void	setOpen (bool open)
void	setOrigin (Vector2f origin)
void	setOutlineColor (Color color)
void	setOutlineThickness (float thickness)
void	setParentEnabled (bool enabled)
void	setPosition (const sf::Vector2f &pos) override
	Set the world-space position immediately (no animation).
void	setPosition (Vector2f position)
void	setRadius (float radius)
	Set the corner arc radius.
template<class T>
void	setRightOf (T &obj, float spacing=0)
	Position this object immediately to the right of `obj`.
void	setRotation (Angle angle)
void	setScale (Vector2f factors)
void	setSize (const sf::Vector2f &size)
std::enable_if_t<!std::is_void_v< T > >	setState (T newState)
	Transition to a new state.
std::enable_if_t<!std::is_void_v< T > >	setState (T newState)
	Transition to a new state.
void	setTexture (const Texture *texture, bool resetRect=false)
void	setTextureRect (const IntRect &rect)
void	setVisible (bool visible) override
void	showTab (int index)
template<typename ENUM_TYPE>
void	subscribe (ENUM_TYPE event, Callback callback)
	Subscribe to an enum-keyed event with a no-argument callback.
template<typename ENUM_TYPE>
void	subscribe (ENUM_TYPE event, EventCallback callback)
	Subscribe to an enum-keyed event with a full SFML event callback.
void	toggleFlag (State state)
	Flip a flag between `true` and `false`.
Core *	topmostMatching (const std::function< bool(Core &)> &accept)
	Find the front-most (last-painted) node in this subtree that satisfies `accept`, searching topmost-first.
void	unlockSettings ()
	Allow `applySettings()` to take effect again.
void	unlockTheme ()
	Resume reacting to global theme changes.
template<typename EnumType>
void	unsubscribe (EnumType event)
	Unsubscribe from a single event by enum value.
void	unsubscribeAll ()
	Remove all event subscriptions for this component.

Static Public Member Functions
static void	linkChild (Core parent, Core child)
static void	unlinkAll (Core *core)

Static Public Attributes
static constexpr int	DefaultLayer = 100

Protected Member Functions
void	drawChildren (sf::RenderTarget &target, sf::RenderStates states) const
const std::vector< Child > &	getChildren () const
virtual void	onEnabledChanged (bool enabled)
void	onThemeApplied (const Theme &theme) override
	Called by `ThemeManager` when the active theme changes.
void	update ()

Detailed Description

Combined color chooser: a "Color" (HSV gradient + RGB/Hex entry + Save/Done) tab and a "Swatches" tab (saved palette + recent colors).

Saved swatches are user-managed: "Save color" on the Color tab adds the current color (and jumps to Swatches); right-click a swatch to delete it; the saved palette is capped (default 24, see setMaxSwatches). A second "Recent" strip auto-records the last 16 committed colors.

See also: ColorPicker, GradientColorPicker

Definition at line 35 of file ColorChooser.h.

Member Typedef Documentation

◆ Flag

using ml::Draggable::Flag = DraggableManifest::Flag

inherited

Definition at line 73 of file Draggable.h.

◆ manifest_type [1/2]

using ml::Customizable< DraggableManifest >::manifest_type

inherited

The manifest type, used by GatherFlags and GatherStates to locate this class's flag and state declarations.

Definition at line 65 of file Customizable.h.

◆ manifest_type [2/2]

using ml::Customizable< PanelManifest >::manifest_type

inherited

The manifest type, used by GatherFlags and GatherStates to locate this class's flag and state declarations.

Definition at line 65 of file Customizable.h.

◆ State [1/2]

using ml::Draggable::State = DraggableManifest::State

inherited

Definition at line 74 of file Draggable.h.

◆ State [2/2]

using ml::FlagManager< Flag >::State

inherited

The enum type this manager stores flags for.

Definition at line 63 of file FlagManager.h.

Member Enumeration Documentation

◆ Layout

enum class ml::ColorChooser::Layout

strong

Enumerator
Tabbed
Stacked
GradientOnly
SwatchesOnly

Definition at line 38 of file ColorChooser.h.

Constructor & Destructor Documentation

◆ ColorChooser()

ml::ColorChooser::ColorChooser ( )

Member Function Documentation

◆ addComponent() [1/4]

void ml::Core::addComponent ( Core & child )

inherited

◆ addComponent() [2/4]

template<typename E, typename = std::enable_if_t<std::is_enum_v<E>>>

void ml::Core::addComponent	(	Core &	child,
		E	layer )

inlineinherited

Register a child at a layer identified by any enum value.

Sugar over addComponent(child, int) — the enum's underlying integer value is used as the layer key. Lets manifests declare a domain-meaningful Layer enum and pass it directly at the call site without explicit casts:

class MyManifest : public ml::Manifest {
public:
    enum class Layer : int {
        Backdrop  = 0,
        Content   = 100,
        Controls  = 150,
    };
};
 
class MyWidget : public ml::ComponentWith<MyManifest> {
public:
    using Layer = MyManifest::Layer;
    MyWidget() {
        addComponent(_bg,    Layer::Backdrop);
        addComponent(_input, Layer::Controls);
    }
};

Also accepts ml::Layer (the framework-provided default) when a component has no manifest of its own.

Definition at line 205 of file Core.h.

◆ addComponent() [3/4]

void ml::Core::addComponent	(	Core &	child,
		int	layer )

inherited

◆ addComponent() [4/4]

template<typename T>

void ml::Panel::addComponent	(	T &	child,
		bool	fill = false )

inlineinherited

Add a child component to this panel.

The child's current absolute position is recorded relative to the panel's current position. Subsequent setPosition() calls will keep the child at the same relative offset.

Parameters

child	The component to add.
fill	If `true` (default) and the child has `setSize`, it will be resized to match this panel whenever the panel resizes. Pass `false` to manage size manually.

Definition at line 67 of file Panel.h.

◆ addComponents() [1/3]

template<typename... Children>

void ml::Core::addComponents ( Children &... children )

inlineinherited

Register multiple child components at the default layer.

Equivalent to calling addComponent for each argument. Use this in a composite component's constructor when several fixed member components need to participate in the enable/disable cascade.

ChatWindow() { addComponents(_scrollPane, _input, _sendBtn); }

ml::ChatWindow

Definition ChatWindow.h:29

ml::RectangleWith< PanelManifest >::addComponents

void addComponents(Children &... children)

Definition Core.h:243

Definition at line 243 of file Core.h.

◆ addComponents() [2/3]

template<typename E, typename... Children, typename = std::enable_if_t<std::is_enum_v<E>>>

void ml::Core::addComponents	(	E	layer,
		Children &...	children )

inlineinherited

Variadic shared-layer registration with an enum layer key.

addComponents(Layer::Controls, _input, _sendBtn);

Definition at line 276 of file Core.h.

◆ addComponents() [3/3]

template<typename... Children>

void ml::Core::addComponents	(	int	layer,
		Children &...	children )

inlineinherited

Register multiple child components at a shared layer.

ChatWindow() {
    addComponents(200, _input, _sendBtn);  // foreground row
}

Definition at line 260 of file Core.h.

◆ addRef()

void ml::Panel::addRef ( Core & child )

inherited

Alias for addUntracked(). Kept for compatibility.

◆ addUntracked()

void ml::Panel::addUntracked ( Core & child )

inherited

Add a child that will NOT follow the panel when it moves.

The panel draws the child and propagates enable/visible state, but never calls setPosition or setSize on it. The caller is responsible for positioning the child at all times.

Use this only when the child's position is managed externally (e.g., a custom setPosition override that manually lays out children). In most cases addComponent() is the right choice — it tracks the child and shifts it whenever the panel moves.

// Override setPosition to lay out children manually:
void MyWidget::setPosition(const sf::Vector2f& pos) override
{
    ml::Panel::setPosition(pos);
    _label.setPosition({pos.x + 10.f, pos.y + 5.f});  // manual
}
// In constructor, register without position tracking:
addUntracked(_label);

◆ center()

template<class T>

void ml::Positionable::center ( T & obj )

inherited

Center this object within obj (both axes).

Template Parameters

T	Any type with `getGlobalBounds()`.

Parameters

obj	Container to center within.

◆ centerHorizonally()

template<class T>

void ml::Positionable::centerHorizonally ( T & obj )

inherited

Center this object horizontally within obj.

Template Parameters

T	Any type with `getGlobalBounds()`.

Parameters

obj	Container to center within.

◆ centerText()

void ml::Positionable::centerText ( sf::Text & obj )

inherited

Center an sf::Text object within this object's bounds.

Convenience overload for the common pattern of centering a text label inside a button or panel.

Parameters

obj	The `sf::Text` to reposition.

◆ centerVertically()

template<class T>

void ml::Positionable::centerVertically ( T & obj )

inherited

Center this object vertically within obj.

Template Parameters

T	Any type with `getGlobalBounds()`.

Parameters

obj	Container to center within.

◆ checkFlag()

bool ml::FlagManager< Flag >::checkFlag ( State state ) const

inherited

Return the current value of a flag.

Returns false for any flag that has never been explicitly set.

Parameters

state The flag to query.

Returns: true if the flag is enabled; false otherwise.

◆ clear()

void ml::Panel::clear ( )

inherited

Remove all child components from this panel.

◆ clearDragBounds()

void ml::Draggable::clearDragBounds ( )

inherited

Remove any previously set drag bounds.

After this call the component can be dragged freely across the window with no position clamping. Has no effect if no bounds were set.

◆ color()

sf::Color ml::ColorChooser::color ( ) const

inlinenodiscard

Definition at line 48 of file ColorChooser.h.

◆ disableFlag()

void ml::FlagManager< Flag >::disableFlag ( State state )

inherited

Set a flag to false.

Parameters

state The flag to disable.

◆ draw()

void ml::Panel::draw	(	sf::RenderTarget &	target,
		sf::RenderStates	states ) const

overridevirtualinherited

Draw this graphic to an SFML render target.

Delegates to T::draw after applying any render states returned by getRenderStates() (e.g., a shader set on this component).

Parameters

target	SFML render target (window or texture).
states	Current render states (transform, blend mode, etc.).

Reimplemented from ml::Graphic< ml::RoundedRectangle >.

◆ drawChildren()

void ml::Core::drawChildren	(	sf::RenderTarget &	target,
		sf::RenderStates	states ) const

protectedinherited

Render all registered children in layer order, skipping invisible ones. The framework default draw uses this; derived classes that override draw to add procedural visuals (background, decoration) or to wrap the loop in a clip view call this at the appropriate point.

void Panel::draw(target, states) const {
    Rectangle::draw(target, states);    // background
    drawChildren(target, states);        // children loop
}

◆ enableFlag()

void ml::FlagManager< Flag >::enableFlag ( State state )

inherited

Set a flag to true.

Parameters

state The flag to enable.

◆ getChildren()

const std::vector< Child > & ml::Core::getChildren ( ) const

inlineprotectedinherited

Read-only view of registered children, sorted by layer ascending. Within a layer, entries appear in registration order. Each Child carries its component pointer and layer key — derived classes that only care about the components walk entry.component.

Definition at line 299 of file Core.h.

◆ getCornerPointCount()

unsigned int ml::RoundedRectangle::getCornerPointCount ( ) const

inherited

Return the current per-corner vertex count.

Returns: Number of vertices per corner arc.

◆ getGlobalBounds()

sf::FloatRect ml::Graphic< ml::RoundedRectangle >::getGlobalBounds ( ) const

overridevirtualinherited

Return the axis-aligned bounding box in world space.

Delegates to T::getGlobalBounds(). Used by AppManager for hit-testing (click, hover) and by layout helpers.

Returns: Bounding rectangle in world coordinates.

Reimplemented from ml::Positionable.

◆ getLayout()

Layout ml::ColorChooser::getLayout ( ) const

inlinenodiscard

Definition at line 54 of file ColorChooser.h.

◆ getPoint()

virtual sf::Vector2f ml::RoundedRectangle::getPoint ( std::size_t index ) const

overridevirtualinherited

Return the position of a single vertex.

Required by sf::Shape for geometry generation.

Parameters

index Vertex index in [0, getPointCount()).

Returns: Local-space position of the vertex.

Implements sf::Shape.

◆ getPointCount()

virtual std::size_t ml::RoundedRectangle::getPointCount ( ) const

overridevirtualinherited

Return the total number of shape vertices.

Equal to cornerPointCount × 4 (one arc per corner). Required by sf::Shape.

Returns: Total vertex count.

Implements sf::Shape.

◆ getPosition()

sf::Vector2f ml::Graphic< ml::RoundedRectangle >::getPosition ( ) const

overridevirtualinherited

Return the current world-space position.

Delegates to T::getPosition.

Returns: Current position in world coordinates.

Reimplemented from ml::Positionable.

◆ getRadius()

float ml::RoundedRectangle::getRadius ( ) const

inherited

Return the current corner arc radius.

Returns: Corner radius in pixels.

◆ getRenderStates()

virtual sf::RenderStates ml::Core::getRenderStates ( ) const

inlinevirtualinherited

Definition at line 102 of file Core.h.

◆ getSize()

const sf::Vector2f & ml::RoundedRectangle::getSize ( ) const

inherited

Return the current size of the rectangle.

Returns: Width and height in pixels.

◆ getState() [1/2]

std::enable_if_t<!std::is_void_v< T >, T > ml::StateManager< extract_State< DraggableManifest >::type >::getState ( ) const

inherited

Return the current state value.

Returns: The active StateEnum value.

◆ getState() [2/2]

std::enable_if_t<!std::is_void_v< T >, T > ml::StateManager< extract_State< PanelManifest >::type >::getState ( ) const

inherited

Return the current state value.

Returns: The active StateEnum value.

◆ Graphic() [1/2]

ml::Graphic< T >::Graphic ( )

inherited

◆ Graphic() [2/2]

template<typename U>

ml::Graphic< T >::Graphic ( const U & obj )

explicitinherited

Construct from an existing SFML object of type U.

Template Parameters

U	Source type, must be compatible with `T's` copy/move constructor.

Parameters

obj	The source object to copy-construct from.

◆ isEffectivelyVisible()

bool ml::Core::isEffectivelyVisible ( ) const

inherited

True only if this component and every ancestor are visible.

isVisible() reports a single component's own HIDDEN flag, but visibility is not cascaded the way enabled-state is: hiding a container does not flip the HIDDEN flag on its descendants. A descendant of a hidden container is therefore not drawn (the parent never reaches it) yet still looks visible to anything that inspects its own flag — notably hit-testing. This walks the parent chain so such a descendant is correctly treated as not visible.

◆ isEnabled()

bool ml::Core::isEnabled ( ) const

inherited

◆ isOpen()

bool ml::ColorChooser::isOpen ( ) const

inlinenodiscard

Definition at line 58 of file ColorChooser.h.

◆ isScrolling()

bool ml::Positionable::isScrolling ( )

inherited

Return true while a moveTo or moveDistance animation is in progress.

Returns: true if the waypoint queue is non-empty.

◆ isSettingsLocked()

bool ml::Themeable::isSettingsLocked ( ) const

inlinenodiscardinherited

Return true if applySettings() is currently blocked.

Definition at line 115 of file Themeable.h.

◆ isState() [1/2]

std::enable_if_t<!std::is_void_v< T >, bool > ml::StateManager< extract_State< DraggableManifest >::type >::isState ( T state ) const

inherited

Return true if currently in state.

Parameters

state The state value to compare against.

Returns: true if the current state equals state.

◆ isState() [2/2]

std::enable_if_t<!std::is_void_v< T >, bool > ml::StateManager< extract_State< PanelManifest >::type >::isState ( T state ) const

inherited

Return true if currently in state.

Parameters

state The state value to compare against.

Returns: true if the current state equals state.

◆ isThemeLocked()

bool ml::Themeable::isThemeLocked ( ) const

inlinenodiscardinherited

Return true if this component ignores theme changes.

Definition at line 97 of file Themeable.h.

◆ isVisible()

bool ml::Core::isVisible ( ) const

inherited

◆ linkChild()

void ml::Core::linkChild	(	Core *	parent,
		Core *	child )

staticinherited

◆ lockSettings()

void ml::Themeable::lockSettings ( )

inlineinherited

Prevent applySettings() from taking effect.

Explicit individual setter calls still work normally. Only blocks the batch applySettings() path.

Definition at line 107 of file Themeable.h.

◆ lockTheme()

void ml::Themeable::lockTheme ( )

inlineinherited

Prevent automatic re-styling when the global theme changes.

The component keeps its current visual state. Explicit individual setter calls still work normally.

Definition at line 85 of file Themeable.h.

◆ moveDistance()

void ml::Positionable::moveDistance	(	sf::Vector2f	distance,
		float	seconds = 1.f )

inherited

Animate by a relative offset from the current position.

Equivalent to moveTo(getPosition() + distance, seconds).

Parameters

distance	Offset in world coordinates to move by.
seconds	Duration of the animation. Defaults to 1.0 s.

◆ moveTo() [1/2]

void ml::Positionable::moveTo	(	sf::FloatRect	position,
		float	seconds = 1.f )

inherited

Animate to a position defined by a FloatRect origin.

Convenience overload that uses the top-left of position as the target. Useful when positioning relative to layout rects.

Parameters

position	Rect whose origin is the animation target.
seconds	Duration of the animation. Defaults to 1.0 s.

◆ moveTo() [2/2]

void ml::Positionable::moveTo	(	sf::Vector2f	position,
		float	seconds = 1.f )

inherited

Animate to an absolute world-space position.

Populates an internal waypoint queue and advances through it on successive onUpdate ticks. The object's position at the start of the call is the implicit start point.

Parameters

position	Target position in world coordinates.
seconds	Duration of the animation. Defaults to 1.0 s.

◆ onBlur() [1/2]

void ml::Focusable::onBlur	(	std::function< void()>	callback,
		bool	overwrite = true )

inherited

Register a no-argument callback invoked when this component loses keyboard focus.

Parameters

callback	Function invoked with no arguments when focus is lost.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onBlur() [2/2]

void ml::Focusable::onBlur	(	std::function< void(const std::optional< sf::Event > &)>	callback,
		bool	overwrite = true )

inherited

Register a callback invoked when this component loses keyboard focus, receiving the raw SFML event.

Parameters

callback	Function invoked with the SFML event when focus is lost.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onClick() [1/2]

void ml::Clickable::onClick	(	std::function< void()>	callback,
		bool	overwrite = true )

inherited

Register a no-argument callback invoked when this component is clicked.

Replaces any previously registered onClick callback. The callback fires after the mouse button is released over this component.

Parameters

callback	Function invoked with no arguments on click.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onClick() [2/2]

void ml::Clickable::onClick	(	std::function< void(const std::optional< sf::Event > &event)>	callback,
		bool	overwrite = true )

inherited

Register a callback invoked when this component is clicked, receiving the raw SFML event.

Replaces any previously registered onClick callback unless overwrite is false, in which case the callback is appended.

Parameters

callback	Function invoked with the SFML event on click.
overwrite	If `true` (default), replaces any existing callback.

◆ onColorChanged()

void ml::ColorChooser::onColorChanged ( std::function< void(const sf::Color &)> cb )

Fired continuously as the color changes (gradient drag / live edits).

◆ onColorSelected()

void ml::ColorChooser::onColorSelected ( std::function< void(const sf::Color &)> cb )

Fired on a deliberate pick — Done, a swatch/recent click, Hex/RGB submit.

◆ onEnabledChanged()

virtual void ml::Core::onEnabledChanged ( bool enabled )

inlineprotectedvirtualinherited

THE hook for reacting to an enable/disable change. Fires whenever the effective enabled state flips — on both the direct (setEnabled) and cascade (setParentEnabled) paths — so visuals, hover/press state, popup teardown, etc. stay correct no matter how the change arrived. Override this instead of setEnabled/setParentEnabled.

Parameters

enabled the new effective enabled state.

Reimplemented in ml::EditableList.

Definition at line 293 of file Core.h.

◆ onFocus() [1/2]

void ml::Focusable::onFocus	(	std::function< void()>	callback,
		bool	overwrite = true )

inherited

Register a no-argument callback invoked when this component gains keyboard focus.

Parameters

callback	Function invoked with no arguments when focus is gained.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onFocus() [2/2]

void ml::Focusable::onFocus	(	std::function< void(const std::optional< sf::Event > &)>	callback,
		bool	overwrite = true )

inherited

Register a callback invoked when this component gains keyboard focus, receiving the raw SFML event.

Parameters

callback	Function invoked with the SFML event when focus is gained.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onHover() [1/2]

void ml::Hoverable::onHover	(	std::function< void()>	callback,
		bool	overwrite = true )

inherited

Register a no-argument callback invoked when the mouse enters this component's bounds.

Parameters

callback	Function invoked with no arguments on hover enter.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onHover() [2/2]

void ml::Hoverable::onHover	(	std::function< void(const std::optional< sf::Event > &event)>	callback,
		bool	overwrite = true )

inherited

Register a callback invoked when the mouse enters this component's bounds, receiving the raw SFML event.

Parameters

callback	Function invoked with the SFML event on hover enter.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onKeypress() [1/2]

void ml::Keyable::onKeypress	(	std::function< void()>	callback,
		bool	overwrite = true )

inherited

Register a no-argument callback invoked when a key is pressed while this component has focus.

Parameters

callback	Function invoked with no arguments on key press.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onKeypress() [2/2]

void ml::Keyable::onKeypress	(	std::function< void(const std::optional< sf::Event > &)>	callback,
		bool	overwrite = true )

inherited

Register a callback invoked when a key is pressed while this component has focus, receiving the raw SFML event.

Parameters

callback	Function invoked with the SFML event on key press.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onKeyRelease() [1/2]

void ml::Keyable::onKeyRelease	(	std::function< void()>	callback,
		bool	overwrite = true )

inherited

Register a no-argument callback invoked when a key is released while this component has focus.

Parameters

callback	Function invoked with no arguments on key release.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onKeyRelease() [2/2]

void ml::Keyable::onKeyRelease	(	std::function< void(const std::optional< sf::Event > &)>	callback,
		bool	overwrite = true )

inherited

Register a callback invoked when a key is released while this component has focus, receiving the raw SFML event.

Parameters

callback	Function invoked with the SFML event on key release.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onMouseMoved() [1/2]

void ml::Scrollable::onMouseMoved	(	std::function< void()>	callback,
		bool	overwrite = true )

inherited

Register a no-argument callback invoked whenever the mouse moves anywhere in the window.

Unlike onHover, this fires for every component regardless of whether the cursor is over it.

Parameters

callback	Function invoked with no arguments on mouse move.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onMouseMoved() [2/2]

void ml::Scrollable::onMouseMoved	(	std::function< void(const std::optional< sf::Event > &)>	callback,
		bool	overwrite = true )

inherited

Register a callback invoked whenever the mouse moves anywhere in the window, receiving the raw SFML event.

Parameters

callback	Function invoked with the SFML event on mouse move.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onMousePressed() [1/2]

void ml::Scrollable::onMousePressed	(	std::function< void()>	callback,
		bool	overwrite = true )

inherited

Register a no-argument callback invoked when a mouse button is pressed anywhere in the window.

This fires before click logic is evaluated. Prefer onClick for standard click handling.

Parameters

callback	Function invoked with no arguments on mouse press.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onMousePressed() [2/2]

void ml::Scrollable::onMousePressed	(	std::function< void(const std::optional< sf::Event > &)>	callback,
		bool	overwrite = true )

inherited

Register a callback invoked when a mouse button is pressed, receiving the raw SFML event.

Parameters

callback	Function invoked with the SFML event on mouse press.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onMouseReleased() [1/2]

void ml::Scrollable::onMouseReleased	(	std::function< void()>	callback,
		bool	overwrite = true )

inherited

Register a no-argument callback invoked when a mouse button is released anywhere in the window.

This fires before click logic is evaluated. Prefer onClick for standard click handling.

Parameters

callback	Function invoked with no arguments on mouse release.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onMouseReleased() [2/2]

void ml::Scrollable::onMouseReleased	(	std::function< void(const std::optional< sf::Event > &)>	callback,
		bool	overwrite = true )

inherited

Register a callback invoked when a mouse button is released, receiving the raw SFML event.

Parameters

callback	Function invoked with the SFML event on mouse release.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onScroll() [1/2]

void ml::Scrollable::onScroll	(	std::function< void()>	callback,
		bool	overwrite = true )

inherited

Register a no-argument callback invoked when the mouse wheel is scrolled while the cursor is over this component.

Parameters

callback	Function invoked with no arguments on scroll.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onScroll() [2/2]

void ml::Scrollable::onScroll	(	std::function< void(const std::optional< sf::Event > &)>	callback,
		bool	overwrite = true )

inherited

Register a callback invoked when the mouse wheel is scrolled while the cursor is over this component, receiving the SFML event.

Parameters

callback	Function invoked with the SFML event on scroll.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onStateEnter() [1/2]

std::enable_if_t<!std::is_void_v< T > > ml::StateManager< extract_State< DraggableManifest >::type >::onStateEnter ( std::function< void(T)> callback )

inherited

Register a callback invoked after each state transition.

The callback receives the newly entered state. Only one enter callback is active at a time; calling this again replaces it.

Parameters

callback Function called with the new state after each transition.

◆ onStateEnter() [2/2]

std::enable_if_t<!std::is_void_v< T > > ml::StateManager< extract_State< PanelManifest >::type >::onStateEnter ( std::function< void(T)> callback )

inherited

Register a callback invoked after each state transition.

The callback receives the newly entered state. Only one enter callback is active at a time; calling this again replaces it.

Parameters

callback Function called with the new state after each transition.

◆ onStateExit() [1/2]

std::enable_if_t<!std::is_void_v< T > > ml::StateManager< extract_State< DraggableManifest >::type >::onStateExit ( std::function< void(T)> callback )

inherited

Register a callback invoked before each state transition.

The callback receives the state being left. Only one exit callback is active at a time; calling this again replaces it.

Parameters

callback Function called with the old state before each transition.

◆ onStateExit() [2/2]

std::enable_if_t<!std::is_void_v< T > > ml::StateManager< extract_State< PanelManifest >::type >::onStateExit ( std::function< void(T)> callback )

inherited

Register a callback invoked before each state transition.

The callback receives the state being left. Only one exit callback is active at a time; calling this again replaces it.

Parameters

callback Function called with the old state before each transition.

◆ onTextEntered() [1/2]

void ml::Keyable::onTextEntered	(	std::function< void()>	callback,
		bool	overwrite = true )

inherited

Register a no-argument callback invoked when a unicode character is entered while this component has focus.

Prefer onTextEntered over onKeypress for text input — it handles modifier keys, input method editors (IME), and non-ASCII characters correctly.

Parameters

callback	Function invoked with no arguments when text is entered.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onTextEntered() [2/2]

void ml::Keyable::onTextEntered	(	std::function< void(const std::optional< sf::Event > &)>	callback,
		bool	overwrite = true )

inherited

Register a callback invoked when a unicode character is entered while this component has focus, receiving the raw SFML event.

Parameters

callback	Function invoked with the SFML event when text is entered.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onThemeApplied()

void ml::Panel::onThemeApplied ( const Theme & theme )

overrideprotectedvirtualinherited

Called by ThemeManager when the active theme changes.

Override in your component to re-style from the new theme. Always check isThemeLocked() first:

void onThemeApplied(const Theme& theme) override
{
    if (isThemeLocked()) return;
    MySettings::applyTheme(theme);
    syncFromSettings();
}

Parameters

theme The newly active theme.

Implements ml::Themeable.

◆ onUnhover() [1/2]

void ml::Hoverable::onUnhover	(	std::function< void()>	callback,
		bool	overwrite = true )

inherited

Register a no-argument callback invoked when the mouse leaves this component's bounds.

Parameters

callback	Function invoked with no arguments on hover leave.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onUnhover() [2/2]

void ml::Hoverable::onUnhover	(	std::function< void(const std::optional< sf::Event > &event)>	callback,
		bool	overwrite = true )

inherited

Register a callback invoked when the mouse leaves this component's bounds, receiving the raw SFML event.

Parameters

callback	Function invoked with the SFML event on hover leave.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onUpdate() [1/2]

void ml::Updatable::onUpdate	(	std::function< void()>	callback,
		bool	overwrite = false )

inherited

Register a no-argument callback invoked every frame.

The callback fires once per frame before the draw pass. All active components receive this regardless of hover or focus state.

Parameters

callback	Function invoked with no arguments each frame.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onUpdate() [2/2]

void ml::Updatable::onUpdate	(	std::function< void(const std::optional< sf::Event > &)>	callback,
		bool	overwrite = false )

inherited

Register a callback invoked every frame, receiving the SFML event.

For frame events the std::optional<sf::Event> is always std::nullopt — use the no-argument overload unless you specifically need the optional parameter in your callback signature.

Parameters

callback	Function invoked with the SFML event (always nullopt) each frame.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onWindowFocusGained() [1/2]

void ml::Updatable::onWindowFocusGained	(	std::function< void()>	callback,
		bool	overwrite = false )

inherited

Register a no-argument callback invoked when the application window gains OS focus.

Parameters

callback	Function invoked with no arguments when focus is gained.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onWindowFocusGained() [2/2]

void ml::Updatable::onWindowFocusGained	(	std::function< void(const std::optional< sf::Event > &)>	callback,
		bool	overwrite = false )

inherited

Register a callback invoked when the application window gains OS focus, receiving the raw SFML event.

Parameters

callback	Function invoked with the SFML event when focus is gained.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onWindowFocusLost() [1/2]

void ml::Updatable::onWindowFocusLost	(	std::function< void()>	callback,
		bool	overwrite = false )

inherited

Register a no-argument callback invoked when the application window loses OS focus.

Parameters

callback	Function invoked with no arguments when focus is lost.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onWindowFocusLost() [2/2]

void ml::Updatable::onWindowFocusLost	(	std::function< void(const std::optional< sf::Event > &)>	callback,
		bool	overwrite = false )

inherited

Register a callback invoked when the application window loses OS focus, receiving the raw SFML event.

Parameters

callback	Function invoked with the SFML event when focus is lost.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onWindowResize()

virtual void ml::Core::onWindowResize	(	unsigned int	,
		unsigned int	)

inlinevirtualinherited

Called by AppManager on every registered component when the window is resized. Override in responsive components to reflow to the new pixel size (the framework keeps a 1:1 view, so width/height are window pixels).

Definition at line 135 of file Core.h.

◆ onWindowResized() [1/2]

void ml::Updatable::onWindowResized	(	std::function< void()>	callback,
		bool	overwrite = false )

inherited

Register a no-argument callback invoked when the application window is resized.

Parameters

callback	Function invoked with no arguments on window resize.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ onWindowResized() [2/2]

void ml::Updatable::onWindowResized	(	std::function< void(const std::optional< sf::Event > &)>	callback,
		bool	overwrite = false )

inherited

Register a callback invoked when the application window is resized, receiving the raw SFML event.

Parameters

callback	Function invoked with the SFML event on window resize.
overwrite	When `true`, replaces any existing callback; when `false`, appends an additional one.

◆ operator const sf::Drawable &()

ml::Graphic< ml::RoundedRectangle >::operator const sf::Drawable & ( ) const

inherited

Implicit conversion to a const sf::Drawable reference.

Allows a Graphic to be passed wherever a raw sf::Drawable& is expected (e.g., window.draw()).

Returns: Const reference to this object as sf::Drawable.

◆ process() [1/2]

virtual void ml::EventReceiver::process	(	const std::string &	key,
		const std::optional< sf::Event > &	event )

virtualinherited

Invoke all callbacks registered for key.

Called by framework dispatchers. key is the string produced by EnumKey::get(eventEnum).

Parameters

key	String key identifying the event.
event	SFML event forwarded to each callback.

◆ process() [2/2]

template<typename ENUM_TYPE>

void ml::EventReceiver::process	(	ENUM_TYPE	eventName,
		const std::optional< sf::Event > &	event )

inherited

Invoke all callbacks registered for eventName.

Template overload that accepts any enum value directly, converting to a string key via EnumKey::get() internally.

Template Parameters

ENUM_TYPE Any enum type.

Parameters

eventName	The enum value identifying the event.
event	SFML event forwarded to each callback.

◆ publish()

template<typename ENUM_TYPE>

void ml::Subscribable::publish	(	ENUM_TYPE	event,
		FilterCallback	filter = [](EventReceiver &){ return true;},
		SystemCallback	resolve = nullptr,
		SystemCallback	reject = nullptr )

inherited

Fire an enum-keyed event to all matching subscribers.

Iterates all subscribers registered for event and invokes their callbacks for each subscriber that passes the optional filter. Optional resolve and reject system callbacks are called after each component passes or fails the filter respectively.

Template Parameters

ENUM_TYPE Any enum type.

Parameters

event	The enum value identifying the event to fire.
filter	Optional predicate; only subscribers for which this returns `true` receive the event. Defaults to accepting all subscribers.
resolve	Optional callback invoked for each subscriber that passes the filter.
reject	Optional callback invoked for each subscriber that fails the filter.

◆ removeComponent()

bool ml::Panel::removeComponent ( Core & child )

inherited

Remove a child component from this panel.

◆ setAbove()

template<class T>

void ml::Positionable::setAbove	(	T &	obj,
		float	spacing = 0 )

inherited

Position this object immediately above obj.

Template Parameters

T	Any type with `getGlobalBounds()`.

Parameters

obj	Reference object.
spacing	Gap in pixels between the two objects. Defaults to 0.

◆ setActive()

void ml::Panel::setActive ( bool active )

overridevirtualinherited

Reimplemented from ml::Core.

◆ setBelow()

template<class T>

void ml::Positionable::setBelow	(	T &	obj,
		float	spacing = 0 )

inherited

Position this object immediately below obj.

Template Parameters

T	Any type with `getGlobalBounds()`.

Parameters

obj	Reference object.
spacing	Gap in pixels between the two objects. Defaults to 0.

◆ setColor()

void ml::ColorChooser::setColor ( const sf::Color & c )

◆ setCornerPointCount()

void ml::RoundedRectangle::setCornerPointCount ( unsigned int count )

inherited

Set the number of vertices per corner arc.

Triggers geometry regeneration.

Parameters

count Vertex count per corner. Must be at least 1.

◆ setDragBounds()

void ml::Draggable::setDragBounds ( const sf::FloatRect & bounds )

inherited

Constrain drag movement to an axis-aligned bounding rectangle.

While bounds are set, the component's position is clamped so that its top-left corner never moves outside bounds during a drag gesture. Bounds are applied in world coordinates.

Call clearDragBounds() to remove the constraint and allow free movement again.

Parameters

bounds The world-space rectangle within which the component may be dragged.

◆ setEnabled()

void ml::Core::setEnabled ( bool enabled )

inherited

Set this component's own enabled intent (_selfEnabled). Public API and non-virtual: there is exactly one enable mechanism. To react to an enable/disable change, override onEnabledChanged — never this.

◆ setFlag()

void ml::FlagManager< Flag >::setFlag	(	State	state,
		bool	status )

inherited

Set a flag to an explicit value.

Parameters

state	The flag to modify.
status	`true` to enable, `false` to disable.

◆ setFramerate()

void ml::Positionable::setFramerate ( float framerate )

inherited

Set the assumed framerate for movement interpolation.

moveTo generates a queue of intermediate positions based on this value. Defaults to 60 fps. Call this if your application runs at a different target rate to keep animation timing accurate.

Parameters

framerate Target framerate in frames per second.

◆ setLayout()

void ml::ColorChooser::setLayout ( Layout layout )

◆ setLeftOf()

template<class T>

void ml::Positionable::setLeftOf	(	T &	obj,
		float	spacing = 0 )

inherited

Position this object immediately to the left of obj.

Template Parameters

T	Any type with `getGlobalBounds()`.

Parameters

obj	Reference object.
spacing	Gap in pixels between the two objects. Defaults to 0.

◆ setMaxSwatches()

void ml::ColorChooser::setMaxSwatches ( int max )

Cap the saved-swatch palette (default 24).

◆ setOpen()

void ml::ColorChooser::setOpen ( bool open )

◆ setParentEnabled()

void ml::Core::setParentEnabled ( bool enabled )

inherited

Cascade plumbing: set the inherited (_parentEnabled) component of the effective state. Called by the framework when an ancestor's effective state changes (and by Modal/Panel for explicit subtree gating). NOT an override point — react via onEnabledChanged instead.

◆ setPosition()

void ml::ColorChooser::setPosition ( const sf::Vector2f & position )

overridevirtual

Set the world-space position immediately (no animation).

Pure virtual — implemented by the concrete shape or adapter class.

Parameters

position New position in world coordinates.

Reimplemented from ml::Positionable.

◆ setRadius()

void ml::RoundedRectangle::setRadius ( float radius )

inherited

Set the corner arc radius.

Triggers geometry regeneration. Values larger than half the shorter side are clamped automatically.

Parameters

radius Corner radius in pixels.

◆ setRightOf()

template<class T>

void ml::Positionable::setRightOf	(	T &	obj,
		float	spacing = 0 )

inherited

Position this object immediately to the right of obj.

Template Parameters

T	Any type with `getGlobalBounds()`.

Parameters

obj	Reference object.
spacing	Gap in pixels between the two objects. Defaults to 0.

◆ setSize()

void ml::ColorChooser::setSize ( const sf::Vector2f & size )

◆ setState() [1/2]

std::enable_if_t<!std::is_void_v< T > > ml::StateManager< extract_State< DraggableManifest >::type >::setState ( T newState )

inherited

Transition to a new state.

Fires the exit callback with the current state, updates the stored state to newState, then fires the enter callback with the new state. Either callback may be unset (nullptr), in which case it is skipped.

Parameters

newState The state to transition into.

◆ setState() [2/2]

std::enable_if_t<!std::is_void_v< T > > ml::StateManager< extract_State< PanelManifest >::type >::setState ( T newState )

inherited

Transition to a new state.

Fires the exit callback with the current state, updates the stored state to newState, then fires the enter callback with the new state. Either callback may be unset (nullptr), in which case it is skipped.

Parameters

newState The state to transition into.

◆ setVisible()

void ml::Panel::setVisible ( bool visible )

overridevirtualinherited

Reimplemented from ml::Core.

Reimplemented in ml::RichTextEditor.

◆ showTab()

void ml::ColorChooser::showTab ( int index )

◆ subscribe() [1/2]

template<typename ENUM_TYPE>

void ml::Subscribable::subscribe	(	ENUM_TYPE	event,
		Callback	callback )

inherited

Subscribe to an enum-keyed event with a no-argument callback.

Convenience overload for callbacks that do not need access to the raw SFML event.

Template Parameters

ENUM_TYPE Any enum type.

Parameters

event	The enum value identifying the event to subscribe to.
callback	Function invoked with no arguments when the event fires.

◆ subscribe() [2/2]

template<typename ENUM_TYPE>

void ml::Subscribable::subscribe	(	ENUM_TYPE	event,
		EventCallback	callback )

inherited

Subscribe to an enum-keyed event with a full SFML event callback.

The callback is invoked each time the event fires and the framework's filter (defined by the associated EventDispatcher) passes this component. The std::optional<sf::Event> parameter carries the raw SFML event when one is available, or std::nullopt for frame events.

Template Parameters

ENUM_TYPE Any enum type — ml::Event for built-in events, or a manifest event enum for custom events.

Parameters

event	The enum value identifying the event to subscribe to.
callback	Function invoked with the SFML event when the event fires.

◆ toggleFlag()

void ml::FlagManager< Flag >::toggleFlag ( State state )

inherited

Flip a flag between true and false.

Parameters

state The flag to toggle.

◆ topmostMatching()

Core * ml::Core::topmostMatching ( const std::function< bool(Core &)> & accept )

inherited

Find the front-most (last-painted) node in this subtree that satisfies accept, searching topmost-first.

Walks this Core and its descendants in reverse paint order — children before their parent, and within a parent the highest layer first — so the first node for which accept returns true is the one visually on top at that location. Invisible subtrees are skipped.

This is the hit-testing seam the event system uses to route a click to only the top-most interactive target instead of every overlapping one. accept encapsulates the test (e.g. "is hovered AND a click target"), keeping Core free of any geometry/bounds knowledge.

Parameters

accept Predicate evaluated per node, topmost-first.

Returns: The front-most accepted node, or nullptr if none match.

◆ unlinkAll()

void ml::Core::unlinkAll ( Core * core )

staticinherited

◆ unlockSettings()

void ml::Themeable::unlockSettings ( )

inlineinherited

Allow applySettings() to take effect again.

Definition at line 112 of file Themeable.h.

◆ unlockTheme()

void ml::Themeable::unlockTheme ( )

inlineinherited

Resume reacting to global theme changes.

Does NOT immediately re-apply the current theme — call ThemeManager::get() and pass it to onThemeApplied() manually if you want to re-sync immediately after unlocking.

Definition at line 94 of file Themeable.h.

◆ unsubscribe()

template<typename EnumType>

void ml::Unsubscribable::unsubscribe ( EnumType event )

inlineinherited

Unsubscribe from a single event by enum value.

Works with any enum type — ml::Event for built-in events, or a manifest Event enum for custom events.

If called during an EventManager::fire() iteration the removal is deferred until the iteration completes.

Template Parameters

EnumType Any enum type. Enforced at compile time.

Parameters

event The enum value identifying the event to remove.

Definition at line 65 of file Unsubscribable.h.

◆ unsubscribeAll()

void ml::Unsubscribable::unsubscribeAll ( )

inherited

Remove all event subscriptions for this component.

Removes every subscription registered across all event names. Called automatically by Core's destructor.

If called during an EventManager::fire() iteration the removal is deferred until the iteration completes.

Member Data Documentation

◆ DefaultLayer

int ml::Core::DefaultLayer = 100

staticconstexprinherited

Default layer key when none is specified. Chosen at 100 so callers can place children both above and below the default without renumbering. Within a layer, children draw in registration order.

Definition at line 155 of file Core.h.

The documentation for this class was generated from the following file:

Graphics/Controls/ColorChooser.h

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Detailed Description

Member Typedef Documentation

◆ Flag

◆ manifest_type [1/2]

◆ manifest_type [2/2]

◆ State [1/2]

◆ State [2/2]

Member Enumeration Documentation

◆ Layout

Constructor & Destructor Documentation

◆ ColorChooser()

Member Function Documentation

◆ addComponent() [1/4]

◆ addComponent() [2/4]

◆ addComponent() [3/4]

◆ addComponent() [4/4]

◆ addComponents() [1/3]

◆ addComponents() [2/3]

◆ addComponents() [3/3]

◆ addRef()

◆ addUntracked()

◆ center()

◆ centerHorizonally()

◆ centerText()

◆ centerVertically()

◆ checkFlag()

◆ clear()

◆ clearDragBounds()

◆ color()

◆ disableFlag()

◆ draw()

◆ drawChildren()

◆ enableFlag()

◆ getChildren()

◆ getCornerPointCount()

◆ getGlobalBounds()

◆ getLayout()

◆ getPoint()

◆ getPointCount()

◆ getPosition()

◆ getRadius()

◆ getRenderStates()

◆ getSize()

◆ getState() [1/2]

◆ getState() [2/2]

◆ Graphic() [1/2]

◆ Graphic() [2/2]

◆ isEffectivelyVisible()

◆ isEnabled()

◆ isOpen()

◆ isScrolling()

◆ isSettingsLocked()

◆ isState() [1/2]

◆ isState() [2/2]

◆ isThemeLocked()

◆ isVisible()

◆ linkChild()

◆ lockSettings()

◆ lockTheme()

◆ moveDistance()

◆ moveTo() [1/2]

◆ moveTo() [2/2]

◆ onBlur() [1/2]

◆ onBlur() [2/2]

◆ onClick() [1/2]

◆ onClick() [2/2]

◆ onColorChanged()

◆ onColorSelected()

◆ onEnabledChanged()

◆ onFocus() [1/2]

◆ onFocus() [2/2]

◆ onHover() [1/2]

◆ onHover() [2/2]

◆ onKeypress() [1/2]

◆ onKeypress() [2/2]