Description_of_NiuniuCapture_Window.doc

牛牛截图控件桌面版调用说明 乖乖牛在线官方网址：/ 本说明文档旨在对截图控件的API进行说明，指导调用者顺利的将截图控件集成进第三方产品中，使第三方产品也能拥有完美的牛牛截图功能。 控件有三个接口：InitScreenCapture，InitCaptureParam以及StartScreenCapture，具体可以参考调用 NiuniuCapturedemo_Window_source.zip，接口的具体描述如下： 1). 接口初始化接口 int InitScreenCapture(const char* szAuth); 此接口函数用于初始化截图控件的授权信息，默认的授权码为：niuniu. 参数说明： 参数名 参数类型 参数说明 备注 szAuth 字符串 接口调用的授权码 默认的授权码为：niuniu 2). 参数初始化接口 int InitCaptureParam(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, //设置水印文字 };emPensize 1 设置画笔大小emDrawType 2 设置是腾讯风格还是360风格emTrackColor 3 Track及自动识别的边框的颜色RGB(255, 0, 0) emEditBorderColor 4 文本输入框的边框颜色RGB(0, 174, 255) emTransparent 5 工具栏的透明度emWindowAware 6 设置是否禁用随着DPI放大，flagvalue传递任意值均可 此项设置非常重要，相当于调用 SetProcessDPIAware，如果不设置，在高DPI的环境下，截图将会错乱,请在程序窗口创建前调用 emDetectSubWindowRect 7 是否自动检测子窗口，暂时无用emSetSaveName 8 设置保存时的文件名称 如： const char* szName = 测试名; InitCaptureParam(emSetSaveName, (unsigned long) szName); 注：免费版本此接口无效，将会显示默认值 emSetMagnifierBkColor 9 用于设置放大镜的背景色 一般不建议设置，默认透明即可 emSetMagnifierLogoText 10 设置放大镜上的显示的LOGO文字 如： const char* szLogoName = 测试名; InitCaptureParam(emSetMagnifierLogoText, (unsigned long) szLogoName); 注：免费版本此接口无效，将会显示默认值 以下是水印设置功能，如果不需要则无需关注 emSetWatermarkPictureType 20 用于设置水印图片的绘制方式 此参数设置具有默认值，仅在授权版本中才可修改设置，具体见下面的水印图片说明 emSetWatermarkPicturePath 21 用于设置水印图片的路径 注：此处的路径需要使用Unicode编码 emSetWatermarkTextType 22 用于设置水印文字绘制方式 此参数设置具有默认值