View.ExecuteAction 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| ExecuteAction(ActionType) |
基于当前在视图中选择的数据,针对表单的基础 XML 文档执行编辑命令。 |
| ExecuteAction(ActionType, String) |
基于指定的域和组,针对表单的基础 XML 文档执行编辑命令。 |
ExecuteAction(ActionType)
基于当前在视图中选择的数据,针对表单的基础 XML 文档执行编辑命令。
public:
abstract void ExecuteAction(Microsoft::Office::InfoPath::ActionType action);
public abstract void ExecuteAction(Microsoft.Office.InfoPath.ActionType action);
abstract member ExecuteAction : Microsoft.Office.InfoPath.ActionType -> unit
Public MustOverride Sub ExecuteAction (action As ActionType)
参数
- action
- ActionType
指定要 ActionType 执行的操作的枚举。
例外
从事件的事件处理程序Loading调用 ExecuteAction 方法。
传递给此方法的参数是一个 null 引用, (Visual Basic) 中无任何内容。
传递给此方法的参数无效。 例如,它的类型或格式有误。
示例
在以下示例中,类的 ExecuteAction (action) 方法 View 用于删除当前选定的数据并将其放在剪贴板上。
// Create XPathNavigator and select field.
XPathNavigator textNode =
CreateNavigator().SelectSingleNode(
"/my:myFields/my:field1", NamespaceManager);
// Select text in specified field.
CurrentView.SelectText(textNode);
// Cut selected text.
CurrentView.ExecuteAction(ActionType.Cut);
' Create XPathNavigator and select field.
Dim textNode As XPathNavigator = _
CreateNavigator().SelectSingleNode( _
"/my:myFields/my:field1", NamespaceManager)
' Select text in specified field.
CurrentView.SelectText(textNode)
' Cut selected text.
CurrentView.ExecuteAction(ActionType.Cut)
注解
使用 ExecuteAction 方法,可以基于视图中选择的上下文,以编程方式对表单的基础 XML 文档执行内置的编辑操作。
所执行的操作与单击等效的菜单或工具栏按钮时所使用的操作相同;即 .xsf 文件中的每个按钮元素都有相应的 xmlToEdit 和 action 属性。 与使用按钮一样,操作将作用于所选的上下文(如果所选项会导致按钮被禁用,则 ExecuteAction 方法将没有效果)。
可以先使用 SelectNodes 方法或 SelectText 方法设置选择上下文,然后调用 ExecuteAction 方法对该上下文进行操作。
注意:在某些情况下,从视图中按钮事件的事件处理程序Clicked调用 ExecuteAction 方法可能会导致错误。 这是因为单击该按钮时,所选上下文将变为按钮。 在这种情况下,最好使用自定义任务窗格、菜单或工具栏上的按钮或链接来调用 ExecuteAction 方法。
此成员只能由与当前打开的表单在相同域中运行的表单访问,或者由已授予跨域权限的表单访问。
可以通过 Microsoft InfoPath Filler 中打开的表单中运行的代码访问此类型或成员。
适用于
ExecuteAction(ActionType, String)
基于指定的域和组,针对表单的基础 XML 文档执行编辑命令。
public:
abstract void ExecuteAction(Microsoft::Office::InfoPath::ActionType action, System::String ^ xmlToEdit);
public abstract void ExecuteAction(Microsoft.Office.InfoPath.ActionType action, string xmlToEdit);
abstract member ExecuteAction : Microsoft.Office.InfoPath.ActionType * string -> unit
Public MustOverride Sub ExecuteAction (action As ActionType, xmlToEdit As String)
参数
- action
- ActionType
指定要 ActionType 执行的操作的枚举。
- xmlToEdit
- String
要对其应用编辑操作的字段或组的 XmlToEdit 标识符。若要确定字段或组的 XmlToEdit 标识符,请右键单击字段或组绑定到的控件,单击“控件类型>属性”<,然后单击“高级”选项卡。“XmlToEdit”值显示在选项卡的“代码”部分中。
例外
从事件的事件处理程序Loading调用 ExecuteAction 方法。
传递给此方法的参数是 null 引用, (Visual Basic) 中没有。
传递给此方法的参数无效。 例如,它们的类型或格式有误。
示例
在以下示例中,类的 ExecuteAction (action) xmlToEdit 方法View用于使用 ActionType.XCollectionInsert 操作将数据插入指定的组中。
this.CurrentView.ExecuteAction(ActionType.XCollectionInsert,
"group1_1");
Me.CurrentView.ExecuteAction(ActionType.XCollectionInsert, "group1_1")
注解
使用 ExecuteAction 方法,可以基于视图中选择的上下文,以编程方式对表单的基础 XML 文档执行内置的编辑操作。
所执行的操作与单击等效的菜单或工具栏按钮时所使用的操作相同;即 .xsf 文件中的每个按钮元素都有相应的 xmlToEdit 和 action 属性。 与使用按钮一样,操作将基于当前所选项:操作将作用于所选的上下文(如果所选项会导致按钮被禁用,则 ExecuteAction 方法将无效)。
可以通过显示控件的“属性”对话框,然后单击“高级”选项卡,确定Designer InfoPath 窗体上的控件或组的 XmlToEdit 标识符。
注意:在某些情况下,从视图中按钮事件的事件处理程序Clicked调用 ExecuteAction 方法可能会导致错误。 这是因为单击该按钮时,所选上下文将变为按钮。 在这种情况下,最好使用自定义任务窗格、菜单或工具栏上的按钮或链接来调用 ExecuteAction 方法。
此成员只能由与当前打开的表单在相同域中运行的表单访问,或者由已授予跨域权限的表单访问。
可以通过 Microsoft InfoPath Filler 中打开的表单中运行的代码访问此类型或成员。