Merge branch 'main' into live

Author: github-actions

docs/code-snippets/office-snippets.yaml

@@ -3859,6 +3859,23 @@ Office.DocumentMode:enum:
   - |-
     const mode : Office.DocumentMode = Office.context.document.mode;
     console.log("Document mode: " + mode);
+Office.DocumentSelectionChangedEventArgs:interface:
+  - |-
+    // The following example adds an event handler for the SelectionChanged event of a document.
+    function addSelectionChangedEventHandler() {
+        Office.context.document.addHandlerAsync(Office.EventType.DocumentSelectionChanged, MyHandler);
+    }
+
+    // The SelectionChanged event handler.
+    function MyHandler(eventArgs: Office.DocumentSelectionChangedEventArgs) {
+        write('Event raised: ' + eventArgs.type);
+        doSomethingWithDocument(eventArgs.document);
+    }
+
+    // Function that writes to a div with id='message' on the page.
+    function write(message){
+        document.getElementById('message').innerText += message; 
+    }
 Office.EventType:enum:
   - |-
     // This sample shows how to register an event handler in Outlook.

docs/docs-ref-autogen/office/office/office.documentselectionchangedeventargs.yml

@@ -4,7 +4,28 @@ uid: 'office!Office.DocumentSelectionChangedEventArgs:interface'
 package: office!
 fullName: Office.DocumentSelectionChangedEventArgs
 summary: Provides information about the document that raised the SelectionChanged event.
-remarks: ''
+remarks: |-
+
+
+  #### Examples
+
+  ```TypeScript
+  // The following example adds an event handler for the SelectionChanged event of a document.
+  function addSelectionChangedEventHandler() {
+      Office.context.document.addHandlerAsync(Office.EventType.DocumentSelectionChanged, MyHandler);
+  }
+
+  // The SelectionChanged event handler.
+  function MyHandler(eventArgs: Office.DocumentSelectionChangedEventArgs) {
+      write('Event raised: ' + eventArgs.type);
+      doSomethingWithDocument(eventArgs.document);
+  }
+
+  // Function that writes to a div with id='message' on the page.
+  function write(message){
+      document.getElementById('message').innerText += message; 
+  }
+  ```
 isPreview: false
 isDeprecated: false
 type: interface

docs/docs-ref-autogen/office_release/office/office.documentselectionchangedeventargs.yml

@@ -4,7 +4,28 @@ uid: 'office!Office.DocumentSelectionChangedEventArgs:interface'
 package: office!
 fullName: Office.DocumentSelectionChangedEventArgs
 summary: Provides information about the document that raised the SelectionChanged event.
-remarks: ''
+remarks: |-
+
+
+  #### Examples
+
+  ```TypeScript
+  // The following example adds an event handler for the SelectionChanged event of a document.
+  function addSelectionChangedEventHandler() {
+      Office.context.document.addHandlerAsync(Office.EventType.DocumentSelectionChanged, MyHandler);
+  }
+
+  // The SelectionChanged event handler.
+  function MyHandler(eventArgs: Office.DocumentSelectionChangedEventArgs) {
+      write('Event raised: ' + eventArgs.type);
+      doSomethingWithDocument(eventArgs.document);
+  }
+
+  // Function that writes to a div with id='message' on the page.
+  function write(message){
+      document.getElementById('message').innerText += message; 
+  }
+  ```
 isPreview: false
 isDeprecated: false
 type: interface

docs/docs-ref-autogen/outlook/outlook/office.userprofile.yml

@@ -23,10 +23,7 @@ properties:
     uid: 'outlook!Office.UserProfile#accountType:member'
     package: outlook!
     fullName: accountType
-    summary: |-
-      Gets the account type of the user associated with the mailbox.
-
-      **Note**: This member is currently only supported in Outlook on Mac starting in Version 16.9 (17121200).
+    summary: Gets the account type of the user associated with the mailbox.
     remarks: >-
       \[ [API set: Mailbox 1.6](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
 
@@ -51,9 +48,18 @@ properties:
       account.</td> </tr> </table>
 
 
-      **Note**: For hybrid Exchange environments, the returned account type value depends on where the mailbox is
-      hosted. If the mailbox is on an on-premises server, the account type value is **enterprise**. However, if it's
-      hosted on Exchange Online, the account type value is **office365**.
+      **Important**:
+
+
+      - Volume-licensed perpetual Outlook 2016 doesn’t support the `accountType` property. To work around this, use
+      Exchange Web Services (EWS) to call the
+      [ResolveNames](https://learn.microsoft.com/exchange/client-developer/web-service-reference/resolvenames-operation)
+      operation on the Exchange on-premise server.
+
+
+      - For hybrid Exchange environments, the returned account type value depends on where the mailbox is hosted. If the
+      mailbox is on an on-premises server, the account type value is **enterprise**. However, if it's hosted on
+      Exchange Online, the account type value is **office365**.
 
 
       #### Examples

docs/docs-ref-autogen/outlook_1_10/outlook/office.userprofile.yml

@@ -23,10 +23,7 @@ properties:
     uid: 'outlook!Office.UserProfile#accountType:member'
     package: outlook!
     fullName: accountType
-    summary: |-
-      Gets the account type of the user associated with the mailbox.
-
-      **Note**: This member is currently only supported in Outlook on Mac starting in Version 16.9 (17121200).
+    summary: Gets the account type of the user associated with the mailbox.
     remarks: >-
       \[ [API set: Mailbox 1.6](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
 
@@ -51,9 +48,18 @@ properties:
       account.</td> </tr> </table>
 
 
-      **Note**: For hybrid Exchange environments, the returned account type value depends on where the mailbox is
-      hosted. If the mailbox is on an on-premises server, the account type value is **enterprise**. However, if it's
-      hosted on Exchange Online, the account type value is **office365**.
+      **Important**:
+
+
+      - Volume-licensed perpetual Outlook 2016 doesn’t support the `accountType` property. To work around this, use
+      Exchange Web Services (EWS) to call the
+      [ResolveNames](https://learn.microsoft.com/exchange/client-developer/web-service-reference/resolvenames-operation)
+      operation on the Exchange on-premise server.
+
+
+      - For hybrid Exchange environments, the returned account type value depends on where the mailbox is hosted. If the
+      mailbox is on an on-premises server, the account type value is **enterprise**. However, if it's hosted on
+      Exchange Online, the account type value is **office365**.
 
 
       #### Examples

docs/docs-ref-autogen/outlook_1_11/outlook/office.userprofile.yml

@@ -23,10 +23,7 @@ properties:
     uid: 'outlook!Office.UserProfile#accountType:member'
     package: outlook!
     fullName: accountType
-    summary: |-
-      Gets the account type of the user associated with the mailbox.
-
-      **Note**: This member is currently only supported in Outlook on Mac starting in Version 16.9 (17121200).
+    summary: Gets the account type of the user associated with the mailbox.
     remarks: >-
       \[ [API set: Mailbox 1.6](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
 
@@ -51,9 +48,18 @@ properties:
       account.</td> </tr> </table>
 
 
-      **Note**: For hybrid Exchange environments, the returned account type value depends on where the mailbox is
-      hosted. If the mailbox is on an on-premises server, the account type value is **enterprise**. However, if it's
-      hosted on Exchange Online, the account type value is **office365**.
+      **Important**:
+
+
+      - Volume-licensed perpetual Outlook 2016 doesn’t support the `accountType` property. To work around this, use
+      Exchange Web Services (EWS) to call the
+      [ResolveNames](https://learn.microsoft.com/exchange/client-developer/web-service-reference/resolvenames-operation)
+      operation on the Exchange on-premise server.
+
+
+      - For hybrid Exchange environments, the returned account type value depends on where the mailbox is hosted. If the
+      mailbox is on an on-premises server, the account type value is **enterprise**. However, if it's hosted on
+      Exchange Online, the account type value is **office365**.
 
 
       #### Examples

docs/docs-ref-autogen/outlook_1_12/outlook/office.userprofile.yml

@@ -23,10 +23,7 @@ properties:
     uid: 'outlook!Office.UserProfile#accountType:member'
     package: outlook!
     fullName: accountType
-    summary: |-
-      Gets the account type of the user associated with the mailbox.
-
-      **Note**: This member is currently only supported in Outlook on Mac starting in Version 16.9 (17121200).
+    summary: Gets the account type of the user associated with the mailbox.
     remarks: >-
       \[ [API set: Mailbox 1.6](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
 
@@ -51,9 +48,18 @@ properties:
       account.</td> </tr> </table>
 
 
-      **Note**: For hybrid Exchange environments, the returned account type value depends on where the mailbox is
-      hosted. If the mailbox is on an on-premises server, the account type value is **enterprise**. However, if it's
-      hosted on Exchange Online, the account type value is **office365**.
+      **Important**:
+
+
+      - Volume-licensed perpetual Outlook 2016 doesn’t support the `accountType` property. To work around this, use
+      Exchange Web Services (EWS) to call the
+      [ResolveNames](https://learn.microsoft.com/exchange/client-developer/web-service-reference/resolvenames-operation)
+      operation on the Exchange on-premise server.
+
+
+      - For hybrid Exchange environments, the returned account type value depends on where the mailbox is hosted. If the
+      mailbox is on an on-premises server, the account type value is **enterprise**. However, if it's hosted on
+      Exchange Online, the account type value is **office365**.
 
 
       #### Examples

docs/docs-ref-autogen/outlook_1_13/outlook/office.userprofile.yml

@@ -23,10 +23,7 @@ properties:
     uid: 'outlook!Office.UserProfile#accountType:member'
     package: outlook!
     fullName: accountType
-    summary: |-
-      Gets the account type of the user associated with the mailbox.
-
-      **Note**: This member is currently only supported in Outlook on Mac starting in Version 16.9 (17121200).
+    summary: Gets the account type of the user associated with the mailbox.
     remarks: >-
       \[ [API set: Mailbox 1.6](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
 
@@ -51,9 +48,18 @@ properties:
       account.</td> </tr> </table>
 
 
-      **Note**: For hybrid Exchange environments, the returned account type value depends on where the mailbox is
-      hosted. If the mailbox is on an on-premises server, the account type value is **enterprise**. However, if it's
-      hosted on Exchange Online, the account type value is **office365**.
+      **Important**:
+
+
+      - Volume-licensed perpetual Outlook 2016 doesn’t support the `accountType` property. To work around this, use
+      Exchange Web Services (EWS) to call the
+      [ResolveNames](https://learn.microsoft.com/exchange/client-developer/web-service-reference/resolvenames-operation)
+      operation on the Exchange on-premise server.
+
+
+      - For hybrid Exchange environments, the returned account type value depends on where the mailbox is hosted. If the
+      mailbox is on an on-premises server, the account type value is **enterprise**. However, if it's hosted on
+      Exchange Online, the account type value is **office365**.
 
 
       #### Examples

docs/docs-ref-autogen/outlook_1_14/outlook/office.userprofile.yml

@@ -23,10 +23,7 @@ properties:
     uid: 'outlook!Office.UserProfile#accountType:member'
     package: outlook!
     fullName: accountType
-    summary: |-
-      Gets the account type of the user associated with the mailbox.
-
-      **Note**: This member is currently only supported in Outlook on Mac starting in Version 16.9 (17121200).
+    summary: Gets the account type of the user associated with the mailbox.
     remarks: >-
       \[ [API set: Mailbox 1.6](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
 
@@ -51,9 +48,18 @@ properties:
       account.</td> </tr> </table>
 
 
-      **Note**: For hybrid Exchange environments, the returned account type value depends on where the mailbox is
-      hosted. If the mailbox is on an on-premises server, the account type value is **enterprise**. However, if it's
-      hosted on Exchange Online, the account type value is **office365**.
+      **Important**:
+
+
+      - Volume-licensed perpetual Outlook 2016 doesn’t support the `accountType` property. To work around this, use
+      Exchange Web Services (EWS) to call the
+      [ResolveNames](https://learn.microsoft.com/exchange/client-developer/web-service-reference/resolvenames-operation)
+      operation on the Exchange on-premise server.
+
+
+      - For hybrid Exchange environments, the returned account type value depends on where the mailbox is hosted. If the
+      mailbox is on an on-premises server, the account type value is **enterprise**. However, if it's hosted on
+      Exchange Online, the account type value is **office365**.
 
 
       #### Examples

docs/docs-ref-autogen/outlook_1_6/outlook/office.userprofile.yml

@@ -23,10 +23,7 @@ properties:
     uid: 'outlook!Office.UserProfile#accountType:member'
     package: outlook!
     fullName: accountType
-    summary: |-
-      Gets the account type of the user associated with the mailbox.
-
-      **Note**: This member is currently only supported in Outlook on Mac starting in Version 16.9 (17121200).
+    summary: Gets the account type of the user associated with the mailbox.
     remarks: >-
       \[ [API set: Mailbox 1.6](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets) \]
 
@@ -51,9 +48,18 @@ properties:
       account.</td> </tr> </table>
 
 
-      **Note**: For hybrid Exchange environments, the returned account type value depends on where the mailbox is
-      hosted. If the mailbox is on an on-premises server, the account type value is **enterprise**. However, if it's
-      hosted on Exchange Online, the account type value is **office365**.
+      **Important**:
+
+
+      - Volume-licensed perpetual Outlook 2016 doesn’t support the `accountType` property. To work around this, use
+      Exchange Web Services (EWS) to call the
+      [ResolveNames](https://learn.microsoft.com/exchange/client-developer/web-service-reference/resolvenames-operation)
+      operation on the Exchange on-premise server.
+
+
+      - For hybrid Exchange environments, the returned account type value depends on where the mailbox is hosted. If the
+      mailbox is on an on-premises server, the account type value is **enterprise**. However, if it's hosted on
+      Exchange Online, the account type value is **office365**.
 
 
       #### Examples