VC5中使用标签控件

姜边
1999年 第9期 13版

    VC5中，标签控件是由CTabCtrl类来作数据支持的。做一个标签控件，主要有以下几个步骤：
    一、在ResourceView标签页（就是VC5左面的标签控件第二项）的对话框中添加TABCTRL（比如取名为MYTABCTRL）。
    二、在ClassWizard中为刚添加的标签控件关联上一个CTabCtrl变量（比如取名为mytab）。
    三、为标签控件添加项目。
    四、到此为止，一个标签控件就做好了。现在便可以用ClassWizard为标签控件添加消息映射了。
    下面重点介绍为标签控件添加项目的方法。
    CTabCtrl类有一个成员函数InsertItem，它的原型是：BOOL InsertItem（int nItem，TC_ITEM＊pTabCtrlItem）；
    其中第一个参数是加入项目的序号，此序号将在调用CTabCtrl的另一个成员函数GetCurSel（）时作为返回值。与GetCurSel（）对应的就是SetCurSel（int nItem），SetCurSel函数可改变标签控件当前选定的项目，其中nItem就是该项目的序号。
    InsertItem的关键在于第二个参数PTabCtrlItem。这是一个指向TC_ITEM结构的指针。
    TC_ITEM结构的定义如下：
    typedef struct_TC_ITEM
    {
    UINT mask； ／／ 标签控件的类型
    UINT lnReserved1； ／／ VC保留，勿用
    UINT lnReserved2； ／／ VC保留，勿用
    LPSTR pszText； ／／ 标签控件的项目文字
    int cchTextMax； ／／ pszText的长度
    int iImage； ／／ 标签控件的图形序号
    LPARAM lParam； ／／ 用于交换的数据
    }TC_ITEM；
    在编程中，真正经常使用的只有mask、pszText、iImage三个成员变量。
    1.mask
    指定标签控件的类型。它可以是以下三个值：
    TCIF_TEXT pszText成员有效
    TCIF_IMAGE iImage成员有效
    TCIF_PARAM iParam成员有效
    如果要使用多个属性，应该用按位或运算符“|”连接。例如要使pszText和iImage成员同时有效，则用TCIF_TEXT|TCIF_IMAGE作为mask的值。
    2.pszText
    标签控件的项目文字，可直接赋予字符串值。此时标签控件的类型必须有TCIF_TEXT。
    3.iImage
    标签控件的图形序号，这是为标签控件添加图形所必须用到的一个成员变量。此标签控件必须有TCIF_IMAGE。
    在赋值时，只需给这三个（有时是两个）变量赋值就行了。
    下面为大家介绍iImage的用法。
    iImage中存储的是项目的图形序号。这个序号所对应的图形（可能为图标和位图）将被显示到标签控件项目文字的左边。这些图形可以是任意大小，但必须一样大。
    标签控件的每一个项目的iImage组成了一个序列，这个序列所对应的图形是用另一个类CImageList来管理的。下面请看CImageList的用法。
    我在使用CImageList时，只用到以下几个成员函数：
    1.BOOL Create（int cx，int cy，UINT nFlags，int nInitial，int nGrow）；
    这个函数建立一个含nGrow个图形（每个图形为cx长，cy高以nInitial为初值：通常为0）的空CImageList；其中有个nFlages参数，它用来指定图形的颜色属性，它的值只能为以下几个值中的一个：
    ILC_COLOR 使用默认颜色（一般为16色）
    ILC_COLOR4 使用4位色（16色）
    ILC_COLOR8 使用8位色（256色）
    ILC_COLOR16 使用16位色（64K色）
    ILC_COLOR24 使用24位色（16M色）
    ILC_COLOR32 使用32位色（4G色）
    ILC_COLORDDB 使用系统当前色
    2.BOOL Create（UINT nBitmapID，int cx，int nGrow，COLORREF crMask）；
    这个函数是以nBitmapID所代表的位图（已在rc文件中定义，与定义工具条的位图相似）建立一个含有nGrow个图形（每个图形长为cx）的CImageList；
    其中crMask指定位图中的什么颜色将被替换为黑色，一般就用黑色（RGB（0，0，0））。
    3.int Add（CBitmap＊pbmImage，COLORREF crMask）；
    这个函数往CImageList中追加一个位图。其中nbmImage可以通过先定义一个CBitmap指针，再用CBitmap的成员LoadBitman来得到。比如：
    CBitmap＊mvbitmap；
    mvhitmap=new CBitmap（）；
    mvbitmap－>LoadBitmap（MYPICTURE）； ／／
    MYPICTURE是已定义的位图资源crMask参数与前面相同。
    4.int Add（HICON hIcon）：
    这个函数往CImageList中追加一个图标。
    其中hIcon可以用AfxGetApp（）－>LoadIcon（UINT nIDResource）来得到。如：AfxGetApp（）－>LoadIcon（MYICON）；／／其中MYICON是已定义的图标资源，当CImageList定制好后，调用CTabCtrl的成员函数SetImageList，其原型如下：
    CImageList＊SetImageList（CImageList＊pImageList）；
    其中的pImageList正是指向我们刚才定制的CImageList对象的指针，而以前的iImage参数就是CImageList中的图形序号了。这样，一个带有图形的标签控件就做好了。
    关于标签控件，在一般编程中我们大约只用到以上函数。上面是我对标签控件编程的心得，希望能与大家分享。


 