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

Exceções

Exemplos

No exemplo a seguir, o método ExecuteAction(action) da View classe é usado para excluir os dados selecionados no momento e colocá-los 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 é usado para executar programaticamente ações de edição internas em relação ao documento XML subjacente de um formulário, com base no contexto selecionado em uma exibição.

A ação executada será a mesma ação que seria usada ao clicar em um menu ou botão de barra de ferramentas equivalente; ou seja, um para o qual o elemento de botão no arquivo .xsf tem atributos xmlToEdit e de ação correspondentes. Assim como acontece com o uso de um botão, ele atuará no contexto selecionado (e no caso em que a seleção levaria o botão a ser desabilitado, o método ExecuteAction não terá efeito).

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

Observação: em alguns casos, chamar o método ExecuteAction de um manipulador de eventos para o Clicked evento de um botão no modo de exibição pode causar um erro. Isso ocorre porque o contexto selecionado muda para o botão quando o botão é clicado. Nesse caso, é melhor usar um botão ou link em um painel de tarefas personalizado, menu ou barra de ferramentas 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.

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

Exceções

Exemplos

No exemplo a seguir, o método ExecuteAction(action, xmlToEdit) da View classe é usado para inserir dados no grupo especificado usando 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 é usado para executar programaticamente ações de edição internas em relação ao documento XML subjacente de um formulário, com base no contexto selecionado em uma exibição.

A ação executada será a mesma ação que seria usada ao clicar em um menu ou botão de barra de ferramentas equivalente; ou seja, um para o qual o elemento de botão no arquivo .xsf tem atributos xmlToEdit e de ação correspondentes. Assim como acontece com o uso de um botão, a ação será baseada na seleção atual: ela atuará no contexto selecionado (e, no caso em que a seleção levaria o botão a ser desabilitado, o método ExecuteAction não terá efeito).

Você pode determinar o identificador XmlToEdit para um controle ou grupo em um formulário InfoPath no Designer exibindo a caixa de diálogo Propriedades do controle e clicando na guia Avançado.

Observação: em alguns casos, chamar o método ExecuteAction de um manipulador de eventos para o Clicked evento de um botão no modo de exibição pode causar um erro. Isso ocorre porque o contexto selecionado muda para o botão quando o botão é clicado. Nesse caso, é melhor usar um botão ou link em um painel de tarefas personalizado, menu ou barra de ferramentas 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.