View.ExecuteAction メソッド

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)

パラメーター

例外

例

次の例では、View クラスの ExecuteAction(action) メソッドを使用して、現在選択されているデータを削除し、クリップボードに配置します。

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

注釈

ExecuteAction メソッドは、ビュー内で選択されているコンテキストに基づいて、フォームの基になる XML ドキュメントに対してプログラムで組み込みの編集操作をする場合に使用します。

実行されるアクションは、同等のメニューまたはツール バー ボタンをクリックするときに使用されるのと同じアクションになります。つまり、.xsf ファイル内の button 要素に対応する xmlToEdit 属性と action 属性が含まれるもの。 ボタンを使用する場合と同様に、選択したコンテキストに対して動作します (選択によってボタンが無効になる場合、 ExecuteAction メソッドは効果がありません)。

最初に、 SelectNodes メソッドまたは SelectText メソッドを使用して選択コンテキストを設定してから、 ExecuteAction メソッドを呼び出してそのコンテキストに対して動作できます。

注: 場合によっては、ビュー内のボタンのClicked イベントに対してイベント ハンドラーから ExecuteAction メソッドを呼び出すと、エラーが発生する可能性があります。 これは、ボタンがクリックされると、選択コンテキストがボタンに移動することが原因です。 このような場合は、カスタム作業ウィンドウ、メニュー、またはツール バーのボタンまたはリンクを使用して ExecuteAction メソッドを呼び出すようにします。

このメンバは、現在開いているフォームと同じドメインで実行中のフォーム、またはクロスドメインのアクセス許可が与えられたフォームだけがアクセスできます。

この型またはメンバーには、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)

パラメーター

例外

例

次の例では、View クラスの ExecuteAction(action, xmlToEdit) メソッドを使用して、ActionType.XCollectionInsert アクションを使用して指定したグループにデータを挿入します。

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

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

注釈

ExecuteAction メソッドは、ビュー内で選択されているコンテキストに基づいて、フォームの基になる XML ドキュメントに対してプログラムで組み込みの編集操作をする場合に使用します。

実行されるアクションは、同等のメニューまたはツール バー ボタンをクリックするときに使用されるのと同じアクションになります。つまり、.xsf ファイル内の button 要素に対応する xmlToEdit 属性と action 属性が含まれるもの。 ボタンを使用する場合と同様に、アクションは現在の選択に基づきます。選択したコンテキストに基づいて動作します (選択によってボタンが無効になる場合は、 ExecuteAction メソッドは効果がありません)。

Designerの InfoPath フォームでコントロールまたはグループの XmlToEdit 識別子を決定するには、コントロールの [プロパティ] ダイアログ ボックスを表示し、[詳細設定] タブをクリックします。

注: 場合によっては、ビュー内のボタンのClicked イベントに対してイベント ハンドラーから ExecuteAction メソッドを呼び出すと、エラーが発生する可能性があります。 これは、ボタンがクリックされると、選択コンテキストがボタンに移動することが原因です。 このような場合は、カスタム作業ウィンドウ、メニュー、またはツール バーのボタンまたはリンクを使用して ExecuteAction メソッドを呼び出すようにします。

このメンバは、現在開いているフォームと同じドメインで実行中のフォーム、またはクロスドメインのアクセス許可が与えられたフォームだけがアクセスできます。

この型またはメンバーには、Microsoft InfoPath Filler で開いたフォームで実行されるコードからのみアクセスできます。