Skip to content

Commit abf74c9

Browse files
committed
Moving Sound
1 parent 1f46eaa commit abf74c9

5 files changed

Lines changed: 21 additions & 17 deletions

File tree

.openpublishing.redirection.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,15 @@
11
{
22
"redirections": [
3+
{
4+
"source_path": "hub/apps/design/widgets/widgets-create-a-template.md",
5+
"redirect_url": "/windows/apps/develop/widgets/widgets-create-a-template",
6+
"redirect_document_id": true
7+
},
8+
{
9+
"source_path": "hub/apps/design/style/sound.md",
10+
"redirect_url": "/windows/apps/develop/ui/sound",
11+
"redirect_document_id": true
12+
},
313
{
414
"source_path": "uwp/audio-video-camera/camera-ui-features-for-mobile-devices.md",
515
"redirect_url": "/previous-versions/windows/uwp/audio-video-camera/camera-ui-features-for-mobile-devices",

hub/apps/design/guidelines-overview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -69,8 +69,8 @@ Use these fundamentals as a guide throughout your design process—whether you'r
6969
:::row-end:::
7070
:::row:::
7171
:::column:::
72-
[![Sound icon](./images/tile-sound.png)](./style/sound.md)<br>
73-
**[Sound](./style/sound.md)**<br>
72+
[![Sound icon](./images/tile-sound.png)](../develop/ui/sound.md)<br>
73+
**[Sound](../develop/ui/sound.md)**<br>
7474
Use audio cues to provide feedback, reinforce actions, and support accessibility.
7575
:::column-end:::
7676
:::column:::

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
@@ -752,6 +752,8 @@ items:
752752
href: ui/alignment-margin-padding.md
753753
- name: Colors and themes
754754
href: ui/theming.md
755+
- name: Sound
756+
href: ui/sound.md
755757
- name: Controls
756758
items:
757759
- 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)