C++builder 消息的运用

一、TApplication的OnMessage事件
OnMessage事件只处理消息队列中的消息，SendMessage()发送的消息不会被截获。
任何窗体接收到一个windows消息，都会触发一次此事件
函数原型：
typedef void __fastcall (__closure *TMessageEvent) (tagMSG &Msg,bool &Handled);
Msg表示被截获的消息，Handled表示是否处理完成，为TRUE则防止被再次处理，设为FALSE则可以继续处理。

// 计算程序响应的消息数
// ---------------------------------------------------------------------------

#ifndef Msg_testH
#define  Msg_testH
// ---------------------------------------------------------------------------
#include  < Classes.hpp >
#include  < Controls.hpp >
#include  < StdCtrls.hpp >
#include  < Forms.hpp >
// ---------------------------------------------------------------------------
class  TForm1 :  public  TForm
{
__published:     //  IDE-managed Components
    TLabel  * Label1;
     void  __fastcall FormCreate(TObject  * Sender);
private :     //  User declarations
     // 自定义消息响应函数
     void  __fastcall AppMessage(tagMSG  & MSG, bool   & Handled);
public :         //  User declarations
    __fastcall TForm1(TComponent *  Owner);
     int  Num;
};
// ---------------------------------------------------------------------------
extern  PACKAGE TForm1  * Form1;
// ---------------------------------------------------------------------------
#endif

// ---------------------------------------------------------------------------

#include  < vcl.h >
#pragma  hdrstop

#include  " Msg_test.h "
// ---------------------------------------------------------------------------
#pragma  package(smart_init)
#pragma  resource "*.dfm"
TForm1  * Form1;
// ---------------------------------------------------------------------------
__fastcall TForm1::TForm1(TComponent *  Owner)
    : TForm(Owner)
{
    Num  =   0 ;
}
// ---------------------------------------------------------------------------

void  __fastcall TForm1::FormCreate(TObject  * Sender)
{
     // 将自定义函数与OnMessage事件联系起来
    Application -> OnMessage  =  AppMessage;
}
// ---------------------------------------------------------------------------
void  __fastcall TForm1::AppMessage(tagMSG  & MSG, bool   & Handled)
{
    Num ++ ;
    Label1 -> Caption  =  AnsiString(Num);
    Handled  =   false ;
}

 

二、消息映射

使用消息映射，一般需要三步：

(1).声明消息映射表，把某些消息的处理权，交给自己定义的函数
以一个没有参数的BEGIN_MESSAGE_MAP宏开始，
以END_MESSAGE_MAP宏结束(唯一参数是组件的父类的名字，通常为TForm)
在中间插入一个或多个MESSAGE_HANDLER宏，其将一个消息句柄和一个消息处理函数联系在一起。
MESSAGE_HANDLER(windows消息名，消息结构体名，消息处理函数名）

(2)声明消息处理函数
函数名称和参数必须和MESSAGE_HANDLER宏定义的一样

(3)实现消息处理函数
与一般类函数差不多，只是在最后加上一条语句，完成VCL对消息的默认处理
TForm::Dispatch(&Message);

 

// ---------------------------------------------------------------------------

#ifndef Unit1H
#define  Unit1H
// ---------------------------------------------------------------------------
#include  < Classes.hpp >
#include  < Controls.hpp >
#include  < StdCtrls.hpp >
#include  < Forms.hpp >
// ---------------------------------------------------------------------------
class  TForm1 :  public  TForm
{
__published:     //  IDE-managed Components
    TLabel  * Label1;
private :     //  User declarations
public :         //  User declarations
    __fastcall TForm1(TComponent *  Owner);

     // 自定义消息映射函数
     void  __fastcall WMGetMinMaxInfo(TWMGetMinMaxInfo  & Msg);

BEGIN_MESSAGE_MAP
    MESSAGE_HANDLER(WM_GETMINMAXINFO,TWMGetMinMaxInfo,WMGetMinMaxInfo)
END_MESSAGE_MAP(TForm)
};
// ---------------------------------------------------------------------------
extern  PACKAGE TForm1  * Form1;
// ---------------------------------------------------------------------------
#endif
 
 
  // ---------------------------------------------------------------------------

#include  < vcl.h >
#pragma  hdrstop

#include  " Unit1.h "
// ---------------------------------------------------------------------------
#pragma  package(smart_init)
#pragma  resource "*.dfm"
TForm1  * Form1;
// ---------------------------------------------------------------------------
__fastcall TForm1::TForm1(TComponent *  Owner)
    : TForm(Owner)
{
}
// ---------------------------------------------------------------------------
void  __fastcall TForm1::WMGetMinMaxInfo(TWMGetMinMaxInfo  & Msg)
{
     // 当用户单击窗体状态栏上的最大化按钮时，限制窗体的长宽
    Msg.MinMaxInfo -> ptMaxSize.x  =   600 ;
    Msg.MinMaxInfo -> ptMaxSize.y  =   400 ;

     // 设定窗体最大化时，左上角左边为窗体当前位置
    Msg.MinMaxInfo -> ptMaxPosition.x  =  Left;
    Msg.MinMaxInfo -> ptMaxPosition.y  =  Top;

     // 当用户用鼠标拖动的方式改变窗体尺寸时，限制其最大值
    Msg.MinMaxInfo -> ptMaxTrackSize.x  =   600 ;
    Msg.MinMaxInfo -> ptMaxTrackSize.y  =   400 ;

     // 当用户用鼠标拖动的方式改变窗体尺寸时，限制其最小值
    Msg.MinMaxInfo -> ptMinTrackSize.x  =   200 ;
    Msg.MinMaxInfo -> ptMinTrackSize.y  =   10 ;

     // 显示当前窗体的尺寸
    Label1 -> Caption  =   " Width: "   +  AnsiString( this -> Width) +
             "  Height:  "   +  AnsiString(Height);

    TForm::Dispatch( & Msg);
}

 

 

三、消息映射的深入讨论

../include/vcl/sysmac.h中有消息映射的宏定义

 

 

#define  BEGIN_MESSAGE_MAP   virtual void __fastcall Dispatch(void *Message) \
        {                                           \
           switch   (((PMessage)Message) -> Msg)        \
          {

#define  VCL_MESSAGE_HANDLER(msg,type,meth)          \
           case     msg:                              \
            meth( * ((type  * )Message));               \
             break ;

//  NOTE: ATL defines a MESSAGE_HANDLER macro which conflicts with VCL's macro. The
//        VCL macro has been renamed to VCL_MESSAGE_HANDLER. If you are not using ATL,
//        MESSAGE_HANDLER is defined as in previous versions of BCB.
//
#if  !defined(USING_ATL) && !defined(USING_ATLVCL) && !defined(INC_ATL_HEADERS)
#define  MESSAGE_HANDLER  VCL_MESSAGE_HANDLER
#endif   //  ATL_COMPAT

#define  END_MESSAGE_MAP(base)           default:    \
                         base ::Dispatch(Message);    \
                         break ;                      \
          }                                         \
        }
        
// 对与消息映射：
BEGIN_MESSAGE_MAP
    MESSAGE_HANDLER(WM_GETMINMAXINFO,TWMGetMinMaxInfo,WMGetMinMaxInfo)
END_MESSAGE_MAP(TForm1)

// 将被扩展为：
virtual   void  __fastcall Dispatch( void   * Message) 
        {                                           
           switch   (((PMessage)Message) -> Msg)        
          {
           case     msg:                              
            WMGetMinMaxInfo( * ((TWMGetMinMaxInfo * )Message));               
             break ;
           default :    
            TForm1::Dispatch(Message);    
             break ;                      
          }                                         
        }

VCL_MESSAGE_HANDLER写法，是为了调用ATL时，命名不冲突

四、重载WndProc()函数

函数原型：
virtual void __fastcall WndProc(Message::TMessage &Message);

 

// 头文件中声明
void  __fastcall WndProc(TMessage  & Message);

// 实现文件
void  __fastcall TForm1::WndProc(TMessage  & Message)
{
     if (Message.Msg  ==  WM_GETMINMAXINFO)
    {
         // 付给结构体LPMINMAXINFO
        LPMINMAXINFO lpmmi  =  (LPMINMAXINFO)Message.LParam;

         // 当用户单击窗体状态栏上的最大化按钮时，限制窗体的长宽
        lpmmi -> ptMaxSize.x  =   600 ;
        lpmmi -> ptMaxSize.y  =   400 ;

         // 设定窗体最大化时，左上角左边为窗体当前位置
        lpmmi -> ptMaxPosition.x  =  Left;
        lpmmi -> ptMaxPosition.y  =  Top;

         // 当用户用鼠标拖动的方式改变窗体尺寸时，限制其最大值
        lpmmi -> ptMaxTrackSize.x  =   600 ;
        lpmmi -> ptMaxTrackSize.y  =   400 ;

         // 当用户用鼠标拖动的方式改变窗体尺寸时，限制其最小值
        lpmmi -> ptMinTrackSize.x  =   200 ;
        lpmmi -> ptMinTrackSize.y  =   100 ;

         // 显示当前窗体的尺寸
        Label1 -> Caption  =   " Width: "   +  AnsiString( this -> Width) +
                 "  Height:  "   +  AnsiString(Height);
    }
    TForm::WndProc(Message);
}

五、非标准消息
1.通知消息(Notification message)
此消息只发生在一些标准windows控件上
当一个窗体的子控件发生了一些事情后，他通知给其父窗体的消息
包括：按钮、编辑框、列表空、label等..
如：BN_CLICKED 单击按钮

2.自定义消息
相比通过改变对象成员的优点：可以不用知道接收者的确切类型，只要知道其窗口句柄；可以广播给多个接受者。
一般有两种方式：直接定义，WM_USER + XXX 或 WM_APP+XXX 分别为0x0400和0x8000
或调用API函数RegisterWindowMessage()向系统注册一个

3.发送自定义消息
向特定窗体发送消息：
TControl::Perform() 由C++ builder提供
SendMessage() 和 PostMessage() API函数

发送广播消息
TWinControl::Broadcast()  由C++ builder提供
BroadcastSystemMessage()  API函数

Perform() 适用于在同一应用程序的不同窗体和控件消息的传递。
SendMessage() 把消息直接发送给窗口函数(不入队列)，等消息被处理后才返回。
PostMessage() 只是单纯吧消息送到消息队列中，就立刻返回。
Boradcast() 只能向C++ builder应用程序中的指定窗体上的所有子控件广播消息，无法向其他应用程序广播。
BroadcastSystemMessage() 可以向任意的应用程序或者组件广播消息。

// 窗体1(四个按钮)
// ---------------------------------------------------------------------------

#ifndef Unit1H
#define  Unit1H
// ---------------------------------------------------------------------------
#include  < Classes.hpp >
#include  < Controls.hpp >
#include  < StdCtrls.hpp >
#include  < Forms.hpp >

#include  " Unit2.h "
// ---------------------------------------------------------------------------
class  TForm1 :  public  TForm
{
__published:     //  IDE-managed Components
    TButton  * Button1;
    TButton  * Button2;
    TButton  * Button3;
    TButton  * Button4;
     void  __fastcall Button1Click(TObject  * Sender);
     void  __fastcall Button2Click(TObject  * Sender);
     void  __fastcall Button3Click(TObject  * Sender);
     void  __fastcall Button4Click(TObject  * Sender);
private :     //  User declarations
public :         //  User declarations
    __fastcall TForm1(TComponent *  Owner);
};
// ---------------------------------------------------------------------------
extern  PACKAGE TForm1  * Form1;
// ---------------------------------------------------------------------------
#endif

// ---------------------------------------------------------------------------

#include  < vcl.h >
#pragma  hdrstop

#include  " Unit1.h "

// ---------------------------------------------------------------------------
#pragma  package(smart_init)
#pragma  resource "*.dfm"
TForm1  * Form1;
// ---------------------------------------------------------------------------
__fastcall TForm1::TForm1(TComponent *  Owner)
    : TForm(Owner)
{
}
// ---------------------------------------------------------------------------

void  __fastcall TForm1::Button1Click(TObject  * Sender)
{
    Form2 -> Perform(WM_CLOSE, 0 , 0 );    
}
// ---------------------------------------------------------------------------

void  __fastcall TForm1::Button2Click(TObject  * Sender)
{
    SendMessage(Form2 -> Handle,WM_CLOSE, 0 , 0 );
}
// ---------------------------------------------------------------------------

void  __fastcall TForm1::Button3Click(TObject  * Sender)
{
    PostMessage(Form2 -> Handle,WM_CLOSE, 0 , 0 );
}
// ---------------------------------------------------------------------------

void  __fastcall TForm1::Button4Click(TObject  * Sender)
{
     // 向窗体Form2的子控件广播WM_LBUTTONDOWN消息
    TMessage M;
    M.Msg  =  WM_LBUTTONDOWN;
    Form2 -> Broadcast( & M);
}
// ---------------------------------------------------------------------------


// 窗体2(两个panel)
// ---------------------------------------------------------------------------

#ifndef Unit2H
#define  Unit2H
// ---------------------------------------------------------------------------
#include  < Classes.hpp >
#include  < Controls.hpp >
#include  < StdCtrls.hpp >
#include  < Forms.hpp >
#include  < ExtCtrls.hpp >
// ---------------------------------------------------------------------------
class  TForm2 :  public  TForm
{
__published:     //  IDE-managed Components
    TPanel  * Panel1;
    TPanel  * Panel2;
     void  __fastcall Panel1MouseDown(TObject  * Sender, TMouseButton Button,
          TShiftState Shift,  int  X,  int  Y);
     void  __fastcall Panel2MouseDown(TObject  * Sender, TMouseButton Button,
          TShiftState Shift,  int  X,  int  Y);
private :     //  User declarations
public :         //  User declarations
    __fastcall TForm2(TComponent *  Owner);
};
// ---------------------------------------------------------------------------
extern  PACKAGE TForm2  * Form2;
// ---------------------------------------------------------------------------
#endif


// ---------------------------------------------------------------------------

#include  < vcl.h >
#pragma  hdrstop

#include  " Unit2.h "
// ---------------------------------------------------------------------------
#pragma  package(smart_init)
#pragma  resource "*.dfm"
TForm2  * Form2;
// ---------------------------------------------------------------------------
__fastcall TForm2::TForm2(TComponent *  Owner)
    : TForm(Owner)
{
}
// ---------------------------------------------------------------------------


void  __fastcall TForm2::Panel1MouseDown(TObject  * Sender,
      TMouseButton Button, TShiftState Shift,  int  X,  int  Y)
{
    Panel1 -> Caption  =   " Down " ;
}
// ---------------------------------------------------------------------------

void  __fastcall TForm2::Panel2MouseDown(TObject  * Sender,
      TMouseButton Button, TShiftState Shift,  int  X,  int  Y)
{
    Panel2 -> Caption  =   " Down " ;
}
// ---------------------------------------------------------------------------

 

 

六
若自定义消息想带参数，可用LParam和WParam参数
更多可自定义结构体
LPARAM+WPARAM能放下就放,放不下就传指针. SENDMESSAGE可以传局部变量的指针,POSTMESSAGE只能传 全局/局部静态/堆上的 变量的指针. 
如：映射到TMessage结构体中，然后取出
void __fastcall myMessage(TMessage &Msg)
{
  int i = Msg.WParam;
}