View.ExecuteAction Método

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)

Parámetros

Excepciones

Ejemplos

En el ejemplo siguiente, se usa el método ExecuteAction(action) de la View clase para eliminar los datos seleccionados actualmente y colocarlos en el Portapapeles.

// 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)

Comentarios

El método ExecuteAction se utiliza para realizar acciones de edición de programación integradas en el documento XML subyacente del formulario, de acuerdo con el contexto seleccionado en una vista.

La acción que se ejecuta será la misma que se utilizaría al hacer clic en el botón de menú o barra de herramientas equivalente; es decir, una acción para la que el elemento de botón del archivo .xsf tenga un los atributos xmlToEdit y action correspondientes. Lo mismo que sucede cuando se usa un botón, actuará en el contexto seleccionado (y en caso de que la selección fuera a deshabilitar el botón, el método ExecuteAction no tendría ningún efecto).

Es posible establecer primero el contexto de selección mediante el SelectNodes método o SelectText método y, a continuación, llamar al método ExecuteAction para actuar sobre ese contexto.

Nota: En algunos casos, llamar al método ExecuteAction desde un controlador de eventos para el Clicked evento de un botón de la vista puede producir un error. Esto se debe a que el contexto seleccionado cambia al botón cuando se hace clic en él. En ese caso, es preferible utilizar un botón o vínculo de un panel de tareas personalizado, un menú o una barra de tareas para llamar al método ExecuteAction.

Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.

Únicamente se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler.

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)

Parámetros

Excepciones

Ejemplos

En el ejemplo siguiente, se usa el método ExecuteAction(action, xmlToEdit) de la View clase para insertar datos en el grupo especificado mediante la acción ActionType.XCollectionInsert .

this.CurrentView.ExecuteAction(ActionType.XCollectionInsert, 
   "group1_1");

Me.CurrentView.ExecuteAction(ActionType.XCollectionInsert, "group1_1")

Comentarios

El método ExecuteAction se utiliza para realizar acciones de edición de programación integradas en el documento XML subyacente del formulario, de acuerdo con el contexto seleccionado en una vista.

La acción que se ejecuta será la misma que se utilizaría al hacer clic en el botón de menú o barra de herramientas equivalente; es decir, una acción para la que el elemento de botón del archivo .xsf tenga un los atributos xmlToEdit y action correspondientes. Al igual que cuando se utiliza un botón, la acción se basará en la selección actual: se aplicará al contexto seleccionado (y, en caso de que la selección suponga que el botón está deshabilitado, el método ExecuteAction no tendrá efecto alguno).

Puede determinar el identificador XmlToEdit de un control o grupo en un formulario de InfoPath en el Designer mostrando el cuadro de diálogo Propiedades del control y, a continuación, haciendo clic en la pestaña Avanzadas.

Nota: En algunos casos, llamar al método ExecuteAction desde un controlador de eventos para el Clicked evento de un botón de la vista puede producir un error. Esto se debe a que el contexto seleccionado cambia al botón cuando se hace clic en él. En ese caso, es preferible utilizar un botón o vínculo de un panel de tareas personalizado, un menú o una barra de tareas para llamar al método ExecuteAction.

Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.

Únicamente se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler.