Skip to content

Commit a07bc2e

Browse files
Merge pull request #6601 from MicrosoftDocs/niels9001/sound
Fix Sound ToC ordering and remove Sound tile from Design overview
2 parents 9ccfae3 + 7b89bb7 commit a07bc2e

5 files changed

Lines changed: 19 additions & 23 deletions

File tree

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
11
{
22
"redirections": [
3+
{
4+
"source_path": "hub/apps/design/style/sound.md",
5+
"redirect_url": "/windows/apps/develop/ui/sound",
6+
"redirect_document_id": false
7+
},
38
{
49
"source_path": "hub/apps/design/app-settings/store-and-retrieve-app-data.md",
510
"redirect_url": "/windows/apps/develop/data/store-and-retrieve-app-data",

hub/apps/design/guidelines-overview.md

Lines changed: 5 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -68,11 +68,6 @@ Use these fundamentals as a guide throughout your design process—whether you'r
6868
:::column-end:::
6969
:::row-end:::
7070
:::row:::
71-
:::column:::
72-
[![Sound icon](./images/tile-sound.png)](./style/sound.md)<br>
73-
**[Sound](./style/sound.md)**<br>
74-
Use audio cues to provide feedback, reinforce actions, and support accessibility.
75-
:::column-end:::
7671
:::column:::
7772
[![Typography icon](./images/tile-typography.png)](./signature-experiences/typography.md)<br>
7873
**[Typography](./signature-experiences/typography.md)**<br>
@@ -83,19 +78,21 @@ Use these fundamentals as a guide throughout your design process—whether you'r
8378
**[Usability](./usability/index.md)**<br>
8479
Ensure your app is easy to use through intuitive interactions, clear affordances, and accessibility.
8580
:::column-end:::
86-
:::row-end:::
87-
88-
:::row:::
8981
:::column:::
9082
[![Widgets icon](./images/tile-widgets.png)](./widgets/index.md)<br>
9183
**[Widgets](./widgets/index.md)**<br>
9284
Extend your app with glanceable, interactive surfaces that surface key information and actions.
9385
:::column-end:::
86+
:::row-end:::
87+
88+
:::row:::
9489
:::column:::
9590
[![Writing icon](./images/tile-writing.png)](style/writing-style.md )<br>
9691
**[Writing](./style/writing-style.md )**<br>
9792
Use clear, concise, and helpful language to improve understanding and reduce cognitive load.
9893
:::column-end:::
9994
:::column:::
10095
:::column-end:::
96+
:::column:::
97+
:::column-end:::
10198
:::row-end:::

hub/apps/design/toc.yml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -68,8 +68,6 @@ items:
6868
href: motion/directionality-and-gravity.md
6969
- name: Navigation
7070
href: basics/navigation-basics.md
71-
- name: Sound
72-
href: style/sound.md
7371
- name: Typography
7472
href: signature-experiences/typography.md
7573
- name: Usability

hub/apps/develop/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -989,6 +989,8 @@ items:
989989
href: ui/layouts-with-xaml.md
990990
- name: Shadows
991991
href: ui/shadows.md
992+
- name: Sound
993+
href: ui/sound.md
992994
- name: Windowing
993995
items:
994996
- name: Overview
Lines changed: 7 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -3,19 +3,14 @@ description: Sound helps complete an application's user experience, and gives th
33
label: Sound
44
title: Sound
55
template: detail.hbs
6-
ms.assetid: 9fa77494-2525-4491-8f26-dc733b6a18f6
7-
ms.date: 05/19/2017
6+
ms.date: 04/08/2026
87
ms.topic: how-to
98
keywords: windows 10, winui
10-
pm-contact: kisai
11-
design-contact: mattben
12-
dev-contact: joyate
13-
doc-status: Published
149
ms.localizationpriority: medium
1510
---
1611
# Sound
1712

18-
![hero image](images/header-sound.svg)
13+
![hero image](../../design/style/images/header-sound.svg)
1914

2015
There are many ways to use sound to enhance your app. You can use to sound to supplement other UI elements, enabling users to recognize events audibly. Sound can be an effective user interface element for people with visual disabilities. You can use sound to create an atmosphere that immerses the user; for example, you might play a whimsical soundtrack in the background of puzzle game, or use ominous sound effects for a horror/survival game.
2116

@@ -31,9 +26,9 @@ There are many ways to use sound to enhance your app. You can use to sound to su
3126

3227
## Sound Global API
3328

34-
UWP provides an easily accessible sound system that allows you to simply "flip a switch" and get an immersive audio experience across your entire app.
29+
WinUI provides an easily accessible sound system that allows you to simply "flip a switch" and get an immersive audio experience across your entire app.
3530

36-
The [**ElementSoundPlayer**](/uwp/api/windows.ui.xaml.elementsoundplayer) is an integrated sound system within XAML, and when turned on all default controls will play sounds automatically.
31+
The [**ElementSoundPlayer**](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.elementsoundplayer) is an integrated sound system within XAML, and when turned on all default controls will play sounds automatically.
3732
```C#
3833
ElementSoundPlayer.State = ElementSoundPlayerState.On;
3934
```
@@ -88,7 +83,7 @@ Each sound relates to a certain basic user interaction, and although sounds can
8883

8984
The most common control-triggered sound in our system today is the **Invoke** sound. This sound plays when a user invokes a control through a tap/click/enter/space or press of the 'A' button on a gamepad.
9085

91-
Typically, this sound is only played when a user explicitly targets a simple control or control part through an [input device](../input/index.md).
86+
Typically, this sound is only played when a user explicitly targets a simple control or control part through an [input device](../../design/input/index.md).
9287

9388

9489
To play this sound from any control event, simply call the Play method from **ElementSoundPlayer** and pass in **ElementSound.Invoke**:
@@ -112,7 +107,7 @@ ElementSoundPlayer.Play(ElementSoundKind.Hide);
112107
```
113108
### Navigation Within a Page
114109

115-
When navigating between panels or views within an app's page (see [NavigationView](../controls/navigationview.md)), there is typically bidirectional movement. Meaning you can move to the next view/panel or the previous one, without leaving the current app page you're on.
110+
When navigating between panels or views within an app's page (see [NavigationView](../../design/controls/navigationview.md)), there is typically bidirectional movement. Meaning you can move to the next view/panel or the previous one, without leaving the current app page you're on.
116111

117112
The audio experience around this navigation concept is encompassed by the **MovePrevious** and **MoveNext** sounds.
118113

@@ -152,5 +147,4 @@ The purpose behind this cycling feature is to keep the focus sounds from becomin
152147

153148
## Related articles
154149

155-
* [Designing for Xbox and TV](../devices/designing-for-tv.md)
156-
* [ElementSoundPlayer class documentation](/uwp/api/windows.ui.xaml.elementsoundplayer)
150+
* [ElementSoundPlayer class documentation](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.elementsoundplayer)

0 commit comments

Comments
 (0)