Skip to content

Commit 11d47d0

Browse files
committed
docs: design-style
Modernize documentation by updating legacy references. Batch: design-style Files changed: 2 Proposals applied: 3
1 parent 25a3c6f commit 11d47d0

2 files changed

Lines changed: 12 additions & 35 deletions

File tree

hub/apps/design/style/mica.md

Lines changed: 2 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -120,20 +120,12 @@ To give your app's window a seamless look, Mica Alt should be visible in the tit
120120
121121
[!INCLUDE [winui-3-gallery](../../../includes/winui-3-gallery.md)]
122122

123-
## How to use Mica
123+
### How to use Mica
124124

125-
You can use Mica in UWP apps that use WinUI for UWP, or in apps that use Windows App SDK 1.1 or later. You can use Mica Alt in apps that use Windows App SDK 1.1 or later.
126-
127-
### Use Mica with the Windows App SDK
128-
129-
To use Mica in a WinUI XAML app, see [Apply Mica or Acrylic materials in desktop apps for Windows 11](../../develop/ui/system-backdrops.md).
125+
To use Mica in a WinUI app, see [Apply Mica or Acrylic materials in desktop apps for Windows 11](../../develop/ui/system-backdrops.md).
130126

131127
To use Mica in a Win32 app, see [Apply Mica in Win32 desktop apps for Windows 11](../../desktop/modernize/ui/apply-mica-win32.md).
132128

133-
### Use Mica with WinUI for UWP
134-
135-
To use Mica in a UWP app with WinUI for UWP, see [Apply Mica with WinUI for UWP](/windows/uwp/ui-input/mica-uwp).
136-
137129
## Related articles
138130

139131
- [Materials](../signature-experiences/materials.md)

hub/apps/design/style/sound.md

Lines changed: 10 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ template: detail.hbs
66
ms.assetid: 9fa77494-2525-4491-8f26-dc733b6a18f6
77
ms.date: 05/19/2017
88
ms.topic: how-to
9-
keywords: windows 10, uwp
9+
keywords: windows 10, winui
1010
pm-contact: kisai
1111
design-contact: mattben
1212
dev-contact: joyate
@@ -21,19 +21,13 @@ There are many ways to use sound to enhance your app. You can use to sound to su
2121

2222
## Examples
2323

24-
<table>
25-
<th align="left">WinUI for UWP Gallery<th>
26-
<tr>
27-
<td><img src="images/xaml-controls-gallery-sm.png" alt="WinUI 3 Gallery"></img></td>
28-
<td>
29-
<p>If you have the <strong>WinUI for UWP Gallery</strong> app installed, click here to <a href="winui2gallery:/item/Sound">open the app and see Sound in action</a>.</p>
30-
<ul>
31-
<li><a href="https://apps.microsoft.com/detail/9MSVH128X2ZT">Get the WinUI for UWP Gallery app (Microsoft Store)</a></li>
32-
<li><a href="https://github.com/Microsoft/WinUI-Gallery">Get the source code (GitHub)</a></li>
33-
</ul>
34-
</td>
35-
</tr>
36-
</table>
24+
> [!div class="nextstepaction"]
25+
26+
> [Open the WinUI 3 Gallery app and see Mica in action](winui3gallery://item/Sound)
27+
28+
29+
[!INCLUDE [winui-3-gallery](../../../includes/winui-3-gallery.md)]
30+
3731

3832
## Sound Global API
3933

@@ -60,11 +54,6 @@ The **SpatialAudioMode** property can takes these values:
6054

6155
To learn more about spatial audio and how XAML handles it see [AudioGraph - Spatial Audio](/windows/uwp/audio-video-camera/audio-graphs#spatial-audio).
6256

63-
### Sound for TV and Xbox
64-
65-
Sound is a key part of the 10-foot experience, and by default, the **ElementSoundPlayer**'s state is **Auto**, meaning that you will only get sound when your app is running on Xbox.
66-
Please see [Designing for Xbox and TV](../devices/designing-for-tv.md) for more details.
67-
6857
## Sound Volume Override
6958

7059
All sounds within the app can be dimmed with the **Volume** control. However, sounds within the app cannot get *louder than the system volume*.
@@ -89,11 +78,11 @@ The **ElementSoundMode** has two states: **Off** and **Default**. When not set,
8978
ButtonName.ElementSoundState = ElementSoundMode.Off;
9079
```
9180

92-
## Is This The Right Sound?
81+
## Is this the right sound?
9382

9483
When creating a custom control, or changing an existing control's sound, it is important to understand the usages of all the sounds the system provides.
9584

96-
Each sound relates to a certain basic user interaction, and although sounds can be customized to play on any interaction, this section serves to illustrate the scenarios where sounds should be used to maintain a consistent experience across all UWP apps.
85+
Each sound relates to a certain basic user interaction, and although sounds can be customized to play on any interaction, this section serves to illustrate the scenarios where sounds should be used to maintain a consistent experience across all WinUI apps.
9786

9887
### Invoking an Element
9988

@@ -161,10 +150,6 @@ As an added feature to calling **ElementSound.Focus**, the sound system will, by
161150

162151
The purpose behind this cycling feature is to keep the focus sounds from becoming monotonous and from being noticeable by the user; focus sounds will be played most often and therefore should be the most subtle.
163152

164-
## Get the sample code
165-
166-
- [WinUI for UWP Gallery sample](https://github.com/Microsoft/WinUI-Gallery) - See all the XAML controls in an interactive format.
167-
168153
## Related articles
169154

170155
* [Designing for Xbox and TV](../devices/designing-for-tv.md)

0 commit comments

Comments
 (0)