Элементы управления. Компоненты меню

void TCentralComponent::menuItemSelected(int iMenuItemID, int iTopLevelMenuIndex)
{
  // Обработчики команд меню
  switch(iMenuItemID)
  {
  // Если выбран пункт "Выход"...
    case FileQuit:
    {
       // Завершаем работу программы
      JUCEApplication::quit();
      break;
    }
    // Если выбран пункт "Новый"...
    case FileNew:
    {
      // показываем сообщение
      AlertWindow::showMessageBox(AlertWindow::InfoIcon, tr("Информация"),  
            tr("Выбран пункт \"Новый\""), tr("Да"), 0);
      break;
    }
    // Если выбран пункт "Открыть"...
    case FileOpen:
    {
      // показываем сообщение
      AlertWindow::showMessageBox(AlertWindow::InfoIcon, tr("Информация"), 
           tr("Выбран пункт \"Открыть\""), tr("Да"), 0);
      break;
    }
  }
}

Метод ).

const PopupMenu TCentralComponent::getMenuForIndex(int iIndex, 
            const String sMenuName)
{
  // Создаём выпадающее меню
  PopupMenu Menu;

  switch(iIndex)
  {
    // Индекс 0 соответствует пункту меню "Файл"
    // (см. getMenuBarNames)
    case 0:
    {
      // Добавляем новые пункты в меню "Файл"
      Menu.addItem(FileNew, tr("Новый"), true, false, ImageNew_png);
      Menu.addItem(FileOpen, tr("Открыть"), true, false, ImageOpen_png);
      // Добавляем разделитель
      Menu.addSeparator();
      Menu.addItem(FileQuit, tr("Выход"), true, false, ImageExit_png);
      break;
    }
  }

  return Menu;
}

Для добавления новых пунктов в выпадающее меню мы воспользовались методом void PopupMenu::addItem(int itemResultId, const String itemText, bool isEnabled = true, bool isTicked = false const Image iconToUse = Image::null) , класса PopupMenu. Метод принимает следующие параметры:

Для того, чтобы удалить все пункты из меню, необходимо вызвать метод void PopupMenu::clear().

void TCentralComponent::mouseDown(const MouseEvent Event)
{
  // Если пользователь пытается вызвать контекстное меню...
  if(Event.mods.isPopupMenu())
  {
    // создаём его...
    PopupMenu LabelPopupMenu;
    // и добавляем в него пункты
    LabelPopupMenu.addItem(FileNew, tr("Новый"), true, false, 
            ImageNew_png);
    LabelPopupMenu.addItem(FileOpen, tr("Открыть"), true, false,
            ImageOpen_png);
    LabelPopupMenu.addSeparator();
    LabelPopupMenu.addItem(FileQuit, tr("Выход"), true, false, 
            ImageExit_png);

    // Показываем контекстное меню.
    const int iResult = LabelPopupMenu.show();

    // В зависимости от идентификатора команды
    // вызываем тот или иной обработчик.
    if(iResult == FileNew)
    {
      AlertWindow::showMessageBox(AlertWindow::InfoIcon, tr("Информация"), 
            tr("Выбран пункт \"Новый\""), tr("Да"), 0);
    }
    else if(iResult == FileOpen)
    {
      AlertWindow::showMessageBox(AlertWindow::InfoIcon, tr("Информация"),                      
            tr("Выбран пункт \"Открыть\""), tr("Да"), 0);
    }
    else if(iResult == FileQuit)
    {
      JUCEApplication::quit();
    }
  }
}

Поскольку контекстное меню вызывается нажатием правой кнопки мыши, а метод mouseDown вызывается, когда пользователь нажимает любую кнопку, мы предусмотрели соответствующее условие выполнения: мы вызываем публичное свойство класса MouseEvent const ModifierKeys MouseEvent::mods, которое представляет собой ключевой модификатор, ассоциированный с этим событием. Метод bool ModifierKeys::isPopupMenu() const throw() класса ModifierKeys позволяет узнать, было ли это событие связано с вызовом пользователем контекстного меню. Для подобной проверки рекомендуется вызывать именно этот метод, а не bool ModifierKeys::isRightButtonDown() const throw(), информирующий о нажатии правой кнопки мыши, исходя из соображений совместимости с Mac OS X, где контекстное меню вызывается как нажатием на клавишу <CTRL>, так и правой кнопкой мыши.

После этого создаётся контекстное меню, в которое добавляются пункты уже знакомым по меню верхнего уровня способом.

Показ контекстного меню осуществляет уже упоминавшаяся выше функция int PopupMenu::show(int itemIdThatMustBeVisible = 0, int minimumWidth = 0, int maximumNumColumns = 0, int standardItemHeight = 0, ModalComponentManager::Callback * callback = 0). Она принимает следующие параметры:

В нашем примере мы оставили все параметры принятыми по умолчанию.

#include "TCentralComponent.h"
#include"TImagesFactory.h"
//-------------------------------------------------------
#define tr(s) String::fromUTF8(s)
//-------------------------------------------------------
TCentralComponent::TCentralComponent(TMainForm* pParent) 
            : Component("Central Component"),
            pMessagesLabel(0)
{
  this->pParent = pParent;
  
  pMessagesLabel = new Label(L"Messages Label", "");
  pMessagesLabel->setFont(Font(15.0000f, Font::plain));
  pMessagesLabel->setJustificationType(Justification::centred);
  pMessagesLabel->setEditable (false, false, false);
  pMessagesLabel->setColour(Label::outlineColourId, Colours::black);
  pMessagesLabel->setColour(Label::textColourId, Colours::black);
  pMessagesLabel->setColour(Label::backgroundColourId, Colours::azure);
  addAndMakeVisible(pMessagesLabel);

  ImageExit_png = ImageCache::getFromMemory(TImagesFactory::psExit_png, 
            TImagesFactory::iExit_pngSize);
  ImageNew_png = ImageCache::getFromMemory(TImagesFactory::psNew_png, 
            TImagesFactory::iNew_pngSize);
  ImageOpen_png = ImageCache::getFromMemory(TImagesFactory::psOpen_png, 
            TImagesFactory::iOpen_pngSize);

  setSize (700, 400);
  
  bEnglish = true;
  bRussian = false;
  
  LanguageChange();
}
//-----------------------------------------------------
TCentralComponent::~TCentralComponent()
{
  // Удаляем дочерние виджеты
  // и обнуляем их указатели
  deleteAllChildren();
}
//-----------------------------------------------------
void TCentralComponent::LanguageChange()
{
  if(bEnglish)
  {
    sMessagesLabelText = tr(
    quot;Choose an option of the main menu \nor right-click outside of the label 
    to invoke a context menu.");
    sFileMenuText = tr("File");
    sLanguageMenuText = tr("Language");
    sFileNewMenuText = tr("New");
    sFileOpenMenuText = tr("Open");
    sFileQuitText = tr("Quit");
    sMessageTitleText = tr("Information");
    sMessageNewText = tr("Option \"New\" was selected");
    sMessageOpenText = tr("Option \"Open\" was selected");
    sYesButtonText = tr("Yes");
  }
  else if(bRussian)
  {
    sMessagesLabelText = tr(
    "Выберите пункт главного меню \nили щёлкните правой кнопкой мыши 
    за пределами надписи для того, 
    чтобы вызвать контекстное меню.");
    sFileMenuText = tr("Файл");
    sLanguageMenuText = tr("Язык");
    sFileNewMenuText = tr("Новый");
    sFileOpenMenuText = tr("Открыть");
    sFileQuitText = tr("Выход");
    sMessageTitleText = tr("Информация");
    sMessageNewText = tr("Выбран пункт \"Новый\"");
    sMessageOpenText = tr("Выбран пункт \"Открыть\"");
    sYesButtonText = tr("Да");
  }
  
  pMessagesLabel->setText(sMessagesLabelText, false);
  getMenuBarNames();
  // Перерисовываем пункты меню с учётом нового языка
  menuItemsChanged();
}
//--------------------------------------------------

В конструкторе компонента содержимого мы вызываем наш метод LanguageChange для задания строк интерфейса приложения. Также эта функция будет вызываться всякий раз, когда пользователь выбирает новый пункт в меню "Язык". Флагом выбора того или иного языка выступают булевые переменные bEnglish и bRussian. Для того, чтобы принудительно перерисовать пункты меню, исходя из новых языковых настроек, мы вызываем метод void MenuBarModel::menuItemsChanged().

Рассмотрим реализацию функций, унаследованных от класса ).

ApplicationCommandTarget* TCentralComponent::getNextCommandTarget()
{getAllCommands
    return findFirstTargetParentComponent();
}

void TCentralComponent::getAllCommands(Array<int> iCommands)
{
  // Регистрация команд для командного менеджера
  const CommandID IDs[] =
  {
    LanguageEnglish,
    LanguageRussian
  };
  
  iCommands.addArray(IDs, numElementsInArray(IDs));
}

Метод ).

void TCentralComponent::getCommandInfo(CommandID ID, ApplicationCommandInfo 
            Result)
{
  switch(ID)
  {
    case LanguageEnglish:
    {
      Result.setInfo(L"English", L"Switch to English", "Language", 0);
      Result.setTicked(bEnglish);
      break;
    }
    case LanguageRussian:
    {
      Result.setInfo(tr("Русский"), L"Switch to Russian", "Language", 0);
      Result.setTicked(bRussian);
      break;
    }
  }
}

Как мы уже упоминали, за это отвечает объект класса ApplicationCommandInfo. Отображение соответствующих команде пунктов меню в программе мы задаём вызовом метода void ApplicationCommandInfo::setInfo(const String shortName, const String description, const String categoryName, int flags), который принимает следующие параметры:

Флагами являются идентификаторы перечислимого типа enum ApplicationCommandInfo::CommandFlags:

В нашем примере параметр ). Аналогично функция void ApplicationCommandInfo::setActive(bool isActive) throw() может делать пункт меню активным или неактивным, устанавливая или сбрасывая флаг isDisabled.

И наконец, рассмотрим метод ). Их работа понятна из комментариев.

bool TCentralComponent::perform(const InvocationInfo Info)
{
  switch(Info.commandID)
  {
    case LanguageEnglish:
    {
      // Отмечаем пункт меню - английский
      bEnglish = true;
      bRussian = false;
      break;
    }
    case LanguageRussian:
    {
      // Отмечаем пункт меню - русский
      bEnglish = false;
      bRussian = true;
      break;
    }
  }
  
  // Меняем язык интерфейса
  LanguageChange();

  return true;
}

Краткие итоги

Для создания меню верхнего уровня вашего приложения необходимо описать набор команд и связать его с соответствующими в модели меню (MenuBarModel). За отображение пунктов меню и выпадающих меню отвечает класс MenuBarComponent. Как выпадающее, так и контекстное меню создаётся объектами класса PopupMenu.

Дополнительные материал