CnPack不可视组件帮助文档

CnPack-中国人自己的开放源码开发包pac,CnPack不可视组件帮助文档作者：ChildeNg(ningensoft@)刘啸(liuxiao@)菩提部门：类别：版本：创建：修改：CnPack开发组不可视化组开发员帮助文档V2008-04-092008-10-25引言1、 组件包概述本部分组件为不可视组中未归类的部分，主要用来实现一些与界面等无较大关系的系统功能，其祖先类一般是TComponent,而不是TControl。二、TCnTrayIcon组件1、 组件功能概述CnTrayIcon组件可为应用程序添加一个到桌面右下角的系统托盘图标,附加有多种形式的气泡提示功能,允许用户在应用程序处于非激活状态时,通过获得对系统托盘图标的各种操作,从而实现对程序进行非界面的后台控制。2、 所在文件CnTraylcon.pas,系统托盘图标类单元。3、 属性说明propertyActive:Boolean;属性名称：Active类型：Boolean默认值：True说明：设置托盘图标是否为激活状态,即是否在系统托盘显示图标。propertyAutoHide:Boolean;属性名称：AutoHide类型：Boolean默认值：False说明：为True时隐藏在任务栏上的程序标题栏。propertyEnabled:Boolean;属性名称：Enabled类型：Boolean默认值：True说明：为True时允许使用CnTraylcon应用到程序中。propertyHint:string;属性名称：Hint类型：string默认值：无说明：当鼠标移动到托盘图标时显示的普通提示内容。propertyIcon:TIcon;属性名称：Icon类型：TIcon默认值：没有说明：显示在系统托盘的图标，可从外部导入图标文件。propertyPopupMenu:TPopupMenu;属性名称：PopupMenu类型：TPopupMenu默认值：nil说明：右击图标时出现的右键菜单。propertyShowDesign:Boolean属性名称：ShowDesign类型：Boolean默认值：False说明：为True时在设计窗体时出现桌面托盘图标。propertyUseAppIcon:Boolean属性名称：UseAppIcon类型：Boolean默认值：False说明：为True时Icon属性将使用主程序的图标，也即Application.Icon。4、 方法说明procedureHideIcon;功能：隐藏托盘图标。参数：无。procedureShowIcon;功能：显示托盘图标。参数：无。procedureHideApplication;功能：隐藏程序的窗体。参数：无。procedureShowApplication;功能：显示程序的窗体。参数：无。procedureBalloonHint(Title,Value:string;BalloonType:TBalloonType=btNone;DelaySeconds:Integer=5);功能：弹出气泡提示内容。参数：1.Title:string;气泡的提示标题。2.Value:string;气泡的提示内容。3.BalloonType:TBalloonType;气泡图标的形式，默认为不显示图标。4.DelaySeconds:Integer;气泡弹出的延时时间，默认时间为5秒。5、 事件说明propertyOnClick:TMouseEvent;左键单击托盘图标时发生。参数：1.Sender:TObject;托盘图标的实例。2.Button:TMouseButton;获得鼠标的按键情况。3.Shift:TShiftState;事件发生时是否还有其他附加键盘被按下4.X:Integer;事件发生时鼠标的X坐标。5.Y:Integer;事件发生时鼠标的Y坐标。propertyOnDblClick:TNotifyEvent;当左键双击托盘图标时触发。参数：1.Sender:TObject;托盘图标的实例propertyOnMouseMove:TMouseMoveEvent;当鼠标在托盘图标上移动时发生。参数：1.Sender:TObject;托盘图标的实例。2.Shift:TShiftState;事件发生时是否还有其他附加键盘被按下。3.X:Integer;事件发生时鼠标的X坐标。4.Y:Integer;事件发生时鼠标的Y坐标。propertyOnMouseDown:TMouseEvent;当鼠标从托盘图标上按下时发生。参数：1.Sender:TObject;托盘图标的实例。2.Button:TMouseButton;获得鼠标的按键情况。3.Shift:TShiftState;事件发生时是否还有其他附加键盘被按下4.X:Integer;事件发生时鼠标的X坐标。5.Y:Integer;事件发生时鼠标的Y坐标。propertyOnMouseUp:TMouseEvent;当鼠标从托盘图标上松开时发生参数：1.Sender:TObject;托盘图标的实例。2.Button:TMouseButton;获得鼠标的按键情况。3.Shift:TShiftState;事件发生时是否还有其他附加键盘被按下4.X:Integer;事件发生时鼠标的X坐标。5.Y:Integer;事件发生时鼠标的Y坐标。propertyOnBalloonShow:TNotifyEvent当弹出气泡提示时发生。参数：Sender:TObject;托盘图标的实例。三、 TCnVolumeCtrl组件1、 组件功能概述TCnVolumeCtrl组件主要用于多媒体程序的音量平衡调整、音量大小控制及获取当前电脑的声音状态和获取声音相关的属性。2、 所在文件CnVolumeCtrl.pas,音量调整组件实现单元propertyDevs;类型：LongWord属性值：获取设备总数。propertyCurDev;类型：LongWord属性值：设置/获取当前设备。propertyCurDevCaption;类型：LongWord属性值：获取当前设备名称。propertyLines;类型：LongWord属性值：获取设备总数。propertyCurLine;类型：LongWord属性值：获取设备总数。propertyCurLineCaption;类型：string属性值：获取设备总数。propertyVolume;类型：Integer属性值：设置/获取当前线路音量。propertyBalance;类型：TCnBalance属性值：设置/获取当前线路左右平衡。propertyIsMute;类型：Boolean属性值：设置/获取当前线路静音状态。4、 方法说明functionGetDevCaption(uDev:UINT):string;参数：uDev:LongWord设备编号。返回值：返回字符串型的设备名称。functionGetDevLines(uDev:UINT):DWORD;参数：uDev:LongWord设备编号。返回值：返回设备线路总数。functionGetLineCaption(uDev,uLine:UINT):string;参数：uDev:LongWord设备编号。uLine:LongWord线路编号。返回值：返回指定设备指定线路字符串型的名称。functionGetLineChannels(uDev,uLine:UINT):DWORD;参数：uDev:LongWord设备编号。uLine:LongWord线路编号。返回值：返回指定设备指定线路的通道总数。functionGetLineHaveBalance(uDev,uLine:UINT):Boolean;参数：uDev:LongWord设备编号。uLine:LongWord线路编号。返回值：如果指定设备指定线路存在左右平衡，返回True,否则为FalsefunctionGetLineVolume(uDev,uLine:UINT):TCnVolume;参数：uDev:LongWord设备编号。uLine:LongWord线路编号。返回值：返回指定设备指定线路的音量。functionGetLineBalance(uDev,uLine:UINT):TCnBalance;参数：1.uDev:LongWord设备编号。2.uLine:LongWord线路编号。返回值：返回指定设备指定线路的平衡状态。functionGetLineMute(uDev,uLine:UINT):Boolean;参数：1.uDev:LongWord设备编号。2.uLine:LongWord线路编号。返回值：为True返回指定设备指定线路已经静音，否则未静音。

CnPack-中国人自己的开放源码开发包pac,functionSetLineVolume(uDev,uLine:UINT;Volume:TCnVolume):Boolean;参数：uDev:LongWord设备编号。uLine:LongWord线路编号。Volume:TCnVolume在0到255范围的音量值。返回值：如果设置线路音量成功，返回True,否则为FalsefunctionSetLineBalance(uDev,uLine:UINT;iBalance:TCnBalance):Boolean;参数：uDev:LongWord设备编号。uLine:LongWord线路编号。iBalance:TCnBalance在-32到32的左右平衡值范围。返回值：如果设置线路左右平衡成功，返回True,否则为False。functionSetLineMute(uDev,uLine:UINT;bMute:Boolean):Boolean;参数：uDev:LongWord设备编号。uLine:LongWord线路编号。bMute:Boolean为True时静音。返回值：如果设置线路通道总数成功，返回True,否则为False。5、 事件说明propertyOnVolumeChange;当音量大小调整时触发。参数：Volume:TCnVolume;返回当前的音量大小。Balance:TCnBalance返回当前的平衡状态。propertyOnMuteChange;当切换是否静音时触发。参数：1.bMute:Boolean返回当前的静音状态，如果为True为已静音。四、 TCnDragResizer组件1、 组件功能概述TCnDragResizer组件可关联一可视化组件，使其出现设计期组件的一些特性，如允许拖动改2、 所在文件CnDragResizer.pas3、 属性说明propertyActive;类型：Boolean属性值：是否使能，默认为TpertyControl;类型：TControl属性值：所关联的控件。propertyGridX;类型：Integer属性值：X方向拖动的步长，默认为4。propertyGridY;类型：Integer属性值：Y方向拖动的步长，默认为4。propertyAllowSize;类型：Boolean属性值：是否允许改变大小，默认为TpertyAllowMove;类型：Boolean属性值：是否允许拖动改变位置，默认为TpertyKeepInParent;类型：Boolean属性值：拖动时是否将其限制在其Parent内部，不超出边缘，默认为TpertyShowBounds;类型：Boolean属性值：是否拖动时显示边框。4、 方法说明无。propertyOnSized:TNotifyEvent;所关联控件被拖动而改变尺寸后触发。参数：Sender:TObject;TCnDragResizer本身。propertyOnSizing:TSizingEvent;TSizingEvent=procedure(Sender:TCnDragResizer;varNewLeft,NewTop,NewWidth,NewHeight:Integer)ofobject;所关联控件被拖动而改变尺寸时触发。参数：Sender:TObject;TCnDragResizer本身。NewLeft:Integer;拖动过程中被拖动控件位置的Left值。NewTop:Integer;拖动过程中被拖动控件位置的Top值。NewWidth:Integer;拖动过程中被拖动控件的新的宽度值。NewHeight:Integer;拖动过程中被拖动控件的新的高度值。propertyOnMoved:TNotifyEvent;所关联控件被拖动而改变位置后触发。参数：Sender:TObject;TCnDragResizer本身。propertyOnMoving:TMovingEvent;TMovingEvent=procedure(Sender:TCnDragResizer;varNewLeft,NewTop:Integer)ofobject;所关联控件被拖动而改变位置时触发。参数：Sender:TObject;TCnDragResizer本身。NewLeft:Integer;拖动过程中被拖动控件位置的Left值。NewTop:Integer;拖动过程中被拖动控件位置的Top值。五、 TCnKeyBlocker组件1、 组件功能概述TCnKeyBlocker组件能够以键盘钩子的形式在整个系统范围内屏蔽键盘的某些组合键，屏蔽功能只在运行期有效，并可自定义一屏蔽键。2、 所在文件CnKeyBlocker.paspropertyEnabled;类型：Boolean属性值：是否使能，也就是是否启动屏蔽功能。默认为False，设计期此属性无效。propertyBlockCtrlAltDelete;类型：Boolean属性值：是否屏蔽Ctrl+Alt+Delete键，默认为False，不屏蔽。此功能在NT或以上版本的Windows下无效。propertyBlockAltTab;类型：Boolean属性值：是否屏蔽Alt+Tab键，默认为False，不屏蔽。propertyBlockCtrlEsc;类型：Boolean属性值：是否屏蔽Ctrl+Esc键，默认为False，不屏蔽。propertyBlockAltEsc;类型：Boolean属性值：是否屏蔽Alt+Esc键，默认为False，不屏蔽。propertyBlockCtrlEnter;类型：Boolean属性值：是否屏蔽Ctrl+Enter键，默认为False，不屏蔽。propertyBlockSleep;类型：Boolean属性值：是否屏蔽休眠Sleep键，默认为False，不屏蔽。propertyBlockPower;类型：Boolean属性值：是否屏蔽Power电源键，默认为False，不屏蔽。propertyBlockWinApps;类型：Boolean属性值：是否屏蔽Windows键，默认为False，不屏蔽。propertyBlockCtrlAltEnter;类型：Boolean属性值：是否屏蔽Ctrl+Alt+Enter键，默认为False，不屏蔽。propertyCustomKeyCode;属性值：自定义一个键供自定义屏蔽用。propertyBlockCustomKey;类型：Boolean属性值：是否屏蔽自定义键，默认为False,不屏蔽。4、 方法说明无。5、 事件说明propertyOnBlockKey:TCnBlockKeyEvent;TCnBlockKeyEvent=procedure(Sender:TObject;VirtualKey:Cardinal)ofobject;当屏蔽某个键时触发。参数：Sender:TObject触发屏蔽事件的对象。VirtualKey:Cardinal被屏蔽的虚拟键值。说明：由于复杂性，参数中只指明虚拟键，未能统一指定Ctrl、Alt等控制键的状态。并且由于挂接机制本身的机制，此事件无Sender,使用时应予注意。六、TCnTaskBar组件1、 组件功能概述CnTaskBar任务栏管理组件能对当前系统所有显示在任务栏上的程序，和“开始”按钮、快速启动栏及托盘区进行隐藏、显示、关闭、自定义的处理。2、 所在文件CnTaskBarpas，任务栏管理单元3、 属性说明propertyTrayBarHandle:THandle;托盘区句柄，只读propertyTaskBarHandle:THandle;任务栏句柄，只读propertyStartBtnHandle:THandle;开始按钮句柄，只读propertyQuitLauchHandle:THandle;快速启动栏句柄，只读propertyImeRecHandle:THandle;输入法选择区域句柄，只读propertyProgramToolBarHandle:THandle;程序最小化按钮容器，只读propertyHideTrayBtnHandle:THandle;显示隐藏图标的按钮，只读propertyClockHandle:THandle;时钟显示区域，只读propertyTrayBtnList:TstringList;托盘图标名称列表，只读propertyTaskBtnList:TstringList;任务栏应用程序名称列表，只读propertyTrayBtnCount:Integer;托盘图标的个数，只读propertyTaskBtnCount:Integer;任务栏应用程序按钮个数，只读propertyTrayBtns[index:Integer]:TCnSysToolBarBtn;托盘按钮列表，只读PropertyTaskBtns[index:Integer]:TCnSysToolBarBtn;任务栏按钮列表，只读propertyTrayBarVisible:Boolean;托盘区域是否可见，只读propertyImeBarVisible:Boolean;语言区域是否可见，只读propertyReBarVisible:Boolean;任务栏按钮是否可见，只读propertyTaskToolBarVisible:Boolean;propertyTaskBarVisible:Boolean;任务栏应用程序区域是否可见，可读写propertyQuickBarVisible:Boolean;快速启动栏是否可见，可读写propertyVisible:Boolean;是否隐藏任务栏，可读写propertyShowHideBtn:Boolean;是否显示系统隐藏的托盘按钮，可读写propertyStartBtnVisible:Boolean;开始按钮是否可见，可读写propertyStartBtnCaption:string;开始按钮的名称，可读写propertyStartBtnEnabled:Boolean;开始按钮是否使能，可读写4、 方法说明procedureSetTimeDlg;功能：弹出设置时间对话框参数：无procedureHideTrayBtnClick;功能：单击显示隐藏托盘区的按钮参数：无procedureImeRectBtnClick;功能：单击输入法按钮参数：无procedureClearTrayBtnList;功能：清除托盘区列表参数：无procedureClearTaskBtnList;功能：清楚任务栏程序按钮名称列表procedureShowTime;功能：显示任务栏时间参数：无procedureStartBtnClick;功能：单击“开始”按钮参数：无procedureHideOn;功能：隐藏任务栏参数：无procedureShowOn;功能：显示任务栏参数：无七、TCnConsole组件1、 组件功能概述TCnConsole组件可为应用程序提供一个控制台，允许用户在应用程序中开启、关闭及复位控制台。从而实现控制台的输入输出操作。2、 所在文件TCnConsole.pas，控制台组件类单元。3、 属性说明propertyEnabled:Boolean;属性名称：Enabled类型：Boolean默认值：False说明：为True时启动控制台，为False关闭控制台propertyConsoleTitle:string;属性名称：ConsoleTitle类型：string默认值：''说明：控制台的标题procedureResetConsole;功能：复位控制台，即重新打开一个新的控制台。在属性Enabled为True时有效。参数：无procedureSetTextColor(constaColor:WORD);功能：设置控制台文本的颜色。参数：1.aColor:WORD：文本的颜色。返回值：无八、TCnFileSystemWatcher组件1、 组件功能概述TCnFileSystemWatcher组件可为应用程序提供对指定目录中文件系统相关改变的监视，将文件系统的相关改变信息通知给应用程序。其内部实现使用一个监视线程类。实现了文件/目录变化的监视组件，可以监视到某目录(可包括子目录)下的文件、目录发生的名称修改、大小改变、访问时间改变等、事件的发生。监视选项可自行选择并组合。2、 所在文件CnFileSystemWatcherpas,文件目录监视组件类单元。3、 属性说明propertyActiv