Операционная система Microsoft Windows 3.1 для программиста

1.4. Приложение MENU

Теперь, когда мы рассказали вам о том, как создать шаблон меню и само меню, приведем исходные тексты простого приложения, работающего с меню. Оно создает меню, описанное нами ранее в разделе "Создание шаблона меню". Вид главного окна приложения был представлен на рис. 1.9.

В листинге 1.1 приведен исходный текст основного файла приложения.

Листинг 1.1. Файл menu/menu.cpp

// ----------------------------------------
// Работа с меню
// ----------------------------------------

#define STRICT
#include <windows.h>
#include <mem.h>
#include "menu.hpp"

// Прототипы функций
BOOL InitApp(HINSTANCE);
LRESULT CALLBACK _export WndProc(HWND, UINT, WPARAM, LPARAM);

// Имя класса окна
char const szClassName[]   = "MenuClass";

// Заголовок окна
char const szWindowTitle[] = "Menu Demo";

// =====================================
// Функция WinMain
// =====================================
#pragma argsused

int PASCAL
WinMain(HINSTANCE hInstance, 
        HINSTANCE hPrevInstance,
        LPSTR     lpszCmdLine, 
        int       nCmdShow)
{
  MSG  msg;   // структура для работы с сообщениями
  HWND hwnd;  // идентификатор главного окна приложения

  // Инициализируем приложение
  if(!InitApp(hInstance))
      return FALSE;

  // После успешной инициализации приложения создаем
  // главное окно приложения
  hwnd = CreateWindow(
    szClassName,         // имя класса окна
    szWindowTitle,       // заголовок окна
    WS_OVERLAPPEDWINDOW, // стиль окна
    CW_USEDEFAULT,       // задаем размеры и расположение
    CW_USEDEFAULT,       // окна, принятые по умолчанию
    CW_USEDEFAULT,
    CW_USEDEFAULT,
    0,                   // идентификатор родительского окна
    0,                   // идентификатор меню
    hInstance,           // идентификатор приложения
    NULL);               // указатель на дополнительные
                         // параметры

  // Если создать окно не удалось, завершаем приложение
  if(!hwnd)
    return FALSE;

  // Рисуем главное окно
  ShowWindow(hwnd, nCmdShow);
  UpdateWindow(hwnd);

  // Запускаем цикл обработки сообщений
  while(GetMessage(&msg, 0, 0, 0))
  {
    DispatchMessage(&msg);
  }
  return msg.wParam;
}

// =====================================
// Функция InitApp
// Выполняет регистрацию класса окна
// =====================================

BOOL
InitApp(HINSTANCE hInstance)
{
  ATOM aWndClass; // атом для кода возврата
  WNDCLASS wc;    // структура для регистрации
                  // класса окна

  // Записываем во все поля структуры нулевые значения
  memset(&wc, 0, sizeof(wc));

  // Подключаем меню 
  wc.lpszMenuName  = "APP_MENU";

  wc.style         = 0;
  wc.lpfnWndProc   = (WNDPROC) WndProc;
  wc.cbClsExtra    = 0;
  wc.cbWndExtra    = 0;
  wc.hInstance     = hInstance;
  wc.hIcon         = LoadIcon(NULL, IDI_APPLICATION);
  wc.hCursor       = LoadCursor(NULL, IDC_ARROW);
  wc.hbrBackground = (HBRUSH)(COLOR_WINDOW + 1);
  wc.lpszClassName = (LPSTR)szClassName;

  // Регистрация класса
  aWndClass = RegisterClass(&wc);

  return (aWndClass != 0);
}

// =====================================
// Функция WndProc
// =====================================

LRESULT CALLBACK _export
WndProc(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam)
{
  switch (msg)
  {
    case WM_COMMAND:
    {
      switch (wParam)
      {
        // Сообщения от меню
        case CM_HELPABOUT:
        case CM_HELPUSING_HELP:
        case CM_HELPPROCEDURES:
        case CM_HELPCOMMANDS:
        case CM_HELPKEYBOARD:
        case CM_HELPINDEX:
        case CM_EDITPASTE:
        case CM_EDITCOPY:
        case CM_EDITCUT:
        case CM_EDITUNDO:
        case CM_FILEPRINTER_SETUP:
        case CM_FILEPAGE_SETUP:
        case CM_FILEPRINT:
        case CM_FILESAVEAS:
        case CM_FILESAVE:
        case CM_FILEOPEN:
        case CM_FILENEW:
        {
          // На сообщение от любой строки меню кроме
          // завершающей работу программы реагируем
          // выводом сообщения об ошибке
               MessageBox(hwnd, "Функция не реализована",
                  NULL, MB_OK);
          return 0;
        }

        // Завершаем работу приложения
        case CM_FILEEXIT:
        {
          DestroyWindow(hwnd);
          return 0;
        }

        default:
          return 0;
      }
    }

    case WM_DESTROY:
    {
      PostQuitMessage(0);
      return 0;
    }

    default:
      break;
  }
  return DefWindowProc(hwnd, msg, wParam, lParam);
}

Функция WinMain регистрирует класс окна и создает на его базе главное окно приложения.

При регистрации класса окна указывается имя шаблона меню, определенного в файле описания ресурсов:

wc.lpszMenuName  = "APP_MENU";

В остальном функция WinMain не имеет никаких особенностей.

Функция главного окна WndProc обрабатывает сообщение WM_COMMAND, поступающее от меню. Для всех идентификаторов, кроме CM_FILEEXIT, обработка сводится к выводу сообщения о том, что данная функция не реализована. Если вы из меню 'File" нашего приложения выбираете строку "Exit", обработчик сообщения WM_COMMAND уничтожает главное окно приложения, вызывая функцию DestroyWindow. Это приводит к завершению работы приложения.

Идентификаторы строк меню описаны в файле menu.hpp (листинг 1.2), включаемом при помощи оператора #include в главный файл приложения и файл описания ресурсов.

Листинг 1.2. Файл menu/menu.hpp

#define CM_HELPABOUT          24346
#define CM_HELPUSING_HELP     24345
#define CM_HELPPROCEDURES     24344
#define CM_HELPCOMMANDS       24343
#define CM_HELPKEYBOARD       24342
#define CM_HELPINDEX          24341

#define CM_EDITPASTE          24324
#define CM_EDITCOPY           24323
#define CM_EDITCUT            24322
#define CM_EDITUNDO           24321

#define CM_FILEEXIT           24338
#define CM_FILEPRINTER_SETUP  24337
#define CM_FILEPAGE_SETUP     24336
#define CM_FILEPRINT          24335
#define CM_FILESAVEAS            24334
#define CM_FILESAVE           24333
#define CM_FILEOPEN           24332
#define CM_FILENEW            24331

Файл описания ресурсов (листинг 1.3) содержит определение шаблона меню с именем APP_MENU, описанный нами ранее.

Листинг 1.3. Файл menu/menu.rc

#include "menu.hpp"

APP_MENU MENU 
BEGIN
        POPUP "&File"
        BEGIN
                MENUITEM "&New",              CM_FILENEW
                MENUITEM "&Open...",          CM_FILEOPEN
                MENUITEM "&Save",             CM_FILESAVE
                MENUITEM "Save &as...",       CM_FILESAVEAS
                MENUITEM SEPARATOR
                MENUITEM "&Print...",         CM_FILEPRINT
                MENUITEM "Page se&tup...",    CM_FILEPAGE_SETUP
                MENUITEM "P&rinter setup...", CM_FILEPRINTER_SETUP
                MENUITEM SEPARATOR
                MENUITEM "E&xit",             CM_FILEEXIT
        END

        POPUP "&Edit"
        BEGIN
                MENUITEM "&Undo\tCtrl+Z",     CM_EDITUNDO
                MENUITEM "&Cut\tCtrl+X",      CM_EDITCUT
                MENUITEM "&Copy\tCtrl+C",     CM_EDITCOPY
                MENUITEM "&Paste\tCtrl+V",    CM_EDITPASTE
        END

        POPUP "&Help"
        BEGIN
                MENUITEM "&Index\tF1",  CM_HELPINDEX,      INACTIVE
                MENUITEM "&Keyboard",   CM_HELPKEYBOARD,   INACTIVE
                MENUITEM "&Commands",   CM_HELPCOMMANDS,   GRAYED
                MENUITEM "&Procedures", CM_HELPPROCEDURES, GRAYED
                MENUITEM "&Using help", CM_HELPUSING_HELP, GRAYED
                MENUITEM SEPARATOR
                MENUITEM "&About...",   CM_HELPABOUT
        END
END

Проверяя работу приложения, обратите внимание на то, что хотя в строках временного меню "Edit" были указаны комбинации клавиш ускоренного выбора (например, для функции "Undo" указана комбинация клавиш "Ctrl+Z"), вы пока не можете их использовать. Это связано с тем, что мы пока не определили комбинации клавиш ускоренного выбора, а всего лишь записали их обозначение в строках меню. Мы еще вернемся к этому вопросу.

В листинге 1.4 приведен файл определения модуля, использованный при сборке приложения MENU.

Листинг 1.4. Файл menu/menu.def

; =============================
; Файл определения модуля
; =============================
NAME        MENU
DESCRIPTION 'Приложение MENU, (C) 1994, Frolov A.V.'
EXETYPE     windows
STUB        'winstub.exe'
STACKSIZE   8120
HEAPSIZE    1024
CODE        preload moveable discardable
DATA        preload moveable multiple