Compartir a través de

(String, Object) del método View3.ExecuteAction

  • Artículo

Ejecuta un comando de edición de Microsoft InfoPath en el documento XML subyacente de un formulario, de acuerdo con los datos seleccionados en la vista.

Espacio de nombres:  Microsoft.Office.Interop.InfoPath.SemiTrust
Ensamblado:  Microsoft.Office.Interop.InfoPath.SemiTrust (en Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Sintaxis

'Declaración
Sub ExecuteAction ( _
    bstrAction As String, _
    varXmlToEdit As Object _
)
'Uso
Dim instance As View3
Dim bstrAction As String
Dim varXmlToEdit As Object

instance.ExecuteAction(bstrAction, varXmlToEdit)

void ExecuteAction(
    string bstrAction,
    Object varXmlToEdit
)

Parámetros

  • bstrAction
    Tipo: System.String

    Nombre de la acción de edición que se va a realizar.

  • varXmlToEdit
    Tipo: System.Object

    Nombre del campo o grupo al que se aplicará la acción de edición. Equivale al valor del atributo name del elemento xmlToEdit del archivo de definición de formulario (.xsf).

Implementaciones

View2.ExecuteAction(String, Object)
View.ExecuteAction(String, Object)

Comentarios

El método ExecuteAction se usa para realizar acciones de edición mediante programación integradas en InfoPath 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 usarí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 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).

Es posible seleccionar primero el contexto usando los métodos SelectNodes o SelectText. A continuación, llame al método ExecuteAction para que actúe en ese contexto.

El método ExecuteAction devolverá un error por los siguientes motivos:

  • El parámetro bstrAction no contiene un nombre de componente de edición válido.

  • El parámetro varXmlToEdit no coincide con uno de los componentes de edición definidos en la vista.

  • Se requiere el parámetro varXmlToEdit para una acción de edición específica.

  • La acción de edición no es aplicable al contexto seleccionado.

  • A continuación, se facilita una tabla de combinaciones de parámetros que se pueden usar con el método ExecuteAction.

Combinación

Description

"Copiar"

Copia los datos seleccionados en el portapapeles.

"Pegar"

Copia los datos del portapapeles en el punto de inserción.

"Cortar"

Extrae los datos seleccionados y los copia en el portapapeles.

"Eliminar"

Elimina los datos seleccionados.

"xCollection::insert", "xmlToEditxmlToEdit"

Inserta datos de acuerdo con el contexto seleccionado utilizando el componente de edición xCollection. Si la selección actual se encuentra en un contenedor de xCollection, lo que se especifica mediante su elemento xmlToEdit en el archivo .xsf, se adjuntarán en ese contenedor los datos del elemento fragmentToInsert.

"xCollection::insertBefore", "xmlToEditxmlToEdit"

Inserta datos antes del contexto seleccionado usando el componente de edición xCollection. Si la selección actual se encuentra dentro de un elemento de xCollection, según lo especificado por su elemento xmlToEdit en el archivo .xsf, se insertarán los datos del elemento fragmentToInsert antes de ese elemento.

"xCollection::insertAfter", "xmlToEditxmlToEdit"

Inserta datos después del contexto seleccionado usando el componente de edición xCollection. Si la selección actual se encuentra dentro de un elemento de xCollection, según lo especificado por su elemento xmlToEdit en el archivo .xsf, se insertarán los datos del elemento fragmentToInsert después de ese elemento.

"xCollection::remove", "xmlToEditxmlToEdit"

Elimina datos del contexto seleccionado usando el componente de edición xCollection. Si la selección actual se encuentra dentro de un elemento de xCollection, según lo especificado por su elemento xmlToEdit en el archivo .xsf, se eliminará dicho elemento.

"xCollection::removeAll", "xmlToEditxmlToEdit"

Elimina todos los datos del contexto seleccionado usando el componente de edición xCollection. Si la selección actual se encuentra dentro de un contenedor de xCollection, según lo especificado por el elemento xmlToEdit en el archivo .xsf, esta acción eliminará todos los elementos de dicho contenedor.

"xReplace::replace", "xmlToEdit"

Reemplaza los datos del contexto seleccionado usando el componente de edición xReplace. Si la selección actual se encuentra dentro de un elemento de xReplace, según lo especificado por su elemento xmlToEdit en el archivo .xsf, ese elemento será reemplazado por los datos del elemento fragmentToInsert.

"xOptional::insert", "xmlToEditxmlToEdit"

Inserta datos de acuerdo con el contexto seleccionado utilizando el componente de edición xOptional. Si la selección actual se encuentra en un contenedor de xOptional, lo que se especifica mediante su elemento xmlToEdit en el archivo .xsf, se adjuntarán en ese contenedor los datos del elemento fragmentToInsert.

"xOptional::remove", "xmlToEdit"

Elimina datos del contexto seleccionado usando el componente de edición xOptional. Si la selección actual se encuentra dentro de un elemento de xOptional, según lo especificado por su elemento xmlToEdit en el archivo .xsf, se eliminará dicho elemento.

Nota:   en algunos casos, al llamar al método ExecuteAction desde el evento OnClick para un botón de una vista puede generarse un error. Esto se debe a que el contexto seleccionado cambia al botón cuando se hace clic en él. En este caso, es preferible usar un botón (o vínculo) de un panel de tareas personalizado, una barra de herramientas o un menú para llamar al método ExecuteAction.

Importante

Ú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.

Vea también

Referencia

interfaz View3

Miembros View3

Sobrecarga ExecuteAction

Espacio de nombres Microsoft.Office.Interop.InfoPath.SemiTrust