DDEPoke 函 数
在动态数据交换 (DDE) 会话中 在客户和服务程序之间传送数据
语 法
DDEPoke( nChannelNumber , cItemNam e, cDataSent
[, cDataFormat [, cUDFNam e]])
返 值 类 型逻辑值 参 数 描 述
nChannelNumber
指 定 发 送 应 用 程 序 数 据 的 通 道 号 如 果 是 服 务 程 序 通 道 则 DDEPoke 响应 一 个 请 求 或 响 应 以 前 建 立 的 报 告 链 接 或 自 动 链 接 发 送 数 据
cItemName
指 定 接 收 数 据 的 项 名 项 名 根 据 应 用 程 序 的 不 同 而 不 同 并 且 必 须 能 被 应 用程 序 理 解 例 如 M icrosoft Excel 支 持 R1C1 为 有 效 项 名 它 指 明 工 作 表 中的 第 一 个 单 元
cDataSent
指 定 发 送 给 项 名 的 数 据 项 名 由 cItemName 指 定
cDataFormat
指 定 发 送 数 据 的 格 式 默 认 格 式 是 CF_TEXT 在 这 种 格 式 中 字 段 用 Tab
键 分 隔 记 录 用 回 车 和 换 行 符 分 隔
cUDFName
允 许 异 步 数 据 传 送 如 果 省 略 cUDFName 客 户 会 等 待 一 段 时 间 时 间 长 短由 DDESetOption 指 定 如 果 用 cUDFName 指 定 用 户 自 定 义 函 数 客 户程 序 在 请 求 之 后 继 续 执 行 下 行 代 码
当从服务程序得到数据时 执行 cUDFName 指定的用户自定义函数 用户自定义程序接受六个参数 参数按下列顺序传递
参 数 内 容
Channel Number 服务程序的通道号
Action XACTCOMPLETE 成功的事务
XACTFAIL 失败的事务
Item 项名 例如 R1C1 表示 M icrosoft Excel 工作表的单元
Data 新数据 (REQUEST) 或已传送的数据 POKE 或
EXECUTED
Format 数据格式 例如 CF_TEXT
Transaction Number
DDEPoke 返回的事务编号
可使用 DDEAbortTrans 取消未完成的事务 如果事务失败了 可以用
DDELastError 确定失败的原因
若包含 cUDFName 事务成功时 DDEPoke 返回一个事务号 发生错误时返回 - 1
说 明
DDEPoke 将数据以字符串形式发送给通道号指定的应用程序中的项名
如果数据发送成功 则 DDEPoke 返回 真 (.T.) 如果不能发送数据 则返回 假 (.F.) 如果包含一个异步用户自定义函数 cUDFName 则 DDEPoke 返回一
个事务号 如果发生错误 DDEPoke 返回 -1
请 参 阅
DDEAbortTran s( ), DDEInitiate( ), DDELastError( ), DDESetOption( ), DDETerminate( )