View.ExecuteAction 方法

定义

重载

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 文件中的每个按钮元素都有相应的 xmlToEditaction 属性。 与使用按钮一样,操作将作用于所选的上下文(如果所选项会导致按钮被禁用,则 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 文件中的每个按钮元素都有相应的 xmlToEditaction 属性。 与使用按钮一样,操作将基于当前所选项:操作将作用于所选的上下文(如果所选项会导致按钮被禁用,则 ExecuteAction 方法将无效)。

可以通过显示控件的“属性”对话框,然后单击“高级”选项卡,确定Designer InfoPath 窗体上的控件或组的 XmlToEdit 标识符。

注意:在某些情况下,从视图中按钮事件的事件处理程序Clicked调用 ExecuteAction 方法可能会导致错误。 这是因为单击该按钮时,所选上下文将变为按钮。 在这种情况下,最好使用自定义任务窗格、菜单或工具栏上的按钮或链接来调用 ExecuteAction 方法。

此成员只能由与当前打开的表单在相同域中运行的表单访问,或者由已授予跨域权限的表单访问。

可以通过 Microsoft InfoPath Filler 中打开的表单中运行的代码访问此类型或成员。

适用于