diff --git a/docs/design/keyboard-shortcuts.md b/docs/design/keyboard-shortcuts.md index 060934361..b34487864 100644 --- a/docs/design/keyboard-shortcuts.md +++ b/docs/design/keyboard-shortcuts.md @@ -23,9 +23,11 @@ Keyboard shortcuts are currently only supported in the following platforms and b - Office on the web - Office on Windows - **Excel**: Version 2102 (Build 13801.20632) and later + - **PowerPoint**: Version TBD (Build TBD) and later - **Word**: Version 2408 (Build 17928.20114) and later - Office on Mac - **Excel**: Version 16.55 (21111400) and later + - **PowerPoint**: Version TBD (Build TBD) and later - **Word**: Version 16.88 (24081116) and later Additionally, keyboard shortcuts only work on platforms that support the following requirement sets. For information about requirement sets and how to work with them, see [Specify Office applications and API requirements](../develop/specify-office-hosts-and-api-requirements.md). @@ -261,8 +263,9 @@ When using custom keyboard shortcuts on the web, some keyboard shortcuts that ar There are many keyboard shortcuts that are already in use by Microsoft 365. Avoid registering keyboard shortcuts for your add-in that are already in use. However, there may be some instances where it's necessary to override existing keyboard shortcuts or handle conflicts between multiple add-ins that have registered the same keyboard shortcut. In the case of a conflict, the user will see a dialog box the first time they attempt to use a conflicting keyboard shortcut. Note that the source of the text for the add-in option that's displayed in this dialog varies depending on the type of manifest your add-in uses. - - **Unified app manifest for Microsoft 365**: The value of the `"extensions.runtimes.actions.displayName"` property in the **manifest.json** file. - - **Add-in only manifest**: The value of the `"actions.name"` property in the shortcuts JSON file. + +- **Unified app manifest for Microsoft 365**: The value of the `"extensions.runtimes.actions.displayName"` property in the **manifest.json** file. +- **Add-in only manifest**: The value of the `"actions.name"` property in the shortcuts JSON file. ![A conflict modal with two different actions for a single shortcut.](../images/add-in-shortcut-conflict-modal.png) @@ -273,8 +276,9 @@ The user can select which action the keyboard shortcut will take. After making t For the best user experience, we recommend that you minimize keyboard shortcut conflicts with these good practices. - Use only keyboard shortcuts with the following pattern: Ctrl+Shift+Alt+*x*, where *x* is some other key. -- Avoid using established keyboard shortcuts in Excel and Word. For a list, see the following: +- Avoid using established keyboard shortcuts in Excel, PowerPoint, and Word. For a list, see the following: - [Keyboard shortcuts in Excel](https://support.microsoft.com/office/1798d9d5-842a-42b8-9c99-9b7213f0040f) + - [Keyboard shortcuts in PowerPoint](https://support.microsoft.com/office/ebb3d20e-dcd4-444f-a38e-bb5c5ed180f4) - [Keyboard shortcuts in Word](https://support.microsoft.com/office/95ef89dd-7142-4b50-afb2-f762f663ceb2) - When the keyboard focus is inside the add-in UI, Ctrl+Space and Ctrl+Shift+F10 won't work as these are essential accessibility shortcuts. - On a Windows or Mac computer, if the **Reset Office Add-ins shortcut preferences** command isn't available on the search menu, the user can manually add the command to the ribbon by customizing the ribbon through the context menu. @@ -443,7 +447,7 @@ Office.actions.areShortcutsInUse(shortcuts) ## Implement custom keyboard shortcuts across supported Microsoft 365 apps -You can implement a custom keyboard shortcut to be used across supported Microsoft 365 apps, such as Excel and Word. If the implementation to perform the same task is different on each app, you must use the `Office.actions.associate` method to call a different callback function for each app. The following code is an example. +You can implement a custom keyboard shortcut to be used across supported Microsoft 365 apps, such as Excel, PowerPoint, and Word. If the implementation to perform the same task is different on each app, you must use the `Office.actions.associate` method to call a different callback function for each app. The following code is an example. ```javascript const host = Office.context.host; diff --git a/docs/develop/configure-your-add-in-to-use-a-shared-runtime.md b/docs/develop/configure-your-add-in-to-use-a-shared-runtime.md index aed58bb40..1d6b445b1 100644 --- a/docs/develop/configure-your-add-in-to-use-a-shared-runtime.md +++ b/docs/develop/configure-your-add-in-to-use-a-shared-runtime.md @@ -229,7 +229,7 @@ Configuring a shared runtime enables the following scenarios. - [Change the availability of add-in commands](../design/disable-add-in-commands.md) - [Run code in your Office Add-in when the document opens](run-code-on-document-open.md) - [Show or hide the task pane of your Office Add-in](show-hide-add-in.md) - - [Add custom keyboard shortcuts to your Office Add-ins](../design/keyboard-shortcuts.md) (supported in Excel and Word add-ins only) + - [Add custom keyboard shortcuts to your Office Add-ins](../design/keyboard-shortcuts.md) (supported in Excel, PowerPoint, and Word add-ins) - The following are available for Excel add-ins only. - [Create custom contextual tabs in Office Add-ins](../design/contextual-tabs.md) - Custom functions will have full CORS support. diff --git a/docs/develop/develop-overview.md b/docs/develop/develop-overview.md index 041822130..e21ec868a 100644 --- a/docs/develop/develop-overview.md +++ b/docs/develop/develop-overview.md @@ -64,7 +64,7 @@ An Office Add-in's manifest defines the settings and capabilities of the add-in. - Location of images that the add-in uses for branding and command iconography. - Dimensions of the add-in (for example, dimensions for content add-ins, requested height for Outlook add-ins). - Rules that specify when the add-in activates in the context of a message or appointment (for Outlook add-ins only). -- Keyboard shortcuts (for Excel and Word add-ins only). +- Keyboard shortcuts (for Excel, PowerPoint, and Word add-ins only). For detailed information about the manifest, see [Office Add-ins manifest](add-in-manifests.md).