Skip to content

Commit bcb5b83

Browse files
drewbatgitCopilot
andcommitted
Fix filename prefix: app-notification -> app-notifications
Co-authored-by: Copilot <[email protected]>
1 parent a5bec3d commit bcb5b83

18 files changed

Lines changed: 58 additions & 41 deletions

hub/apps/develop/notifications/app-notifications/adaptive-interactive-toasts.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -25,13 +25,13 @@ App notifications are defined with an XML payload that is defined by the [App no
2525

2626
**Install Notifications Visualizer.** This free Windows app helps you design interactive app notifications by providing an instant visual preview of your toast as you edit it, similar to Visual Studio's XAML editor/design view. See [Notifications Visualizer](../notifications-visualizer.md) for more information, or [download Notifications Visualizer from the Store](https://apps.microsoft.com/detail/9nblggh5xsl1).
2727

28-
This article only covers creating the app notification content. For information on sending a notification after you have generated the XML payload, see [Send a local app notification](app-notification-csharp-legacy.md).
28+
This article only covers creating the app notification content. For information on sending a notification after you have generated the XML payload, see [Send a local app notification](app-notifications-csharp-legacy.md).
2929

3030
## App notification structure
3131

3232
Some important, high-level components of an app notification XML payload include:
3333

34-
- **toast**: The **launch** attribute of this element defines what arguments will be passed back to your app when the user clicks your toast, allowing you to deep link into the correct content that the toast was displaying. To learn more, see [Send a local app notification](app-notification-csharp-legacy.md).
34+
- **toast**: The **launch** attribute of this element defines what arguments will be passed back to your app when the user clicks your toast, allowing you to deep link into the correct content that the toast was displaying. To learn more, see [Send a local app notification](app-notifications-csharp-legacy.md).
3535
- **visual**: This element represents visual portion of the toast, including the generic binding that contains text and images.
3636
- **actions**: This element represents interactive portion of the toast, including inputs and actions.
3737
- **audio**: This element specifies the audio played when the toast is shown to the user.
@@ -366,7 +366,7 @@ Here's an example where columns and some advanced adaptive text elements are use
366366

367367
Buttons make your toast interactive, letting the user take quick actions on your app notification without interrupting their current workflow. For example, users can reply to a message directly from within a toast, or delete an email without even opening the email app. Buttons appear in the expanded portion of your notification.
368368

369-
To learn more about implementing buttons end-to-end, see [Send local toast](app-notification-csharp-legacy.md).
369+
To learn more about implementing buttons end-to-end, see [Send local toast](app-notifications-csharp-legacy.md).
370370

371371
Buttons can activate an app in the following ways:
372372

@@ -969,10 +969,11 @@ Your tiles and app notifications can load strings and images tailored for displa
969969

970970

971971
## Handling activation
972-
To learn how to handle app activations (the user clicking your toast or buttons on the toast), see [Send local toast](app-notification-csharp-legacy.md).
972+
To learn how to handle app activations (the user clicking your toast or buttons on the toast), see [Send local toast](app-notifications-csharp-legacy.md).
973973

974974
## Related topics
975975

976-
* [Send a local toast and handle activation](app-notification-csharp-legacy.md)
976+
* [Send a local toast and handle activation](app-notifications-csharp-legacy.md)
977977
* [Tile and toast notification support for language, scale, and high contrast](/windows/uwp/launch-resume/tile-toast-language-scale-contrast)
978978

979+

hub/apps/develop/notifications/app-notifications/app-notification-console.md renamed to hub/apps/develop/notifications/app-notifications/app-notifications-console.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ An app notification is a message that your app can construct and deliver to your
1616
This article walks you through the steps to send and handle app notifications from a .NET console app using the [Windows App SDK](/windows/apps/windows-app-sdk/). The Windows App SDK `Microsoft.Windows.AppNotifications` APIs handle all the complexity of notification registration and activation for both packaged and unpackaged apps.
1717

1818
> [!NOTE]
19-
> For WinUI apps, see [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md). For other app types, see [WPF](app-notification-wpf.md), [WinForms](app-notification-winforms.md), or [UWP](app-notification-uwp.md).
19+
> For WinUI apps, see [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md). For other app types, see [WPF](app-notifications-wpf.md), [WinForms](app-notifications-winforms.md), or [UWP](app-notifications-uwp.md).
2020
2121
> [!IMPORTANT]
2222
> Notifications for elevated (admin) apps are not currently supported.
@@ -145,3 +145,4 @@ AppNotificationManager.Default.Unregister();
145145
- [AppNotificationManager Class](/windows/windows-app-sdk/api/winrt/microsoft.windows.appnotifications.appnotificationmanager)
146146
- [AppNotificationBuilder Class](/windows/windows-app-sdk/api/winrt/microsoft.windows.appnotifications.builder.appnotificationbuilder)
147147

148+

hub/apps/develop/notifications/app-notifications/app-notification-cpp-uwp.md renamed to hub/apps/develop/notifications/app-notifications/app-notifications-cpp-uwp.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ This quickstart walks you through the steps to create, deliver, and display a Wi
2222
> The term "toast notification" is being replaced with "app notification". These terms both refer to the same feature of Windows, but over time we will phase out the use of "toast notification" in the documentation.
2323
2424
> [!IMPORTANT]
25-
> If you're writing a C++ non-UWP app, please see the [C++ WRL](app-notification-cpp-wrl.md) documentation. If you're writing a C# app, please see the [C# documentation](app-notification-csharp-legacy.md).
25+
> If you're writing a C++ non-UWP app, please see the [C++ WRL](app-notifications-cpp-wrl.md) documentation. If you're writing a C# app, please see the [C# documentation](app-notifications-csharp-legacy.md).
2626
2727
> [!NOTE]
2828
> For C++ apps using the Windows App SDK, see [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md) which covers the recommended approach using the `Microsoft.Windows.AppNotifications` APIs.
@@ -381,3 +381,4 @@ toastManager.History().Clear();
381381
* [ToastNotification Class](/uwp/api/Windows.UI.Notifications.ToastNotification)
382382
* [ToastNotificationActivatedEventArgs Class](/uwp/api/Windows.ApplicationModel.Activation.ToastNotificationActivatedEventArgs)
383383

384+

hub/apps/develop/notifications/app-notifications/app-notification-cpp-wrl.md renamed to hub/apps/develop/notifications/app-notifications/app-notifications-cpp-wrl.md

File renamed without changes.

hub/apps/develop/notifications/app-notifications/app-notification-csharp-legacy.md renamed to hub/apps/develop/notifications/app-notifications/app-notifications-csharp-legacy.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ This quickstart walks you through the steps to create, deliver, and display a Wi
2222
> The term "toast notification" is being replaced with "app notification".These terms both refer to the same feature of Windows, but over time we will phase out the use of "toast notification" in the documentation.
2323
2424
> [!IMPORTANT]
25-
> If you're writing a C++ app, please see the [C++ UWP](app-notification-cpp-uwp.md) or [C++ WRL](app-notification-cpp-wrl.md) documentation.
25+
> If you're writing a C++ app, please see the [C++ UWP](app-notifications-cpp-uwp.md) or [C++ WRL](app-notifications-cpp-wrl.md) documentation.
2626
2727
## Step 1: Add namespace references
2828

@@ -440,3 +440,4 @@ await AppNotificationManager.Default.RemoveAllAsync();
440440
* [ToastNotification Class](/uwp/api/Windows.UI.Notifications.ToastNotification)
441441
* [ToastNotificationActivatedEventArgs Class](/uwp/api/Windows.ApplicationModel.Activation.ToastNotificationActivatedEventArgs)
442442

443+

hub/apps/develop/notifications/app-notifications/app-notification-other-apps.md renamed to hub/apps/develop/notifications/app-notifications/app-notifications-other-apps.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ An app notification is a message that an app can construct and deliver to the us
2424
> The term "toast notification" is being replaced with "app notification". These terms both refer to the same feature of Windows, but over time we will phase out the use of "toast notification" in the documentation.
2525
2626
> [!IMPORTANT]
27-
> If you're writing a C# app, then please see the [C# documentation](app-notification-csharp-legacy.md). If you're writing a C++ app, the please see the [C++ UWP](app-notification-cpp-uwp.md) or [C++ WRL](app-notification-cpp-wrl.md) documentation.
27+
> If you're writing a C# app, then please see the [C# documentation](app-notifications-csharp-legacy.md). If you're writing a C++ app, the please see the [C++ UWP](app-notifications-cpp-uwp.md) or [C++ WRL](app-notifications-cpp-wrl.md) documentation.
2828
2929
> [!NOTE]
3030
> If your app can use the Windows App SDK, see [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md) for the recommended approach.
@@ -126,3 +126,4 @@ Your COM activator will be activated when your notification is clicked.
126126
127127
The AUMID should be at most 129 characters long. If the AUMID is more than 129 characters long, scheduled app notifications won't work - you'll get the following exception when adding a scheduled notification: *The data area passed to a system call is too small. (0x8007007A)*.
128128
129+

hub/apps/develop/notifications/app-notifications/app-notification-uwp.md renamed to hub/apps/develop/notifications/app-notifications/app-notifications-uwp.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ This article walks you through the steps to send and handle app notifications fr
1919
> For new desktop apps, we recommend using the [Windows App SDK](/windows/apps/windows-app-sdk/) instead. See [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md) for the recommended approach using the `Microsoft.Windows.AppNotifications` APIs.
2020
2121
> [!NOTE]
22-
> For other app types, see [WPF](app-notification-wpf.md), [WinForms](app-notification-winforms.md), or [Console](app-notification-console.md).
22+
> For other app types, see [WPF](app-notifications-wpf.md), [WinForms](app-notifications-winforms.md), or [Console](app-notifications-console.md).
2323
2424
## Prerequisites
2525

@@ -310,3 +310,4 @@ Background task registration and handling in C++ follows the same pattern. For d
310310
- [ToastNotification Class](/uwp/api/Windows.UI.Notifications.ToastNotification)
311311
- [ToastNotificationActivatedEventArgs Class](/uwp/api/Windows.ApplicationModel.Activation.ToastNotificationActivatedEventArgs)
312312

313+

hub/apps/develop/notifications/app-notifications/app-notification-winforms.md renamed to hub/apps/develop/notifications/app-notifications/app-notifications-winforms.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ An app notification is a message that your app can construct and deliver to your
1616
This article walks you through the steps to send and handle app notifications from a WinForms app using the [Windows App SDK](/windows/apps/windows-app-sdk/). The Windows App SDK `Microsoft.Windows.AppNotifications` APIs handle all the complexity of notification registration and activation for both packaged and unpackaged apps.
1717

1818
> [!NOTE]
19-
> For WinUI apps, see [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md). For other app types, see [WPF](app-notification-wpf.md), [Console](app-notification-console.md), or [UWP](app-notification-uwp.md).
19+
> For WinUI apps, see [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md). For other app types, see [WPF](app-notifications-wpf.md), [Console](app-notifications-console.md), or [UWP](app-notifications-uwp.md).
2020
2121
> [!IMPORTANT]
2222
> Notifications for elevated (admin) apps are not currently supported.
@@ -160,7 +160,7 @@ AppNotificationManager.Default.Show(notification);
160160

161161
## Packaged app setup
162162

163-
For unpackaged WinForms apps, `Register()` handles COM registration automatically. For packaged apps (MSIX), you need to add extensions to your `Package.appxmanifest`. See [Packaged app setup](app-notification-wpf.md#packaged-app-setup) in the WPF article for the required manifest entries.
163+
For unpackaged WinForms apps, `Register()` handles COM registration automatically. For packaged apps (MSIX), you need to add extensions to your `Package.appxmanifest`. See [Packaged app setup](app-notifications-wpf.md#packaged-app-setup) in the WPF article for the required manifest entries.
164164

165165
## Related content
166166

@@ -169,3 +169,4 @@ For unpackaged WinForms apps, `Register()` handles COM registration automaticall
169169
- [AppNotificationManager Class](/windows/windows-app-sdk/api/winrt/microsoft.windows.appnotifications.appnotificationmanager)
170170
- [AppNotificationBuilder Class](/windows/windows-app-sdk/api/winrt/microsoft.windows.appnotifications.builder.appnotificationbuilder)
171171

172+

hub/apps/develop/notifications/app-notifications/app-notification-wpf.md renamed to hub/apps/develop/notifications/app-notifications/app-notifications-wpf.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ An app notification is a message that your app can construct and deliver to your
1616
This article walks you through the steps to send and handle app notifications from a WPF app using the [Windows App SDK](/windows/apps/windows-app-sdk/). The Windows App SDK `Microsoft.Windows.AppNotifications` APIs handle all the complexity of notification registration and activation for both packaged and unpackaged apps.
1717

1818
> [!NOTE]
19-
> For WinUI apps, see [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md). For other app types, see [WinForms](app-notification-winforms.md), [Console](app-notification-console.md), or [UWP](app-notification-uwp.md).
19+
> For WinUI apps, see [Quickstart: App notifications in the Windows App SDK](app-notifications-quickstart.md). For other app types, see [WinForms](app-notifications-winforms.md), [Console](app-notifications-console.md), or [UWP](app-notifications-uwp.md).
2020
2121
> [!IMPORTANT]
2222
> Notifications for elevated (admin) apps are not currently supported.
@@ -254,3 +254,4 @@ For unpackaged WPF apps, `Register()` handles COM registration automatically. Fo
254254
- [AppNotificationManager Class](/windows/windows-app-sdk/api/winrt/microsoft.windows.appnotifications.appnotificationmanager)
255255
- [AppNotificationBuilder Class](/windows/windows-app-sdk/api/winrt/microsoft.windows.appnotifications.builder.appnotificationbuilder)
256256

257+

hub/apps/develop/notifications/app-notifications/custom-audio-on-toasts.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -77,12 +77,13 @@ Supported audio file sources:
7777

7878
## Send the notification
7979

80-
Sending a notification with audio is the same as sending a regular notification. For Windows App SDK apps, use `AppNotificationManager.Default.Show()`. See [Send local toast](app-notification-csharp-legacy.md) to learn more.
80+
Sending a notification with audio is the same as sending a regular notification. For Windows App SDK apps, use `AppNotificationManager.Default.Show()`. See [Send local toast](app-notifications-csharp-legacy.md) to learn more.
8181

8282

8383
## Related topics
8484

8585
- [Full code sample on GitHub](https://github.com/WindowsNotifications/quickstart-toast-with-custom-audio)
86-
- [Send a local toast](app-notification-csharp-legacy.md)
86+
- [Send a local toast](app-notifications-csharp-legacy.md)
8787
- [Toast content documentation](adaptive-interactive-toasts.md)
8888

89+

0 commit comments

Comments
 (0)