次の方法で共有

View.ExecuteAction メソッド

  • リファレンス

定義

名前空間:
Microsoft.Office.InfoPath
アセンブリ:
Microsoft.Office.InfoPath.dll

オーバーロード

ExecuteAction(ActionType)

ビューで現在選択されているデータに基づいて、フォームの基になる XML ドキュメントに対して編集コマンドを実行します。
ExecuteAction(ActionType, String)

指定したフィールドまたはグループに基づいて、フォームの基になる XML ドキュメントに対して編集コマンドを実行します。

ExecuteAction(ActionType)

ビューで現在選択されているデータに基づいて、フォームの基になる XML ドキュメントに対して編集コマンドを実行します。

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)

パラメーター

action
ActionType

実行するアクションを指定する ActionType 列挙体。

例外

InvalidOperationException

ExecuteAction メソッドは、Loading イベントのイベント ハンドラーから呼び出されました。

ArgumentNullException

このメソッドに渡されるパラメーターは null 参照です (Visual Basic では Nothing)。

ArgumentException

このメソッドに渡されるパラメーターは無効です。 たとえば、型または形式が正しくありません。

例

次の例では、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 で開いたフォームで実行されるコードからのみアクセスできます。

適用対象

ExecuteAction(ActionType, String)

指定したフィールドまたはグループに基づいて、フォームの基になる XML ドキュメントに対して編集コマンドを実行します。

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)

パラメーター

action
ActionType

実行するアクションを指定する ActionType 列挙体。

xmlToEdit
String

編集アクションを適用するフィールドまたはグループの XmlToEdit 識別子。フィールドまたはグループの XmlToEdit 識別子を確認するには、フィールドまたはグループのバインド先のコントロールを右クリックし、[ <Control Type> Properties] をクリックし、[詳細設定] タブをクリックします。 [XmlToEdit] の値は、タブの [コード] セクションに表示されます。

例外

InvalidOperationException

ExecuteAction メソッドは、Loading イベントのイベント ハンドラーから呼び出されました。

ArgumentNullException

このメソッドに渡されるパラメーターは null 参照です (Visual Basic では Nothing)。

ArgumentException

このメソッドに渡されたパラメーターは有効ではありません。 たとえば、型または形式が正しくありません。

例

次の例では、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 で開いたフォームで実行されるコードからのみアクセスできます。

適用対象