牛牛截图控件桌面版调用说明.doc

牛牛截图控件桌面版调用说明 本说明文档旨在对截图控件的API进行说明，指导调用者顺利的将截图控件集成进第三方产品中，使第三方产品也能拥有完美的牛牛截图功能。 控件有三个接口：InitScreenCaptureW，InitCaptureParamW以及StartScreenCaptureW，具体可以参考调用 NiuniuCapturedemo_Window_source.zip。 对于上述三个接口，也可以使用不带W的版本，区别在于传递字符串时不使用Unicode编码，而直接使用Ansi字符串即可: InitScreenCapture，InitCaptureParam以及StartScreenCapture。 接口的具体描述如下： 1. 接口初始化接口 int InitScreenCaptureW(const wchar_t* szAuth); 此接口函数用于初始化截图控件的授权信息，默认的授权码为：niuniu. 参数说明： 参数名 参数类型 参数说明 备注 szAuth 字符串 接口调用的授权码 默认的授权码为：niuniu 2. 参数初始化接口 int InitCaptureParamW(int flag, unsigned long flagvalue); 此接口函数用于初始化截图各个状态下的界面的显示效果，如果不调用，则以默认值处理。 参数说明： 参数名 参数类型 参数说明 备注 flag int 要设置的参数项 此处对应的枚举ExtendFlagTypeEnum的整形值 flagvalue unsigned long 设置的参数值 根据不同的枚举来设置不同的值 枚举定义如下: typedef enum ExtendFlagTypeEnum { emPensize = 1, // emDrawType, // emTrackColor, // emEditBorderColor, // emTransparent, // emWindowAware, emDetectSubWindowRect, emSetSaveName, emSetMagnifierBkColor, //设置放大镜的背景色，不设置则透明 emSetMagnifierLogoText, //设置放大镜上的LOGO字符，可提示快捷键，如：牛牛截图(CTRL + SHIFT + A) emSetWatermarkPictureType=20, //设置水印的类型 emSetWatermarkPicturePath, //设置水印的路径 emSetWatermarkTextType, //设置水印文字的类型 emSetWatermarkTextValue, //设置水印文字 emSetMosaicType, //设置马赛克类型，1为矩形，2为画线 emSetToolbarText, //设置工具栏上的各按钮的tooltip及显示的文字 }; 枚举项的说明如下： 枚举参数名 枚举对应数值 参数值说明 备注 emPensize 1 设置画笔大小 如不设置，默认为2 emDrawType 2 设置是腾讯风格还是360风格 0表示腾讯风格，1表示360风格 emTrackColor 3 Track及自动识别的边框的颜色 如：RGB(255, 0, 0) emEditBorderColor 4 文本输入框的边框颜色 如：RGB(0, 174, 255) emTransparent 5 工具栏的透明度 默认为220 emWindowAware 6 设置是否禁用随着DPI放大，flagvalue传递任意值均可 此项设置非常重要，相当于调用 SetProcessDPIAware，如果不设置，在高DPI的环境下，截图将会错乱,请在程序窗口创建前调用 emDetectSubWindowRect 7 是否自动检测子窗口，暂时无用 未使用 emSetSaveName 8 设置保存时的文件名称 如： const wchar_t* szName = L测试名; InitCaptureParam(emSetSaveName, (unsigned long) szName); 注：免费版本此接口无效，将会显示默认值 emSetMagnifierBkColor 9 用于设置放大镜的背景色 一般不建议设置，默认透明即可 emSetMagnifierLogoText 10 设置放大镜上的显示的LOGO文字 如： const wchar_t* szLogoName = L测试名; InitCaptureParam(emSetMagnifierLogoText, (unsigned lo