Event.GetFilterCommands 方法 (Visio)

返回命令区域数组以及 True 或 False 值，指示如何筛选该命令区域的事件。

语法

expression。 GetFilterCommands

表达 一个代表 Event 对象的变量。

返回值

Long ()

备注

GetFilterCommands 方法返回的数组中描述的事件筛选器为开发人员提供了根据命令 ID 忽略指定事件的方式。 返回的数组将被传递给此 Event 对象的 SetFilterCommands 方法。

可以采用以下方式解释 GetFilterCommands 方法返回的数组：

该数组中的元素数是 3 的倍数，如下所示：

• 第一个元素包含 visUICmds) 的任何成员 (范围的起始命令 ID。

• 第二个元素包含区域的结束命令 ID（VisUICmds的任何成员）。

• 第三个元素包含 True 或 False 值，指示是否侦听该命令区域的事件（True 表示侦听事件；False 表示排除事件）。

若要使事件成功地通过命令筛选，它必须满足以下条件：

• 必须具有有效的命令 ID。

• 如果所有的筛选器都为 True，则事件必须至少与一个筛选器匹配。

• 如果所有的筛选器都为 False，则事件一定与任何筛选器都不匹配。

• 如果筛选器为 True 和 False 的混合，则事件必须至少与一个 True 筛选器匹配，但一定不能与任何 False 筛选器匹配。

如果数组中没有定义任何 True 区域，则将事件视为 True。

有关使用命令 ID 定义事件筛选器的详细信息，请参阅 SetFilterCommands 方法。

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈？ 请参阅 Office VBA 支持和反馈，获取有关如何接收支持和提供反馈的指南。