手册简体k3插件开发

K/3BOS插件开发手册K/3BOS插件开发手册K/3BOS插件开发手册K/3BOS插件开发手册（版本：V12.3）金蝶软件（中国）K/3部K/3BOS开发部目录概述 1COM 1K3ClassEvents的对象模型 1使用说明 1K3ClassEvents的对象 2ListEvents对象参考 3DataSrv属性 3EnableListFillRowEvents属性 4K3Lib属性 5目录概述 1COM 1K3ClassEvents的对象模型 1使用说明 1K3ClassEvents的对象 2ListEvents对象参考 3DataSrv属性 3EnableListFillRowEvents属性 4K3Lib属性 5List属性 6ListEntrySort属性 6ListFilterString属性 7ListHeadSort属性 7Bar属性 7MultiCheckMgr属性 8RsId属性 8ShowMode属性 9ShowMsg属性 9DeleteBill函数 9GetDataFldByKey函数 10GetDataFld函数 11GetCurrentSelRowInfo函数 12GetSelectedBillInfo函数 13LoadSelectedBill函数 14RefreshList函数 14SenderMessage函数 15UpdateNormalFld函数 16UpdateNormalFldByKey函数 16Refresh函数 17AfterBatchMultiCheckAfterBusinessCheckAfterBusinessCheckExAfterCopyBillCreateData17181819AfterDeleteBillAfterMergeCopyBillAfterMultiCheckAfterMultiCheckEx19202020AfterSelList21AfterUnBusinessCheckAfterUnBusinessCheckEx2122AfterUnMultiCheck22K/3BOS插件开发手册AfterUnMultiCheckExBeforeMultiCheck232324BeforePrintBill24BeforeSenderMessageBeforRefreshToolBar2525BusinessCheckBusinessCheckExFinishMultiCheckFinishMultiCheckEx262626K/3BOS插件开发手册AfterUnMultiCheckExBeforeMultiCheck232324BeforePrintBill24BeforeSenderMessageBeforRefreshToolBar2525BusinessCheckBusinessCheckExFinishMultiCheckFinishMultiCheckEx26262627ListFillRowBarClickBarInitialize27293030MultiCheckMultiCheckExPrintSuccessfulStartMultiCheckStartMultiCheckExUnBusinessCheck30313232333333UnBusinessCheckExUnMultiCheckUnMultiCheckExReMultiCheckReMultiCheckExReUnMultiCheckEx343535353636BaseClassEvent对象参考 38BrowseCtl属性 38DataSrv属性 38EnableListFillRowEvents属性 38InsertNewRowAndFillOption属性 40K3Lib属性 40ListActiveBar属性 41ListEntrySort属性 41ListFilterString属性 41ListHeadSort属性 42Bar属性 42RsClassGroup属性 43RsId属性 43GetActiveCtl函数 43GetSelectedClassID函数 44GetSelectedClassType函数 45GetSelectedItemID函数 45iiiK/3BOS插件开发手册GetSelectedItems函数 46IsSearchState函数 47PitchItemByID函数 47SelectClassGroupByID函数 48SenderMessage函数 49SetStatus函数 50RefreshClassGroupsK/3BOS插件开发手册GetSelectedItems函数 46IsSearchState函数 47PitchItemByID函数 47SelectClassGroupByID函数 48SenderMessage函数 49SetStatus函数 50RefreshClassGroups方法 50RefreshListByClassGroupID方法 51RefreshSelectedClassGroup方法 51RefreshSelectedClassGroupList方法 52AfterGetDataBeforePrintBill5253BeforeSenderMessageDeleteBillSucessful535454ListFillRowBarClickBarInitialize55575757RefreshList58BillEvent对象参考 59AccessoryTypeID属性 59BillCtl属性 59BillEntrys属性 59BillHeads属性 60BillHeight属性 60BillName属性 60BillStatus属性 61BillWidth属性 61CancelPrintControl属性 62ClassType属性 62ClassTypeEntry属性 62ClassTypeKey属性 63Data属性 63DataSrv属性 63EntryPrimaryKey属性 64FID属性 64InsertNewRowAndFillOption属性 65IsDoAction属性 65IsDoActionData属性 65K3Lib属性 66LayerCount属性 66LayerNames属性 66Bar属性 67ivK/3BOS插件开发手册MultiCheckMgrK/3BOS插件开发手册MultiCheckMgr属性 67ObjectID属性 68ObjectType属性 68OriginalFieldValue属性 68PrimaryKey属性 69ReSaveSuccess属性 69rsBillID属性 69ShowType属性 70TableInfo属性 70TableName属性 70TaskID属性 71ShowMsg属性 71BatchToDoActions函数 71DeleteEntryData函数 72GetActiveCtl函数 73GetActiveField函数 74GetCommonControl函数 74GetDataFld函数 75GetDataFldbyKey函数 76GetFieldInfoByKey函数 77GetDynamicCtlByKey函数 78GetFieldValue函数 78GetToolIndex函数 79GetVariable函数 80InsertNewRowAndFill函数 81IsChange函数 81IsFileNeedFilter函数 82LockBill函数 83RefreshBill函数 83SenderMessage函数 83SetDecimal函数 84SetFieldSumValue函数 85SetFieldValue函数 85SetSumDecimal函数 86SetText函数 87SetTypeFloatMax函数 88SetTypeFloatMin函数 88ShowHideField函数 89ShowHideGrid函数 89Sum函数 90UpdateLookFld函数 90UpdateNormalFld函数 91DoAction方法 91IsDoActionByKey方法 92vK/3BOS插件开发手册LockCell方法 92RemoveRow方法 93SaveBill方法 93SetActiveTab方法 94SetBillFormCaption方法 94SetCaption方法 95SetGridMaxRows方法 95SetStatus方法 96SetActiveCell方法 96SetBillWindowState方法 97SetRowsPerRequest方法 97SetStateStampPicture方法 98SetStatusBarInfo方法 98SetVariable函数 99SizeBillControl方法 100AddNewRow100AfterBusinessCheckAfterBusinessCheckExK/3BOS插件开发手册LockCell方法 92RemoveRow方法 93SaveBill方法 93SetActiveTab方法 94SetBillFormCaption方法 94SetCaption方法 95SetGridMaxRows方法 95SetStatus方法 96SetActiveCell方法 96SetBillWindowState方法 97SetRowsPerRequest方法 97SetStateStampPicture方法 98SetStatusBarInfo方法 98SetVariable函数 99SizeBillControl方法 100AddNewRow100AfterBusinessCheckAfterBusinessCheckEx100101AfterCopyBillAfterDoActionAfterFillRowAfterFirstNewBill101101102103103AfterInputBillSetSumData103AfterLoadBill104AfterLoadBillSetSumDataAfterMergeCopyBill104104105AfterMultiCheckAfterMultiCheckExAfterNewBill105106106AfterNewEmptyData106AfterSaveAfterSelBill107107AfterSelBillBeforeFillData107AfterStockQuery107AfterUnBusinessCheckAfterUnBusinessCheckEx108108AfterUnMultiCheckAfterUnMultiCheckExBeforeDeleteRowBeforeDoAction108109109110BeforeLoadBillBeforeMultiCheck111111viK/3BOS插件开发手册BeforeMultiCheckExBeforePrintBill112112BeforeSaveBeforeSelBills113113BeforeSenderMessageBeforeSetMutilSelDataBeforeSetMutilSelData2114115115116116BeforeWindowExit 116BeforLoadBillFillData117BeginEditBusinessCheckBusinessCheckEx117117118Change118CommandClickFinishMultiCheckFinishMultiCheckEx119119119K/3BOS插件开发手册BeforeMultiCheckExBeforePrintBill112112BeforeSaveBeforeSelBills113113BeforeSenderMessageBeforeSetMutilSelDataBeforeSetMutilSelData2114115115116116BeforeWindowExit 116BeforLoadBillFillData117BeginEditBusinessCheckBusinessCheckEx117117118Change118CommandClickFinishMultiCheckFinishMultiCheckEx119119119120GetFocusLostFocusBarClick120121121122BarInitialize122MultiCheckMultiCheckExReMultiCheckReMultiCheckExReUnMultiCheckSaveBillFailedSaveBillSuccess122123124124125125125126126StartMultiCheckStartMultiCheckExUnBusinessCheckUnBusinessCheckEx126127128128UnMultiCheckUnMultiCheckEx128129Verify130K3Lib对象参考 131Account属性 131Net属性 132User属性 132viiK/3BOS插件开发手册BatchPushOldBills函数K/3BOS插件开发手册BatchPushOldBills函数 132CreateK3Object函数 136GetData函数 137GetK3Language函数 138LoadKDString函数 139UpdateData方法 141GetStockQty函数 141LookUpClass函数 142LoadBill方法 144LoadList方法 144LoadOldList方法 145Account对象参考 147AccountID属性 147AccountName属性 147SetupType属性 147Net对象参考 149BeginMutex函数 149CommitMutex函数 149QueryFunc函数 150QuerySubSys函数 150User对象参考 151UserID属性 151UserName属性 151Bar对象参考 152Bar对象结构图 152ActiveBand属性 153BOSBands属性 153BOSTools属性 154Refresh方法 154BOSBands对象参考 155Count属性 155Item属性 155Add函数 155Remove方法 156RemoveAll方法 156BOSBand对象参考 157BandName属性 157BandType属性 157BOSTools属性 157Caption属性 157CurrentTool属性 158DockingArea属性 158DockingOffset属性 158DockLine属性 159viiiK/3BOS插件开发手册FlagsK/3BOS插件开发手册Flags属性 159Visible属性 159Wrappable属性 160Refresh方法 160BOSTools对象参考 161Count属性 161Item属性 161Add函数 161GetFreeToolID函数 162InsertAfter方法 162InsertBefore方法 163Remove方法 163RemoveAll方法 164BOSTool对象参考 165Alignment属性 165BeginGroup属性 165Caption属性 165CaptionPosition属性 166Checked属性 166Default属性 166Description属性 167Enabled属性 167ShortcutKey属性 167Style属性 170SubBand属性 170Tag属性 170ToolID属性 170ToolName属性 171ToolPicture属性 171TooltipText属性 171Visible属性 171PasteToolFace方法 171SetPicture方法 172BillHeads\BillHead\BillEntrys\BillEntry\BOSFields\BOSField对象参考 174Bar对象结构图 174BillHeads对象参考 175Count属性 175Item属性 176BillHead对象参考 177BOSFields属性 177BillEntrys对象参考 178Count属性 178Item属性 179BillEntry对象参考 180ixK/3BOS插件开发手册BOSFieldsK/3BOS插件开发手册BOSFields属性 180EntryHeight属性 180EntryIndex属性 180EntryLeft属性 180EntryTop属性 180EntryType属性 181EntryWidth属性 181KeyField属性 181Layer属性 181MaxRows属性 182TableName属性 182Visible属性 182AddRow方法 182RemoveRow方法 183BOSFields对象参考 184Count属性 184Item属性 184BOSField对象参考 185Caption属性 185FieldHeight属性 185FieldLeft属性 185FieldLock属性 185FieldName属性 186FieldTop属性 186FieldWidth属性 186Filter属性 186FKey属性 186FontBold属性 187FontItalic属性 187FontName属性 187FontSize属性 187FrameBorder属性 188FrameBorderColor属性 188LabelColor属性 188LabelWidth属性 188Layer属性 188MustInput属性 189NeedSave属性 189Note属性 189Number属性 189Page属性 189Row属性 190TableName属性 190Text属性 190xK/3BOS插件开发手册TextColor属性 190Value属性 190Visible属性 191SetFieldSumValue方法 191.Net 192基础配置 192开发环境 192使用说明 192192插件跟踪K/3BOS插件开发手册TextColor属性 190Value属性 190Visible属性 191SetFieldSumValue方法 191.Net 192基础配置 192开发环境 192使用说明 192192插件跟踪 192K3ClassEvents的对象模型 193K3ClassEvents的对象 193ListEvents对象参考 194194AfterCopyBillCreateData195OnBarInitializeAfterShowBillOnBarItemClick195195196ShowBill函数 196AspxGetSelectList函数 197AddBarItem函数 197AddBarItemLink函数 198SetBarItemProperty函数 199AddBarItemLink函数 199RemoveBarItem函数 200RemoveBarItemLink函数 200BillName属性 201ClassType属性 201ClassTypeEntry属性 201ClassTypeKey属性 202PrimaryKey属性 202EntryPrimaryKey属性 203TableInfo属性 203TableName属性 203BillEvent对象参考 205205OnBarInitializeOnBarItemClickAfterNewBill206207207BeforLoadBillFillData 207AfterLoadBillAfterShowBillAfterConfirmAfterF7Select207208208208xiK/3BOS插件开发手册ChangeAfterSave209K/3BOS插件开发手册ChangeAfterSave209209209AddBarItem函数 210AddBarItemLink函数 211GetBarItemProperty函数 211SetBarItemProperty函数 212AddBarItemLink函数 212RemoveBarItem函数 213RemoveBarItemLink函数 213Alter函数 214Confirm函数 214GetFieldValue函数 215GetRequest函数 216LockBillEntry函数 216LockCell函数 217LockWebTabItem函数 218SaveBill函数 218SetFieldValue函数 219ShowBill函数 220ShowF7Select函数 221BillName属性 221ClassType属性 222ClassTypeEntry属性 222ClassTypeKey属性 223PrimaryKey属性 223EntryPrimaryKey属性 223TableInfo属性 224TableName属性 224CurBillID属性 224BillHeads对象参考 226Count属性 226Item属性 226BillHead对象参考 227BOSFields属性 227BillEntrys对象参考 228Count属性 228Item属性 228BillEntry对象参考 229BOSFields属性 229EntryHeight属性 229EntryIndex属性 229EntryLeft属性 229xiiK/3BOS插件开发手册EntryTopK/3BOS插件开发手册EntryTop属性 229EntryType属性 230EntryWidth属性 230KeyField属性 230Layer属性 230TableName属性 231Visible属性 231BOSFields对象参考 232Count属性 232Item属性 232BOSField对象参考 233Caption属性 233FieldHeight属性 233FieldLeft属性 233FieldLock属性 233FieldName属性 234FieldTop属性 234FieldWidth属性 234Filter属性 234FKey属性 234FontBold属性 235FontItalic属性 235FontName属性 235FontSize属性 235FrameBorder属性 236FrameBorderColor属性 236LabelColor属性 236LabelWidth属性 236Layer属性 236MustInput属性 237NeedSave属性 237Note属性 237Number属性 237Page属性 237Row属性 238TableName属性 238Text属性 238TextColor属性 238Value属性 238Visible属性 239用户场景 240需求 240总体需求 240需求分解 241xiiiK/3BOS插件开发手册详细需求 242单据信息 242单据流程K/3BOS插件开发手册详细需求 242单据信息 242单据流程 244多级审核 245凭证功能 245设计和实现 246单据数据结构设计 246单据头 246单据体 248字段的过滤条件 251BOSIDE中设置过滤条件 251通过SQL更新字段的过滤条件 253Action设置 254自动生成Action. 254手动添加Action. 257单据流程 259【销售订单】下推生成【入库通知单】 259练习一下 263多级审核 265多级审核设置 265凭证功能 266设置凭证数据来源 266操作管理 267插件开发 270部署 271发布到主控台 271制作部署文件 273xivK/3BOS插件开发手册概述K/3BOS架构的开放性，K/3BOS提供了插件编程，有效的扩展了K/3BOS平台，K/3K/3BOS插件开发手册概述K/3BOS架构的开放性，K/3BOS提供了插件编程，有效的扩展了K/3BOS平台，K/3BOS插件编程是通过K3ClassEvents对象实现的。COM和.Net两套插件模型。COM对象。K3ClassEvents的对象模型KingdeeFoundationObjects1.0对象KFOKFO.Dictionary、KFO.Vector，他们的结构、使用方法、KFOMicrosoftActiveXDataObjectsLibrary对象使用方法、描述等详细内容，请参考相关内容。第1页使用说明K/3BOS插件开发手册上面的对象结构图囊括了K3ClassEvents组件中所使用到的所有对象。需要注意的是：以下对象：K3Lib（Net、User、Account）BarBOSBand（BOSBandsK/3BOS插件开发手册上面的对象结构图囊括了K3ClassEvents组件中所使用到的所有对象。需要注意的是：以下对象：K3Lib（Net、User、Account）BarBOSBand（BOSBands）BOSTools）BillHead（BillHeads）BillEntry（BillEntrys）BOSField（BOSFields）New关键字创建。以下对象：ListEventsBaseClassEventBillEventK/3BOS3个对象完成插件的开发。第2页K3ClassEvents的对象K/3BOS插件开发手册ListEvents对象参考ListEventsK/3BOSK/3BOS的客户端的序时簿对象的属性、方法和。ListEvents11个属性、823个。序时簿客户端的数据服务对象语法Object.DataSrv返回值类型Object注释K/3BOS插件开发手册ListEvents对象参考ListEventsK/3BOSK/3BOS的客户端的序时簿对象的属性、方法和。ListEvents11个属性、823个。序时簿客户端的数据服务对象语法Object.DataSrv返回值类型Object注释、等KFO.DictionaryClassTypeID、SQLSelect、SQLFrom、SQLSelectDetail等值。示例一ID：获取当前单据的Caption：示例二获取序时簿的SQL语句：示例三sField指定）的模板的数据：第3页PrivateFunctionGetFieldInfo(ByValsFieldAsString)AsKFO.DictionaryDimdctTableInfoAsKFO.DictionaryDimsKeyAsStringDataSrv.SQLSelectDetail&"Where"&DataSrv.Filter("FilterString")DataSrv.ClassType("FName")DataSrv.ClassTypeID部分描述Object对象的一个实例。DataSrv属性K/3BOS插件开发手册是 否触发插件的序时簿FillRow。语法Object.EnableListFillRowEvents返回值类型Boolean注释是 FillRowFillRow。示例根据填充的字段的值，实现：a、将1、2、3…对应成K/3BOS插件开发手册是 否触发插件的序时簿FillRow。语法Object.EnableListFillRowEvents返回值类型Boolean注释是 FillRowFillRow。示例根据填充的字段的值，实现：a、将1、2、3…对应成行背景设为绿色，其余为白色：一、二、6、7对应的第4页PublicSubShow(ByValoListInterfaceAsObject)'ListEvents接口实现'注意:此方法必须存在, 修改Setm_ListInterface=oListInterface'设置EnableListFillRowEvents属性， 激发ListFillRowm_ListInterface.EnableListFillRowEvents=TrueEndSublRowAsLong,ByValRowDataAsObject,ByValHeadDi KFO.IDictionary,CellDataAsString,BackColorAsLong,ContinueRaiseAsBoolean)部分描述Object对象的一个实例。EnableListFillRowEvents属性SetdctTableInfo=m_ListInterface.DataSrv.TableInfoIfdctTableInfo("Map").Lookup(sField)ThensKey=dctTableInfo("Map")(sField)SetGetFieldInfo=dctTableInfo(sKey)ElseSetGetFieldInfo=NothingEndIfEndFunctionK/3BOS插件开发手册K3Lib对象语法Object.K3Lib返回值类型K3ClassEvents.K3Lib第5页部分描述ObjectK/3BOS插件开发手册K3Lib对象语法Object.K3Lib返回值类型K3ClassEvents.K3Lib第5页部分描述Object对象的一个实例。K3Lib属性IfHeadDict("FKey")="FText"ThenSelectCaseCellDataCase“1”:CellData=" BackColorvbWhiteCase“2”:CellData=" BackColorvbWhiteCase“3”:CellData=" BackColorvbWhiteCase“4”:CellData=" BackColorvbWhiteCase“5”:CellData=" BackColorvbWhiteCase“6”:CellData=" BackColorvbGreenCase“7”:CellData=" BackColorvbGreenCaseElseBackColor=vbWhiteEndSelectEndIfContinueRaise=TrueEndSubK/3BOS插件开发手册注释详细请参考“K3Lib对象参考的一些标准操作。序时簿对象语法Object.List返回值类型Object注释示例在插件中刷新序时簿：返回或设置序时簿单据体字段排序。K/3BOS插件开发手册注释详细请参考“K3Lib对象参考的一些标准操作。序时簿对象语法Object.List返回值类型Object注释示例在插件中刷新序时簿：返回或设置序时簿单据体字段排序。语法Object.ListEntrySort返回值类型String注释可以通过该属性返回当前序时簿显示前过滤界面中设置的单据体字段排序，或者设置当前单据体字段的排序（设置后需要调用序时簿刷新方法才可以看到设置结果。第6页部分描述Object对象的一个实例。ListEntrySort属性Callm_ListInterface.List.RefreshList(False)部分描述Object对象的一个实例。List属性K/3BOS插件开发手册返回或设置序时簿的过滤条件。语法Object.ListFilterString返回值类型String注释（设置后需要调用序时簿刷新方法才可以看到设置结果。返回或设置序时簿单据头字段排序。语法Object.ListHeadSort返回值类型String注释可以通过该属性返回当前序时簿显示前过滤界面中设置的单据头字段排序，或者设置当前单据头字段的排序（设置后需要调用序时簿刷新方法才可以看到设置结果。菜单及工具栏对象语法Object.Bar返回值类型第7页部分描述Object对象的一个实例。Bar属性K/3BOS插件开发手册返回或设置序时簿的过滤条件。语法Object.ListFilterString返回值类型String注释（设置后需要调用序时簿刷新方法才可以看到设置结果。返回或设置序时簿单据头字段排序。语法Object.ListHeadSort返回值类型String注释可以通过该属性返回当前序时簿显示前过滤界面中设置的单据头字段排序，或者设置当前单据头字段的排序（设置后需要调用序时簿刷新方法才可以看到设置结果。菜单及工具栏对象语法Object.Bar返回值类型第7页部分描述Object对象的一个实例。Bar属性部分描述Object对象的一个实例。ListHeadSort属性部分描述Object对象的一个实例。ListFilterString属性K/3BOS插件开发手册K3ClassEvents.Bar注释Bar对象参考多级审核对象语法Object.MultiCheckMgr返回值类型Object注释返回多级审核对象，多级审核的设置信息、当前审核情况、审核等都能从此组件中到。序时簿关键字段数据集合语法Object.RsID返回值类型ADODB.Recordset注释只读属性，返回序时簿关键字段数据集合。有三个重要的字段：FID、FClassTypeID、FEntryID，这三个字段能把选中的行的其他值取出来。表示序时簿当前行的所属单据的内码,取值语法是：rsID("FID");ID：K/3BOS插件开发手册K3ClassEvents.Bar注释Bar对象参考多级审核对象语法Object.MultiCheckMgr返回值类型Object注释返回多级审核对象，多级审核的设置信息、当前审核情况、审核等都能从此组件中到。序时簿关键字段数据集合语法Object.RsID返回值类型ADODB.Recordset注释只读属性，返回序时簿关键字段数据集合。有三个重要的字段：FID、FClassTypeID、FEntryID，这三个字段能把选中的行的其他值取出来。表示序时簿当前行的所属单据的内码,取值语法是：rsID("FID");ID：rsID("FEntryID");注意：如果要使用这个属性，插件工程还必须 MicrosoftActiveXDataObjectsLibrary。第8页部分描述Object对象的一个实例。RsId属性部分描述Object对象的一个实例。MultiCheckMgr属性K/3BOS插件开发手册返回序时簿当前调用模式。此属性只读。语法Object.ListFilterString返回值类型Enu类型Enu_ListShowMode_View0:一般窗口Enu_ListShowMode_ViewM1:一般模态窗口Enu_ListShowMode_LookUp2:选单Enu_ListShowMode_ConnectView3:联查Enu_ListShowMode_ConnectViewExt4:自定义联查注释当多级审核流程出现错误时是否显示错误提示。语法Object.ShowMsg返回值类型Boolean注释K/3BOS插件开发手册返回序时簿当前调用模式。此属性只读。语法Object.ListFilterString返回值类型Enu类型Enu_ListShowMode_View0:一般窗口Enu_ListShowMode_ViewM1:一般模态窗口Enu_ListShowMode_LookUp2:选单Enu_ListShowMode_ConnectView3:联查Enu_ListShowMode_ConnectViewExt4:自定义联查注释当多级审核流程出现错误时是否显示错误提示。语法Object.ShowMsg返回值类型Boolean注释，并不显示错误提示。理删除一张单据。语法Object.DeleteBill(ByVallClassTypeIDAsLong,ByValnInterIDAsLong,OptionalByRef第9页DeleteBill函数部分描述Object对象的一个实例。ShowMsg属性部分描述Object对象的一个实例。ShowMode属性K/3BOS插件开发手册bSuccessAsBoolean=True)AsString返回值类型String对操作结果的描述：删除操作或失败注释用户定义单据并保存后，会在数据库中创建对应的表。如单据为t_BOS200000001表，单据体为t_BOS200000001Entry2表。本函数删除这些表中指定的行。列；nInterID对应的字段为：用户在定义单据时所指定的“主键字段”（K/3BOS插件开发手册bSuccessAsBoolean=True)AsString返回值类型String对操作结果的描述：删除操作或失败注释用户定义单据并保存后，会在数据库中创建对应的表。如单据为t_BOS200000001表，单据体为t_BOS200000001Entry2表。本函数删除这些表中指定的行。列；nInterID对应的字段为：用户在定义单据时所指定的“主键字段”（D。当前序时簿的单据类型ID与内码可以通过m_ListInterface.RsId("FClassTypeIDm_ListInterface.RsId("FID")取得。示例删除一张单据，其类型ID是200000001，内码是0018：通过字段关键字获取字段对象。语法Object.GetDataFldByKey(sFKeyAsString,[RowAsLong])第10页参数描述Object对象的一个实例。sFKeyString类型。字段模板的关键字（y。Row类型。可选参数。GetDataFldByKey函数DimbSuccessAsBooleanDimsResultAsStringsResult=m_ListInterface.DeleteBill(200000001,0018,bSuccess)IfbSuccessThenDebug.Print“删除 ElseDebug.Print删除失败”EndIfDebug.PrintsResult参数描述Object对象的一个实例。lClassTypeID要删除单据的类型IDnInterID要删除的单据的内码bSuccess用于返回，指示操作是否K/3BOS插件开发手册返回值类型KFO.Dictionary注释返回字段值对象，在字段值对象中再取出相应的值。示例获取序时簿中选中行对应得单据上的“单据编号(FBillNo)”字段的字段对象：通过指定字段的模板获取字段对象。语法Object.GetDataFld(dDictionary,[RowAsLong])第11页部分描述ObjectK/3BOS插件开发手册返回值类型KFO.Dictionary注释返回字段值对象，在字段值对象中再取出相应的值。示例获取序时簿中选中行对应得单据上的“单据编号(FBillNo)”字段的字段对象：通过指定字段的模板获取字段对象。语法Object.GetDataFld(dDictionary,[RowAsLong])第11页部分描述Object对象的一个实例。DctKFO.Dictionary对象。指定字段的模版的对象。Row类型。可选参数。当字段位于多分录上时，通过此参数指定需要获得的字段的值所在的行号。不指定此参数时得到当前激活行的值。GetDataFld函数DimdctFieldAsKFO.DictionaryDimdctDataAsKFO.DictionaryDimdctBillIDAsKFO.DictionarySetdctBillID=m_ListInterface.List.GetSelectedBillIDSetdctData=m_ListInterface.DataSrv.LoadBill(dctBillID.Name(1))Setm_ListInterface.Data=dctDataSetdctField=m_ListInterface.GetDataFldbyKey("FBillNo")IfNotdctFieldIsNothingThenDebug.Print单据编号:"&dctField("FFLD")EndIfSetdctField=NothingSetdctData=NothingSetdctBillID=Nothing当字段位于多分录上时，通过此参数指定需要获得的字段的值所在的行号。不指定此参数时得到当前激活行的值。当字段位于其他类型分录，或位于单据头时，此参数被忽略。K/3BOS插件开发手册返回值类型KFO.Dictionary注释返回字段值对象。示例获得序时簿当前选定行的关键数据。语法Object.GetCurrentSelRowInfo()返回值类型第12页部分描述Object对象的一个实例。K/3BOS插件开发手册返回值类型KFO.Dictionary注释返回字段值对象。示例获得序时簿当前选定行的关键数据。语法Object.GetCurrentSelRowInfo()返回值类型第12页部分描述Object对象的一个实例。GetCurrentSelRowInfo函数获取序时簿中选中行对应得单据上的“单据编号(FBillNo)”字段的字段对象：DimdctAsKFO.DictionaryDimdctDataAsKFO.DictionaryDimdctBillIDAsKFO.DictionaryDimdctDataInfoAsKFO.DictionarySetdctBillID=m_ListInterface.List.GetSelectedBillIDSetdctData=m_ListInterface.DataSrv.LoadBill(dctBillID.Name(1))Setm_ListInterface.Data=dctData'GetFieldInfo()函数的实现参见ListEvents.DataSrv属性的示例SetdctDataInfo=GetFieldInfo("FBillNo")Setdct=m_ListInterface.GetDataFld(dctDataInfo)IfNotdctIsNothingThenDebug.Print单据编号:"&dct("FFLD")EndIfSetdct=NothingSetdctData=NothingSetdctBillID=NothingSetdctDataInfo=Nothing当字段位于其他类型分录，或位于单据头时，此参数被忽略。K/3BOS插件开发手册KFO.Dictionary注释此函数返回的数据 FEntryIDID。如果当前选定了多行，只返回选定行中第一行的单据数据。示例获取序时簿上当前选中的行对应的单据的内码：获取选中行（可以多选）的关键数据。语法Object.GetSelectedBillInfo()返回值类型注释此函数返回一个KFO.VectorK/3BOS插件开发手册KFO.Dictionary注释此函数返回的数据 FEntryIDID。如果当前选定了多行，只返回选定行中第一行的单据数据。示例获取序时簿上当前选中的行对应的单据的内码：获取选中行（可以多选）的关键数据。语法Object.GetSelectedBillInfo()返回值类型注释此函数返回一个KFO.VectorVector的Size和选中的行数一致。每行包含一个数据包，此数据FEntryIDID。示例获取序时簿当前选中的多个行中的第一行对应的单据的分录ID：第13页DimiAsLongDimvctRowsAsKFO.VectorDimdctRowAsKFO.DictionarySetvctRows=m_ListInterface.GetSelectedBillInfoIfNotvctRowsIsNothingThenFori=1TovctRows.SizeSetdctRow=vctRows(i)部分描述Object对象的一个实例。GetSelectedBillInfo函数DimdctSelectedRowAsKFO.DictionarySetdctSelectedRow=m_ListInterface.GetCurrentSelRowInfoDebug.Print"单据内码: "&dctSelectedRow("FID"),_"单据类型: "&dctSelectedRow("FClassTypeID"),_"单据分录ID:"&dctSelectedRow("FEntryID")SetdctSelectedRow=NothingK/3BOS插件开发手册加载当前选择的单据，并按照指定的状态显示。语法Object.LoadSelectedBill(BillStatusAsEnuBillStatusExt)Enu_BillStatusExt常数返回值类型Boolean。注释加载TrueFalse。示例以“修改状态”显示序时簿当前选中的行对应的单据：刷新序时簿语法Object.RefreshList(OptionalByValbRefreshToolBarAsBoolean=True,K/3BOS插件开发手册加载当前选择的单据，并按照指定的状态显示。语法Object.LoadSelectedBill(BillStatusAsEnuBillStatusExt)Enu_BillStatusExt常数返回值类型Boolean。注释加载TrueFalse。示例以“修改状态”显示序时簿当前选中的行对应的单据：刷新序时簿语法Object.RefreshList(OptionalByValbRefreshToolBarAsBoolean=True,OptionalByVal第14页RefreshListm_ListInterface.LoadSelectedBillEnu_BillStatusExt_Modify常数值描述Enu_BillStatusExt_View0查看状态。Enu_BillStatusExt_New1新增状态。Enu_BillStatusExt_Modify2修改状态。部分描述Object对象的一个实例。BillStatus类型。显示单据时单据的状态。LoadSelectedBill函数Debug.Print"单据内码: "&dctRow("FID");_"单据类型: "&dctRow("FClassTypeID");_"单据分录ID:"&dctRow("FEntryID")NextEndIfSetdctRow=NothingSetvctRows=NothingK/3BOS插件开发手册bMarkSelRowAsBoolean=True)返回值无示例刷新序时簿，刷新工具栏，刷新后用户选定的行不变：消息。语法Object.SenderMessage(sTitleAsString,sMessageAsString,arrUsers,[lSenderTypeAsLong])返回值Boolean。注释TrueFalseK/3BOS插件开发手册bMarkSelRowAsBoolean=True)返回值无示例刷新序时簿，刷新工具栏，刷新后用户选定的行不变：消息。语法Object.SenderMessage(sTitleAsString,sMessageAsString,arrUsers,[lSenderTypeAsLong])返回值Boolean。注释TrueFalse。示例主控台消息给系统管理员：第15页部分描述Object对象的一个实例。sTitleString类型，消息的标题。sMessageString类型，消息的内容。arrUsers可以为（下0开始。lSenderType类型，可选参数，消息 的方式，目前保留。SenderMessage函数m_ListInterface.RefreshListTrue,True部分描述Object对象的一个实例。bRefreshToolBarbMarkSelRowFalse，则刷新后选定用户选择了多行，那么刷新后，只选中多行中的第一行。K/3BOS插件开发手册9”为系统管理员的内码。更新非查找类型字段的值。语法Object.UpdateNormalFld(d[bSetModifyFlagAsBoolean])sValueAsString,[RowAsLong],返回值KFO.Dictionary注释此函数仅更新了该字段的值对象中的值，并不影响已有的显示。示例更改当前单据的单据编号“Bllo）3通过字段名称来更新非查找类型字段的值。语法Object.UpdateNormalFldByKeyK/3BOS插件开发手册9”为系统管理员的内码。更新非查找类型字段的值。语法Object.UpdateNormalFld(d[bSetModifyFlagAsBoolean])sValueAsString,[RowAsLong],返回值KFO.Dictionary注释此函数仅更新了该字段的值对象中的值，并不影响已有的显示。示例更改当前单据的单据编号“Bllo）3通过字段名称来更新非查找类型字段的值。语法Object.UpdateNormalFldByKey(sKeyAsString,sValue[bSetModifyFlagAsBoolean])AsString,[RowAsLong],第16页UpdateNormalFldByKey函数'GetFieldInfo()的实现参见ListEvents.DataSrv属性的示例程序m_ListInterface.UpdateNormalFldGetFieldInfo("FBillNo"),"33333"部分描述Object对象的一个实例。dctKFO.Dictionary对象。指定字段的模版的对象。sValueString类型。需要更新的值。Row类型。可选参数。不指定此参数时更新当前激活行的值。当字段位于其他类型分录，或位于单据头时，此参数被忽略。bSetModifyFlag类型。可选参数。目前保留。UpdateNormalFld函数DimblnAsBooleanbln=m_ListInterface.SenderMessage("审核单据","请审核[111111]单据",16394)K/3BOS插件开发手册返回值KFO.Dictionary注释此个函数仅更新了该字段的值对象中的值，并不影响已有的显示。示例更改当前单据的单据编号“Bllo）3刷新序时簿菜单和工具栏语法Object.Refresh示例批量审核或反审核单据后，触发此。语法第17页AfterBatchMultiCheckm_ListInterface.Refresh部分描述Object对象的一个实例。Refresh 函数K/3BOS插件开发手册返回值KFO.Dictionary注释此个函数仅更新了该字段的值对象中的值，并不影响已有的显示。示例更改当前单据的单据编号“Bllo）3刷新序时簿菜单和工具栏语法Object.Refresh示例批量审核或反审核单据后，触发此。语法第17页AfterBatchMultiCheckm_ListInterface.Refresh部分描述Object对象的一个实例。Refresh 函数m_ListInterface.UpdateNormalFldByKey"FBillNo","33333"部分描述Object对象的一个实例。sKeyString类型。字段模板的关键名称（y。sValueString类型。需要更新的值。Row类型。可选参数。不指定此参数时更新当前激活行的值。当字段位于其他类型分录，或位于单据头时，此参数被忽略。bSetModifyFlag类型。可选参数。是否设置更新标志。True，则该字段的更新标志将被设置。K/3BOS插件开发手册PrivateSubObject_AfterBatchMultiCheck(ByVallCheckDirectiondctCheckResultAsKFO.Dictionary)AsLong,ByVal注释业务最末级审核后发生。语法PrivateSubObject_AfterBusinessCheck(ByValSuccessAsBoolean)注释只有在业务最末级审核 此后不触发此。业务最末级审核后发生。K/3BOS插件开发手册PrivateSubObject_AfterBatchMultiCheck(ByVallCheckDirectiondctCheckResultAsKFO.Dictionary)AsLong,ByVal注释业务最末级审核后发生。语法PrivateSubObject_AfterBusinessCheck(ByValSuccessAsBoolean)注释只有在业务最末级审核 此后不触发此。业务最末级审核后发生。语法PrivateSubObject_AfterBusinessCheckEx(ByVallBillIDAsLong,ByValSuccessAsBoolean)完全相同。注释此 之后触发。第18页部分描述Object对象的一个实例。lBillIDID。AfterBusinessCheckEx部分描述Object对象的一个实例。Success类型。业务审核是否 。True为业务审核 。AfterBusinessCheck部分描述Object对象的一个实例。lCheckDirection类型。标识审核方向。1=审核，2=反审核dctCheckResult类型。审核或反审核结果及相关信息。K/3BOS插件开发手册选中的单据数据到新单据，在新单据尚未保存时发生。语法AsLong,ByValdctDataAsKFO.Dictionary)注释新单据的单据编号会自动更改，审核信息不到新的单据中；此应用场景：在选中的单据且需要更改原单据的数据。删除选中的单据后发生。语法PrivateSubObject_AfterDeleteBill(ByValbSuccessAsBoolean,ByVallBillInterIDAsLong,K/3BOS插件开发手册选中的单据数据到新单据，在新单据尚未保存时发生。语法AsLong,ByValdctDataAsKFO.Dictionary)注释新单据的单据编号会自动更改，审核信息不到新的单据中；此应用场景：在选中的单据且需要更改原单据的数据。删除选中的单据后发生。语法PrivateSubObject_AfterDeleteBill(ByValbSuccessAsBoolean,ByVallBillInterIDAsLong,ByValsBillNoAsString,ByValsErrorMessageAsString,bCancelErrorMessageBoolean)As注释为删除的单据的单据编号，但有可能没有单据编号，此时为空字符串。bCancelErrorMessageFalse，默认情况下不显示提示框。第19页部分描述Object对象的一个实例。bSuccess类型。删除是否 。True为删除 。lBillInterID类型。删除的单据的内码。sBillNoString类型。删除的单据的编号。sErrorMessageString类型。错误信息。如果删除 ，则为 的提示信息。bCancelErrorMessage类型。是否显示错误信息提示 框（包括 信息。AfterDeleteBill部分描述Object对象的一个实例。srcInterID类型，选择的单据的内码。dctDataKFO.Dictionary对象，新单据的数据。AfterCopyBillCreateDataK/3BOS插件开发手册合并选中的单据数据到新单据，在新单据尚未保存时发生。语法PrivateSubObject_AfterMergeCopyBill(ByValdctDataAsKFO.Dictionary)注释新单据的单据编号会自动更改，审核信息不到新的单据中；此应用场景：在合并选中的单据且需要更改某些数据。多级审核后发生。语法PrivateSubObject_AfterMultiCheck(ByVallCheckModeAsLong,ByVallCheckMaxLevelAsLong,ByVallBusinessLevelAsLong,ByValK/3BOS插件开发手册合并选中的单据数据到新单据，在新单据尚未保存时发生。语法PrivateSubObject_AfterMergeCopyBill(ByValdctDataAsKFO.Dictionary)注释新单据的单据编号会自动更改，审核信息不到新的单据中；此应用场景：在合并选中的单据且需要更改某些数据。多级审核后发生。语法PrivateSubObject_AfterMultiCheck(ByVallCheckModeAsLong,ByVallCheckMaxLevelAsLong,ByVallBusinessLevelAsLong,ByVallCheckLevelAsLong,ByVallCheckStatusAsLong,ByValSuccessAsBoolean)注释此 在每步审核后都能触发，和AfterBusinessCheck不同。多级审核后发生。第20页AfterMultiCheckEx部分描述Object对象的一个实例。lCheckM 类型。审核模式，0—顺序审核；1—会签。lCheckMaxLevel类型。多级审核最大审核级次。lBusinessLevel类型。业务审核级次。lCheckLevel类型。本次审核的级次。lCheckStatus序审核，则和中最大的审核级次为当前已审核级次。Success类型。多级审核是否 。True为多级审核 。AfterMultiCheck部分描述Object对象的一个实例。dctDataKFO.Dictionary对象，新单据的数据。AfterMergeCopyBillK/3BOS插件开发手册语法PrivateSubObject_AfterMultiCheckEx(ByVallBillIDAsLong,ByVallCheckModeAsLong,ByVallCheckMaxLevelAsLong,ByVallBusinessLevelAsLong,ByVallCheckLevelAsLong,ByValK/3BOS插件开发手册语法PrivateSubObject_AfterMultiCheckEx(ByVallBillIDAsLong,ByVallCheckModeAsLong,ByVallCheckMaxLevelAsLong,ByVallBusinessLevelAsLong,ByVallCheckLevelAsLong,ByVallCheckStatusAsLong,ByValSuccessAsBoolean)其他参数及其含义跟AfterMultiCheck完全相同。注释此 总是在AfterMultiCheck之后触发。在选单过程中，选定源单序时簿上的单据，返回目标单据时发生。语法PrivateSubObject_AfterSelList(ByValRsIdAsADODB.Recordset,KFO.Vector)VectListAs注释VectList参数中的值，并将其一同返回。：如果要使用RsId参数，插件工程还必须 MicrosoftActiveXDataObjectsLibrary。驳回业务审核后发生。语法PrivateSubObject_AfterUnBusinessCheck(ByValSuccessAsBoolean)第21页部分描述Object对象的一个实例。Success类型。驳回业务审核是否 。True为驳回业务审核 。AfterUnBusinessCheck部分描述Object对象的一个实例。RsIdADODB.Recordset对象。源单序时簿所有单据的关键字段 集合。VectListKFO.Vector对象。选定的源单单据集合。AfterSelList部分描述Object对象的一个实例。lBillIDID。K/3BOS插件开发手册驳回业务审核后发生。语法PrivateSubObject_AfterUnBusinessCheckEx(ByVallBillIDAsLong,ByValSuccessAsBoolean)注释此 总是在AfterUnBusinessCheck之后触发。驳回多级审核后发生。语法PrivateSubObject_AfterUnMultiCheck(ByVallCheckModeAsLong,ByVallCheckMaxLevelAsLong,ByVallBusinessLevelAsLong,ByVallCheckLevelAsK/3BOS插件开发手册驳回业务审核后发生。语法PrivateSubObject_AfterUnBusinessCheckEx(ByVallBillIDAsLong,ByValSuccessAsBoolean)注释此 总是在AfterUnBusinessCheck之后触发。驳回多级审核后发生。语法PrivateSubObject_AfterUnMultiCheck(ByVallCheckModeAsLong,ByVallCheckMaxLevelAsLong,ByVallBusinessLevelAsLong,ByVallCheckLevelAsLong,ByVallCheckStatusAsLong,ByValSuccessAsBoole