Skip to content

Commit 04f0510

Browse files
Merge pull request #6545 from MicrosoftDocs/main
Auto Publish – main to live - 2026-03-26 05:00 UTC
2 parents 25a3c6f + 0a676c0 commit 04f0510

67 files changed

Lines changed: 154 additions & 743 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.openpublishing.redirection.json

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11280,6 +11280,11 @@
1128011280
"redirect_url": "/windows/apps/develop/performance/winui-perf",
1128111281
"redirect_document_id": false
1128211282
},
11283+
{
11284+
"source_path": "uwp/devices-sensors/host-card-emulation.md",
11285+
"redirect_url": "/previous-versions/dotnet/devices-sensors/host-card-emulation",
11286+
"redirect_document_id": false
11287+
},
1128311288
{
1128411289
"source_path": "hub/dev-environment/javascript/nodejs-beginners-tutorial.md",
1128511290
"redirect_url": "/windows/dev-environment/javascript/nodejs-on-windows",
@@ -11293,7 +11298,16 @@
1129311298
{
1129411299
"source_path": "hub/dev-environment/javascript/nuxtjs-on-wsl.md",
1129511300
"redirect_url": "https://nuxt.com/docs",
11296-
11301+
"redirect_document_id": false
11302+
},
11303+
{
11304+
"source_path": "hub/apps/winui/winui3/winui-project-templates-in-visual-studio.md",
11305+
"redirect_url": "/windows/apps/dev-tools/visual-studio",
11306+
"redirect_document_id": false
11307+
},
11308+
{
11309+
"source_path": "hub/apps/desktop/visual-studio-templates.md",
11310+
"redirect_url": "/windows/apps/dev-tools/visual-studio",
1129711311
"redirect_document_id": false
1129811312
}
1129911313
]

hub/apps/api-reference/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ The [Windows SDK](https://developer.microsoft.com/windows/downloads/windows-sdk/
1717
The following API frameworks ship with the Windows SDK:
1818

1919
- [WinRT API reference](/uwp/api/)
20-
- [WinUI for UWP API reference](/windows/winui/api/)
20+
- [WinUI 2 for UWP API reference](/windows/winui/api/)
2121
- [Win32 API reference](/windows/win32/api/)
2222

2323
## Windows App SDK

hub/apps/design/basics/commanding-basics.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ When designing a command interface, the most important decision is choosing what
3535

3636
## Choose the right command elements
3737

38-
Using the right elements in a command interface can make the difference between an intuitive, easy-to-use app and a difficult, confusing app. A comprehensive set of command elements are available in the Windows app. Here's a list of some of the most common UWP command elements.
38+
Using the right elements in a command interface can make the difference between an intuitive, easy-to-use app and a difficult, confusing app. A comprehensive set of command elements are available in the Windows app. Here's a list of some of the most common WinUI command elements.
3939

4040
:::row:::
4141
:::column:::
@@ -137,7 +137,7 @@ Menus and context menus save space by organizing commands and hiding them until
137137

138138
The [CommandBarFlyout](../controls/command-bar-flyout.md) is a type of contextual menu that combines the benefits of a command bar and a context menu into a single control. It can provide shortcuts to commonly-used actions and provide access to secondary commands that are only relevant in certain contexts, such as clipboard or custom commands.
139139

140-
UWP also provides a set of traditional menus and context menus; for more info, see [Menus and context menus](../controls/menus-and-context-menus.md).
140+
WinUI also provides a set of traditional menus and context menus; for more info, see [Menus and context menus](../controls/menus-and-context-menus.md).
141141
:::column-end:::
142142
:::row-end:::
143143

hub/apps/design/signature-experiences/typography.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -140,7 +140,7 @@ Don't use fewer than 20 characters or more than 60 characters per line as this i
140140

141141
### Clipping and ellipses
142142

143-
When the amount of text extends beyond the space available, we recommend clipping the text and inserting ellipses [...], which is the default behavior of most [UWP text controls](../controls/text-controls.md).
143+
When the amount of text extends beyond the space available, we recommend clipping the text and inserting ellipses [...], which is the default behavior of most [WinUI text controls](../controls/text-controls.md).
144144

145145
![Shows a device frame with some text clipping.](../style/images/type/clipping.svg)
146146

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 Sound 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)

hub/apps/desktop/modernize/ui/apply-rounded-corners.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.localizationpriority: medium
88

99
# Apply rounded corners in desktop apps for Windows 11
1010

11-
Rounded corners are the most immediately noticeable feature of [Windows 11 Geometry](../../../design/signature-experiences/geometry.md). On Windows 11, the system automatically rounds top-level window corners for all inbox apps, including all UWP apps, and most other apps. However, some Win32 apps might not be rounded. This topic describes how to round your Win32 app's main window corners if the system does not round them automatically.
11+
Rounded corners are the most immediately noticeable feature of [Windows 11 Geometry](../../../design/signature-experiences/geometry.md). On Windows 11, the system automatically rounds top-level window corners for all inbox apps, including all WinUI apps, and most other apps. However, some Win32 apps might not be rounded. This topic describes how to round your Win32 app's main window corners if the system does not round them automatically.
1212

1313
> [!NOTE]
1414
> By design, apps are not rounded when maximized, snapped, running in a Virtual Machine (VM), running on a Windows Virtual Desktop (WVD), or running as a Windows Defender Application Guard (WDAG) window.

0 commit comments

Comments
 (0)