mirror of https://github.com/odrling/Aegisub
62 lines
2.2 KiB
C++
62 lines
2.2 KiB
C++
// Copyright (c) 2011, Thomas Goyne <plorkyeran@aegisub.org>
|
|
//
|
|
// Permission to use, copy, modify, and distribute this software for any
|
|
// purpose with or without fee is hereby granted, provided that the above
|
|
// copyright notice and this permission notice appear in all copies.
|
|
//
|
|
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
// WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
// MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
// ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
// WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
// ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
// OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
|
|
/// @file menu.h
|
|
/// @brief Dynamic menu and toolbar generator.
|
|
/// @ingroup menu toolbar
|
|
|
|
#include <memory>
|
|
#include <string>
|
|
|
|
#include <libaegisub/exception.h>
|
|
|
|
namespace agi { struct Context; }
|
|
|
|
class wxFrame;
|
|
class wxMenu;
|
|
class wxMenuBar;
|
|
class wxWindow;
|
|
|
|
namespace menu {
|
|
DEFINE_EXCEPTION(Error, agi::Exception);
|
|
DEFINE_EXCEPTION(UnknownMenu, Error);
|
|
DEFINE_EXCEPTION(InvalidMenu, Error);
|
|
|
|
/// @brief Get the menu with the specified name as a wxMenuBar
|
|
/// @param name Name of the menu
|
|
///
|
|
/// Throws:
|
|
/// UnknownMenu if no menu with the given name was found
|
|
/// BadMenu if there is a menu with the given name, but it is invalid
|
|
void GetMenuBar(std::string const& name, wxFrame *window, agi::Context *c);
|
|
|
|
/// @brief Get the menu with the specified name as a wxMenu
|
|
/// @param name Name of the menu
|
|
///
|
|
/// Throws:
|
|
/// UnknownMenu if no menu with the given name was found
|
|
/// BadMenu if there is a menu with the given name, but it is invalid
|
|
std::unique_ptr<wxMenu> GetMenu(std::string const& name, agi::Context *c);
|
|
|
|
/// @brief Open a popup menu at the mouse
|
|
/// @param menu Menu to open
|
|
/// @param parent_window Parent window for the menu; cannot be NULL
|
|
///
|
|
/// This function should be used rather than wxWindow::PopupMenu due to
|
|
/// that PopupMenu does not trigger menu open events and triggers update
|
|
/// ui events on the opening window rather than the menu for some bizarre
|
|
/// reason
|
|
void OpenPopupMenu(wxMenu *menu, wxWindow *parent_window);
|
|
}
|