View.ExecuteAction Метод (ActionType)

Статья
04/27/2010

Выполняет команду редактирования для связанного XML-документа формы на основе данных, выбранных в представлении.

Пространство имен: Microsoft.Office.InfoPath
Сборка: Microsoft.Office.InfoPath (в microsoft.office.infopath.dll)

Синтаксис

'Декларация
Public MustOverride Sub ExecuteAction ( _
    action As ActionType _
)
'Применение
Dim instance As View
Dim action As ActionType

instance.ExecuteAction(action)

public abstract void ExecuteAction (
    ActionType action
)

Параметры

action
Перечисление ActionType, которое определяет действие для выполнения.

Исключения

Тип исключения	Условие
InvalidOperationException	Метод ExecuteAction вызван из обработчика события для события Loading.
ArgumentNullException	Этому методу передан параметр .
ArgumentException	Этому методу передан недопустимый параметр . Например, неправильный тип или формат.

Заметки

Метод ExecuteAction используется для программного выполнения встроенных действий редактирования для связанного XML-документа на основе выбранного контекста в представлении.

Выполняемое действие соответствует действию при выборе эквивалентного меню или кнопки в панели инструментов; то есть элемент кнопки в файле XSF имеет соответствующие этому действию атрибуты xmlToEdit и action. Как и с использованием кнопки, это действие применяется к выбранному контексту (и в случае, когда выбор приводит к отключению кнопки, метод ExecuteAction не действует).

Имеется возможность сначала установить контекст выбора с помощью метода SelectNodes или SelectText и затем вызвать метод ExecuteAction, чтобы применить действие к этому контексту.

Заметка
В некоторых случаях, вызов метода ExecuteAction из обработчика события для события Clicked кнопки в представлении может создать ошибку. Это происходит потому, что выбранный контекст будет изменен для кнопки при ее нажатии. В этом случае, лучше использовать кнопку или ссылку в настраиваемой области задач, меню или панели инструментов, чтобы вызвать метод ExecuteAction.

В некоторых случаях, вызов метода ExecuteAction из обработчика события для события Clicked кнопки в представлении может создать ошибку. Это происходит потому, что выбранный контекст будет изменен для кнопки при ее нажатии. В этом случае, лучше использовать кнопку или ссылку в настраиваемой области задач, меню или панели инструментов, чтобы вызвать метод ExecuteAction.

Доступ к этому члену имеется только у форм, запускаемых на том же домене, что и открытая в настоящий момент форма, или у форм, которым были присвоены междоменные разрешения.

Доступ к этому типу или члену имеется только из программы, работающей в формах, открытых в Microsoft Office InfoPath 2007.

Пример

В следующем примере метод 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)

См. также

Ссылка

Класс View
Члены View
Пространство имен Microsoft.Office.InfoPath

Поделиться через