C++代码 Visual Assist X + VS2008 添加自定义头文件说明和函数注释
先上代码注释效果:
1 //******************************************************************** 2 // 创建时间: 2013/12/05 11:20 3 // 4 // 文件名称: Helper.h 5 // 6 // 文件作者: fanchenglong 7 //==================================================================== 8 // 功能说明: 帮助类 9 // 10 // 其他说明: 11 //******************************************************************** 12 #pragma once 13 14 #include "stdafx.h" 15 16 class CHelperEx 17 { 18 public: 19 CHelperEx(); 20 21 ~CHelperEx(); 22 23 //******************************************************************** 24 // 函数名称:S2WS 25 //==================================================================== 26 // 参 数:将string转为wstring 27 // 28 // 返 回 值:std::wstring 29 // 30 // 作 者:fanchenglong 31 //******************************************************************** 32 wstring S2WS(const string& s); 33 34 //******************************************************************** 35 // 函数名称:获取操作系统版本 36 //==================================================================== 37 // 38 // 返 回 值:std::string 39 // 40 // 作 者:fanchenglong 41 //******************************************************************** 42 string GetSystemName(); 43 44 45 //******************************************************************** 46 // 函数名称:获取操作系统位数 47 //==================================================================== 48 // 49 // 返 回 值:std::string 50 // 51 // 作 者:fanchenglong 52 //******************************************************************** 53 string GetSystemBit(); 54 };
一、如何使用Visual Assist X添加头文件和函数注释内容?
头文件注释:先将光标定位到文件头部,VS08菜单中点击“VAsistX->Insert VA Snippets..->(显示可以插入的各种VA脚本)VA Snippets with $selected$->File header detailed”。
函数注释:右击需添加注释的函数名->Refactor(VA X)->Document Methord。
二、如何自定义?
打开自定义注释样式编辑框说明:VS08菜单中点击“VAsistX->Insert VA Snippets..->File header detailed和Refactor Document Methord”,在右侧就可以更改你的文件头和函数头的自定义样式了。
1、

2、

3、

三、文章开头代码中自定义的注释样式如下:
用于头文件的说明 //******************************************************************** // 创建时间:$DATE$ $HOUR$:$MINUTE$ // // 文件名称:$FILE_BASE$.$FILE_EXT$ // // 文件作者:fanchenglong //==================================================================== // 功能说明:$end$ // // 其他说明:$selected$ //******************************************************************** 用于函数注释 //******************************************************************** // 函数名称:$SymbolName$ //==================================================================== // 参 数:$MethodArg$ // // 返 回 值:$SymbolType$ // // 作 者:fanchenglong //********************************************************************
浙公网安备 33010602011771号