Action 要素
ユーザーが Button コントロールまたは Menu コントロールを選択したときに実行するアクションを指定 します 。
次の VersionOverrides スキーマでのみ有効です。
- 作業ウィンドウ 1.0
- メール 1.0
- メール 1.1
詳細については、「 マニフェストでのバージョンのオーバーライド」を参照してください。
次の要件セットに関連付けられています。
- 親 <VersionOverrides が Taskpane 1.0 型の場合、AddinCommands> 1.1。
- 親 <VersionOverrides が「Mail 1.0」と入力されている場合の>メールボックス 1.3。
- 親 <VersionOverrides が「Mail 1.1」と入力されている場合の>メールボックス 1.5。
属性
属性 | 必須 | 説明 |
---|---|---|
xsi:type | はい | 実行する操作の種類 |
xsi:type
この属性は、ユーザーがボタンをクリックしたときに実行される操作の種類を指定します。 次のいずれかを指定できます。
ExecuteFunction
ShowTaskpane
ユーザーがアクションを開始 ExecuteFunction
するボタンを選択すると、それまでに完了していない場合、アドインは 5 分後にタイムアウトします。
子要素
パラメーターの値 xsi:type
に非常に依存する有効な子要素。
xsi:type は ExecuteFunction です
要素 | 説明 |
---|---|
FunctionName | 実行する関数の名前を指定します。 |
FunctionName
xsi:type が である場合にExecuteFunction
必要な要素。 実行する関数の名前を指定します。 関数は、FunctionFile 要素に指定されたファイルに含まれています。
<Action xsi:type="ExecuteFunction">
<FunctionName>getSubject</FunctionName>
</Action>
xsi:type は ShowTaskpane です
要素 | 説明 |
---|---|
SourceLocation | この操作のソース ファイルの場所を指定します。 |
TaskpaneId | 作業ウィンドウ コンテナーの ID を指定します。 Outlook アドインではサポートされていません。 |
Title | 作業ウィンドウのカスタム タイトルを指定します。 Outlook アドインではサポートされていません。 |
SupportsPinning | 作業ウィンドウがピン留めをサポートすることを指定します。これにより、ユーザーが選択を変更したときも作業ウィンドウが開いたままになります。 Outlook でのみサポートされます。 |
SupportsMultiselect | Outlook アドインが複数の選択したメッセージでアクティブ化できることを指定します。 Outlook でのみサポートされます。 |
SupportsNoItemContext | 閲覧ウィンドウが有効になっていないか、メッセージが選択されていない状態で Outlook アドインをアクティブ化できることを指定します。 Outlook デスクトップ クライアントでのみサポートされます。 |
SourceLocation
xsi:type が である場合にShowTaskpane
必要な要素。 この操作のソース ファイルの場所を指定します。 resid 属性は 32 文字以内で指定でき、Resources 要素の Urls> 要素の<Url> 要素の id 属性の<値に設定する必要があります。
<Action xsi:type="ShowTaskpane">
<SourceLocation resid="readTaskPaneUrl" />
</Action>
TaskpaneId
xsi:type が の場合のShowTaskpane
省略可能な要素。 作業ウィンドウ コンテナーの ID を指定します。 複数の ShowTaskpane
アクションがある場合は、それぞれに独立したウィンドウを作成する場合は、別 <の TaskpaneId> を使用します。 同じウィンドウを共有するさまざまなアクションに同じ TaskpaneId> を使用します。< ユーザーが同じ <TaskpaneId を>共有するコマンドを選択すると、ウィンドウ コンテナーは開いたままですが、ウィンドウの内容は対応するアクション SourceLocation
に置き換えられます。
アドインの種類: 作業ウィンドウ
次の VersionOverrides スキーマでのみ有効です。
- 作業ウィンドウ 1.0
詳細については、「 マニフェストでのバージョンのオーバーライド」を参照してください。
次の要件セットに関連付けられています。
注:
この要素は、Outlook ではサポートされていません。
次の例は、同じ <TaskpaneId を共有する 2 つのアクションを示しています>。
<Action xsi:type="ShowTaskpane">
<TaskpaneId>MyPane</TaskpaneId>
<SourceLocation resid="aTaskPaneUrl" />
</Action>
<Action xsi:type="ShowTaskpane">
<TaskpaneId>MyPane</TaskpaneId>
<SourceLocation resid="anotherTaskPaneUrl" />
</Action>
次の例では、異なる <TaskpaneId を使用する 2 つのアクションを示します>。 これらの例をコンテキストで確認するには、「 Simple Add-in Commands Sample」を参照してください。
<Action xsi:type="ShowTaskpane">
<TaskpaneId>MyTaskPaneID1</TaskpaneId>
<SourceLocation resid="Contoso.Taskpane1.Url" />
</Action>
<Action xsi:type="ShowTaskpane">
<TaskpaneId>MyTaskPaneID2</TaskpaneId>
<SourceLocation resid="Contoso.Taskpane2.Url" />
</Action>
<bt:Urls>
<bt:Url id="Contoso.Taskpane1.Url" DefaultValue="https://commandsimple.azurewebsites.net/Taskpane.html" />
<bt:Url id="Contoso.Taskpane2.Url" DefaultValue="https://commandsimple.azurewebsites.net/Taskpane2.html" />
</bt:Urls>
タイトル
xsi:type が の場合のShowTaskpane
省略可能な要素。 この操作に関する、作業ウィンドウのカスタム タイトルを指定します。
アドインの種類: 作業ウィンドウ
次の VersionOverrides スキーマでのみ有効です。
- 作業ウィンドウ 1.0
詳細については、「 マニフェストでのバージョンのオーバーライド」を参照してください。
次の要件セットに関連付けられています。
注:
この子要素は、Outlook アドインではサポートされていません。
次の例は、Title> 要素を使用するアクションを<示しています。 タイトル>を文字列に<直接割り当てない点に注意してください。 代わりに、マニフェストの [リソース] セクションで定義され、32 文字以内の <リソース> ID (レジド) を割り当てます。
<Action xsi:type="ShowTaskpane">
<TaskpaneId>Office.AutoShowTaskpaneWithDocument</TaskpaneId>
<SourceLocation resid="PG.Code.Url" />
<Title resid="PG.CodeCommand.Title" />
</Action>
... Other markup omitted ...
<Resources>
<bt:Images> ...
</bt:Images>
<bt:Urls>
<bt:Url id="PG.Code.Url" DefaultValue="https://localhost:3000?commands=1" />
</bt:Urls>
<bt:ShortStrings>
<bt:String id="PG.CodeCommand.Title" DefaultValue="Code" />
</bt:ShortStrings>
... Other markup omitted ...
</Resources>
SupportsPinning
xsi:type が の場合のShowTaskpane
省略可能な要素。 VersionOverrides 要素を含むには、 の xsi:type 属性値VersionOverridesV1_1
が必要です。 作業ウィンドウのピン留めをサポートする場合は、この要素に true
の値を含めます。 ユーザーは、作業ウィンドウをピン留めできるようになります。ピン留めすると、選択を変更したときも作業ウィンドウが開いたままになります。 詳細については、「Outlook にピン留め可能な作業ウィンドウを実装する」を参照してください。
アドインの種類: メール
次の VersionOverrides スキーマでのみ有効です。
- メール 1.1
詳細については、「 マニフェストでのバージョンのオーバーライド」を参照してください。
次の要件セットに関連付けられています。
重要
SupportsPinning 要素は要件セット 1.5 で導入されましたが、現在は次を使用する Microsoft 365 サブスクライバーでのみサポートされています。
- Windows でのOutlook 2016以降 (ビルド 7628.1000 以降)
- Mac でOutlook 2016以降 (ビルド 16.13.503 以降)
- モダン Outlook on the web
- 新しい Outlook on Windows (プレビュー)
<Action xsi:type="ShowTaskpane">
<SourceLocation resid="readTaskPaneUrl" />
<SupportsPinning>true</SupportsPinning>
</Action>
SupportsMultiselect
xsi:type が ShowTaskpane
の場合の Outlook アドインの省略可能な要素。 アドインが複数の選択したメッセージに対して特定の操作をアクティブ化および実行できるようにするには、 の true
値を含めます。 項目の複数選択はメッセージにのみ適用されるため、ExtensionPoint 要素の xsi:type 属性値は または MessageComposeCommandSurface
に設定するMessageReadCommandSurface
必要があります。 アイテムの複数選択の詳細については、「複数の メッセージで Outlook アドインをアクティブ化する」を参照してください。
アドインの種類: メール
次の VersionOverrides スキーマでのみ有効です。
- メール 1.1
詳細については、「 マニフェストでのバージョンのオーバーライド」を参照してください。
次の要件セットに関連付けられています。
<Action xsi:type="ShowTaskpane">
<SourceLocation resid="readTaskpaneUrl" />
<SupportsMultiSelect>true</SupportsMultiSelect>
</Action>
SupportsNoItemContext
xsi:type が ShowTaskpane
の場合の Outlook アドインの省略可能な要素。 [閲覧ウィンドウ] が有効になっていないアドインまたはメッセージが選択されていない状態でアクティブ化できるようにするには、 の true
値を含めます。 SupportsNoItemContext> が に設定されている場合<、ExtensionPoint 要素の xsi:type 属性値を に設定するMessageReadCommandSurface
必要があります。true
詳細については、「 閲覧ウィンドウを有効にしたり、メッセージを選択せずに Outlook アドインをアクティブ化する」を参照してください。
アドインの種類: メール
次の VersionOverrides スキーマでのみ有効です。
- メール 1.1
詳細については、「 マニフェストでのバージョンのオーバーライド」を参照してください。
次の要件セットに関連付けられています。
注:
Outlook on the webおよび新しい Outlook on Windows (プレビュー) ではメールボックス要件セット 1.13 がサポートされていますが、閲覧ウィンドウが非表示になっている場合、またはメッセージが最初に選択されていない場合、アドインはアクティブになりません。 詳細については、「Outlook on the webおよび新しい Outlook on Windows の機能サポート (プレビュー)」を参照してください。
<Action xsi:type="ShowTaskpane">
<SourceLocation resid="Taskpane.Url"/>
<SupportsNoItemContext>true</SupportsNoItemContext>
</Action>
Office Add-ins
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示