在系統菜單裡添加菜單項和相應事件

有時候我們經常在程序中實現菜單項的重畫，已有好多文章已經加以介紹，在此不再贅述。但是有時我們需要加新菜單項到系統菜單中，並希望給其增加相應的事件。筆者通過運用WindowAPI的AppendMenu函數和C++BUIDER的相關方法、屬性，實現了往系統菜單中增加菜單項和事件。

下面介紹具體的實現方法，讀者按照以下步驟操作，就可以實現在系統菜單中增加菜單項和事件：

1 首先創建一個新的空工程文件，存盤為project1.cpp和unit1.cpp。

2 使用菜單Tools中的Image Editor，打開資源文件project1，新建一個位圖並取名為HELP。

3 在源文件頭部定義如下常量作為菜單的標示：

#define IDM_HELP1　　　1

#define IDM_HELP2　　　2

#define IDM_REMOVE　　 3

#define IDM_SEPARATOR1 4

#define IDM_SEPARATOR2 5

4 為Form1創建OnCreate事件，添加代碼實現在系統菜單裡增加菜單項：

首先定義菜單句柄和位圖句柄：

HMENU hMenu;

HBITMAP　hBitmapHelp;

然後獲得系統菜單的句柄：

hMenu = GetSystemMenu (this->Handle, FALSE) ;

往系統菜單中增加自己的菜單項：

AppendMenu (hMenu, MF_SEPARATOR,IDM_SEPARATOR1,　NULL) ;

AppendMenu (hMenu, MF_STRING,IDM_HELP1,"幫助") ;

AppendMenu (hMenu, MF_SEPARATOR,IDM_SEPARATOR2,　NULL) ;

AppendMenu (hMenu, MF_STRING,IDM_REMOVE,"取消菜單") ;

往菜單中添加位圖，首先裝載位圖資源，獲得其句柄，然後將它添加到系統菜單中：

hBitmapHelp =LoadBitmap ((void*)HInstance, "HELP");

AppendMenu (hMenu, MF_BITMAP,IDM_HELP2,　(char*)hBitmapHelp);

5 在頭文件的public下面添加方法MyWndProc的定義：

void __fastcall MyWndProc(Messages::TMessage &Message);

6 在構造函數中加入WindowProc=MyWndProc代碼，以重載WndProc方法，完成用戶自己所要求的操作。

7 在源文件裡面添加MyWndProc的實現：

首先獲得系統菜單的句柄，為動態修改菜單項做准備。

HMENU hMenu;

hMenu = GetSystemMenu (this->Handle, FALSE);

判斷當前消息是否為系統命令消息，若是，則重新實現它，再判斷消息的WparamLo參數是否為在OnCreate事件中添加的菜單項，若是，進行相應事件處理，如不是按系統默認執行；若是其他消息則執行系統默認的代碼。

　if (Message.Msg == WM_SYSCOMMAND)
　 {
　　  switch(Message.WParamLo)
　　  {
　　　　 case IDM_HELP1:
　　　　　　 ShowMessage("這是一個測試！");
　　　　　　 break;
　　　　 case IDM_HELP2:
　　　　　　 ShowMessage("這是一個測試！");
　　　　　　 break;
　　　　 case IDM_REMOVE:
　　　　 {
　　　　  //刪除添加到系統菜單的菜單項
DeleteMenu(hMenu,IDM_HELP1,MF_BYCOMMAND);
DeleteMenu(hMenu,IDM_HELP2,MF_BYCOMMAND);
DeleteMenu(hMenu,IDM_REMOVE,MF_BYCOMMAND);
DeleteMenu(hMenu,IDM_SEPARATOR1,MF_BYCOMMAND);
DeleteMenu(hMenu,IDM_SEPARATOR2,MF_BYCOMMAND);
　　　　 }
　　　　 default:
　　　　　  WndProc(Message);
　  }
}
else
　　 WndProc(Message);

接下來調試運行程序，本程序在C++builder 4.0下調試通過。

下面介紹一下實現的技術內幕。往系統菜單中增加菜單項的關鍵就是獲得系統菜單的句柄，在程序中使用Window API函數GetSysMenu，然後用AppendMenu增加菜單。函數的相關用法可查閱C++Builder聯機幫助。給菜單項添加相應的事件，我們用到了TForm類的WindowProc屬性，把用戶自定義的方法代替系統自己的 WndProc方法。WindowProc屬性指向一個被送往窗體的消息的處理過程，是我們能夠在程序中重載WndProc方法。WndProc方法是窗體中第一個接收到消息的方法，調用父類的方法可完成窗體的激活、定位等與Windows同步的消息處理。重載該方法可改變窗體如何相應Windows的消息。本文程序就是運用兩者的配合實現了給系統菜單添加相應事件的。

附程序清單：

1 unit1.h

/-
#ifndef Unit1H
#define Unit1H
//
#include < Classes.hpp >
#include < Controls.hpp >
#include < StdCtrls.hpp >
#include < Forms.hpp >
#include < Db.hpp >
#include < DBGrids.hpp >
#include < DBTables.hpp >
#include < Grids.hpp >
//--
class TForm1 : public TForm
{
__published: // IDE-managed Components
　　　　 void __fastcall FormCreate(TObject *Sender);
// User declarations
public: // User declarations
　　　　  __fastcall TForm1(TComponent* Owner);
　　　　  void __fastcall MyWndProc(Messages::TMessage &Message);
protected:
};
//--
extern PACKAGE TForm1 *Form1;
//---
#endif
2 unit1.cpp
//---
#include < vcl.h >
#pragma hdrstop
#include "Unit1.h"
//-
#pragma package(smart_init)
#pragma resource "*.dfm"
#define IDM_HELP1　 1
#define IDM_HELP2　 2
#define IDM_REMOVE　3
#define IDM_SEPARATOR1 4
#define IDM_SEPARATOR2 5
TForm1 *Form1;
//---
__fastcall TForm1::TForm1(TComponent* Owner)
　　　　 : TForm(Owner)
{
　 WindowProc=MyWndProc;
}
//--
void __fastcall TForm1::FormCreate(TObject *Sender)
{
　  HMENU hMenu;
　  HBITMAP　hBitmapHelp;
　  hMenu = GetSystemMenu (this->Handle, FALSE) ;
　  AppendMenu (hMenu, MF_SEPARATOR,IDM_SEPARATOR1,　NULL) ;
　  AppendMenu (hMenu, MF_STRING,IDM_HELP1,"幫助") ;
　  hBitmapHelp =LoadBitmap ((void*)HInstance, "HELP");
　  AppendMenu (hMenu, MF_BITMAP,IDM_HELP2,　(char*)hBitmapHelp);
　  AppendMenu (hMenu, MF_SEPARATOR,IDM_SEPARATOR2,　NULL) ;
　  AppendMenu (hMenu, MF_STRING,IDM_REMOVE,"取消菜單") ;
}
//-
void __fastcall TForm1::MyWndProc
(Messages::TMessage &Message)
{
　 HMENU hMenu;
　 hMenu = GetSystemMenu (this->Handle, FALSE);
　 if (Message.Msg == WM_SYSCOMMAND)
　 {
　　  switch(Message.WParamLo)
　　  {
　　　　 case IDM_HELP1:
　　　　　　 ShowMessage("這是一個測試！");
　　　　　　 break;
　　　　 case IDM_HELP2:
　　　　　　 ShowMessage("這是一個測試！");
　　　　　　 break;
　　　　 case IDM_REMOVE:
　　　　 {
　　　　　 DeleteMenu(hMenu,IDM_HELP1,MF_BYCOMMAND);
　　　　　 DeleteMenu(hMenu,IDM_HELP2,MF_BYCOMMAND);
　　　　　 DeleteMenu(hMenu,IDM_REMOVE,MF_BYCOMMAND);
　　　　　 DeleteMenu(hMenu,IDM_SEPARATOR1,MF_BYCOMMAND);
　　　　　 DeleteMenu(hMenu,IDM_SEPARATOR2,MF_BYCOMMAND);
　　　　 }
　　　　 default:
　　　　　  WndProc(Message);
　  }
}
else
　　 WndProc(Message);
}