SDK中的任务跟踪代码简单注释

 hud_tasklist.h

#ifndef HUD_TASKLIST_H               // 任务跟踪列表头文件宏定义
#define  HUD_TASKLIST_H

#define  TASKLIST_MAX_TASKS 4         // 最大任务记录条数为4
#define  TASKLIST_TASK_INACTIVE 0       // 没有活动的任务数
#define  TASKLIST_TASK_COMPLETE 1       // 完成的任务数
#define  TASKLIST_TASK_LOWPRIORITY 2      // 底优先权
#define  TASKLIST_TASK_MEDPRIORITY 3      // 中级优先权
#define  TASKLIST_TASK_HIGHPRIORITY 4     // 高级优先权

#define  TASKLINE_NUM_FLASHES 8.0f       // 任务跟踪器数目刷新时率
#define  TASKLINE_FLASH_TIME 5.0f       // 任务跟踪器刷新时率
#define  TASKLINE_FADE_TIME 1.0f        // 任务跟踪器提示淡化时率

class  CHudTaskList :  public  CHudElement ,  public  vgui::Panel
... {
DECLARE_CLASS_SIMPLE( CHudTaskList, vgui::Panel );      //全局声明该类

public:
CHudTaskList( const char *pElementName ); //The constructor.构造函数
void Init( void ); //This gets called when the element is created.初始化
void VidInit( void ); //Same as above, this may only gets called when you load up the map for the first time.同上，但仅在地图加载时调用
void Reset(); //This gets called when you reset the HUD.重绘HUD
void Paint( void ); //This gets called every frame, to display the element on the screen!绘制
// void OnThink(void); //This gets called also almost every frame, so we can update things often.实时更新
void MsgFunc_TaskList( bf_read &msg );//消息函数

private:
// CHudTexture *m_pIcon;   // Icon texture reference头标指针
wchar_t   m_pText[TASKLIST_MAX_TASKS][256]; // Unicode text buffer字符缓存
int    m_iPriority[TASKLIST_MAX_TASKS];   // 0=inactive, 1=complete, 2=low, 3=medium, 4=high当前状态的管理数组
float   m_flStartTime[TASKLIST_MAX_TASKS]; // When the message was recevied收到消息的时间
float   m_flDuration[TASKLIST_MAX_TASKS]; // Duration of the message持续时间
vgui::HFont m_hSmallFont, m_hLargeFont;//字体定义

protected:
virtual void ApplySchemeSettings( vgui::IScheme *pScheme );//配置加载函数

private:
   // vgui::Label *m_pNameLabel; //The vgui label that will hold our name.标签名称
   vgui::HScheme scheme;     //The Scheme object to hold our scheme info.Scheme对象信息
} ;
#endif

hud_tasklist.cpp

// ========= Copyright ? 1996-2004, Valve LLC, All rights reserved. ============
//
//  Purpose: Task List element
//
// =============================================================================

#include  " cbase.h "
#include  " hudelement.h "
#include  " hud_macros.h "
#include  " iclientmode.h "
#include  " view.h "

using   namespace  vgui;

#include  < vgui_controls / Panel.h >
#include  < vgui_controls / Frame.h >
#include  < vgui / IScheme.h >
#include  < vgui / ISurface.h >
#include  < vgui / ILocalize.h > // 本地化文件头

using   namespace  vgui;

#include  " c_baseplayer.h "
#include  " hud_tasklist.h "

DECLARE_HUDELEMENT( CHudTaskList ); // 声明HUD元素对象
DECLARE_HUD_MESSAGE( CHudTaskList, TaskList ); // 声明HUD消息对象

//  ===================================================================

// 构造函数
CHudTaskList::CHudTaskList(  const   char   * pElementName ) : CHudElement( pElementName ), vgui::Panel( NULL,  " HudTaskList "  )
... {
DevMsg (2, "CHudTaskList::CHudTaskList - constructor sent %s ", pElementName);//调试函数
scheme = vgui::scheme()->LoadSchemeFromFile("resource/ClientScheme.res", "ClientScheme");//配置文件
SetScheme(scheme); // Here we load up our scheme and set this element to use it. Using a different scheme than ClientScheme doesn't work right off the bat anyways, so... :)加载其他的配置文件
vgui::Panel *pParent = g_pClientMode->GetViewport();//获取客户端视角的panel对象指针
SetParent( pParent ); // Our parent is the screen itself.我们使用当前视角的panel
SetHiddenBits( 0 ); // Never Hidden. You could make it so that it gets hidden when health is, with HIDEHUD_HEALTH, or any other combination of HIDEHUD flags.设置为从不隐藏
SetBgColor(Color( 0,0,0,100 ));//设置背景色
SetPaintBackgroundEnabled( true );//使用背景色
SetPaintBackgroundType (2); // Rounded corner box使用圆角长方形
}  

// 初始化
void  CHudTaskList::Init(  void  )
... {
HOOK_HUD_MESSAGE( CHudTaskList, TaskList );//HUD消息钩子
DevMsg (2, "CHudTaskList::Init " );//调试信息
Reset();//重绘
}

// 重绘
void  CHudTaskList::Reset(  void  )
... {
DevMsg (2, "CHudTaskList::Reset (clearing out list) " );//调试信息
for (int i=0; i<TASKLIST_MAX_TASKS; i++) 
...{
   m_pText[i][0] = '