Automatically generated docs (#2287)

* Automatically generated docs

* Get latest updates

---------

Co-authored-by: github-actions <[email protected]>

Author: ElizabethSamuel-MSFT

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

@@ -89,6 +89,7 @@ enums:
   - outlook!Office.MailboxEnums.AttachmentContentFormat:enum
   - outlook!Office.MailboxEnums.AttachmentStatus:enum
   - outlook!Office.MailboxEnums.AttachmentType:enum
+  - outlook!Office.MailboxEnums.BodyMode:enum
   - outlook!Office.MailboxEnums.CategoryColor:enum
   - outlook!Office.MailboxEnums.ComposeType:enum
   - outlook!Office.MailboxEnums.Days:enum

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

@@ -339,10 +339,7 @@ methods:
     package: outlook!
     fullName: getAsync(coercionType, options, callback)
     summary: >-
-      Returns the current body in a specified format.
-
-
-      This method returns the entire current body in the format specified by
+      Returns the entire current body in the format specified by
       `coercionType`<!-- -->.
     remarks: >-
       \[ [API set: Mailbox
@@ -377,6 +374,29 @@ methods:
       Otherwise, you may receive an unexpected value, such as an empty string.
 
 
+      - In Outlook on the web and new Outlook on Windows, users can organize
+      their messages as conversations or individual messages in **Settings**
+      &gt; **Mail** &gt; **Layout** &gt; **Message organization**
+      (see [Change how the message list is displayed in
+      Outlook](https://support.microsoft.com/office/57fe0cd8-e90b-4b1b-91e4-a0ba658c0042)<!--
+      -->). This setting affects how much of a message's body is displayed to
+      the user (that is, the entire conversation thread of a message or just the
+      current message). In Message Compose mode, particulary for replies to a
+      conversation thread with more than one message, if you want the returned
+      body to reflect the user's setting, specify the `bodyMode:
+      Office.MailboxEnums.BodyMode.HostConfig` parameter in your `getAsync`
+      call. If messages are grouped by conversation, only the body of the
+      current reply is returned. Conversely, if messages are displayed
+      individually, the entire conversation thread is returned.
+
+
+      - The `bodyMode` option isn't supported on a message that's loaded using
+      the `loadItemByIdAsync` method. For more information, see [Activate your
+      Outlook add-in on multiple
+      messages](https://learn.microsoft.com/office/dev/add-ins/outlook/item-multi-select)<!--
+      -->.
+
+
       #### Examples
 
 
@@ -407,18 +427,28 @@ methods:
     syntax:
       content: >-
         getAsync(coercionType: Office.CoercionType | string, options:
-        Office.AsyncContextOptions, callback?: (asyncResult:
-        Office.AsyncResult<string>) => void): void;
+        Office.AsyncContextOptions & { bodyMode?: MailboxEnums.BodyMode },
+        callback?: (asyncResult: Office.AsyncResult<string>) => void): void;
       parameters:
         - id: coercionType
           description: The format for the returned body.
           type: <xref uid="office!Office.CoercionType:enum" /> | string
         - id: options
           description: >-
             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.
-          type: <xref uid="office!Office.AsyncContextOptions:interface" />
+            properties. `asyncContext`<!-- -->: Any data you want to access in
+            the callback function. `bodyMode`<!-- -->: In Outlook on the web and
+            new Outlook on Windows, specifies whether only the body of the
+            current message or the entire body of a message conversation is
+            returned. If a value isn't specified, `bodyMode` defaults to
+            `Office.MailboxEnums.BodyMode.FullBody`<!-- -->, which returns the
+            entire body of a message conversation. The `bodyMode` property only
+            applies to replies on the Message Compose surface. It's ignored in
+            Outlook on Windows (classic), on Mac, and on mobile devices.
+          type: >-
+            <xref uid="office!Office.AsyncContextOptions:interface" /> & {
+            bodyMode?: <xref uid="outlook!Office.MailboxEnums.BodyMode:enum" />
+            }
         - id: callback
           description: >-
             Optional. When the method completes, the function passed in the
@@ -436,10 +466,7 @@ methods:
     package: outlook!
     fullName: getAsync(coercionType, callback)
     summary: >-
-      Returns the current body in a specified format.
-
-
-      This method returns the entire current body in the format specified by
+      Returns the entire current body in the format specified by
       `coercionType`<!-- -->.
     remarks: >-
       \[ [API set: Mailbox
@@ -474,6 +501,22 @@ methods:
       Otherwise, you may receive an unexpected value, such as an empty string.
 
 
+      - In Outlook on the web and new Outlook on Windows, users can organize
+      their messages as conversations or individual messages in **Settings**
+      &gt; **Mail** &gt; **Layout** &gt; **Message organization**
+      (see [Change how the message list is displayed in
+      Outlook](https://support.microsoft.com/office/57fe0cd8-e90b-4b1b-91e4-a0ba658c0042)<!--
+      -->). This setting affects how much of a message's body is displayed to
+      the user (that is, the entire conversation thread of a message or just the
+      current message). In Message Compose mode, particulary for replies to a
+      conversation thread with more than one message, if you want the returned
+      body to reflect the user's setting, specify the `bodyMode:
+      Office.MailboxEnums.BodyMode.HostConfig` parameter in your `getAsync`
+      call. If messages are grouped by conversation, only the body of the
+      current reply is returned. Conversely, if messages are displayed
+      individually, the entire conversation thread is returned.
+
+
       #### Examples
 
 
@@ -1265,6 +1308,35 @@ methods:
       -->.
 
 
+      - In Outlook on the web and new Outlook on Windows, users can organize
+      their messages as conversations or individual messages in **Settings**
+      &gt; **Mail** &gt; **Layout** &gt; **Message organization**
+      (see [Change how the message list is displayed in
+      Outlook](https://support.microsoft.com/office/57fe0cd8-e90b-4b1b-91e4-a0ba658c0042)<!--
+      -->). This setting affects how much of a message's body is displayed to
+      the user (that is, the entire conversation thread of a message or just the
+      current message). In Message Compose mode, particulary for replies to a
+      conversation thread with more than one message, if you want to honor the
+      user's settings when setting the body of a message, specify the `bodyMode:
+      Office.MailboxEnums.BodyMode.HostConfig` parameter in your `setAsync`
+      call. If messages are grouped by conversation, only the body of the
+      current reply is set. Conversely, if messages are displayed individually,
+      the entire body, including previous messages in the conversation thread,
+      is replaced.
+
+
+      - In Outlook on the web and new Outlook on Windows, if the `bodyMode`
+      property isn't specified or is set to
+      `Office.MailboxEnums.BodyMode.FullBody`<!-- -->, the entire body of a
+      message, including previous messages from the conversation thread, is
+      replaced. This applies even if a user's messages are organized by
+      conversation. In this scenario, the user's setting is temporarily changed
+      to **Individual messages: Do not group messages** &gt; **Only a
+      single message** or **Show email as individual messages** during the
+      `setAsync` call. A notification is shown to the user to alert them to this
+      change. Once the call completes, the user's setting is reinstated.
+
+
       **Errors**:
 
 
@@ -1353,24 +1425,33 @@ methods:
     syntax:
       content: >-
         setAsync(data: string, options: Office.AsyncContextOptions &
-        CoercionTypeOptions, callback?: (asyncResult: Office.AsyncResult<void>)
-        => void): void;
+        CoercionTypeOptions & { bodyMode?: MailboxEnums.BodyMode }, callback?:
+        (asyncResult: Office.AsyncResult<void>) => void): void;
       parameters:
         - id: data
           description: >-
-            The string that will replace the existing body. The string is
-            limited to 1,000,000 characters.
+            The string that replaces the existing body. The string is limited to
+            1,000,000 characters.
           type: string
         - id: options
           description: >-
             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.
-            `coercionType`<!-- -->: The desired format for the body. The string
-            in the `data` parameter will be converted to this format.
+            properties. `asyncContext`<!-- -->: Any data you want to access in
+            the callback function. `coercionType`<!-- -->: The desired format
+            for the body. The string in the `data` parameter is converted to
+            this format. `bodyMode`<!-- -->: In Outlook on the web and new
+            Outlook on Windows, specifies whether only the body of the current
+            message or the entire body of a message conversation is set. If a
+            value isn't specified, `bodyMode` defaults to
+            `Office.MailboxEnums.BodyMode.FullBody`<!-- -->, which replaces the
+            entire body, including previous messages in the conversation thread.
+            The `bodyMode` property only applies to replies on the Message
+            Compose surface. It's ignored in Outlook on Windows (classic), on
+            Mac, and on mobile devices.
           type: >-
             <xref uid="office!Office.AsyncContextOptions:interface" /> & <xref
-            uid="outlook!Office.CoercionTypeOptions:interface" />
+            uid="outlook!Office.CoercionTypeOptions:interface" /> & { bodyMode?:
+            <xref uid="outlook!Office.MailboxEnums.BodyMode:enum" /> }
         - id: callback
           description: >-
             Optional. When the method completes, the function passed in the
@@ -1461,6 +1542,35 @@ methods:
       -->.
 
 
+      - In Outlook on the web and new Outlook on Windows, users can organize
+      their messages as conversations or individual messages in **Settings**
+      &gt; **Mail** &gt; **Layout** &gt; **Message organization**
+      (see [Change how the message list is displayed in
+      Outlook](https://support.microsoft.com/office/57fe0cd8-e90b-4b1b-91e4-a0ba658c0042)<!--
+      -->). This setting affects how much of a message's body is displayed to
+      the user (that is, the entire conversation thread of a message or just the
+      current message). In Message Compose mode, particulary for replies in a
+      conversation thread with more than one message, if you want to honor the
+      user's settings when setting the body of a message, specify the `bodyMode:
+      Office.MailboxEnums.BodyMode.HostConfig` parameter in your `setAsync`
+      call. If messages are grouped by conversation, only the body of the
+      current reply is set. Conversely, if messages are displayed individually,
+      the entire body, including previous messages in the conversation thread,
+      is replaced.
+
+
+      - In Outlook on the web and new Outlook on Windows, if the `bodyMode`
+      property isn't specified or is set to
+      `Office.MailboxEnums.BodyMode.FullBody`<!-- -->, the entire body of a
+      message, including previous messages from the conversation thread, is
+      replaced. This applies even if a user's messages are organized by
+      conversation. In this scenario, the user's setting is temporarily changed
+      to **Individual messages: Do not group messages** &gt; **Only a
+      single message** or **Show email as individual messages** during the
+      `setAsync` call. A notification is shown to the user to alert them to this
+      change. Once the call completes, the user's setting is reinstated.
+
+
       **Errors**:
 
 

docs/docs-ref-autogen/outlook/outlook/office.mailboxenums.bodymode.yml

@@ -0,0 +1,59 @@
+### YamlMime:TSEnum
+name: Office.MailboxEnums.BodyMode
+uid: outlook!Office.MailboxEnums.BodyMode:enum
+package: outlook!
+fullName: Office.MailboxEnums.BodyMode
+summary: >-
+  Specifies the portion of a message's body displayed for replies to a
+  conversation thread with more than one message.
+remarks: >-
+  **[Applicable Outlook
+  mode](https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview#extension-points)<!--
+  -->**: Message Compose
+
+
+  **Important**: This enum is only supported in Outlook on the web and new
+  Outlook on Windows. On these platforms, users can organize their messages as
+  conversations or individual messages in **Settings** &gt; **Mail**
+  &gt; **Layout** &gt; **Message organization**. This user setting
+  affects the portion of the body of a message that's displayed.
+
+
+  The `BodyMode` enum supports the following message organization settings.
+
+
+  - Conversations: **Group messages by conversation** &gt; **All messages
+  from the selected conversation** or **Show email grouped by
+  conversation** &gt; **Newest on top**<!-- -->/<!-- -->**Newest on
+  bottom**
+
+
+  - Individual messages: **Do not group messages** &gt; **Only a single
+  message** or **Show email as individual messages**
+
+
+  For more information, see [Change how the message list is displayed in
+  Outlook](https://support.microsoft.com/office/57fe0cd8-e90b-4b1b-91e4-a0ba658c0042)<!--
+  -->.
+
+isPreview: false
+isDeprecated: false
+fields:
+  - name: FullBody
+    uid: outlook!Office.MailboxEnums.BodyMode.FullBody:member
+    package: outlook!
+    summary: >-
+      The entire body of a message, including previous messages from the same
+      conversation thread.
+    value: '0'
+  - name: HostConfig
+    uid: outlook!Office.MailboxEnums.BodyMode.HostConfig:member
+    package: outlook!
+    summary: >-
+      The body mode depends on the user's current setting for message
+      organization (that is, messages are organized as conversations or
+      individual messages). If messages are organized by conversation, it
+      specifies only the current body of the reply. Conversely, if messages are
+      organized as individual messages, it specifies the entire body of a
+      message, including previous messages from the same conversation thread.
+    value: '1'

docs/docs-ref-autogen/outlook/toc.yml

@@ -23,6 +23,8 @@ items:
                 uid: outlook!Office.MailboxEnums.AttachmentStatus:enum
               - name: AttachmentType
                 uid: outlook!Office.MailboxEnums.AttachmentType:enum
+              - name: BodyMode
+                uid: outlook!Office.MailboxEnums.BodyMode:enum
               - name: CategoryColor
                 uid: outlook!Office.MailboxEnums.CategoryColor:enum
               - name: ComposeType

docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.tableaddoptions.yml

@@ -246,7 +246,7 @@ properties:
       If provided, specifies properties for each cell in the table.
 
 
-      This should be an 2D array with the same number of rows and columns as the
+      This should be a 2D array with the same number of rows and columns as the
       table. If a cell doesn't require specific formatting, specify an empty
       object for that cell. Only the top left cell of a merged are can have
       properties specified, which will be applied to the entire merged area. For
@@ -407,7 +407,7 @@ properties:
 
 
       To apply specific formatting to individual cells, use
-      specificCellProperties.
+      `specificCellProperties`<!-- -->.
 
 
       If both uniformCellProperties and specificCellProperties are undefined,
@@ -417,7 +417,7 @@ properties:
 
 
       To provide a plain appearance for the table, set this property to an empty
-      object and don't specify specificCellProperties.
+      object and don't specify `specificCellProperties`<!-- -->.
     remarks: >-
       \[ [API set: PowerPointApi
       1.8](/javascript/api/requirement-sets/powerpoint/powerpoint-api-requirement-sets)

docs/docs-ref-autogen/powerpoint/powerpoint/powerpoint.textverticalalignment.yml

@@ -6,8 +6,8 @@ fullName: PowerPoint.TextVerticalAlignment
 summary: >-
   Represents the vertical alignment of a
   [PowerPoint.TextFrame](xref:powerpoint!PowerPoint.TextFrame:class) in a
-  [PowerPoint.Shape](xref:powerpoint!PowerPoint.Shape:class)<!-- -->. If one the
-  centered options are selected, the contents of the `TextFrame` will be
+  [PowerPoint.Shape](xref:powerpoint!PowerPoint.Shape:class)<!-- -->. If one of
+  the centered options is selected, the contents of the `TextFrame` will be
   centered horizontally within the `Shape` as a group. To change the horizontal
   alignment of a text, see
   [PowerPoint.ParagraphFormat](xref:powerpoint!PowerPoint.ParagraphFormat:class)

docs/docs-ref-autogen/powerpoint_1_4/powerpoint/powerpoint.textverticalalignment.yml

@@ -6,8 +6,8 @@ fullName: PowerPoint.TextVerticalAlignment
 summary: >-
   Represents the vertical alignment of a
   [PowerPoint.TextFrame](xref:powerpoint!PowerPoint.TextFrame:class) in a
-  [PowerPoint.Shape](xref:powerpoint!PowerPoint.Shape:class)<!-- -->. If one the
-  centered options are selected, the contents of the `TextFrame` will be
+  [PowerPoint.Shape](xref:powerpoint!PowerPoint.Shape:class)<!-- -->. If one of
+  the centered options is selected, the contents of the `TextFrame` will be
   centered horizontally within the `Shape` as a group. To change the horizontal
   alignment of a text, see
   [PowerPoint.ParagraphFormat](xref:powerpoint!PowerPoint.ParagraphFormat:class)

docs/docs-ref-autogen/powerpoint_1_5/powerpoint/powerpoint.textverticalalignment.yml

@@ -6,8 +6,8 @@ fullName: PowerPoint.TextVerticalAlignment
 summary: >-
   Represents the vertical alignment of a
   [PowerPoint.TextFrame](xref:powerpoint!PowerPoint.TextFrame:class) in a
-  [PowerPoint.Shape](xref:powerpoint!PowerPoint.Shape:class)<!-- -->. If one the
-  centered options are selected, the contents of the `TextFrame` will be
+  [PowerPoint.Shape](xref:powerpoint!PowerPoint.Shape:class)<!-- -->. If one of
+  the centered options is selected, the contents of the `TextFrame` will be
   centered horizontally within the `Shape` as a group. To change the horizontal
   alignment of a text, see
   [PowerPoint.ParagraphFormat](xref:powerpoint!PowerPoint.ParagraphFormat:class)

docs/docs-ref-autogen/powerpoint_1_6/powerpoint/powerpoint.textverticalalignment.yml

@@ -6,8 +6,8 @@ fullName: PowerPoint.TextVerticalAlignment
 summary: >-
   Represents the vertical alignment of a
   [PowerPoint.TextFrame](xref:powerpoint!PowerPoint.TextFrame:class) in a
-  [PowerPoint.Shape](xref:powerpoint!PowerPoint.Shape:class)<!-- -->. If one the
-  centered options are selected, the contents of the `TextFrame` will be
+  [PowerPoint.Shape](xref:powerpoint!PowerPoint.Shape:class)<!-- -->. If one of
+  the centered options is selected, the contents of the `TextFrame` will be
   centered horizontally within the `Shape` as a group. To change the horizontal
   alignment of a text, see
   [PowerPoint.ParagraphFormat](xref:powerpoint!PowerPoint.ParagraphFormat:class)

docs/docs-ref-autogen/powerpoint_1_7/powerpoint/powerpoint.textverticalalignment.yml

@@ -6,8 +6,8 @@ fullName: PowerPoint.TextVerticalAlignment
 summary: >-
   Represents the vertical alignment of a
   [PowerPoint.TextFrame](xref:powerpoint!PowerPoint.TextFrame:class) in a
-  [PowerPoint.Shape](xref:powerpoint!PowerPoint.Shape:class)<!-- -->. If one the
-  centered options are selected, the contents of the `TextFrame` will be
+  [PowerPoint.Shape](xref:powerpoint!PowerPoint.Shape:class)<!-- -->. If one of
+  the centered options is selected, the contents of the `TextFrame` will be
   centered horizontally within the `Shape` as a group. To change the horizontal
   alignment of a text, see
   [PowerPoint.ParagraphFormat](xref:powerpoint!PowerPoint.ParagraphFormat:class)