View.ExecuteAction Método

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Sobrecargas

ExecuteAction(ActionType)	Executa um comando de edição no documento XML subjacente de um formulário, com base nos dados atualmente selecionados na vista.
ExecuteAction(ActionType, String)	Executa um comando de edição no documento XML subjacente de um formulário, com base no campo ou grupo especificado.

ExecuteAction(ActionType)

Executa um comando de edição no documento XML subjacente de um formulário, com base nos dados atualmente selecionados na vista.

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

action

ActionType

Uma ActionType enumeração que especifica a ação a executar.

Exceções

InvalidOperationException

O método ExecuteAction foi chamado a partir de um processador de eventos para o Loading evento.

ArgumentNullException

O parâmetro transmitido para este método é uma referência nula (Nada no Visual Basic).

ArgumentException

O parâmetro transmitido para este método não é válido. Por exemplo, é do tipo ou formato errado.

Exemplos

No exemplo seguinte, o método ExecuteAction(action) da View classe é utilizado para eliminar os dados atualmente selecionados e colocá-lo na área de transferência.

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

Comentários

O método ExecuteAction é utilizado para realizar programaticamente ações de edição incorporadas no documento XML subjacente de um formulário, com base no contexto selecionado numa vista.

A ação executada será a mesma ação que seria utilizada ao clicar num menu ou botão de barra de ferramentas equivalente; ou seja, um elemento para o qual o elemento de botão no ficheiro .xsf tem atributos de ação e xmlToEdit correspondentes. Tal como acontece com a utilização de um botão, funcionará no contexto selecionado (e no caso de a seleção levar à desativação do botão, o método ExecuteAction não terá qualquer efeito).

É possível definir primeiro o contexto de seleção com o SelectNodes método ou SelectText método e, em seguida, chamar o método ExecuteAction para agir nesse contexto.

Nota: em alguns casos, chamar o método ExecuteAction a partir de um processador de eventos para o Clicked evento de um botão na vista pode causar um erro. Isto acontece porque o contexto selecionado muda para o botão quando o botão é clicado. Neste caso, é melhor utilizar um botão ou ligação num painel de tarefas, menu ou barra de ferramentas personalizado para chamar o método ExecuteAction .

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.

ExecuteAction(ActionType, String)

Executa um comando de edição no documento XML subjacente de um formulário, com base no campo ou grupo especificado.

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

action

ActionType

Uma ActionType enumeração que especifica a ação a executar.

xmlToEdit

String

O identificador XmlToEdit do campo ou grupo ao qual pretende aplicar a ação de edição. Para determinar o identificador XmlToEdit de um campo ou grupo, clique com o botão direito do rato no controlo ao qual o campo ou grupo está vinculado, clique em <Propriedades do Tipo> de Controlo e, em seguida, clique no separador Avançadas. O valor XmlToEdit é apresentado na secção Código do separador.

Exceções

InvalidOperationException

O método ExecuteAction foi chamado a partir de um processador de eventos para o Loading evento.

ArgumentNullException

Os parâmetros transmitidos a este método são uma referência nula (Nada no Visual Basic).

ArgumentException

Os parâmetros transmitidos a este método não são válidos. Por exemplo, são do tipo ou formato errados.

Exemplos

No exemplo seguinte, o método ExecuteAction(action, xmlToEdit) da View classe é utilizado para inserir dados no grupo especificado com a ação ActionType.XCollectionInsert .

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

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

Comentários

O método ExecuteAction é utilizado para realizar programaticamente ações de edição incorporadas no documento XML subjacente de um formulário, com base no contexto selecionado numa vista.

A ação executada será a mesma ação que seria utilizada ao clicar num menu ou botão de barra de ferramentas equivalente; ou seja, um elemento para o qual o elemento de botão no ficheiro .xsf tem atributos de ação e xmlToEdit correspondentes. Tal como acontece com a utilização de um botão, a ação será baseada na seleção atual: funcionará no contexto selecionado (e no caso de a seleção levar à desativação do botão, o método ExecuteAction não terá qualquer efeito).

Pode determinar o identificador XmlToEdit de um controlo ou grupo num formulário do InfoPath no Designer ao apresentar a caixa de diálogo Propriedades do controlo e, em seguida, ao clicar no separador Avançadas.

Nota: em alguns casos, chamar o método ExecuteAction a partir de um processador de eventos para o Clicked evento de um botão na vista pode causar um erro. Isto acontece porque o contexto selecionado muda para o botão quando o botão é clicado. Neste caso, é melhor utilizar um botão ou ligação num painel de tarefas, menu ou barra de ferramentas personalizado para chamar o método ExecuteAction .

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.