menu.h

Go to the documentation of this file.

#ifndef MENU_CLASS
#define MENU_CLASS

/*****************************************************************************\
*                                                                             *
*  Name   : menu                                                              *
*  Author : Chris Koeritz                                                     *
*                                                                             *
*  Purpose:                                                                   *
*                                                                             *
*    Provides a fairly simplified interface to the window system's menus.     *
*                                                                             *
*******************************************************************************
* Copyright (c) 1991-$now By Author.  This program is free software; you can  *
* redistribute it and/or modify it under the terms of the GNU General Public  *
* License as published by the Free Software Foundation; either version 2 of   *
* the License or (at your option) any later version.  This is online at:      *
*     http://www.fsf.org/copyleft/gpl.html                                    *
* Please send any updates to: fred@gruntose.com                               *
\*****************************************************************************/

#include "dll_wp_active.h"

#include <wp_passive/argument_list.h>
#include <wp_passive/worker.h>

class wp_menu_item;

class WP_ACTIVE_CLASS_STYLE menu : public worker
{
public:
  menu(manager &parent, const c_point &origin, const char *title,
       const color &foreground = colors::WHITE, const color &background = colors::BLACK);
    // this constructor creates a menu bar with "title" as the name of the
    // application?
  ~menu();

  void add(wp_menu_item *to_add);
    // puts another top-level menu item on the menu bar.  if that item is
    // to have sub-menus and so forth, then the wp_menu_item must be connected
    // to another wp_menu_item.

  virtual void draw();

  static void wp_menu_item_callback(window_handle w, wp_menu_item *the_item, caddr_t call_data);
    // invoked by motif when the menu is triggered by the user.

private:
  amorph<wp_menu_item> menu_list;
  istring _title;

  void recursively_create(window_handle parent, const char *title,
          amorph<wp_menu_item> *menulist);
};

class WP_ACTIVE_CLASS_STYLE wp_menu_item : public nub
{
public:
  wp_menu_item(menu &parent, const char *name = NIL, bool label = false);
    // constructs a new item.  if the "name" is NIL, then the item's space in
    // the menu is a separator instead of a choosable option.  if "label" is
    // true, then the item is only a label and will not trigger an event when
    // it is selected.  also, if another item is connected to this item (by
    // calling connect with "this" as the wp_menu_item to connect), then no event
    // is triggered when the item connected to this is selected (instead, the
    // submenu represented by this menu item appears).

  virtual ~wp_menu_item();

  void connect(wp_menu_item *to_connect);
    // attaches a sub-menu to this menu item.  when a wp_menu_item has sub-menu_
    // items connected to it, the wp_menu_item does not trigger the
    // item_selected_event.  "name" is the name for the sub-menu.  "to_connect"
    // is an item to connect to "this" wp_menu_item.  Multiple sub-menu items
    // can be connected to a wp_menu_item.

  void submenu_name(const istring &name);
    // sets the name of the submenu.  only used if one is connected.

  virtual void item_selected_event();
    // This event function is triggered when this wp_menu_item is selected by the
    // user as long as this item is: 1) visible, 2) not a separator, 3) not a
    // label, and 4) not a wp_menu_item with a sub_menu connected to it.

  IMPLEMENT_CLASS_NAME("wp_menu_item");

private:
  istring name;
  bool i_am_label;
  amorph<wp_menu_item> sub_menus;
  istring sub_menu_title;

  friend class menu;
  menu &parent;
};

#endif

---