@types/office-js-preview 1.0.343 → 1.0.344

office-js-preview/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for Office.js (https://github.com/OfficeD
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js-preview.
 
 ### Additional Details
- * Last updated: Mon, 10 Oct 2022 23:33:18 GMT
+ * Last updated: Tue, 11 Oct 2022 17:33:25 GMT
  * Dependencies: none
  * Global values: `Excel`, `Office`, `OfficeCore`, `OfficeExtension`, `OneNote`, `PowerPoint`, `Visio`, `Word`
 

office-js-preview/index.d.ts

@@ -2275,7 +2275,7 @@ declare namespace Office {
         ActiveViewChanged,
         /**
          * Occurs when any date or time of the selected appointment or series is changed in Outlook.
-         * **Important**: Only available with task pane implementation.
+         * **Important**: This event can only be handled in a task pane. It isn't supported in function commands.
          *
          * To add an event handler for the `AppointmentTimeChanged` event, use the `addHandlerAsync` method of the `Item` object.
          * The event handler receives an argument of type
@@ -2285,7 +2285,7 @@ declare namespace Office {
          */
         AppointmentTimeChanged,
         /**
-         * Occurs when an attachment is added to or removed from an item. **Important**: Only available with task pane implementation.
+         * Occurs when an attachment is added to or removed from an item. **Important**: This event can only be handled in a task pane. It isn't supported in function commands.
          *
          * To add an event handler for the `AttachmentsChanged` event, use the `addHandlerAsync` method of the `Item` object.
          * The event handler receives an argument of type
@@ -2334,7 +2334,7 @@ declare namespace Office {
          */
         DocumentSelectionChanged,
         /**
-         * Occurs when the appointment location is changed in Outlook. **Important**: Only available with task pane implementation.
+         * Occurs when the appointment location is changed in Outlook. **Important**: This event can only be handled in a task pane. It isn't supported in function commands.
          *
          * To add an event handler for the `EnhancedLocationsChanged` event, use the `addHandlerAsync` method of the `Item` object.
          * The event handler receives an argument of type
@@ -2348,7 +2348,7 @@ declare namespace Office {
          * {@link https://learn.microsoft.com/javascript/api/outlook/office.notificationmessagedetails#actions | custom action}.
          * Currently, "Dismiss" is the only supported action that fires this event.
          *
-         * **Important**: This event is only available with task pane implementation.
+         * **Important**: This event can only be handled in a task pane. It isn't supported in function commands.
          *
          * To add an event handler for the `InfobarClicked` event, use the `addHandlerAsync` method of the `Item` object.
          * The event handler receives an argument of type
@@ -2359,7 +2359,7 @@ declare namespace Office {
         InfobarClicked,
         /**
          * Occurs when a different Outlook item is selected for viewing while the task pane is pinned.
-         * **Important**: Only available with task pane implementation.
+         * **Important**: This event can only be handled in a task pane. It isn't supported in function commands.
          *
          * To add an event handler for the `ItemChanged` event, use the `addHandlerAsync` method of the `Mailbox` object.
          *
@@ -2379,7 +2379,7 @@ declare namespace Office {
          */
         NodeReplaced,
         /**
-         * Occurs when the OfficeTheme is changed in Outlook. **Important**: Only available with task pane implementation.
+         * Occurs when the OfficeTheme is changed in Outlook. **Important**: This event can only be handled in a task pane. It isn't supported in function commands.
          *
          * To add an event handler for the `OfficeThemeChanged` event, use the `addHandlerAsync` method of the `Mailbox` object.
          * The event handler receives an argument of type
@@ -2392,7 +2392,7 @@ declare namespace Office {
         OfficeThemeChanged,
         /**
          * Occurs when the recipient list of the selected item or the appointment location is changed in Outlook.
-         * **Important**: Only available with task pane implementation.
+         * **Important**: This event can only be handled in a task pane. It isn't supported in function commands.
          *
          * To add an event handler for the `RecipientsChanged` event, use the `addHandlerAsync` method of the `Item` object.
          * The event handler receives an argument of type
@@ -2403,7 +2403,7 @@ declare namespace Office {
         RecipientsChanged,
         /**
          * Occurs when the recurrence pattern of the selected series is changed in Outlook.
-         * **Important**: Only available with task pane implementation.
+         * **Important**: This event can only be handled in a task pane. It isn't supported in function commands.
          *
          * To add an event handler for the `RecurrenceChanged` event, use the `addHandlerAsync` method of the `Item` object.
          * The event handler receives an argument of type
@@ -2416,6 +2416,15 @@ declare namespace Office {
          * Triggers when a Resource selection happens in Project.
          */
         ResourceSelectionChanged,
+        /**
+         * Occurs in Outlook when one or more messages are selected or deselected.
+         * **Important**: This event can only be handled in a task pane. It isn't supported in function commands.
+         * 
+         * To add an event handler for the `SelectedItemsChanged` event, use the `addHandlerAsync` method of the `Mailbox` object.
+         * 
+         * [Api set: Mailbox preview]
+         */
+        SelectedItemsChanged,
         /**
          * A Settings.settingsChanged event was raised.
          *
@@ -14273,8 +14282,8 @@ declare namespace Office {
          * @param callback - Optional. When the method completes, the function passed in the `callback` parameter is called with a single parameter,
          *                `asyncResult`, which is an `Office.AsyncResult` object.
          */
-         displayNewAppointmentFormAsync(parameters: AppointmentForm, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
-         /**
+        displayNewAppointmentFormAsync(parameters: AppointmentForm, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
+        /**
          * Displays a form for creating a new message.
          *
          * The `displayNewMessageForm` method opens a form that enables the user to create a new message. If parameters are specified, the message form
@@ -14540,6 +14549,54 @@ declare namespace Office {
          * @param userContext - Optional. Any state data that is passed to the asynchronous method.
          */
         getCallbackTokenAsync(callback: (asyncResult: Office.AsyncResult<string>) => void, userContext?: any): void;
+        /**
+         * Gets currently selected messages on which an add-in can activate and perform operations. An add-in can activate on a maximum of 100 messages at a time.
+         * To learn more about item multi-select, see
+         * [Activate your Outlook add-in on multiple messages (preview)](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select).
+         *
+         * @remarks
+         * [Api set: Mailbox preview]
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: `ReadWriteMailbox`
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose, Read
+         * 
+         * **Important**: This method only applies to messages.
+         *
+         * @param options - An object literal that contains one or more of the following properties:-
+         *        `asyncContext`: Developers can provide any object they wish to access in the callback function.
+         * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter,
+         *        `asyncResult`, which is an `Office.AsyncResult` object. The properties of the selected messages are returned as an array of JSON objects in the
+         *        `asyncResult.value` property. These properties include the item ID, subject, item type (`Message` is the only supported type at this time), and item mode
+         *        (`Read` or `Compose`). The objects in the array follow the order in which messages were selected.
+         * 
+         * @beta
+         */
+        getSelectedItemsAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<object[]>) => void): void;
+        /**
+         * Gets currently selected messages on which an add-in can activate and perform operations. An add-in can activate on a maximum of 100 messages at a time.
+         * To learn more about item multi-select, see
+         * [Activate your Outlook add-in on multiple messages (preview)](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select).
+         *
+         * @remarks
+         * [Api set: Mailbox preview]
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/understanding-outlook-add-in-permissions | Minimum permission level}**: `ReadWriteMailbox`
+         *
+         * **{@link https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points | Applicable Outlook mode}**: Compose, Read
+         * 
+         * **Important**: This method only applies to messages.
+         *
+         * @param options - An object literal that contains one or more of the following properties:-
+         *        `asyncContext`: Developers can provide any object they wish to access in the callback function.
+         * @param callback - When the method completes, the function passed in the `callback` parameter is called with a single parameter,
+         *        `asyncResult`, which is an `Office.AsyncResult` object. The properties of the selected messages are returned as an array of JSON objects in the
+         *        `asyncResult.value` property. These properties include the item ID, subject, item type (`Message` is the only supported type at this time), and item mode
+         *        (`Read` or `Compose`). The objects in the array follow the order in which messages were selected.
+         * 
+         * @beta
+         */
+        getSelectedItemsAsync(callback: (asyncResult: Office.AsyncResult<object[]>) => void): void;
         /**
          * Gets a token identifying the user and the Office Add-in.
          *

office-js-preview/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/office-js-preview",
-    "version": "1.0.343",
+    "version": "1.0.344",
     "description": "TypeScript definitions for Office.js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/office-js-preview",
     "license": "MIT",
@@ -45,6 +45,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "29a063dd1df28c8e3504d112ca119d534499b9504eab5db9501aae7aed1adfd4",
+    "typesPublisherContentHash": "0f62d3659bfc798e0dd6fc089951a2c474e8941003d2e8736d154bf36d55db16",
     "typeScriptVersion": "4.1"
 }