Skip to content

Commit 225b1d5

Browse files
🤖 Merge PR DefinitelyTyped#74237 [office-js-preview] (Outlook) Update features in preview on Mac by @samantharamon
1 parent 3ad6f7c commit 225b1d5

File tree

1 file changed

+25
-6
lines changed

1 file changed

+25
-6
lines changed

‎types/office-js-preview/index.d.ts‎

Lines changed: 25 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -21395,6 +21395,10 @@ declare namespace Office {
2139521395
*
2139621396
* - Any code included after the `sendAsync` call isn't guaranteed to run since the add-in completes processing after the `sendAsync` call.
2139721397
*
21398+
* - The `sendAsync` method is available for preview in Outlook on Mac starting in Version 16.105 (Build 25121117).
21399+
* To test this feature, join the {@link https://techcommunity.microsoft.com/kb/microsoft-365-insider-kb/join-the-microsoft-365-insider-program-on-macos/4401756 | Microsoft 365 Insider program}
21400+
* and select the **Beta Channel** option to access Office beta builds.
21401+
*
2139821402
* @param options - An object literal that contains the `asyncContext` property. Use the `asyncContext` property to specify any object you want to access in the
2139921403
* callback function.
2140021404
* @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter, `asyncResult`. The `asyncResult`
@@ -21430,6 +21434,10 @@ declare namespace Office {
2143021434
*
2143121435
* - Any code included after the `sendAsync` call isn't guaranteed to run since the add-in completes processing after the `sendAsync` call.
2143221436
*
21437+
* - The `sendAsync` method is available for preview in Outlook on Mac starting in Version 16.105 (Build 25121117).
21438+
* To test this feature, join the {@link https://techcommunity.microsoft.com/kb/microsoft-365-insider-kb/join-the-microsoft-365-insider-program-on-macos/4401756 | Microsoft 365 Insider program}
21439+
* and select the **Beta Channel** option to access Office beta builds.
21440+
*
2143321441
* @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter, `asyncResult`. The `asyncResult`
2143421442
* parameter is an `Office.AsyncResult` object.
2143521443
*/
@@ -24961,16 +24969,15 @@ declare namespace Office {
2496124969
*
2496224970
* The customizable button in the Smart Alerts dialog varies depending on the Outlook client and its version.
2496324971
*
24964-
* - In Outlook on the web, new Outlook on Windows, and classic Outlook on Windows starting in Version 2412 (Build 18324.20000), the `cancelLabel` property customizes the text of the **Take Action** button.
24972+
* - In Outlook on the web, on Mac (in preview starting in Version 16.105 (Build 25121117)), new Outlook on Windows, and classic Outlook on Windows starting in Version 2412 (Build 18324.20000), the `cancelLabel` property customizes the text of the **Take Action** button.
2496524973
* The **Take Action** button only appears on the Smart Alerts dialog if the `commandId` option is configured in the `event.completed` call. The option must be configured
2496624974
* if you want to customize the text of the dialog button. In this implementation, the **Don't Send** button cancels the item being sent. Its text and functionality can't be customized.
2496724975
* If you previously customized the text of the **Don't Send** button without assigning it a task pane or function command, your custom text won't take effect in the latest Outlook client versions.
2496824976
* If you previously assigned a task pane or function command to the **Don't Send** button, no additional action is needed to implement the **Take Action** button in the latest versions.
2496924977
* The default or customized **Take Action** button will automatically appear the next time a user receives a Smart Alerts dialog. Although no implementation changes are needed, we recommend notifying users of this updated experience.
2497024978
*
24971-
* - In earlier supported versions of classic Outlook on Windows (versions prior to Version 2412 (Build 18324.20000) that support
24972-
* {@link https://learn.microsoft.com/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets#version-support-for-requirement-sets-in-classic-outlook-on-windows | Mailbox requirement set 1.14}),
24973-
* and Outlook on Mac, the `cancelLabel` property customizes the text of the **Don't Send** button. The **Don't Send** button cancels the item being sent.
24979+
* - In classic Outlook on Windows (prior to Version 2412 (Build 18324.20000) and Outlook on Mac (prior to Version 16.105 (Build 25121117)),
24980+
* the `cancelLabel` property customizes the text of the **Don't Send** button. The **Don't Send** button cancels the item being sent.
2497424981
*/
2497524982
cancelLabel?: string;
2497624983
/**
@@ -24998,13 +25005,13 @@ declare namespace Office {
2499825005
* - **Unified manifest for Microsoft 365**: The "id" property of the task pane or function command in the "controls" array.
2499925006
*
2500025007
* The button in the Smart Alerts dialog that opens a task pane or runs a function varies depending on the Outlook client and version.
25001-
* In Outlook on the web, new Outlook on Windows, and classic Outlook on Windows starting in Version 2412 (Build 18324.20000), the **Take Action** button opens a
25008+
* In Outlook on the web, on Mac (in preview starting in Version 16.105 (Build 25121117)), new Outlook on Windows, and classic Outlook on Windows starting in Version 2412 (Build 18324.20000), the **Take Action** button opens a
2500225009
* task pane or runs a function. In this implementation, the **Don't Send** button cancels the item being sent. Its text and functionality can't be customized.
2500325010
* In earlier supported versions of classic Outlook on Windows (versions prior to Version 2412 (Build 18324.20000) that support
2500425011
* {@link https://learn.microsoft.com/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets#version-support-for-requirement-sets-in-classic-outlook-on-windows | Mailbox requirement set 1.14}),
2500525012
* and Outlook on Mac, the **Don't Send** button opens a task pane or runs a function.
2500625013
*
25007-
* If you customized the text and functionality of the **Don't Send** button in your Smart Alerts add-in prior to Version 2412 (Build 18324.20000) of classic Outlook on Windows,
25014+
* If you've already customized the text and functionality of the **Don't Send** button in your Smart Alerts add-in prior to Version 2412 (Build 18324.20000) of classic Outlook on Windows or prior to Version 16.105 (Build 25121117) of Outlook on Mac,
2500825015
* no additional action is needed to implement the **Take Action** button in the latest supported versions. The default or customized **Take Action** button will automatically appear the next time a user receives a Smart Alerts dialog.
2500925016
* Although no implementation changes are needed, we recommend notifying users of this updated experience.
2501025017
*
@@ -25015,6 +25022,10 @@ declare namespace Office {
2501525022
*
2501625023
* When you configure a button in the Smart Alerts dialog to run a function, a button for the function is also added to the ribbon or action bar of the Outlook client.
2501725024
* Use the `contextData` option to distinguish when a user runs the function from the Smart Alerts dialog.
25025+
*
25026+
* Programming a button in the Smart Alerts dialog to run a function is available for preview in Outlook on Mac starting in Version 16.105 (Build 25121117).
25027+
* To test this feature, join the {@link https://techcommunity.microsoft.com/kb/microsoft-365-insider-kb/join-the-microsoft-365-insider-program-on-macos/4401756 | Microsoft 365 Insider program}
25028+
* and select the **Beta Channel** option to access Office beta builds.
2501825029
*/
2501925030
commandId?: string;
2502025031
/**
@@ -25203,6 +25214,10 @@ declare namespace Office {
2520325214
* `Office.MailboxEnums.MoveSpamItemTo.NoMove`.
2520425215
*
2520525216
* - If you implement a task pane to open after a reported message is processed, when the `event.completed` call occurs, any task pane that's open or pinned is closed.
25217+
*
25218+
* - The `commandId` option is available for preview in Outlook on Mac starting in Version 16.103 (Build 25101816). To test this option, join the
25219+
* {@link https://techcommunity.microsoft.com/kb/microsoft-365-insider-kb/join-the-microsoft-365-insider-program-on-macos/4401756 | Microsoft 365 Insider program}
25220+
* and select the **Beta Channel** option to access Office beta builds.
2520625221
*/
2520725222
commandId?: string;
2520825223
/**
@@ -25240,6 +25255,10 @@ declare namespace Office {
2524025255
* - To retrieve the value of the `contextData` property, you must call `Office.context.mailbox.item.getInitializationContextAsync` in the JavaScript implementation
2524125256
* of your task pane. If you create a JSON string using `JSON.stringify()` and assign it to the `contextData` property, you must parse the string using
2524225257
* `JSON.parse()` once you retrieve it.
25258+
*
25259+
* - The `contextData` option is available for preview in Outlook on Mac starting in Version 16.103 (Build 25101816). To test this option, join the
25260+
* {@link https://techcommunity.microsoft.com/kb/microsoft-365-insider-kb/join-the-microsoft-365-insider-program-on-macos/4401756 | Microsoft 365 Insider program}
25261+
* and select the **Beta Channel** option to access Office beta builds.
2524325262
*/
2524425263
contextData?: any;
2524525264
/**

0 commit comments

Comments
 (0)