fcn::MenuBar Class Reference

#include <menubar.hpp>

Inheritance diagram for fcn::MenuBar:

Public Member Functions
Widget *	addMenu (std::string const &text, MenuPopup *popup=nullptr)
void	closeAll ()
MenuPopup *	getOpenMenu () const
bool	isMenuOpen () const
	MenuBar ()
	MenuBar (MenuBar &&)=delete
	MenuBar (MenuBar const &)=delete
MenuBar &	operator= (MenuBar &&)=delete
MenuBar &	operator= (MenuBar const &)=delete
Public Member Functions inherited from fcn::HorizontalBar
void	adjustSize () override
unsigned int	getFixedHeight () const
unsigned int	getPadding () const
unsigned int	getSpacing () const
	HorizontalBar ()
	HorizontalBar (HorizontalBar &&)=delete
	HorizontalBar (HorizontalBar const &)=delete
bool	isClipping () const
bool	isExpandChildren () const
HorizontalBar &	operator= (HorizontalBar &&)=delete
HorizontalBar &	operator= (HorizontalBar const &)=delete
void	resizeToContent (bool recursion=true) override
void	setClipping (bool clip)
void	setExpandChildren (bool expand)
void	setFixedHeight (unsigned int height)
void	setPadding (unsigned int padding)
void	setSpacing (unsigned int spacing)
Public Member Functions inherited from fcn::Container
virtual void	add (Widget *widget)
virtual void	add (Widget *widget, int x, int y)
void	addContainerListener (ContainerListener *containerListener)
virtual void	addWidget (std::unique_ptr< Widget > widget)
virtual void	addWidget (std::unique_ptr< Widget > widget, int x, int y)
	Container ()
	Container (Container &&)=delete
	Container (Container const &)=delete
void	expandContent ()
void	expandContent (bool recursion) override
Widget *	findWidgetById (std::string const &id) override
Widget *	getBackgroundWidget ()
Widget *	getChild (unsigned int index) const
Rectangle	getChildrenArea () override
virtual unsigned int	getHorizontalSpacing () const
virtual LayoutPolicy	getLayout () const
virtual unsigned int	getVerticalSpacing () const
bool	isLayouted () override
virtual bool	isOpaque () const
virtual bool	isUniformSize () const
Container &	operator= (Container &&)=delete
Container &	operator= (Container const &)=delete
void	remove (Widget *widget) override
void	removeAllChildren () override
void	removeContainerListener (ContainerListener *containerListener)
void	setBackgroundWidget (Widget *widget)
virtual void	setHorizontalSpacing (unsigned int spacing)
virtual void	setLayout (LayoutPolicy policy)
virtual void	setOpacity (float opacity)
virtual void	setOpaque (bool opaque)
virtual void	setUniformSize (bool uniform)
virtual void	setVerticalSpacing (unsigned int spacing)
Public Member Functions inherited from fcn::Widget
virtual void	_draw (Graphics *graphics)
virtual FocusHandler *	_getFocusHandler ()
virtual std::list< FocusListener * > const &	_getFocusListeners ()
virtual FocusHandler *	_getInternalFocusHandler ()
virtual std::list< KeyListener * > const &	_getKeyListeners ()
virtual std::list< MouseListener * > const &	_getMouseListeners ()
virtual void	_logic ()
virtual void	_setFocusHandler (FocusHandler *focusHandler)
virtual void	_setParent (Widget *parent)
void	adaptLayout ()
virtual void	adaptLayout (bool top)
void	addActionListener (ActionListener *actionListener)
void	addDeathListener (DeathListener *deathListener)
void	addDropTargetListener (DropTargetListener *listener)
void	addFocusListener (FocusListener *focusListener)
void	addKeyListener (KeyListener *keyListener)
void	addMouseListener (MouseListener *mouseListener)
void	addWidgetListener (WidgetListener *widgetListener)
bool	captureMouse ()
bool	contains (int x, int y) const
virtual void	drawBorder (Graphics *graphics)
void	drawBorder (Graphics *graphics, unsigned int sides)
virtual void	drawOutline (Graphics *graphics)
virtual void	drawSelectionFrame (Graphics *graphics)
void	expandContent ()
virtual void	focusNext ()
virtual void	focusPrevious ()
virtual void	fontChanged ()
virtual void	getAbsolutePosition (int &x, int &y) const
std::string const &	getActionEventId () const
Color const &	getBackgroundColor () const
Color const &	getBaseColor () const
Color const &	getBorderColor () const
unsigned int	getBorderSides () const
unsigned int	getBorderSize () const
unsigned int	getBorderStyle () const
unsigned int	getChildrenCount () const
Rectangle const &	getDimension () const
Size const &	getFixedSize () const
Font *	getFont () const
Color const &	getForegroundColor () const
int	getHeight () const
std::string const &	getId () const
void	getLastPosition (int &x, int &y) const
int	getMarginBottom () const
int	getMarginLeft () const
int	getMarginRight () const
int	getMarginTop () const
Size const &	getMaxSize () const
Size const &	getMinSize () const
Color const &	getOutlineColor () const
unsigned int	getOutlineSize () const
unsigned int	getPaddingBottom () const
unsigned int	getPaddingLeft () const
unsigned int	getPaddingRight () const
unsigned int	getPaddingTop () const
virtual Widget *	getParent () const
Color const &	getSelectionColor () const
SelectionMode	getSelectionMode () const
virtual Widget *	getTop () const
unsigned int	getVisibleChildrenCount () const
Widget *	getWidgetAt (int x, int y)
virtual Widget *	getWidgetAt (int x, int y, Widget *exclude)
std::list< Widget * >	getWidgetsIn (Rectangle const &area)
virtual std::list< Widget * >	getWidgetsIn (Rectangle const &area, Widget *ignore)
int	getWidth () const
int	getX () const
int	getY () const
bool	hasMouseCapture () const
bool	isDescendantOf (Widget const *ancestor) const noexcept
bool	isEnabled () const
bool	isFixedSize () const
bool	isFocusable () const
virtual bool	isFocused () const
bool	isHorizontalExpand () const
bool	isInsideActiveMouseModal () const noexcept
bool	isLastPositionSet () const
virtual bool	isModalFocusable () const
virtual bool	isModalFocused () const
virtual bool	isModalMouseInputFocusable () const
bool	isMouseInside (MouseEvent const &mouseEvent) const
bool	isSetVisible () const
bool	isTabInEnabled () const
bool	isTabOutEnabled () const
virtual bool	isUnderMouseModal () const
bool	isVerticalExpand () const
bool	isVisible () const
virtual void	logic ()
virtual void	moveToBottom (Widget *widget)
virtual void	moveToTop (Widget *widget)
virtual void	onFocusChanged ()
virtual void	onFocusGained ()
virtual void	onFocusLost ()
Widget &	operator= (Widget &&)=delete
Widget &	operator= (Widget const &)=delete
void	releaseMouse ()
void	removeActionListener (ActionListener *actionListener)
void	removeDeathListener (DeathListener *deathListener)
void	removeDropTargetListener (DropTargetListener *listener)
void	removeFocusListener (FocusListener *focusListener)
void	removeKeyListener (KeyListener *keyListener)
void	removeMouseListener (MouseListener *mouseListener)
void	removeWidgetListener (WidgetListener *widgetListener)
virtual void	requestFocus ()
virtual void	requestMoveToBottom ()
virtual void	requestMoveToTop ()
void	setActionEventId (std::string const &actionEventId)
virtual void	setBackgroundColor (Color const &color)
virtual void	setBaseColor (Color const &color)
void	setBorderBottom (unsigned int size, unsigned int style)
virtual void	setBorderColor (Color const &color)
void	setBorderSides (unsigned int sides)
void	setBorderSize (unsigned int size)
void	setBorderStyle (unsigned int style)
void	setBorderTop (unsigned int size, unsigned int style)
virtual void	setDimension (Rectangle const &dimension)
void	setEnabled (bool enabled)
void	setFixedSize (Size const &size)
void	setFocusable (bool focusable)
virtual void	setFocused (bool focused)
virtual void	setFont (Font *font)
virtual void	setForegroundColor (Color const &color)
virtual void	setHeight (int height)
void	setHorizontalExpand (bool expand)
void	setId (std::string const &id)
void	setInternalFocusHandler (FocusHandler *internalFocusHandler)
void	setLastPosition (int x, int y)
void	setMargin (int margin)
void	setMarginBottom (int margin)
void	setMarginLeft (int margin)
void	setMarginRight (int margin)
void	setMarginTop (int margin)
void	setMaxSize (Size const &size)
void	setMinSize (Size const &size)
virtual void	setOutlineColor (Color const &color)
void	setOutlineSize (unsigned int size)
void	setPadding (unsigned int padding)
void	setPaddingBottom (unsigned int padding)
void	setPaddingLeft (unsigned int padding)
void	setPaddingRight (unsigned int padding)
void	setPaddingTop (unsigned int padding)
void	setPosition (int x, int y)
virtual void	setSelectionColor (Color const &color)
virtual void	setSelectionMode (SelectionMode mode)
virtual void	setSize (int width, int height)
void	setTabInEnabled (bool enabled)
void	setTabOutEnabled (bool enabled)
void	setVerticalExpand (bool expand)
void	setVisible (bool visible)
virtual void	setWidth (int width)
void	setX (int x)
void	setY (int y)
virtual void	showPart (Rectangle rectangle)
virtual void	showWidgetPart (Widget *widget, Rectangle area)
	Widget ()
	Widget (Widget &&)=delete
	Widget (Widget const &)=delete
Public Member Functions inherited from fcn::ActionListener
	ActionListener (ActionListener &&)=delete
	ActionListener (ActionListener const &)=delete
ActionListener &	operator= (ActionListener &&)=delete
ActionListener &	operator= (ActionListener const &)=delete
Public Member Functions inherited from fcn::KeyListener
	KeyListener (KeyListener &&)=default
	KeyListener (KeyListener const &)=default
KeyListener &	operator= (KeyListener &&)=default
KeyListener &	operator= (KeyListener const &)=default
Public Member Functions inherited from fcn::MouseListener
virtual void	mouseClicked (MouseEvent &mouseEvent)
virtual void	mouseDragged (MouseEvent &mouseEvent)
virtual void	mouseEntered (MouseEvent &mouseEvent)
virtual void	mouseExited (MouseEvent &mouseEvent)
	MouseListener (MouseListener &&)=default
	MouseListener (MouseListener const &)=default
virtual void	mouseMoved (MouseEvent &mouseEvent)
virtual void	mouseReleased (MouseEvent &mouseEvent)
virtual void	mouseWheelMovedDown (MouseEvent &mouseEvent)
virtual void	mouseWheelMovedLeft (MouseEvent &mouseEvent)
virtual void	mouseWheelMovedRight (MouseEvent &mouseEvent)
virtual void	mouseWheelMovedUp (MouseEvent &mouseEvent)
MouseListener &	operator= (MouseListener &&)=default
MouseListener &	operator= (MouseListener const &)=default

Protected Member Functions
void	action (ActionEvent const &event) override
void	draw (Graphics *graphics) override
void	keyPressed (KeyEvent &event) override
void	keyReleased (KeyEvent &event) override
void	mousePressed (MouseEvent &event) override
Protected Member Functions inherited from fcn::Container
void	distributeWidgetAddedEvent (Widget *source)
void	distributeWidgetRemovedEvent (Widget *source)
Protected Member Functions inherited from fcn::Widget
void	add (Widget *widget)
void	calculateSize ()
void	distributeActionEvent ()
void	distributeAncestorHiddenEvent (Widget *ancestor)
void	distributeAncestorMovedEvent (Widget *ancestor)
void	distributeAncestorShownEvent (Widget *ancestor)
void	distributeDragDrop (DragEvent &event)
bool	distributeDragEnter (DragEvent &event)
void	distributeDragHover (DragEvent &event)
void	distributeDragLeave (DragEvent &event)
void	distributeHiddenEvent ()
void	distributeMovedEvent ()
void	distributeResizedEvent ()
void	distributeShownEvent ()
std::list< Widget * > const &	getChildren () const
void	resizeToChildren ()
Protected Member Functions inherited from fcn::ActionListener
	ActionListener ()=default
Protected Member Functions inherited from fcn::KeyListener
	KeyListener ()=default
Protected Member Functions inherited from fcn::MouseListener
	MouseListener ()=default

Additional Inherited Members
Public Types inherited from fcn::HorizontalBar
enum class	Alignment { Start , Center , End }
Public Types inherited from fcn::Container
enum class	LayoutPolicy : uint8_t {   Absolute = 0 , AutoSize , Vertical , Horizontal ,   Circular }
Public Types inherited from fcn::Widget
enum	BorderSide : uint8_t {   BORDER_NONE = 0 , BORDER_LEFT = 1 << 0 , BORDER_TOP = 1 << 1 , BORDER_RIGHT = 1 << 2 ,   BORDER_BOTTOM = 1 << 3 , BORDER_ALL = BORDER_LEFT | BORDER_TOP | BORDER_RIGHT | BORDER_BOTTOM }
enum	BorderStyle : uint8_t { BORDER_STYLE_BEVEL = 0 , BORDER_STYLE_FLAT = 1 }
enum class	SelectionMode : uint8_t { None = 0 , Border = 1 , Background = 2 }
Static Public Member Functions inherited from fcn::Widget
static DeathListener *	_getGuiDeathListener ()
static VisibilityEventHandler *	_getVisibilityEventHandler ()
static void	_setGuiDeathListener (DeathListener *deathListener)
static void	_setVisibilityEventHandler (VisibilityEventHandler *visibilityEventHandler)
static Widget *	getMouseCapture ()
static void	resetGlobalFont ()
static void	setGlobalFont (Font *font)
static bool	widgetExists (Widget const *widget)
Protected Types inherited from fcn::Container
using	ContainerListenerIterator = ContainerListenerList::iterator
using	ContainerListenerList = std::list<ContainerListener*>
Protected Attributes inherited from fcn::HorizontalBar
bool	mClipping {true}
bool	mExpandChildren {false}
unsigned int	mFixedHeight {0}
unsigned int	mPadding {4}
unsigned int	mSpacing {4}
Protected Attributes inherited from fcn::Container
Widget *	mBackgroundWidget {nullptr}
ContainerListenerList	mContainerListeners
unsigned int	mHorizontalSpacing {2}
LayoutPolicy	mLayout {LayoutPolicy::Absolute}
float	mOpacity {1.0F}
bool	mOpaque {true}
bool	mUniform {false}
unsigned int	mVerticalSpacing {2}
Protected Attributes inherited from fcn::Widget
std::string	mActionEventId
std::list< ActionListener * >	mActionListeners
Color	mBackgroundColor {0xf9fafb}
Color	mBaseColor {0xe5e7eb}
Color	mBorderColor {0xd1d5db}
unsigned int	mBorderSides {BORDER_ALL}
unsigned int	mBorderSize {0}
unsigned int	mBorderStyle {BORDER_STYLE_FLAT}
std::list< Widget * >	mChildren
Font *	mCurrentFont {nullptr}
std::list< DeathListener * >	mDeathListeners
Rectangle	mDimension
std::list< DropTargetListener * >	mDropTargetListeners
bool	mEnabled {true}
Size	mFixedSize {-1, -1}
bool	mFixedSizeUsed {false}
bool	mFocusable {false}
bool	mFocused {false}
FocusHandler *	mFocusHandler {nullptr}
std::list< FocusListener * >	mFocusListeners
Color	mForegroundColor {0x1f2933}
bool	mHExpand {false}
std::string	mId
FocusHandler *	mInternalFocusHandler {nullptr}
std::list< KeyListener * >	mKeyListeners
int	mLastX {0}
int	mLastY {0}
int	mMarginBottom {0}
int	mMarginLeft {0}
int	mMarginRight {0}
int	mMarginTop {0}
Size	mMaxSize {std::numeric_limits<int>::max(), std::numeric_limits<int>::max()}
Size	mMinSize {0, 0}
std::list< MouseListener * >	mMouseListeners
Rectangle	mOffsetRect
Color	mOutlineColor {0x9ca3af}
unsigned int	mOutlineSize {0}
unsigned int	mPaddingBottom {0}
unsigned int	mPaddingLeft {0}
unsigned int	mPaddingRight {0}
unsigned int	mPaddingTop {0}
Widget *	mParent {nullptr}
Color	mSelectionColor {0x3b82f6}
SelectionMode	mSelectionMode {SelectionMode::None}
bool	mTabIn {true}
bool	mTabOut {true}
bool	mVExpand {false}
bool	mVisible {true}
std::list< WidgetListener * >	mWidgetListeners
Static Protected Attributes inherited from fcn::Widget
static DefaultFont	mDefaultFont
static Font *	mGlobalFont = nullptr
static DeathListener *	mGuiDeathListener = nullptr
static VisibilityEventHandler *	mVisibilityEventHandler = nullptr
static std::list< Widget * >	mWidgetInstances
static Widget *	sMouseCapture = nullptr

Detailed Description

A menu bar widget that displays menus at the top of a window.

MenuBar displays horizontal top-level menu items. Clicking on an item opens the corresponding MenuPopup dropdown.

Definition at line 31 of file menubar.hpp.

Constructor & Destructor Documentation

MenuBar()

fcn::MenuBar::MenuBar

(

)

Constructor.

Definition at line 17 of file menubar.cpp.

References fcn::Widget::addMouseListener(), fcn::Widget::getBorderStyle(), fcn::Widget::setBorderBottom(), fcn::HorizontalBar::setFixedHeight(), and fcn::Container::setOpaque().

Member Function Documentation

action()

void fcn::MenuBar::action ( ActionEvent const & actionEvent )

overrideprotectedvirtual

Handles an action event emitted by a widget.

Invoked when a widget triggers an action, providing details about the event via the ActionEvent object.

Parameters

actionEvent

The action event data.

Implements fcn::ActionListener.

Definition at line 78 of file menubar.cpp.

References fcn::Widget::getParent(), fcn::Widget::getX(), fcn::Widget::getY(), fcn::MenuPopup::hide(), fcn::Widget::requestFocus(), and fcn::MenuPopup::show().

Referenced by keyPressed().

addMenu()

Widget * fcn::MenuBar::addMenu	(	std::string const &	text,
		MenuPopup *	popup = nullptr )

Adds a menu item to the menu bar.

Parameters

text	The menu text (e.g., "File", "Edit").
popup	The popup to open when clicked (can be nullptr for non-dropdown items).

Returns

The created MenuItem.

Definition at line 26 of file menubar.cpp.

References fcn::Container::add(), fcn::Widget::getTop(), fcn::MenuPopup::setParentMenuItem(), and fcn::Widget::setVisible().

closeAll()

void fcn::MenuBar::closeAll

(

)

Closes all open menus.

Definition at line 60 of file menubar.cpp.

draw()

void fcn::MenuBar::draw ( Graphics * graphics )

overrideprotectedvirtual

Draws the menu bar (background and bottom border).

Reimplemented from fcn::HorizontalBar.

Definition at line 220 of file menubar.cpp.

References fcn::Container::draw(), fcn::Graphics::fillRectangle(), fcn::Widget::getBackgroundColor(), fcn::Widget::getHeight(), fcn::Widget::getWidth(), fcn::Container::isOpaque(), and fcn::Graphics::setColor().

getOpenMenu()

MenuPopup * fcn::MenuBar::getOpenMenu

(

)

const

Gets the currently open menu popup.

Returns

The open popup, or nullptr if none.

Definition at line 73 of file menubar.cpp.

isMenuOpen()

bool fcn::MenuBar::isMenuOpen

(

)

const

Checks if any menu is currently open.

Returns

True if a menu is open.

Definition at line 68 of file menubar.cpp.

keyPressed()

void fcn::MenuBar::keyPressed ( KeyEvent & keyEvent )

overrideprotectedvirtual

Called if a key is pressed when the widget has keyboard focus.

If a key is held down the widget will generate multiple key presses.

Parameters

keyEvent

Describes the event.

Reimplemented from fcn::KeyListener.

Definition at line 126 of file menubar.cpp.

References action(), fcn::Container::getChild(), fcn::Widget::getChildrenCount(), fcn::Key::getValue(), and fcn::Widget::requestFocus().

keyReleased()

void fcn::MenuBar::keyReleased ( KeyEvent & keyEvent )

overrideprotectedvirtual

Called if a key is released when the widget has keyboard focus.

Parameters

keyEvent

Describes the event.

Reimplemented from fcn::KeyListener.

Definition at line 183 of file menubar.cpp.

mousePressed()

void fcn::MenuBar::mousePressed ( MouseEvent & mouseEvent )

overrideprotectedvirtual

Called when a mouse button has been pressed down on the widget area.

Note

A mouse press is NOT equal to a mouse click. Use mouseClicked() for "pressed AND released" (full click) on a widget.

See also

mouseClicked

Parameters

mouseEvent

Describes the event.

Reimplemented from fcn::MouseListener.

Definition at line 188 of file menubar.cpp.

References fcn::Widget::getWidgetAt(), fcn::MouseEvent::getX(), fcn::MouseEvent::getY(), and fcn::Widget::requestFocus().

---

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

• menubar.hpp
• menubar.cpp