CnPack不可視組件幫助文檔

CnPack-中國人自己的開放源碼開發(fā)包pac,CnPack不可視組件幫助文檔作者：ChildeNg(ningensoft@)劉嘯(liuxiao@)菩提部門：類別：版本：創(chuàng)建：修改：CnPack開發(fā)組不可視化組開發(fā)員幫助文檔V2008-04-092008-10-25引言1、 組件包概述本部分組件為不可視組中未歸類的部分，主要用來實(shí)現(xiàn)一些與界面等無較大關(guān)系的系統(tǒng)功能，其祖先類一般是TComponent,而不是TControl。二、TCnTrayIcon組件1、 組件功能概述CnTrayIcon組件可為應(yīng)用程序添加一個(gè)到桌面右下角的系統(tǒng)托盤圖標(biāo),附加有多種形式的氣泡提示功能,允許用戶在應(yīng)用程序處于非激活狀態(tài)時(shí),通過獲得對系統(tǒng)托盤圖標(biāo)的各種操作,從而實(shí)現(xiàn)對程序進(jìn)行非界面的后臺控制。2、 所在文件CnTraylcon.pas,系統(tǒng)托盤圖標(biāo)類單元。3、 屬性說明propertyActive:Boolean;屬性名稱：Active類型：Boolean默認(rèn)值：True說明：設(shè)置托盤圖標(biāo)是否為激活狀態(tài),即是否在系統(tǒng)托盤顯示圖標(biāo)。propertyAutoHide:Boolean;屬性名稱：AutoHide類型：Boolean默認(rèn)值：False說明：為True時(shí)隱藏在任務(wù)欄上的程序標(biāo)題欄。propertyEnabled:Boolean;屬性名稱：Enabled類型：Boolean默認(rèn)值：True說明：為True時(shí)允許使用CnTraylcon應(yīng)用到程序中。propertyHint:string;屬性名稱：Hint類型：string默認(rèn)值：無說明：當(dāng)鼠標(biāo)移動到托盤圖標(biāo)時(shí)顯示的普通提示內(nèi)容。propertyIcon:TIcon;屬性名稱：Icon類型：TIcon默認(rèn)值：沒有說明：顯示在系統(tǒng)托盤的圖標(biāo)，可從外部導(dǎo)入圖標(biāo)文件。propertyPopupMenu:TPopupMenu;屬性名稱：PopupMenu類型：TPopupMenu默認(rèn)值：nil說明：右擊圖標(biāo)時(shí)出現(xiàn)的右鍵菜單。propertyShowDesign:Boolean屬性名稱：ShowDesign類型：Boolean默認(rèn)值：False說明：為True時(shí)在設(shè)計(jì)窗體時(shí)出現(xiàn)桌面托盤圖標(biāo)。propertyUseAppIcon:Boolean屬性名稱：UseAppIcon類型：Boolean默認(rèn)值：False說明：為True時(shí)Icon屬性將使用主程序的圖標(biāo)，也即Application.Icon。4、 方法說明procedureHideIcon;功能：隱藏托盤圖標(biāo)。參數(shù)：無。procedureShowIcon;功能：顯示托盤圖標(biāo)。參數(shù)：無。procedureHideApplication;功能：隱藏程序的窗體。參數(shù)：無。procedureShowApplication;功能：顯示程序的窗體。參數(shù)：無。procedureBalloonHint(Title,Value:string;BalloonType:TBalloonType=btNone;DelaySeconds:Integer=5);功能：彈出氣泡提示內(nèi)容。參數(shù)：1.Title:string;氣泡的提示標(biāo)題。2.Value:string;氣泡的提示內(nèi)容。3.BalloonType:TBalloonType;氣泡圖標(biāo)的形式，默認(rèn)為不顯示圖標(biāo)。4.DelaySeconds:Integer;氣泡彈出的延時(shí)時(shí)間，默認(rèn)時(shí)間為5秒。5、 事件說明propertyOnClick:TMouseEvent;左鍵單擊托盤圖標(biāo)時(shí)發(fā)生。參數(shù)：1.Sender:TObject;托盤圖標(biāo)的實(shí)例。2.Button:TMouseButton;獲得鼠標(biāo)的按鍵情況。3.Shift:TShiftState;事件發(fā)生時(shí)是否還有其他附加鍵盤被按下4.X:Integer;事件發(fā)生時(shí)鼠標(biāo)的X坐標(biāo)。5.Y:Integer;事件發(fā)生時(shí)鼠標(biāo)的Y坐標(biāo)。propertyOnDblClick:TNotifyEvent;當(dāng)左鍵雙擊托盤圖標(biāo)時(shí)觸發(fā)。參數(shù)：1.Sender:TObject;托盤圖標(biāo)的實(shí)例propertyOnMouseMove:TMouseMoveEvent;當(dāng)鼠標(biāo)在托盤圖標(biāo)上移動時(shí)發(fā)生。參數(shù)：1.Sender:TObject;托盤圖標(biāo)的實(shí)例。2.Shift:TShiftState;事件發(fā)生時(shí)是否還有其他附加鍵盤被按下。3.X:Integer;事件發(fā)生時(shí)鼠標(biāo)的X坐標(biāo)。4.Y:Integer;事件發(fā)生時(shí)鼠標(biāo)的Y坐標(biāo)。propertyOnMouseDown:TMouseEvent;當(dāng)鼠標(biāo)從托盤圖標(biāo)上按下時(shí)發(fā)生。參數(shù)：1.Sender:TObject;托盤圖標(biāo)的實(shí)例。2.Button:TMouseButton;獲得鼠標(biāo)的按鍵情況。3.Shift:TShiftState;事件發(fā)生時(shí)是否還有其他附加鍵盤被按下4.X:Integer;事件發(fā)生時(shí)鼠標(biāo)的X坐標(biāo)。5.Y:Integer;事件發(fā)生時(shí)鼠標(biāo)的Y坐標(biāo)。propertyOnMouseUp:TMouseEvent;當(dāng)鼠標(biāo)從托盤圖標(biāo)上松開時(shí)發(fā)生參數(shù)：1.Sender:TObject;托盤圖標(biāo)的實(shí)例。2.Button:TMouseButton;獲得鼠標(biāo)的按鍵情況。3.Shift:TShiftState;事件發(fā)生時(shí)是否還有其他附加鍵盤被按下4.X:Integer;事件發(fā)生時(shí)鼠標(biāo)的X坐標(biāo)。5.Y:Integer;事件發(fā)生時(shí)鼠標(biāo)的Y坐標(biāo)。propertyOnBalloonShow:TNotifyEvent當(dāng)彈出氣泡提示時(shí)發(fā)生。參數(shù)：Sender:TObject;托盤圖標(biāo)的實(shí)例。三、 TCnVolumeCtrl組件1、 組件功能概述TCnVolumeCtrl組件主要用于多媒體程序的音量平衡調(diào)整、音量大小控制及獲取當(dāng)前電腦的聲音狀態(tài)和獲取聲音相關(guān)的屬性。2、 所在文件CnVolumeCtrl.pas,音量調(diào)整組件實(shí)現(xiàn)單元propertyDevs;類型：LongWord屬性值：獲取設(shè)備總數(shù)。propertyCurDev;類型：LongWord屬性值：設(shè)置/獲取當(dāng)前設(shè)備。propertyCurDevCaption;類型：LongWord屬性值：獲取當(dāng)前設(shè)備名稱。propertyLines;類型：LongWord屬性值：獲取設(shè)備總數(shù)。propertyCurLine;類型：LongWord屬性值：獲取設(shè)備總數(shù)。propertyCurLineCaption;類型：string屬性值：獲取設(shè)備總數(shù)。propertyVolume;類型：Integer屬性值：設(shè)置/獲取當(dāng)前線路音量。propertyBalance;類型：TCnBalance屬性值：設(shè)置/獲取當(dāng)前線路左右平衡。propertyIsMute;類型：Boolean屬性值：設(shè)置/獲取當(dāng)前線路靜音狀態(tài)。4、 方法說明functionGetDevCaption(uDev:UINT):string;參數(shù)：uDev:LongWord設(shè)備編號。返回值：返回字符串型的設(shè)備名稱。functionGetDevLines(uDev:UINT):DWORD;參數(shù)：uDev:LongWord設(shè)備編號。返回值：返回設(shè)備線路總數(shù)。functionGetLineCaption(uDev,uLine:UINT):string;參數(shù)：uDev:LongWord設(shè)備編號。uLine:LongWord線路編號。返回值：返回指定設(shè)備指定線路字符串型的名稱。functionGetLineChannels(uDev,uLine:UINT):DWORD;參數(shù)：uDev:LongWord設(shè)備編號。uLine:LongWord線路編號。返回值：返回指定設(shè)備指定線路的通道總數(shù)。functionGetLineHaveBalance(uDev,uLine:UINT):Boolean;參數(shù)：uDev:LongWord設(shè)備編號。uLine:LongWord線路編號。返回值：如果指定設(shè)備指定線路存在左右平衡，返回True,否則為FalsefunctionGetLineVolume(uDev,uLine:UINT):TCnVolume;參數(shù)：uDev:LongWord設(shè)備編號。uLine:LongWord線路編號。返回值：返回指定設(shè)備指定線路的音量。functionGetLineBalance(uDev,uLine:UINT):TCnBalance;參數(shù)：1.uDev:LongWord設(shè)備編號。2.uLine:LongWord線路編號。返回值：返回指定設(shè)備指定線路的平衡狀態(tài)。functionGetLineMute(uDev,uLine:UINT):Boolean;參數(shù)：1.uDev:LongWord設(shè)備編號。2.uLine:LongWord線路編號。返回值：為True返回指定設(shè)備指定線路已經(jīng)靜音，否則未靜音。

CnPack-中國人自己的開放源碼開發(fā)包pac,functionSetLineVolume(uDev,uLine:UINT;Volume:TCnVolume):Boolean;參數(shù)：uDev:LongWord設(shè)備編號。uLine:LongWord線路編號。Volume:TCnVolume在0到255范圍的音量值。返回值：如果設(shè)置線路音量成功，返回True,否則為FalsefunctionSetLineBalance(uDev,uLine:UINT;iBalance:TCnBalance):Boolean;參數(shù)：uDev:LongWord設(shè)備編號。uLine:LongWord線路編號。iBalance:TCnBalance在-32到32的左右平衡值范圍。返回值：如果設(shè)置線路左右平衡成功，返回True,否則為False。functionSetLineMute(uDev,uLine:UINT;bMute:Boolean):Boolean;參數(shù)：uDev:LongWord設(shè)備編號。uLine:LongWord線路編號。bMute:Boolean為True時(shí)靜音。返回值：如果設(shè)置線路通道總數(shù)成功，返回True,否則為False。5、 事件說明propertyOnVolumeChange;當(dāng)音量大小調(diào)整時(shí)觸發(fā)。參數(shù)：Volume:TCnVolume;返回當(dāng)前的音量大小。Balance:TCnBalance返回當(dāng)前的平衡狀態(tài)。propertyOnMuteChange;當(dāng)切換是否靜音時(shí)觸發(fā)。參數(shù)：1.bMute:Boolean返回當(dāng)前的靜音狀態(tài)，如果為True為已靜音。四、 TCnDragResizer組件1、 組件功能概述TCnDragResizer組件可關(guān)聯(lián)一可視化組件，使其出現(xiàn)設(shè)計(jì)期組件的一些特性，如允許拖動改2、 所在文件CnDragResizer.pas3、 屬性說明propertyActive;類型：Boolean屬性值：是否使能，默認(rèn)為TpertyControl;類型：TControl屬性值：所關(guān)聯(lián)的控件。propertyGridX;類型：Integer屬性值：X方向拖動的步長，默認(rèn)為4。propertyGridY;類型：Integer屬性值：Y方向拖動的步長，默認(rèn)為4。propertyAllowSize;類型：Boolean屬性值：是否允許改變大小，默認(rèn)為TpertyAllowMove;類型：Boolean屬性值：是否允許拖動改變位置，默認(rèn)為TpertyKeepInParent;類型：Boolean屬性值：拖動時(shí)是否將其限制在其Parent內(nèi)部，不超出邊緣，默認(rèn)為TpertyShowBounds;類型：Boolean屬性值：是否拖動時(shí)顯示邊框。4、 方法說明無。propertyOnSized:TNotifyEvent;所關(guān)聯(lián)控件被拖動而改變尺寸后觸發(fā)。參數(shù)：Sender:TObject;TCnDragResizer本身。propertyOnSizing:TSizingEvent;TSizingEvent=procedure(Sender:TCnDragResizer;varNewLeft,NewTop,NewWidth,NewHeight:Integer)ofobject;所關(guān)聯(lián)控件被拖動而改變尺寸時(shí)觸發(fā)。參數(shù)：Sender:TObject;TCnDragResizer本身。NewLeft:Integer;拖動過程中被拖動控件位置的Left值。NewTop:Integer;拖動過程中被拖動控件位置的Top值。NewWidth:Integer;拖動過程中被拖動控件的新的寬度值。NewHeight:Integer;拖動過程中被拖動控件的新的高度值。propertyOnMoved:TNotifyEvent;所關(guān)聯(lián)控件被拖動而改變位置后觸發(fā)。參數(shù)：Sender:TObject;TCnDragResizer本身。propertyOnMoving:TMovingEvent;TMovingEvent=procedure(Sender:TCnDragResizer;varNewLeft,NewTop:Integer)ofobject;所關(guān)聯(lián)控件被拖動而改變位置時(shí)觸發(fā)。參數(shù)：Sender:TObject;TCnDragResizer本身。NewLeft:Integer;拖動過程中被拖動控件位置的Left值。NewTop:Integer;拖動過程中被拖動控件位置的Top值。五、 TCnKeyBlocker組件1、 組件功能概述TCnKeyBlocker組件能夠以鍵盤鉤子的形式在整個(gè)系統(tǒng)范圍內(nèi)屏蔽鍵盤的某些組合鍵，屏蔽功能只在運(yùn)行期有效，并可自定義一屏蔽鍵。2、 所在文件CnKeyBlocker.paspropertyEnabled;類型：Boolean屬性值：是否使能，也就是是否啟動屏蔽功能。默認(rèn)為False，設(shè)計(jì)期此屬性無效。propertyBlockCtrlAltDelete;類型：Boolean屬性值：是否屏蔽Ctrl+Alt+Delete鍵，默認(rèn)為False，不屏蔽。此功能在NT或以上版本的Windows下無效。propertyBlockAltTab;類型：Boolean屬性值：是否屏蔽Alt+Tab鍵，默認(rèn)為False，不屏蔽。propertyBlockCtrlEsc;類型：Boolean屬性值：是否屏蔽Ctrl+Esc鍵，默認(rèn)為False，不屏蔽。propertyBlockAltEsc;類型：Boolean屬性值：是否屏蔽Alt+Esc鍵，默認(rèn)為False，不屏蔽。propertyBlockCtrlEnter;類型：Boolean屬性值：是否屏蔽Ctrl+Enter鍵，默認(rèn)為False，不屏蔽。propertyBlockSleep;類型：Boolean屬性值：是否屏蔽休眠Sleep鍵，默認(rèn)為False，不屏蔽。propertyBlockPower;類型：Boolean屬性值：是否屏蔽Power電源鍵，默認(rèn)為False，不屏蔽。propertyBlockWinApps;類型：Boolean屬性值：是否屏蔽Windows鍵，默認(rèn)為False，不屏蔽。propertyBlockCtrlAltEnter;類型：Boolean屬性值：是否屏蔽Ctrl+Alt+Enter鍵，默認(rèn)為False，不屏蔽。propertyCustomKeyCode;屬性值：自定義一個(gè)鍵供自定義屏蔽用。propertyBlockCustomKey;類型：Boolean屬性值：是否屏蔽自定義鍵，默認(rèn)為False,不屏蔽。4、 方法說明無。5、 事件說明propertyOnBlockKey:TCnBlockKeyEvent;TCnBlockKeyEvent=procedure(Sender:TObject;VirtualKey:Cardinal)ofobject;當(dāng)屏蔽某個(gè)鍵時(shí)觸發(fā)。參數(shù)：Sender:TObject觸發(fā)屏蔽事件的對象。VirtualKey:Cardinal被屏蔽的虛擬鍵值。說明：由于復(fù)雜性，參數(shù)中只指明虛擬鍵，未能統(tǒng)一指定Ctrl、Alt等控制鍵的狀態(tài)。并且由于掛接機(jī)制本身的機(jī)制，此事件無Sender,使用時(shí)應(yīng)予注意。六、TCnTaskBar組件1、 組件功能概述CnTaskBar任務(wù)欄管理組件能對當(dāng)前系統(tǒng)所有顯示在任務(wù)欄上的程序，和“開始”按鈕、快速啟動欄及托盤區(qū)進(jìn)行隱藏、顯示、關(guān)閉、自定義的處理。2、 所在文件CnTaskBarpas，任務(wù)欄管理單元3、 屬性說明propertyTrayBarHandle:THandle;托盤區(qū)句柄，只讀propertyTaskBarHandle:THandle;任務(wù)欄句柄，只讀propertyStartBtnHandle:THandle;開始按鈕句柄，只讀propertyQuitLauchHandle:THandle;快速啟動欄句柄，只讀propertyImeRecHandle:THandle;輸入法選擇區(qū)域句柄，只讀propertyProgramToolBarHandle:THandle;程序最小化按鈕容器，只讀propertyHideTrayBtnHandle:THandle;顯示隱藏圖標(biāo)的按鈕，只讀propertyClockHandle:THandle;時(shí)鐘顯示區(qū)域，只讀propertyTrayBtnList:TstringList;托盤圖標(biāo)名稱列表，只讀propertyTaskBtnList:TstringList;任務(wù)欄應(yīng)用程序名稱列表，只讀propertyTrayBtnCount:Integer;托盤圖標(biāo)的個(gè)數(shù)，只讀propertyTaskBtnCount:Integer;任務(wù)欄應(yīng)用程序按鈕個(gè)數(shù)，只讀propertyTrayBtns[index:Integer]:TCnSysToolBarBtn;托盤按鈕列表，只讀PropertyTaskBtns[index:Integer]:TCnSysToolBarBtn;任務(wù)欄按鈕列表，只讀propertyTrayBarVisible:Boolean;托盤區(qū)域是否可見，只讀propertyImeBarVisible:Boolean;語言區(qū)域是否可見，只讀propertyReBarVisible:Boolean;任務(wù)欄按鈕是否可見，只讀propertyTaskToolBarVisible:Boolean;propertyTaskBarVisible:Boolean;任務(wù)欄應(yīng)用程序區(qū)域是否可見，可讀寫propertyQuickBarVisible:Boolean;快速啟動欄是否可見，可讀寫propertyVisible:Boolean;是否隱藏任務(wù)欄，可讀寫propertyShowHideBtn:Boolean;是否顯示系統(tǒng)隱藏的托盤按鈕，可讀寫propertyStartBtnVisible:Boolean;開始按鈕是否可見，可讀寫propertyStartBtnCaption:string;開始按鈕的名稱，可讀寫propertyStartBtnEnabled:Boolean;開始按鈕是否使能，可讀寫4、 方法說明procedureSetTimeDlg;功能：彈出設(shè)置時(shí)間對話框參數(shù)：無procedureHideTrayBtnClick;功能：單擊顯示隱藏托盤區(qū)的按鈕參數(shù)：無procedureImeRectBtnClick;功能：單擊輸入法按鈕參數(shù)：無procedureClearTrayBtnList;功能：清除托盤區(qū)列表參數(shù)：無procedureClearTaskBtnList;功能：清楚任務(wù)欄程序按鈕名稱列表procedureShowTime;功能：顯示任務(wù)欄時(shí)間參數(shù)：無procedureStartBtnClick;功能：單擊“開始”按鈕參數(shù)：無procedureHideOn;功能：隱藏任務(wù)欄參數(shù)：無procedureShowOn;功能：顯示任務(wù)欄參數(shù)：無七、TCnConsole組件1、 組件功能概述TCnConsole組件可為應(yīng)用程序提供一個(gè)控制臺，允許用戶在應(yīng)用程序中開啟、關(guān)閉及復(fù)位控制臺。從而實(shí)現(xiàn)控制臺的輸入輸出操作。2、 所在文件TCnConsole.pas，控制臺組件類單元。3、 屬性說明propertyEnabled:Boolean;屬性名稱：Enabled類型：Boolean默認(rèn)值：False說明：為True時(shí)啟動控制臺，為False關(guān)閉控制臺propertyConsoleTitle:string;屬性名稱：ConsoleTitle類型：string默認(rèn)值：''說明：控制臺的標(biāo)題procedureResetConsole;功能：復(fù)位控制臺，即重新打開一個(gè)新的控制臺。在屬性Enabled為True時(shí)有效。參數(shù)：無procedureSetTextColor(constaColor:WORD);功能：設(shè)置控制臺文本的顏色。參數(shù)：1.aColor:WORD：文本的顏色。返回值：無八、TCnFileSystemWatcher組件1、 組件功能概述TCnFileSystemWatcher組件可為應(yīng)用程序提供對指定目錄中文件系統(tǒng)相關(guān)改變的監(jiān)視，將文件系統(tǒng)的相關(guān)改變信息通知給應(yīng)用程序。其內(nèi)部實(shí)現(xiàn)使用一個(gè)監(jiān)視線程類。實(shí)現(xiàn)了文件/目錄變化的監(jiān)視組件，可以監(jiān)視到某目錄(可包括子目錄)下的文件、目錄發(fā)生的名稱修改、大小改變、訪問時(shí)間改變等、事件的發(fā)生。監(jiān)視選項(xiàng)可自行選擇并組合。2、 所在文件CnFileSystemWatcherpas,文件目錄監(jiān)視組件類單元。3、 屬性說明propertyActiv