CommandTargetQuery 事 件

当 Active Document 宿主程序 更新自己的用户界面时发生该事件

语 法

PROCEDURE Ob jec t.CommandTargetQuery

[LPARAMETERS aCommands , nCommandTextFlag , cCommandTextOut ]

参 数 描 述

aCommands

一 个 二 维 数 组 其 中 包 含 一 组 Active Document 宿 主 程 序 支 持 的 命 令

数 组 的 第 一 列 包 含 一 些 对 应 于 Active Document 宿 主 程 序 支 持 的 命 令 的 数

值 有 关 命 令 列 表 和 数 值 的 详 细 内 容 请 参 阅 CommandTargetExec 事 件 中 的

nCommandID 参 数

数 组 的 第 二 列 包 含 一 些 对 应 于 每 个 命 令 的 支 持 状 态 的 数 值 下 表 列 出 了 第 二列 包 含 的 数 值 以 及 相 应 的 每 个 命 令 的 支 持 状 态

数 值 FOXPRO.H 常 数 说 明

1. CMDF_NOTSUPPOR TED

该 对象 不支持该 命令

1. CMDF_SUPPORTED

   该 对象 支持该 命令

2. CMDF_ENABLED

   该 命令 可用而且已经启用

续 表

状态对应于三种状态复选框的 不明状态

数 组 的 第 二 列 对 于 每 个 命 令 初 始 都 包 含 零 事 件 代 码 应 该 在 第 二 列 包 含 一个 数 值 以 表 明 Active Document 对 每 个 命 令 的 支 持 状 态 可 以 任 意 组 合 这些 值 以 指 定 附 加 的 支 持 级 别 例 如 一 个 命 令 支 持 (1) 您 的 Active Document 过 程 而 且 可 用 并 启 用 了 (2) 则 可 以 在 相 应 命 令 的 第 二 列 保 存 3 (1 + 2)

nCommandTextFlag

从 Active Document 宿 主 程 序 传 递 到 CommandTargetExec 事 件 的 一 个 参 数nCommandTextFlag 表 明 了 通 过 cCommandTextOut 参 数 传 递 给 Active Document 宿 主 程 序 的 命 令 信 息 的 类 型 下 表 列 出 了 nCommandTextFlag 的值 以 及 相 应 的 传 递 给 Active Document 宿 主 程 序 的 命 令 信 息nCommandTextFlag 命 令 信 息

1. 不需要额外 信息

2. Active

   Document 应该提供命令的本地名称

续 表

1. Active

   Document 应该提供命令的本地状态栏字符串

cCommandTextOut

从 CommandTargetExec 事 件 传 递 给 Active Document 宿 主 程 序 的 一 个 参 数cCommandTextOut 是 为 一 个 命 令 显 示 的 文 本 通 常 显 示 在 Active Document 宿 主 程 序 的 状 态 栏 cCommandTextOut 适 用 于 数 组 中 第 一 列 的 命 令

说 明

CommandTargetQuery 事件 允许通知一个 Active Document 的宿主程序 该 Active Document 支持哪些命令 而且每个命令可用的支持类型 也可以指定当选中一个命令通常是一个菜单项 时显示的文本

对于 CommandTargetExec 和 CommandTargetQuery 事件 Visual FoxPro 利用IOleCommandTarget 接口 有关这些事件是如何实施的详细 信息 可以在 MSDN library 中搜索 IO leCommandTarget

注意 Internet Explorer 3 .0 和 4 .0 通常不需要 cCommandTextOut 的命令文本 因此nCommandTextFlag 通常为零 而且 cCommandTextOut 通常包含 null 值 包含这些参数 以便将来与 IOleCommandTarget 接口兼容 而且在您的应用程序中可以安全地忽略它们

应 用 于ActiveDoc 对象请 参 阅

CommandTargetExec 事 件