fltk/src/Fl_Sys_Menu_Bar.cxx

254 lines
8.1 KiB
C++

//
// system menu bar widget for the Fast Light Tool Kit (FLTK).
//
// Copyright 1998-2021 by Bill Spitzak and others.
//
// This library is free software. Distribution and use rights are outlined in
// the file "COPYING" which should have been included with this file. If this
// file is missing or damaged, see the license at:
//
// https://www.fltk.org/COPYING.php
//
// Please see the following page on how to report bugs and issues:
//
// https://www.fltk.org/bugs.php
//
#include <config.h>
#include "Fl_Sys_Menu_Bar_Driver.H"
#include <FL/platform.H>
#include "Fl_System_Driver.H"
Fl_Sys_Menu_Bar *fl_sys_menu_bar = 0;
/**
The constructor.
On Mac OS X, all arguments are unused. On other platforms they are used as by Fl_Menu_Bar::Fl_Menu_Bar().
*/
Fl_Sys_Menu_Bar::Fl_Sys_Menu_Bar(int x,int y,int w,int h,const char *l)
: Fl_Menu_Bar(x,y,w,h,l)
{
if (driver()) {
if (fl_sys_menu_bar) delete fl_sys_menu_bar;
fl_sys_menu_bar = this;
driver()->bar = this;
}
}
/** The destructor */
Fl_Sys_Menu_Bar::~Fl_Sys_Menu_Bar()
{
if (driver()) {
fl_sys_menu_bar = 0;
clear();
}
}
void Fl_Sys_Menu_Bar::update() {
if (driver()) driver()->update();
}
/**
\brief create a system menu bar using the given list of menu structs
\author Matthias Melcher
\param m Zero-ending list of Fl_Menu_Item's
*/
void Fl_Sys_Menu_Bar::menu(const Fl_Menu_Item *m)
{
if (driver()) driver()->menu(m);
else Fl_Menu_Bar::menu(m);
}
/** Changes the shortcut of item i to n.
*/
void Fl_Sys_Menu_Bar::shortcut (int i, int s) {
if (driver()) driver()->shortcut(i, s);
else Fl_Menu_Bar::shortcut(i, s);
}
/** Turns the radio item "on" for the menu item and turns "off" adjacent radio items of the same group.*/
void Fl_Sys_Menu_Bar::setonly (Fl_Menu_Item *item) {
if (driver()) driver()->setonly(item);
else Fl_Menu_Bar::setonly(item);
}
/** Sets the flags of item i
\see Fl_Menu_::mode(int i, int fl) */
void Fl_Sys_Menu_Bar::mode (int i, int fl) {
if (driver()) driver()->mode(i, fl);
else Fl_Menu_Bar::mode(i, fl);
}
/**
\brief Add a new menu item to the system menu bar.
Add to the system menu bar a new menu item, with a title string, shortcut int,
callback, argument to the callback, and flags.
\param label - new menu item's label
\param shortcut - new menu item's integer shortcut (can be 0 for none, or e.g. FL_ALT+'x')
\param cb - callback to be invoked when item selected (can be 0 for none, in which case the menubar's callback() can be used instead)
\param user_data - argument to the callback
\param flags - item's flags, e.g. ::FL_MENU_TOGGLE, etc.
\returns the index into the menu() array, where the entry was added
\see Fl_Menu_::add(const char* label, int shortcut, Fl_Callback *cb, void *user_data, int flags)
*/
int Fl_Sys_Menu_Bar::add(const char* label, int shortcut, Fl_Callback *cb, void *user_data, int flags)
{
if (driver()) return driver()->add(label, shortcut, cb, user_data, flags);
else return Fl_Menu_Bar::add(label, shortcut, cb, user_data, flags);
}
/**
Forms-compatible procedure to add items to the system menu bar
\returns the index into the menu() array, where the entry was added
\see Fl_Menu_::add(const char* str)
*/
int Fl_Sys_Menu_Bar::add(const char* str)
{
return driver() ? driver()->add(str) : Fl_Menu_Bar::add(str);
}
/**
\brief insert in the system menu bar a new menu item
Insert in the system menu bar a new menu item, with a title string, shortcut int,
callback, argument to the callback, and flags.
\returns the index into the menu() array, where the entry was inserted
\see Fl_Menu_::insert(int index, const char* label, int shortcut, Fl_Callback *cb, void *user_data, int flags)
*/
int Fl_Sys_Menu_Bar::insert(int index, const char* label, int shortcut, Fl_Callback *cb, void *user_data, int flags)
{
return driver() ? driver()->insert(index, label, shortcut, cb, user_data, flags) :
Fl_Menu_Bar::insert(index, label, shortcut, cb, user_data, flags);
}
/** Set the Fl_Menu_Item array pointer to null, indicating a zero-length menu.
\see Fl_Menu_::clear()
*/
void Fl_Sys_Menu_Bar::clear()
{
if (driver()) driver()->clear();
else Fl_Menu_Bar::clear();
}
/** Clears the specified submenu pointed to by index of all menu items.
\see Fl_Menu_::clear_submenu(int index)
*/
int Fl_Sys_Menu_Bar::clear_submenu(int index)
{
return driver() ? driver()->clear_submenu(index) : Fl_Menu_Bar::clear_submenu(index);
}
/**
\brief remove an item from the system menu bar
\param index the index of the item to remove
*/
void Fl_Sys_Menu_Bar::remove(int index)
{
if (driver()) driver()->remove(index);
else Fl_Menu_Bar::remove(index);
}
/**
\brief rename an item from the system menu bar
\param index the index of the item to rename
\param name the new item name as a UTF8 string
*/
void Fl_Sys_Menu_Bar::replace(int index, const char *name)
{
if (driver()) driver()->replace(index, name);
else Fl_Menu_Bar::replace(index, name);
}
/**
Attaches a callback to the "About myprog" item of the system application menu.
This cross-platform function is effective only under the MacOS platform.
\param cb a callback that will be called by "About myprog" menu item
with NULL 1st argument.
\param data a pointer transmitted as 2nd argument to the callback.
*/
void Fl_Sys_Menu_Bar::about(Fl_Callback *cb, void *data) {
if (driver()) {
fl_open_display(); // create the system menu, if needed
driver()->about(cb, data);
}
}
void Fl_Sys_Menu_Bar::draw() {
if (driver()) driver()->draw();
else Fl_Menu_Bar::draw();
}
/** Get the style of the Window menu in the system menu bar */
Fl_Sys_Menu_Bar::window_menu_style_enum Fl_Sys_Menu_Bar::window_menu_style() {
return driver() ? Fl_Sys_Menu_Bar_Driver::window_menu_style() : no_window_menu;
}
/** Set the desired style of the Window menu in the system menu bar.
This function, to be called before the first call to Fl_Window::show(), allows to
control whether the system menu bar should contain a Window menu,
and if yes, whether new windows should be displayed in tabbed form. These are
the effects of various values for \p style :
\li \c no_window_menu : don't add a Window menu to the system menu bar
\li \c tabbing_mode_none : add a simple Window menu to the system menu bar
\li \c tabbing_mode_automatic : the window menu also contains "Merge All Windows" to group
all windows in a single tabbed display mode. This is the \b default Window menu style
for FLTK apps.
\li \c tabbing_mode_preferred : new windows are displayed in tabbed mode when first created
The Window menu, if present, is entirely created and controlled by the FLTK library.
Mac OS version 10.12 or later must be running for windows to be displayed in tabbed form.
Under non MacOS platforms, this function does nothing.
\version 1.4
*/
void Fl_Sys_Menu_Bar::window_menu_style(Fl_Sys_Menu_Bar::window_menu_style_enum style) {
if (driver()) Fl_Sys_Menu_Bar_Driver::window_menu_style(style);
}
/** Adds a Window menu, to the end of the system menu bar.
FLTK apps typically don't need to call this function which is automatically
called by the library the first time a window is shown. The default system menu bar
contains a Window menu with a "Merge All Windows" item.
Other Window menu styles can be obtained calling
Fl_Sys_Menu_Bar::window_menu_style(window_menu_style_enum) before the first Fl_Window::show().
Alternatively, an app can call create_window_menu() after having populated the system menu bar,
for example with menu(const Fl_Menu_Item *), and before the first Fl_Window::show().
This function does nothing on non MacOS platforms.
\version 1.4
*/
void Fl_Sys_Menu_Bar::create_window_menu() {
if (driver()) {
fl_open_display();
fl_sys_menu_bar->driver()->create_window_menu();
}
}
#if !defined(FL_DOXYGEN)
Fl_Sys_Menu_Bar_Driver *Fl_Sys_Menu_Bar::driver() {
return Fl::system_driver()->sys_menu_bar_driver();
}
Fl_Sys_Menu_Bar_Driver *Fl_Sys_Menu_Bar_Driver::driver_ = 0;
Fl_Sys_Menu_Bar_Driver::Fl_Sys_Menu_Bar_Driver() {bar = NULL;}
Fl_Sys_Menu_Bar_Driver::~Fl_Sys_Menu_Bar_Driver() {}
Fl_Sys_Menu_Bar::window_menu_style_enum Fl_Sys_Menu_Bar_Driver::window_menu_style_ = Fl_Sys_Menu_Bar::tabbing_mode_automatic;
#endif // !defined(FL_DOXYGEN)