用戶手冊(cè)簡(jiǎn)體k3bos插件開發(fā)手冊(cè)

1、（版本：V12.2）金蝶（中國(guó)）K/3 產(chǎn)品部K/3開發(fā)部目錄概述1COM1K3ClassEvents的對(duì)象模型1使用說明1K3ClassEvents的對(duì)象2ListEvents對(duì)象參考3DataSrv 屬性3EnableListFillRowEvents 屬性4K3Lib 屬性5List 屬性6ListEntrySort 屬性6ListFilterString 屬性7ListHeadSort 屬性7Bar 屬性7MultiCheckMgr 屬性8RsId 屬性8ShowMode 屬性9ShowMsg 屬性9DeleteBill 函數(shù)9GetDataFldByKey 函數(shù)10GetDataFl

2、d 函數(shù)11GetCurrentSelRowInfo 函數(shù)12GetSelectedBillInfo 函數(shù)13LoadSelectedBill 函數(shù)14RefreshList函數(shù)14SenderMessage 函數(shù)15UpdateNormalFld 函數(shù)16UpdateNormalFldByKey 函數(shù)16RefreshAfterBat函數(shù)17ultiCheck事件17AfterBusinessCheck 事件18AfterBusinessCheckEx 事件18AfterCopyBillCreateData 事件19AfterDeleteBill 事件19AfterMergeCopyBill

3、事件20AfterMultiCheck 事件20AfterMultiCheckEx 事件20AfterSelList 事件21AfterUnBusinessCheck 事件21AfterUnBusinessCheckEx 事件22AfterUnMultiCheck 事件22AfterUnMultiCheckEx 事件23BeforeMultiCheck 事件23BeforeMultiCheckEx 事件24BeforePrBill 事件24BeforeSenderMessage 事件25BeforRefreshToolBar 事件25BusinessCheck 事件26BusinessChec

4、kEx 事件26FinishMultiCheck 事件26FinishMultiCheckEx 事件27ListFillRow 事件27ListRowSelected 事件29BarClick 事件30BarInitialize 事件30MultiCheck 事件30MultiCheckEx 事件31PrSucsful事件32StartMultiCheck 事件32StartMultiCheckEx 事件33UnBusinessCheck 事件33UnBusinessCheckEx 事件33UnMultiCheck 事件34UnMultiCheckEx 事件35ReMultiCheck 事件3

5、5ReMultiCheckEx 事件35ReUnMultiCheck 事件36ReUnMultiCheckEx 事件36BaseClassEvent對(duì)象參考38BrowseCtl 屬性38DataSrv 屬性38EnableListFillRowEvents 屬性38InsertNewRowAndFillOption屬性40K3Lib 屬性40ListActiveBar 屬性41ListEntrySort 屬性41ListFilterString 屬性41ListHeadSort 屬性42Bar 屬性42RsClassGroup 屬性43RsId 屬性43GetActiveCtl 函數(shù)43Ge

6、tSelectedCla函數(shù)44GetSelectedClassType 函數(shù)45GetSelectedItemID 函數(shù)45iiiGetSelectedItems 函數(shù)46IsSearchSe 函數(shù)47PitchItemByID 函數(shù)47SelectClassGroupByID 函數(shù)48SenderMessage 函數(shù)49SetSus函數(shù)50RefreshClassGroups 方法50RefreshListByClassGrou方法51RefreshSelectedClassGroup 方法51RefreshSelectedClassGroupList 方法52AfterGetData 事

7、件52BeforePrBill 事件53BeforeSenderMessage 事件53ClassGroupSelected 事件54DeleteBillSusful事件54ListFillRow 事件55ListRowSelected 事件57BarClick 事件57BarInitialize 事件57RefreshList 事件58BillEvent對(duì)象參考59AcsoryTypeID 屬性59BillCtl 屬性59BillEntrys 屬性59BillHeads 屬性60BillHeight 屬性60BillName 屬性60BillSus 屬性61BillWidth 屬性61Can

8、celPrControl屬性62ClassType 屬性62ClassTypeEntry 屬性62ClassTypeKey 屬性63Data 屬性63DataSrv 屬性63EntryPrimaryKey 屬性64FID 屬性64InsertNewRowAndFillOption屬性65IsDoAction 屬性65IsDoActionData 屬性65K3Lib 屬性66LayerCount 屬性66LayerNames屬性66Bar 屬性67ivMultiCheckMgr 屬性67ObjectID 屬性68ObjectType 屬性68OriginalFieldValue屬性68Prima

9、ryKey 屬性69ReSaveSucs 屬性69rsBillID 屬性69ShowType 屬性70TableInfo 屬性70TableName 屬性70TaskID 屬性71ShowMsg 屬性71BatchToDoActions函數(shù)71DeleteEntryData 函數(shù)72GetActiveCtl 函數(shù)73GetActiveField 函數(shù)74monControl函數(shù)74GetDataFld 函數(shù)75GetDataFldbyKey 函數(shù)76GetFieldInfoByKey 函數(shù)77GetDynamicCtlByKey函數(shù)78GetFieldValue 函數(shù)78GetToolInde

10、x 函數(shù)79GetVariable函數(shù)80InsertNewRowAndFill 函數(shù)81IsChange 函數(shù)81IsFileNeedFilter 函數(shù)82LockBill 函數(shù)83RefreshBill 函數(shù)83SenderMessage 函數(shù)83SetDecimal 函數(shù)84SetFieldSumValue函數(shù)85SetFieldValue 函數(shù)85SetSumDecimal 函數(shù)86SetText 函數(shù)87SetTypeFloatMax 函數(shù)88SetTypeFloatMin 函數(shù)88ShowHideField 函數(shù)89ShowHideGrid 函數(shù)89Sum 函數(shù)90UpdaookF

11、ld 函數(shù)90UpdateNormalFld 函數(shù)91DoAction 方法91IsDoActionByKey 方法92vLockCell 方法92RemoveRow 方法93SaveBill 方法93SetActiveTab方法94SetBillFormCaption 方法94SetCaption 方法95SetGridMaxRows方法95SetSus 方法96SetActiveCell 方法96SetBillWindowS e方法97SetRowsPerRequest方法97SetSeStPicture方法98SetS usBarInfo方法98SetVariable函數(shù)99SizeBi

12、llControl方法100AddNewRow 事件100AfterBusinessCheck 事件100AfterBusinessCheckEx 事件101AfterCopyBill 事件101AfterDeleteRow 事件101AfterDoAction 事件102AfterFillRow 事件103AfterNewBill 事件103AfterInputBillSetSumData 事件103AfterLoadBill 事件104AfterLoadBillSetSumData 事件104AfterLoadDynamicCtl事件104AfterMergeCopyBill 事件105A

13、fterMultiCheck 事件105AfterMultiCheckEx 事件106AfterNewBill 事件106AfterNewEmptyData 事件106AfterSave 事件107AfterSelBill 事件107AfterSelBillBeforeFillData 事件107AfterStockQuery事件107AfterUnBusinessCheck 事件108AfterUnBusinessCheckEx 事件108AfterUnMultiCheck 事件108AfterUnMultiCheckEx 事件109BeforeDeleteRow事件109BeforeDoA

14、ction 事件110BeforeLoadBill 事件111BeforeMultiCheck 事件111viBeforeMultiCheckEx 事件112BeforePrBill 事件112BeforeSave 事件113BeforeSelBills 事件113BeforeSelBillShowFilter 事件114BeforeSenderMessage 事件115BeforeSetMutilSelData事件115BeforeSetMutilSelData2 事件116BeforeVerify 事件116BeforeWindowExit事件116BeforLoadBillFillDat

15、a 事件117BeginEdit 事件117BusinessCheck 事件117BusinessCheckEx 事件118Change 事件118dClick事件119EntryFieldChanged事件119FinishMultiCheck 事件119FinishMultiCheckEx 事件120GetFocus 事件120HeadCtlClick 事件121LostFocus 事件121BarClick 事件122BarInitialize 事件122MultiCheck 事件122MultiCheckEx 事件123ReMultiCheck 事件124ReMultiCheckEx

16、事件124ReUnMultiCheck 事件125ReUnMultiCheckEx 事件125SaveBillFailed 事件125SaveBillSucs事件126SSTabClick事件126StartMultiCheck 事件126StartMultiCheckEx 事件127UnBusinessCheck 事件128UnBusinessCheckEx 事件128UnMultiCheck 事件128UnMultiCheckEx 事件129Verify 事件130K3Lib對(duì)象參考131Account 屬性131Net 屬性132User 屬性132viiBatchPushOldBill

17、s 函數(shù)132CreateK3Object 函數(shù)136GetData 函數(shù)137GetK3Language 函數(shù)138LoadKDString 函數(shù)139UpdateData 方法141GetStockQty 函數(shù)141LookUpClass函數(shù)142LoadBill 方法144LoadList方法144LoadOldList方法145Account對(duì)象參考147AccountID 屬性147AccountName 屬性147SetupType 屬性147Net對(duì)象參考149Begutex 函數(shù)149CommitMutex 函數(shù)149QueryFunc 函數(shù)150QuerySubSys 函數(shù)1

18、50User對(duì)象參考151UserID 屬性151UserName 屬性151Bar對(duì)象參考152Bar 對(duì)象結(jié)構(gòu)圖152ActiveBand 屬性153Bands 屬性153Tools 屬性154Refresh 方法154Bands對(duì)象參考155Count 屬性155Item 屬性155Add 函數(shù)155Remove 方法156RemoveAll 方法156Band對(duì)象參考157BandName 屬性157BandType 屬性157Tools 屬性157Caption 屬性157CurrentTool 屬性158DockingArea 屬性158DockingOffset 屬性158Doc

19、kLine 屬性159viiiFlags 屬性159Visible 屬性159Wrappable 屬性160Refresh 方法160Tools對(duì)象參考161Count 屬性161Item 屬性161Add 函數(shù)161GetFreeToolID 函數(shù)162InsertAfter 方法162InsertBefore 方法163Remove 方法163RemoveAll 方法164Tool對(duì)象參考165Alignment 屬性165BeginGroup屬性165Caption 屬性165Captionition 屬性166Checked 屬性166Default 屬性166Description

20、屬性167Enabled 屬性167ShortcutKey 屬性167Style 屬性170SubBand 屬性170Tag 屬性170ToolID 屬性170ToolName 屬性171ToolPicture 屬性171TooltipText 屬性171Visible 屬性171PasteToolFace 方法171SetPicture 方法172BillHeadsBillHeadBillEntrysBillEntryFieldsField對(duì)象參考174Bar 對(duì)象結(jié)構(gòu)圖174BillHeads對(duì)象參考175Count 屬性175Item 屬性176BillHead對(duì)象參考177Fields

21、 屬性177BillEntrys對(duì)象參考178Count 屬性178Item 屬性179BillEntry對(duì)象參考180ixFields 屬性180EntryHeight 屬性180EntryIndex 屬性180EntryLeft 屬性180EntryTop 屬性180EntryType 屬性181EntryWidth 屬性181KeyField 屬性181Layer 屬性181MaxRows 屬性182TableName 屬性182Visible 屬性182AddRow 方法182RemoveRow 方法183Fields對(duì)象參考184Count 屬性184Item 屬性184Field對(duì)

22、象參考185Caption 屬性185FieldHeight 屬性185FieldLeft 屬性185FieldLock 屬性185FieldName 屬性186FieldTop 屬性186FieldWidth 屬性186Filter 屬性186FKey 屬性186FontBold 屬性187FontItalic 屬性187FontName 屬性187FontSize 屬性187FrameBorder 屬性188FrameBorderColor 屬性188LabelColor 屬性188LabelWidth 屬性188Layer 屬性188MustInput 屬性189NeedSave 屬性1

23、89Note 屬性189Number 屬性189Page 屬性189Row 屬性190TableName 屬性190Text 屬性190 xTextColor 屬性190Value 屬性190Visible 屬性191SetFieldSumValue方法191.Net192基礎(chǔ)配置192開發(fā)環(huán)境192使用說明192 192插件192K3ClassEvents的對(duì)象模型193K3ClassEvents的對(duì)象193ListEvents對(duì)象參考194事件 194AfterCopyBillCreateData 事件195OnBarInitialize 事件195AfterShowBill 事件195O

24、nBarItemClick 事件196ShowBill函數(shù)196AspxGetSelectList 函數(shù)197AddBarItem函數(shù)197AddBarItemLink函數(shù)198SetBarItemProperty函數(shù)199AddBarItemLink函數(shù)199RemoveBarItem函數(shù)200RemoveBarItemLink函數(shù)200BillName 屬性201ClassType 屬性201ClassTypeEntry 屬性201ClassTypeKey 屬性202PrimaryKey 屬性202EntryPrimaryKey 屬性203TableInfo 屬性203TableName

25、屬性203BillEvent對(duì)象參考205事件 205OnBarInitialize 事件206OnBarItemClick 事件207AfterNewBill 事件207BeforLoadBillFillData 事件207AfterLoadBill 事件207AfterShowBill 事件208AfterConfirm 事件208AfterF7Select 事件208xiChange 事件209BeforeSave 事件209AfterSave 事件209AddBarItem函數(shù)210AddBarItemLink函數(shù)211GetBarItemProperty函數(shù)211SetBarItem

26、Property函數(shù)212AddBarItemLink函數(shù)212RemoveBarItem函數(shù)213RemoveBarItemLink函數(shù)213Alter函數(shù)214Confirm函數(shù)214GetFieldValue函數(shù)215GetRequest函數(shù)216LockBillEntry函數(shù)216PUBLIC FUNCTION LOCKBILLENTRY(BYVAL LPAGE AS LONG, _216LockCell函數(shù)217LockWebTabItem函數(shù)218SaveBill函數(shù)218SetFieldValue函數(shù)219ShowBill函數(shù)220ShowF7Select函數(shù)221BillNam

27、e 屬性221ClassType 屬性222ClassTypeEntry 屬性222ClassTypeKey 屬性223PrimaryKey 屬性223EntryPrimaryKey 屬性223TableInfo 屬性224TableName 屬性224CurBillID 屬性224BillHeads對(duì)象參考226Count 屬性226Item 屬性226BillHead對(duì)象參考227Fields 屬性227BillEntrys對(duì)象參考228Count 屬性228Item 屬性228BillEntry對(duì)象參考229Fields 屬性229EntryHeight 屬性229EntryIndex

28、屬性229EntryLeft 屬性229xiiEntryTop 屬性229EntryType 屬性230EntryWidth 屬性230KeyField 屬性230Layer 屬性230TableName 屬性231Visible 屬性231Fields對(duì)象參考232Count 屬性232Item 屬性232Field對(duì)象參考233Caption 屬性233FieldHeight 屬性233FieldLeft 屬性233FieldLock 屬性233FieldName 屬性234FieldTop 屬性234FieldWidth 屬性234Filter 屬性234FKey 屬性234FontBo

29、ld 屬性235FontItalic 屬性235FontName 屬性235FontSize 屬性235FrameBorder 屬性236FrameBorderColor 屬性236LabelColor 屬性236LabelWidth 屬性236Layer 屬性236MustInput 屬性237NeedSave 屬性237Note 屬性237Number 屬性237Page 屬性237Row 屬性238TableName 屬性238Text 屬性238TextColor 屬性238Value 屬性238Visible 屬性239用戶場(chǎng)景240需求240總體需求240需求分解241xiii詳細(xì)

30、需求242單據(jù)信息242單據(jù)流程244多級(jí)審核245憑證功能245設(shè)計(jì) 246單據(jù)數(shù)據(jù)結(jié)構(gòu)設(shè)計(jì)246單據(jù)頭246單據(jù)體248字段的過濾條件251IDE中設(shè)置過濾條件251通過SQL更新字段的過濾條件253Action設(shè)置254自動(dòng)生成Action.254手動(dòng)添加Action.257單據(jù)流程259【銷售訂單】下推生成【產(chǎn)品入庫(kù)通知單】259練下263多級(jí)審核265多級(jí)審核設(shè)置265憑證功能266設(shè)置憑證數(shù)據(jù)來源266操作管理267插件開發(fā)270部署271發(fā)布到主控臺(tái)271制作部署文件273xiv概述為了實(shí)現(xiàn)客戶個(gè)性化的需求和保持 K/3架構(gòu)的開放性，K/3提供了插件編程，有效的擴(kuò)展了K/3，K/

31、3插件編程是通過K3ClassEvents 對(duì)象實(shí)現(xiàn)的。K/3提供了基于 COM 和.Net 兩套插件模型。COMK/3對(duì)象。提供 ListEvents、BaseClassEvent、BillEvent 三個(gè)重要的客戶端接口對(duì)象及其他的輔助K3ClassEvents 的對(duì)象模型關(guān)于 Kingdee Foundation Objects 1.0 對(duì)象本文中所有涉及到的 KFO 對(duì)象，如 KFO.Dictionary 、KFO.Vector ，他們的結(jié)構(gòu)、使用方法、描述等詳細(xì)內(nèi)容，請(qǐng)參考KFO 組件使用參考。ActiveX Data Objects Library 對(duì)象關(guān)于本文中所有涉及到的 AD

32、ODB 對(duì)象，如 ADODB.Recordset ，版本必需不低于 2.6；他們的結(jié)構(gòu)、使用方法、描述等詳細(xì)內(nèi)容，請(qǐng)參考 HYPERLINK http:/m/ http:/m/ 相關(guān)內(nèi)容。第 1 頁(yè)使用說明上面的對(duì)象結(jié)構(gòu)圖囊括了K3ClassEvents 組件中所使用到的所有對(duì)象。需要注意的是：以下對(duì)象：K3Lib （Net、User、Account）BarBand（以及它的集合對(duì)象Bands）Tool（以及它的集合對(duì)象Tools）BillHead（以及它的集合對(duì)象 BillHeads）BillEntry（以及它的集合對(duì)象 BillEntrys）Field（以及它的集合對(duì)象Fields）屬于輔

33、助對(duì)象，不能使用 New 關(guān)鍵字創(chuàng)建。以下對(duì)象：ListEventsBaseClassEventBillEvent屬于金蝶 K/3的客戶端接口對(duì)象。主要使用這 3 個(gè)對(duì)象完成插件的開發(fā)。第 2 頁(yè)K3ClassEvents 的對(duì)象ListEvents 對(duì)象參考ListEvents 對(duì)象屬于金蝶 K/3象的屬性、方法和事件。的客戶端接口對(duì)象，用來獲得金蝶 K/3的客戶端的序時(shí)簿對(duì)ListEvents 對(duì)象共包含 11 個(gè)屬性、8 個(gè)函數(shù)和 23 個(gè)事件。序時(shí)簿客戶端的數(shù)據(jù)服務(wù)對(duì)象語(yǔ)法Object.DataSrv返回值類型Object注釋返回序時(shí)簿客戶端數(shù)據(jù)服務(wù)對(duì)象，包括了單據(jù)的模板信息 Clas

34、sType、ClassTypeEntry、TableInfo、Filter 等KFO.Dictionary 對(duì)象和 ClassTypeID、SQLSelect、SQLFrom、SQLSelectDetail 等值。示例一獲取當(dāng)前單據(jù)的 ID：獲取當(dāng)前單據(jù)的Caption：示例二獲取序時(shí)簿的SQL 語(yǔ)句：示例三獲取字段（Key 通過參數(shù) sField 指定）的模板的數(shù)據(jù)：第 3 頁(yè)P(yáng)rivate Function GetFieldInfo(ByVal sField As String) As KFO.DictionaryDim dctTableInfo As KFO.Dictionary Dim

35、 sKey As StringDataSrv.SQLSelectDetail & Where & DataSrv.Filter(FilterString)DataSrv.ClassType(FName)DataSrv.ClassTypeID部分描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。DataSrv 屬性是允許否觸發(fā)插件的序時(shí)簿FillRow 事件。語(yǔ)法Object. EnableListFillRowEvents返回值類型注釋是允許否觸發(fā)插件的序時(shí)簿 FillRow 事件。默認(rèn)為 False，即不觸發(fā)。只有當(dāng)此值為 True 且發(fā)生序時(shí)簿行填充時(shí)，才會(huì)觸發(fā)插件的序時(shí)簿 FillR

36、ow 事件。示例根據(jù)填充的字段的值，實(shí)現(xiàn)：a、將 1、2、3對(duì)應(yīng)成行背景設(shè)為綠色，其余為白色：一、二、三；b、將 6、7 對(duì)應(yīng)的第 4 頁(yè)P(yáng)ublic Sub Show(ByVal oListerface As Object)ListEvents 接口實(shí)現(xiàn)注意: 此方法必須存在,修改Set m_Listerface = oListerface設(shè)置 EnableListFillRowEvents 屬性，允許激發(fā) ListFillRow 事件m_Listerface.EnableListFillRowEvents = True End SubPrivate Sub m_Listerface_Lis

37、tFillRow(ByVal lRow As Long, ByVal RowData As Object, ByVal HeadDiKFO.IDictionary, CellData As String, BackColor As Long, ContinueRaise As)部分描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。EnableListFillRowEvents 屬性Set dctTableInfo = m_Listerface.DataSrv.TableInfo If dctTableInfo(Map).Lookup(sField) ThensKey = dctTableI

38、nfo(Map)( sField) Set GetFieldInfo = dctTableInfo(sKey)ElseSet GetFieldInfo = Nothing End IfEnd FunctionK3Lib 對(duì)象語(yǔ)法Object.K3Lib返回值類型K3ClassEvents.K3Lib第 5 頁(yè)部分描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。K3Lib 屬性If HeadDict(FKey) = FText Then Select Case CellDataCase “1”:CellData = 一 BackColor = vbWhiteCase “2”:CellDat

39、a = 二 BackColor = vbWhiteCase “3”:CellData = 三 BackColor = vbWhiteCase “4”:CellData = 四 BackColor = vbWhiteCase “5”:CellData = 五 BackColor = vbWhiteCase “6”:CellData = 六 BackColor = vbGreenCase “7”:CellData = 日 BackColor = vbGreenCase ElseBackColor = vbWhite End SelectEnd IfContinueRaise = TrueEnd S

40、ub注釋只讀屬性。返回 K3Lib 對(duì)象，主要用來詳細(xì)請(qǐng)參考“K3Lib 對(duì)象參考”。金蝶 K/3 的一些屬性，及執(zhí)行金蝶 K/3 的一些標(biāo)準(zhǔn)操作。序時(shí)簿對(duì)象語(yǔ)法Object.List返回值類型Object注釋返回序時(shí)簿對(duì)象，包括 DataSrv、Parent、rsID 等對(duì)象,以及一些隱含的方法和函數(shù)，如刷新序時(shí)簿。示例在插件中刷新序時(shí)簿：返回或設(shè)置序時(shí)簿單據(jù)體字段排序。語(yǔ)法Object.ListEntrySort返回值類型String注釋可以通過該屬性返回當(dāng)前序時(shí)簿顯示前過濾界面中設(shè)置的單據(jù)體字段排序，或者設(shè)置當(dāng)前單據(jù)體字段的排序（設(shè)置后需要調(diào)用序時(shí)簿刷新方法才可以看到設(shè)置結(jié)果）。第 6

41、頁(yè)部分描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。ListEntrySort 屬性Call m_Listerface.List.RefreshList(False)部分描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。List 屬性返回或設(shè)置序時(shí)簿的過濾條件。語(yǔ)法Object. ListFilterString返回值類型String注釋可以通過該屬性返回當(dāng)前序時(shí)簿顯示前過濾界面中設(shè)置的過濾條件，或者設(shè)置當(dāng)前單據(jù)的過濾條件（設(shè)置后需要調(diào)用序時(shí)簿刷新方法才可以看到設(shè)置結(jié)果）。返回或設(shè)置序時(shí)簿單據(jù)頭字段排序。語(yǔ)法Object.ListHeadSort返回值類型String注釋可以通過該

42、屬性返回當(dāng)前序時(shí)簿顯示前過濾界面中設(shè)置的單據(jù)頭字段排序，或者設(shè)置當(dāng)前單據(jù)頭字段的排序（設(shè)置后需要調(diào)用序時(shí)簿刷新方法才可以看到設(shè)置結(jié)果）。菜單及對(duì)象語(yǔ)法Object.Bar返回值類型第 7 頁(yè)部分描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。Bar 屬性部分描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。ListHeadSort 屬性部分描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。ListFilterString 屬性K3ClassEvents.Bar注釋Bar 對(duì)只讀屬性。返回菜單及象參考”。對(duì)象，主要用來新增、修改菜單和。詳細(xì)請(qǐng)參考“多級(jí)審核控制對(duì)象語(yǔ)法Object.

43、 MultiCheckMgr返回值類型Object注釋返回多級(jí)審核控制對(duì)象，多級(jí)審核的設(shè)置信息、當(dāng)前審核情況、審核等都能從此組件中到。序時(shí)簿關(guān)鍵字段數(shù)據(jù)集合語(yǔ)法Object.RsID返回值類型ADODB.Recordset注釋只讀屬性，返回序時(shí)簿關(guān)鍵字段數(shù)據(jù)集合。有三個(gè)重要的字段：FID、FClassTypeID、FEntryID，這三個(gè)字段能把選中的行的其他值取出來。FID 表示序時(shí)簿當(dāng)前行的所屬單據(jù)的內(nèi)碼,取值語(yǔ)法是：rsID(FID);FClassTypeID 表示序時(shí)簿當(dāng)前行的所屬單據(jù)類型：rsID(FClassTypeID);FEntryID 表示序時(shí)簿當(dāng)前行的分錄 ID：rsID(

44、FEntryID);ActiveX Data Objects Library。注意：如果要使用這個(gè)屬性，插件工程還必須第 8 頁(yè)部分描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。RsId 屬性部分描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。MultiCheckMgr 屬性返回序時(shí)簿當(dāng)前調(diào)用模式。此屬性只讀。語(yǔ)法Object. ListFilterString返回值類型Enu_ListShowMode 類型Enu_ListShowMode_View= 0 : 一般查詢 MDI 窗口Enu_ListShowMode_ViewM= 1 : 一般查詢模態(tài)窗口Enu_ListShowM

45、ode_LookUp= 2 : 選單Enu_ListShowMode_ConnectView= 3 : 聯(lián)查Enu_ListShowMode_ConnectViewExt = 4 : 自定義聯(lián)查注釋當(dāng)多級(jí)審核流程出現(xiàn)錯(cuò)誤時(shí)是否允許顯示錯(cuò)誤提示。語(yǔ)法Object. ShowMsg返回值類型注釋默認(rèn)為 Ture，即當(dāng)多級(jí)審核流程出現(xiàn)錯(cuò)誤時(shí)顯示錯(cuò)誤信息。如果設(shè)置為 False，則只觸發(fā)插件錯(cuò)誤處理事件，并不顯示錯(cuò)誤提示。刪除一張單據(jù)。語(yǔ)法Object. DeleteBill(ByVal lClassTypeID As Long, ByVal nerID As Long, Optional ByRef

46、第 9 頁(yè)DeleteBill 函數(shù)部分描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。ShowMsg 屬性部分描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。ShowMode 屬性bSucs As= True) As String返回值類型String 對(duì)操作結(jié)果的描述：刪除操作成功或失敗注釋用戶定義單據(jù)并保存后，會(huì)在數(shù)據(jù)庫(kù)中創(chuàng)建對(duì)應(yīng)的表。如單據(jù)為 t_t_200000001Entry2 表。本函數(shù)刪除這些表中指定的行。200000001 表，單據(jù)體為函數(shù)參數(shù)中的 lClassTypeID 對(duì)應(yīng)的字段為表中的 FClassTypeId 列；nerID 對(duì)應(yīng)的字段為：用戶在定義單據(jù)

47、時(shí)所指定的“主鍵字段”（默認(rèn)為“ FID ”）。當(dāng)前序時(shí)簿的單據(jù)類型 ID 與內(nèi)碼可以通過m_Listerface.RsId(FClassTypeID), m_Listerface.RsId(FID)取得。示例刪除一張單據(jù)，其類型ID 是 200000001，內(nèi)碼是 0018：通過字段關(guān)鍵字獲取字段對(duì)象。語(yǔ)法Object.GetDataFldByKey (sFKey As String, Row As Long)第 10 頁(yè)參數(shù)描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。sFKeyString 類型。字段模板的關(guān)鍵字（FKey）。RowLong 類型。可選參數(shù)。GetDataFldB

48、yKey 函數(shù)Dim bSucs AsDim sResult As StringsResult = m_Listerface.DeleteBill (200000001, 0018, bSucs) If bSucs ThenDebug.Pr“刪除成功” ElseDebug.Pr“刪除失敗” End IfDebug.PrsResult參數(shù)描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。lClassTypeID要?jiǎng)h除單據(jù)的類型IDnerID要?jiǎng)h除的單據(jù)的內(nèi)碼bSucs用于返回，指示操作是否成功返回值類型KFO.Dictionary注釋返回字對(duì)象，在字對(duì)象中再取出相應(yīng)的值。示例獲取序時(shí)簿中選中

49、行對(duì)應(yīng)得單據(jù)上的“單據(jù)(FBillNo)”字段的字段對(duì)象：通過指定字段的模板獲取字段對(duì)象。語(yǔ)法Object.GetDataFld (dDictionary, Row As Long)第 11 頁(yè)部分描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。DctKFO.Dictionary 對(duì)象。指定字段的模版的對(duì)象。RowLong 類型?？蛇x參數(shù)。當(dāng)字段位于多分錄上時(shí)，通過此參數(shù)指定需要獲得的字段的值所在的行號(hào)。不指定此參數(shù)時(shí)得到當(dāng)前激活行的值。GetDataFld 函數(shù)Dim dctField As KFO.Dictionary Dim dctData As KFO.Dictionary Di

50、m dctBillID As KFO.DictionarySet dctBillID = m_Listerface.List.GetSelectedBillIDSet dctData = m_Listerface.DataSrv.LoadBill(dctBillID.Name(1) Set m_Listerface.Data = dctDataSet dctField = m_Listerface.GetDataFldbyKey(FBillNo)If Not dctField Is Nothing ThenDebug.Pr單據(jù): & dctField(FFLD) End IfSet dctFi

51、eld = Nothing Set dctData = Nothing Set dctBillID = Nothing當(dāng)字段位于多分錄上時(shí)，通過此參數(shù)指定需要獲得的字段的值所在的行號(hào)。不指定此參數(shù)時(shí)得到當(dāng)前激活行的值。當(dāng)字段位于其他類型分錄，或位于單據(jù)頭時(shí)，此參數(shù)被忽略。返回值類型KFO.Dictionary注釋返回字對(duì)象。示例獲得序時(shí)簿當(dāng)前選定行的關(guān)鍵數(shù)據(jù)。語(yǔ)法Object.GetCurrentSelRowInfo ()返回值類型第 12 頁(yè)部分描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。GetCurrentSelRowInfo 函數(shù)獲取序時(shí)簿中選中行對(duì)應(yīng)得單據(jù)上的“單據(jù) (FBi

52、llNo)”字段的字段對(duì)象： Dim dct As KFO.DictionaryDim dctData As KFO.Dictionary Dim dctBillID As KFO.Dictionary Dim dctDataInfo As KFO.DictionarySet dctBillID = m_Listerface.List.GetSelectedBillIDSet dctData = m_Listerface.DataSrv.LoadBill(dctBillID.Name(1)Set m_Listerface.Data = dctData GetFieldInfo()函數(shù)的實(shí)現(xiàn)參見

53、ListEvents.DataSrv 屬性的示例Set dctDataInfo = GetFieldInfo(FBillNo)Set dct = m_Listerface.GetDataFld(dctDataInfo) If Not dct Is Nothing ThenDebug.Pr單據(jù): & dct(FFLD) End IfSet dct = NothingSet dctData = Nothing Set dctBillID = NothingSet dctDataInfo = Nothing當(dāng)字段位于其他類型分錄，或位于單據(jù)頭時(shí)，此參數(shù)被忽略。KFO.Dictionary注釋此函數(shù)返

54、回的數(shù)據(jù)含 FClassTypeID,FID,FEntryID。FClassTypeID 表示單據(jù)類型；FID 表示當(dāng)前行所屬單據(jù)的內(nèi)碼；FEntryID 表示單據(jù)分錄 ID。如果當(dāng)前選定了多行，只返回選定行中第一行的單據(jù)數(shù)據(jù)。示例獲取序時(shí)簿上當(dāng)前選中的行對(duì)應(yīng)的單據(jù)的內(nèi)碼：獲取選中行（可以多選）的關(guān)鍵數(shù)據(jù)。語(yǔ)法Object.GetSelectedBillInfo ()返回值類型KFO.Vector注釋此函數(shù)返回一個(gè) KFO.Vector 數(shù)據(jù)包， Vector的 Size和選中的行數(shù)一致。每行包含一個(gè)KFO.Dictionary 數(shù)據(jù)包，此數(shù)據(jù)含 FClassTypeID,FID,FEntry

55、ID。FClassTypeID 表示單據(jù)類型；FID 表示當(dāng)前行所屬單據(jù)的內(nèi)碼；FEntryID 表示單據(jù)分錄 ID。示例獲取序時(shí)簿當(dāng)前選中的多個(gè)行中的第一行對(duì)應(yīng)的單據(jù)的分錄ID：第 13 頁(yè)Dim i As LongDim vctRows As KFO.VectorDim dctRow As KFO.DictionarySet vctRows = m_Listerface.GetSelectedBillInfo If Not vctRows Is Nothing ThenFor i = 1 To vctRows.Size Set dctRow = vctRows(i)部分描述ObjectLi

56、stEvents 對(duì)象的一個(gè)實(shí)例。GetSelectedBillInfo 函數(shù)Dim dctSelectedRow As KFO.DictionarySet dctSelectedRow = m_Listerface.GetCurrentSelRowInfo Debug.Pr單據(jù)內(nèi)碼: & dctSelectedRow(FID), _單據(jù)類型: & dctSelectedRow(FClassTypeID), _ 單據(jù)分錄ID: & dctSelectedRow(FEntryID)Set dctSelectedRow = Nothing加載當(dāng)前選擇的單據(jù)，并按照指定的狀態(tài)顯示。語(yǔ)法Object.

57、LoadSelectedBill (BillSus As Enu BillSusExt)Enu_BillSusExt 常數(shù)返回值類型。注釋加載成功并顯示單據(jù)返回 True；否則返回 False。示例以“修改狀態(tài)”顯示序時(shí)簿當(dāng)前選中的行對(duì)應(yīng)的單據(jù)：刷新序時(shí)簿語(yǔ)法Object. RefreshList(Optional ByVal bRefreshToolBar As= True, Optional ByVal第 14 頁(yè)RefreshList 函數(shù)m_Listerface.LoadSelectedBill Enu_BillSusExt_Modify常數(shù)值描述Enu_BillSusExt_View

58、0查看狀態(tài)。Enu_BillSusExt_New1新增狀態(tài)。Enu_BillSusExt_Modify2修改狀態(tài)。部分描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。BillSusEnu_BillSusExt 類型。顯示單據(jù)時(shí)單據(jù)的狀態(tài)。LoadSelectedBill 函數(shù)Debug.Pr單據(jù)內(nèi)碼: & dctRow(FID); _ 單據(jù)類型: & dctRow(FClassTypeID); _ 單據(jù)分錄ID: & dctRow(FEntryID)Next End IfSet dctRow = Nothing Set vctRows = NothingbMarkSelRow As= T

59、rue)返回值無示例刷新序時(shí)簿，刷新，刷新后用戶選定的行不變：發(fā)送消息。語(yǔ)法ObjecLong)derMessage (sTitle As String, sMessage As String, arrUsers, lSenderType As返回值。注釋發(fā)送成功返回 True；否則返回 False。示例發(fā)送K/3 主控臺(tái)消息給系統(tǒng)管理員：第 15 頁(yè)部分描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。sTitleString 類型，消息的標(biāo)題。sMessageString 類型，消息的內(nèi)容。arrUsersVariant 類型，消息接收用戶的代碼?？梢詾镾tring、Long、 ege

60、r、Single、Double 類型，或這些類型的數(shù)組（下標(biāo)必須從 0 開始）。lSenderTypeLong 類型，可選參數(shù)，消息發(fā)送的方式，目前保留。SenderMessage 函數(shù)m_Listerface.RefreshList True, True部分描述ObjectListEvents 對(duì)象的一個(gè)實(shí)例。bRefreshToolBar指示是否刷新。如為 True，則刷新；為 False，則不刷新bMarkSelRow指示在刷新后是否選定用戶在刷新前選定的行。如為 False，則刷新后選定的是第一行；如為 True，則用戶選定的行在刷新后仍然選定，但如果在刷新前，用戶選擇了多行，那么刷新