MoreNotepad++

--------活出自己的精彩。

导航

windows sdk编程系列---- 通用控件

本课中我们将学习什么是通用控件和如何使用它们。

理论:

WIN95相对于WIN3X有几个加强的用户界面控件。其实在WIN95正式发行前这些控件就在使用,譬如:状态条、工具条等。以前程序员要自己去编程使用它们,现在微软已经把它们包含到了WIN9X和WINNT中了。

  • Toolbar ---工具条
  • Tooltip ---提示文本
  • Status bar ---状态条
  • Property sheet ---属性页单
  • Property page ---属性页
  • Tree view ---树型视图
  • List view ---列表视图
  • Animation ---动画
  • Drag list ---能够处理Drag-Drop的列表框
  • Header ---
  • Hot-key --- 热键
  • Image list ---图象链表
  • Progress bar ---进程状态条
  • Right edit ---
  • Tab ---跳格表
  • Trackbar ---跟踪条
  • Up-down ---滚动条

因为通用控件的数量非常多,把它们全部装入内存并注册它们是非常浪费内存的。除了“RTF文本编辑”控件外其他控件的可执行代码都放在comctl32.dll中,这样其他的应用程序就可以使用它们了。“RTF文本编辑”控件在richedXX.dll中,由于该控件非常的复杂,所以也比其它控件大。

要加载comctl32.dll可以在您的应用程序中调用函数InitCommonControls。InitCommonControls函数是动态链接库comctl32.dll中的一个函数,只要在您的程序中的任意地方引用了该函数就、会使得WINDOWS的程序加载器PE Loader加载该库。函数InitCommonControls其实只有一条指令“ret”,它的唯一目的是为了使得在调用了个该函数的应用程序的可执行文件的PE头中的“引入”段中包含有comctl32.dll,这样无论什么时候该应用程序都会为您加载该库。所以真正初始化的工作是在该库的入口点处做的,在这里会注册所有的通用控件类,然后所有的通用控件就可以在这些类上进行创建,这就象创建其它的子窗口控件一样。

RTF文本编辑控件则不同。如果您要使用它,就必须调用LoadLibrary函数来动态加载,并调用FreeLibrary来动态地卸载。

现在我们学习如何创建这些通用控件。您可以用资源编辑器把它们放到一个对话框中,或者您也可以自己调用相关的函数来手动创建它们。几乎所有的通用控件都是调用函数CreateWindowEx或CreateWindow来创建的,您只要在其中传递通用控件的类名即可。有一些通用控件有一些特别的创建函数,但是其实这些函数在内部都调用了CreateWindowEx,只是包装后的函数更方便使用而已。经过包装的函数有:

  • CreateToolbarEx
  • CreateStatusWindow
  • CreatePropertySheetPage
  • PropertySheet
  • ImageList_Create

为了创建通用控件您必须要知道它们的类名,我们把类名列于如下:

类名                      通用控件

ToolbarWindow32            Toolbar

tooltips_class32           Tooltip

msctls_statusbar32          Status bar

SysTreeView32              Tree view

SysListView32              List view

SysAnimate32               Animation

SysHeader32                Header

msctls_hotkey32            Hot-key

msctls_progress32           Progress bar

RICHEDIT                  Rich edit

msctls_updown32            Up-down

SysTabControl32            Tab

Property sheets、property pages和image list控件有它们自己的创建函数。Drag list其实是可以伸缩的listbox控件,所以它没有自己的类名。上面的类名是VC++的资源编辑器提供的,它们和Borland公司的WIN32 API指南中提出的不一样,和Petzold的书《Programming Windows 95》也不一样。可以肯定的是我们上面列出的类名绝对准确。 这些通用控件可以有通用的窗口类的一些风格,譬如WS_CHILD等。它们当然还有其他的特殊风格,譬如树型视图控件就有TVS_XXXXX风格,列表控件就有LVS_xxxx风格。具体的最好查找有关的WIN32 API函数指南。 既然我们已经知道了如何创建一个通用控件,我们就可以讨论这些通用控件之间以及和它们的父窗口之间是如何通讯的了。不象子窗口控件,通用控件在某些状态发生变化时不通过发送WM_COMMAND而是发送WM_NOTIFY消息和父窗口通讯的。父窗口可以通过发送消息来控制窗口的行为。对于那些新的通用控件,还有一些新的消息类型。您可以参考您的WIN32 API手册在下面的例子中我们将要实验一下进度条和状态条。

例子:

#include "Windows.h"
#include "tchar.h"
#include "commctrl.h"
#pragma comment(lib,"comctl32.lib")
#define IDC_PROGRESS    1
#define IDC_STATUS        2
#define IDC_TIMER        3
TCHAR ClassName[] = _T("CommonControlWinClass");
TCHAR AppName[] = _T("Common Control Demo");
TCHAR ProgressClass[] = _T("msctls_progress32");
TCHAR Message[] = _T("Finished!");
DWORD TimerID;
HINSTANCE g_hInstance;

HWND hwndStatus;
HWND hwndProgress;
DWORD CurrentStep;

LRESULT CALLBACK ProcWinMain(   HWND hWnd,
                                UINT Msg,
                                WPARAM wParam,
                                LPARAM lParam
                            )
{
    switch(Msg)
    {
    case WM_CREATE:
        hwndProgress = CreateWindowEx(NULL,ProgressClass,NULL,WS_CHILD|WS_VISIBLE,100,200,300,20,hWnd,(HMENU)IDC_PROGRESS,
                                      g_hInstance,NULL);
        CurrentStep = 1000;
        SendMessage(hwndProgress,PBM_SETRANGE,0,65536000);
        SendMessage(hwndProgress,PBM_SETSTEP,10,0);
        hwndStatus = CreateStatusWindow(WS_CHILD|WS_VISIBLE,NULL,hWnd,IDC_STATUS);
        TimerID = SetTimer(hWnd,IDC_TIMER,100,NULL);
        break;

    case WM_DESTROY:
        PostQuitMessage(0);
        if(TimerID != 0)
            KillTimer(hWnd,TimerID);
        break;
    case WM_TIMER:
        SendMessage(hwndProgress,PBM_STEPIT,0,0);
        CurrentStep -= 10;
        if(CurrentStep == 0)
        {
            KillTimer(hWnd,TimerID);
            TimerID = 0;
            SendMessage(hwndStatus,SB_SETTEXT,0,(LPARAM)Message);
            MessageBox(hWnd,Message,AppName,MB_OK | MB_ICONINFORMATION);
            SendMessage(hwndStatus,SB_SETTEXT,0,0);
            SendMessage(hwndProgress,PBM_SETPOS,0,0);
        }

        break;

    default:
        return DefWindowProc(hWnd,Msg,wParam,lParam);
    }
    return 0;
}

int WINAPI WinMain(    HINSTANCE hInstance,
                    HINSTANCE hPrevInstance,
                    LPSTR lpCmdLine,
                    int nCmdShow
                  )
{
    WNDCLASSEX wc;
    MSG msg;
    HWND hWnd;
    g_hInstance = hInstance;
    wc.cbSize = sizeof(WNDCLASSEX);
    wc.style = CS_HREDRAW | CS_VREDRAW;
    wc.lpfnWndProc = ProcWinMain;
    wc.cbClsExtra = NULL;
    wc.cbWndExtra = NULL;
    wc.hInstance = hInstance;
    wc.hbrBackground = (HBRUSH)(COLOR_APPWORKSPACE + 1);
    wc.lpszMenuName = NULL;
    wc.lpszClassName = ClassName;
    wc.hIcon = wc.hIconSm = LoadIcon(NULL,IDI_APPLICATION);
    wc.hCursor = LoadCursor(NULL,IDC_ARROW);
    RegisterClassEx(&wc);

    hWnd = CreateWindowEx(
               WS_EX_CLIENTEDGE,\
               ClassName,AppName,\
               WS_OVERLAPPEDWINDOW,\
               CW_USEDEFAULT,CW_USEDEFAULT,\
               CW_USEDEFAULT,CW_USEDEFAULT,\
               NULL,\
               NULL,\
               hInstance,\
               NULL\
           );

    ShowWindow(hWnd,SW_SHOWNORMAL);
    UpdateWindow(hWnd);

    while(GetMessage(&msg,NULL,0,0))
    {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }

    return msg.wParam;
}

分析:

   #include "commctrl.h"

   #pragma comment(lib,"comctl32.lib")

大部分的通用控件由comctl32.dll模块提供,所以在使用之前要在源程序中包含相应的头文件 。

return msg.wParam;

InitCommonControls();

我故意把函数InitCommonControls放到WinMain最后,这样就可以验证调用该函数仅仅是为了在我们程序的可执行文件的PE头中的引入段中放入引用了comctl32.dll的信息。您可以看到,即使该函数什么都没有做,我们的通用控件对话框依旧可以正常工作。(不过,我试验了下,本例中去掉InitCommonControls();这句程序照常正常工作。不过为了遵守规范,还是写上这句吧)

case WM_CREATE:
    hwndProgress=CreateWindowEx(
        NULL,
        ProgressClass,
        NULL,
        WS_CHILD|WS_VISIBLE,
        100,200,
        300,20,
        hWnd,
        (HMENU)
        IDC_PROGRESS,
        g_hInstance,
        NULL);

在这里我们创建了通用控件。注意CreateWindowEx函数中的参数hWnd是父窗口的句柄。另外它也指定了通用控件的ID号。因为我们直接使用控件的窗口句柄,所以就没有使用该ID号。所有的窗口都必须具有WS_CHILD风格。

 

CurrentStep = 1000;

SendMessage(hwndProgress,PBM_SETRANGE,0,65536000);

SendMessage(hwndProgress,PBM_SETSTEP,10,0);

在创建了进度条后我们先设定它的范围。缺省的范围是0-100。如果您不满意,可以重新设置,这通过传递PBM_SETRANGE消息来实现。参数lParam中包含了范围值,其中底字和高字分别是范围的起始和终了的值。您可以指定进度条每移动一格的步长。本例子中把步长设置成10,意味着每发送一次PBM_STEPIT消息给进度条,它的显示指针就会移动10。当然您可以调用PBM_SETPOS 来直接设定进度条上的指针的位置。用该消息您可以更方便地设定进度条了。

hwndStatus = CreateStatusWindow(WS_CHILD|WS_VISIBLE,NULL,hWnd,IDC_STATUS);

TimerID = SetTimer(hWnd,IDC_TIMER,100,NULL);

下面我们调用CreateStatusWindow来创建状态条。这个调用很好理解,无需我多解释。在状态条创建后我们创建一个计时器。在本例中我们每隔100毫秒就更新一次进度条。下面时创建记时器的函数原型: UINT_PTR SetTimer(      

                    HWND hWnd,    

                   UINT_PTR nIDEvent,   

                   UINT uElapse,    

                   TIMERPROC lpTimerFunc );

 

hWnd : 父窗口的句柄。

nIDEvent: 计时器的ID号。您可以指定一个唯一的非零值。

uElapse : 以毫秒计的时间间隔。

lpTimerProc : 计时器回调函数的地址。每当时间间隔到了的时候,该函数就会被系统调用。如果该值为NULL,计时器就会把WM_TIMER消息发送到父窗口。

如果SetTimer调用成功的话就会返回计时器的ID号值,否则返回0。这也是为什么计时器的ID号必须为非零值的原因。

   

 case WM_TIMER:

        SendMessage(hwndProgress,PBM_STEPIT,0,0);

        CurrentStep -= 10;

        if(CurrentStep == 0)

        {

            KillTimer(hWnd,TimerID);

            TimerID = 0;

            SendMessage(hwndStatus,SB_SETTEXT,0,(LPARAM)Message);

            MessageBox(hWnd,Message,AppName,MB_OK | MB_ICONINFORMATION);

            SendMessage(hwndStatus,SB_SETTEXT,0,0);

            SendMessage(hwndProgress,PBM_SETPOS,0,0);

        }
        break;

当指定的时间到了的时候,计时器将发送WM_TIMER消息。您可以在处理该消息时作适当的处理。本例中我们将更新进度条,并检查进度条是否超过最大的值。如果超过了的话,我们通过发送SB_SETTEXT消息来在状态条中设置文本。这时,弹出一个对话框,当用户关闭掉对话框后,我们去除掉进度条和状态条中的文本。

 

 

 

posted on 2013-07-01 11:23  MoreNotepad++  阅读(1513)  评论(0编辑  收藏  举报