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