Skip to content

Commit 00d6e39

Browse files
Merge pull request #6353 from MicrosoftDocs/main
Auto Publish – main to live - 2026-03-04 05:00 UTC
2 parents 8eb27b3 + c21866f commit 00d6e39

158 files changed

Lines changed: 806 additions & 940 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: 115 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,15 @@
11
{
22
"redirections": [
3+
{
4+
"source_path": "hub/apps/winui/winui3/testing/index.md",
5+
"redirect_url": "/windows/apps/develop/testing/",
6+
"redirect_document_id": false
7+
},
8+
{
9+
"source_path": "hub/apps/winui/winui3/testing/create-winui-unit-test-project.md",
10+
"redirect_url": "/windows/apps/develop/testing/",
11+
"redirect_document_id": false
12+
},
313
{
414
"source_path": "hub/apps/performance/introduction.md",
515
"redirect_url": "/windows/apps/performance/",
@@ -10754,6 +10764,111 @@
1075410764
"source_path": "hub/apps/desktop/modernize/xaml-islands/xaml-islands.md",
1075510765
"redirect_url": "/windows/uwp/xaml-islands/xaml-islands",
1075610766
"redirect_document_id": false
10767+
},
10768+
{
10769+
"source_path": "hub/apps/develop/input/gamepad-and-remote-interactions.md",
10770+
"redirect_url": "/windows/uwp/ui-input/gamepad-and-remote-interactions",
10771+
"redirect_document_id": false
10772+
},
10773+
{
10774+
"source_path": "hub/apps/develop/input/gaze-interactions.md",
10775+
"redirect_url": "/windows/uwp/ui-input/gaze-interactions",
10776+
"redirect_document_id": false
10777+
},
10778+
{
10779+
"source_path": "hub/apps/develop/input/input-injection.md",
10780+
"redirect_url": "/windows/uwp/ui-input/input-injection",
10781+
"redirect_document_id": false
10782+
},
10783+
{
10784+
"source_path": "hub/apps/develop/input/radialcontroller-walkthrough.md",
10785+
"redirect_url": "/windows/uwp/ui-input/radialcontroller-walkthrough",
10786+
"redirect_document_id": false
10787+
},
10788+
{
10789+
"source_path": "hub/apps/develop/input/windows-wheel-interactions.md",
10790+
"redirect_url": "/windows/uwp/ui-input/windows-wheel-interactions",
10791+
"redirect_document_id": false
10792+
},
10793+
{
10794+
"source_path": "hub/apps/develop/input/convert-ink-to-text.md",
10795+
"redirect_url": "/windows/uwp/ui-input/convert-ink-to-text",
10796+
"redirect_document_id": false
10797+
},
10798+
{
10799+
"source_path": "hub/apps/develop/input/ink-toolbar.md",
10800+
"redirect_url": "/windows/uwp/ui-input/ink-toolbar",
10801+
"redirect_document_id": false
10802+
},
10803+
{
10804+
"source_path": "hub/apps/develop/input/ink-walkthrough.md",
10805+
"redirect_url": "/windows/uwp/ui-input/ink-walkthrough",
10806+
"redirect_document_id": false
10807+
},
10808+
{
10809+
"source_path": "hub/apps/develop/input/pen-and-stylus-interactions.md",
10810+
"redirect_url": "/windows/uwp/ui-input/pen-and-stylus-interactions",
10811+
"redirect_document_id": false
10812+
},
10813+
{
10814+
"source_path": "hub/apps/develop/input/pen-haptics.md",
10815+
"redirect_url": "/windows/uwp/ui-input/pen-haptics",
10816+
"redirect_document_id": false
10817+
},
10818+
{
10819+
"source_path": "hub/apps/develop/input/save-and-load-ink.md",
10820+
"redirect_url": "/windows/uwp/ui-input/save-and-load-ink",
10821+
"redirect_document_id": false
10822+
},
10823+
{
10824+
"source_path": "hub/apps/develop/input/text-handwriting-view.md",
10825+
"redirect_url": "/windows/uwp/ui-input/text-handwriting-view",
10826+
"redirect_document_id": false
10827+
},
10828+
{
10829+
"source_path": "hub/apps/develop/input/define-custom-recognition-constraints.md",
10830+
"redirect_url": "/windows/uwp/ui-input/define-custom-recognition-constraints",
10831+
"redirect_document_id": false
10832+
},
10833+
{
10834+
"source_path": "hub/apps/develop/input/enable-continuous-dictation.md",
10835+
"redirect_url": "/windows/uwp/ui-input/enable-continuous-dictation",
10836+
"redirect_document_id": false
10837+
},
10838+
{
10839+
"source_path": "hub/apps/develop/input/manage-issues-with-audio-input.md",
10840+
"redirect_url": "/windows/uwp/ui-input/manage-issues-with-audio-input",
10841+
"redirect_document_id": false
10842+
},
10843+
{
10844+
"source_path": "hub/apps/develop/input/set-speech-recognition-timeouts.md",
10845+
"redirect_url": "/windows/uwp/ui-input/set-speech-recognition-timeouts",
10846+
"redirect_document_id": false
10847+
},
10848+
{
10849+
"source_path": "hub/apps/develop/input/specify-the-speech-recognizer-language.md",
10850+
"redirect_url": "/windows/uwp/ui-input/specify-the-speech-recognizer-language",
10851+
"redirect_document_id": false
10852+
},
10853+
{
10854+
"source_path": "hub/apps/develop/input/speech-interactions.md",
10855+
"redirect_url": "/windows/uwp/ui-input/speech-interactions",
10856+
"redirect_document_id": false
10857+
},
10858+
{
10859+
"source_path": "hub/apps/develop/input/speech-recognition.md",
10860+
"redirect_url": "/windows/uwp/ui-input/speech-recognition",
10861+
"redirect_document_id": false
10862+
},
10863+
{
10864+
"source_path": "hub/apps/develop/speech.md",
10865+
"redirect_url": "/windows/uwp/ui-input/speech-interactions",
10866+
"redirect_document_id": false
10867+
},
10868+
{
10869+
"source_path": "hub/apps/develop/ui/controls/inking-controls.md",
10870+
"redirect_url": "/windows/uwp/ui-input/inking-controls",
10871+
"redirect_document_id": false
1075710872
}
1075810873
]
1075910874
}

hub/apps/design/accessibility/accessibility.md

Lines changed: 17 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -4,36 +4,41 @@ ms.assetid: C89D79C2-B830-493D-B020-F3FF8EB5FFDD
44
title: Accessibility
55
label: Accessibility
66
template: detail.hbs
7-
ms.date: 09/24/2020
7+
ms.date: 03/03/2026
88
ms.topic: article
99
keywords: windows 10, uwp
1010
ms.localizationpriority: medium
1111
---
1212

13-
# Accessibility
13+
# Accessibility
1414

15-
Accessibility is about building experiences that make your Windows application usable by people who use technology in a wide range of environments and approach your UI with a range of needs and experiences. For some situations, accessibility requirements are imposed by law. However, it's a good idea to address accessibility issues regardless of legal requirements so that your apps have the largest possible audience.
15+
Design and build Windows applications that provide full and successful experiences for as many people as possible.
1616

17-
> There's also a Microsoft Store declaration regarding accessibility for your app!
17+
Accessible Windows applications support not only people with disabilities (both temporary and permanent) but also those with personal preferences, specific work styles, or situational and environmental constraints (such as shared work spaces, low bandwidth, bright sunlight, noisy or quiet surroundings, while cooking, and so on).
18+
19+
**Everyone should have access to the same rooms in a building, whether they need to use the stairs or the elevator.**
20+
21+
This article provides information on accessibility for developers building Windows applications, assistive technology developers building tools such as screen readers and magnifiers, and software test engineers creating automated scripts for testing applications.
1822

1923
| Article | Description |
20-
|---------|-------------|
21-
| [Accessibility overview](accessibility-overview.md) | This article is an overview of the concepts and technologies related to accessibility scenarios for Windows apps. |
24+
| ------- | ----------- |
25+
| [Accessibility overview](accessibility-overview.md) | An overview of the concepts and technologies related to accessibility scenarios for Windows apps. |
2226
| [Designing inclusive software](designing-inclusive-software.md) | Learn about evolving inclusive design with Windows apps for Windows. Design and build inclusive software with accessibility in mind. |
23-
| [Developing inclusive Windows apps](developing-inclusive-windows-apps.md) | This article is a roadmap for developing accessible Windows apps. |
27+
| [Developing inclusive Windows apps](developing-inclusive-windows-apps.md) | A roadmap for developing accessible Windows apps. |
2428
| [Accessibility testing](accessibility-testing.md) | Testing procedures to follow to ensure that your Windows app is accessible. |
2529
| [Accessibility in the Store](accessibility-in-the-store.md) | Describes the requirements for declaring your Windows app as accessible in the Microsoft Store. |
2630
| [Accessibility checklist](accessibility-checklist.md) | Provides a checklist to help you ensure that your Windows app is accessible. |
2731
| [Expose basic accessibility information](basic-accessibility-information.md) | Basic accessibility info is often categorized into name, role, and value. This topic describes code to help your app expose the basic information that assistive technologies need. |
28-
| [Keyboard accessibility](keyboard-accessibility.md) | If your app does not provide good keyboard access, users who are blind or have mobility issues can have difficulty using your app or may not be able to use it at all. |
29-
| [Screen readers and hardware system buttons](system-button-narration.md) | Screen-readers, such as [Narrator](https://support.microsoft.com/en-us/help/22798/windows-10-complete-guide-to-narrator), must be able to recognize and handle hardware system button events and communicate their state to users. In some cases, the screen reader might need to handle button events exclusively and not let them bubble up to other handlers. |
32+
| [Keyboard accessibility](keyboard-accessibility.md) | If your app doesn't provide good keyboard access, users who are blind or have mobility problems can have difficulty using your app or might not be able to use it at all. |
33+
| [Screen readers and hardware system buttons](system-button-narration.md) | Screen readers, such as [Narrator](https://support.microsoft.com/en-us/help/22798/windows-10-complete-guide-to-narrator), must be able to recognize and handle hardware system button events and communicate their state to users. In some cases, the screen reader might need to handle button events exclusively and not let them bubble up to other handlers. |
3034
| [Landmarks and Headings](landmarks-and-headings.md) | Landmarks and headings define sections of a user interface that aid in efficient navigation for users of assistive technology such as screen readers. |
3135
| [High-contrast themes](high-contrast-themes.md) | Describes the steps needed to ensure your Windows app is usable when a high-contrast theme is active. |
3236
| [Accessible text requirements](accessible-text-requirements.md) | This topic describes best practices for accessibility of text in an app, by assuring that colors and backgrounds satisfy the necessary contrast ratio. This topic also discusses the Microsoft UI Automation roles that text elements in a Windows app can have, and best practices for text in graphics. |
3337
| [Accessibility practices to avoid](practices-to-avoid.md) | Lists the practices to avoid if you want to create an accessible Windows app. |
3438
| [Custom automation peers](custom-automation-peers.md) | Describes the concept of automation peers for UI Automation, and how you can provide automation support for your own custom UI class. |
3539
| [Control patterns and interfaces](control-patterns-and-interfaces.md) | Lists the Microsoft UI Automation control patterns, the classes that clients use to access them, and the interfaces providers use to implement them. |
3640

37-
## Related topics
38-
* [**Windows.UI.Xaml.Automation**](/uwp/api/Windows.UI.Xaml.Automation)
39-
* [Get started with Narrator](https://support.microsoft.com/help/22798/windows-10-complete-guide-to-narrator)
41+
## Related topics
42+
43+
- [Accessibility in the Store](accessibility-in-the-store.md)
44+
- [Microsoft.UI.Xaml.Automation](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.automation)

hub/apps/develop/communication/copy-and-paste.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,12 +10,13 @@ ms.localizationpriority: medium
1010

1111
# Copy and paste
1212

13-
Copy and paste is a fundamental way for users to exchange data between apps or within an app. This article shows you how to implement copy and paste in WinUI and Universal Windows Platform (UWP) apps using the clipboard APIs. You'll learn how to copy, cut, and paste data, track clipboard changes, and use the [DataPackage](/uwp/api/Windows.ApplicationModel.DataTransfer.DataPackage) class to handle different data formats.
13+
Copy and paste is a fundamental way for users to exchange data between apps or within an app. This article shows you how to implement copy and paste in WinUI apps using the clipboard APIs. You'll learn how to copy, cut, and paste data, track clipboard changes, and use the [DataPackage](/uwp/api/Windows.ApplicationModel.DataTransfer.DataPackage) class to handle different data formats.
1414

1515
> [!NOTE]
1616
> You can also use these APIs in other desktop apps through Windows Runtime (WinRT) APIs. For more information, see [Call Windows Runtime APIs in desktop apps](/windows/apps/desktop/modernize/desktop-to-uwp-enhance).
1717
18-
For complete code examples that demonstrate different copy and paste scenarios, see the [UWP clipboard sample on GitHub](https://github.com/microsoft/Windows-universal-samples/tree/master/Samples/Clipboard).
18+
> [!div class="nextstepaction"]
19+
> [Open the WinUI Gallery app and see Clipboard samples](winui3gallery://item/Clipboard)
1920
2021
## Check for built-in clipboard support
2122

hub/apps/develop/data-access/cosmos-db-data-access.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Use a Cosmos DB database from a Windows app
2+
title: "Tutorial: Use a Cosmos DB database from a Windows app"
33
description: Learn how to connect your Windows app to a Cosmos DB database and test the connection programmatically.
44
ms.date: 08/01/2024
55
ms.topic: how-to
@@ -8,7 +8,7 @@ ms.localizationpriority: medium
88
#customer intent: As a Windows developer, I want to learn how to connect my Windows app to a Cosmos DB database so that I can store and retrieve data in the cloud.
99
---
1010

11-
# Use a Cosmos DB database from a Windows app
11+
# Tutorial: Use a Cosmos DB database from a Windows app
1212

1313
This article contains the steps required to enable working with a Cosmos DB database from a Windows app. It also contains a small code snippet showing how you can interact with the database in code.
1414

hub/apps/develop/data-access/mongodb-database.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Use a MongoDB database in a Windows app
2+
title: "Tutorial: Use a MongoDB database in a Windows app"
33
description: Learn how to connect your Windows app directly to a MongoDB database and test the connection programmatically.
44
ms.date: 08/01/2024
55
ms.topic: how-to
@@ -8,7 +8,7 @@ ms.localizationpriority: medium
88
#customer intent: As a Windows developer, I want to learn how to connect my Windows app directly to a MongoDB database so that I can store and retrieve data.
99
---
1010

11-
# Use a MongoDB database in a Windows app
11+
# Tutorial: Use a MongoDB database in a Windows app
1212

1313
This article contains the steps required to enable working with a MongoDB database from a Windows app. It also contains a small code snippet showing how you can interact with the database in code.
1414

hub/apps/develop/data-access/mysql-database.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Use a MySQL database in a Windows app
2+
title: "Tutorial: Use a MySQL database in a Windows app"
33
description: Learn how to connect to a MySQL database from your Windows app, and test your connection using sample code.
44
ms.date: 01/23/2025
55
ms.custom: copilot-scenario-highlight
@@ -9,7 +9,7 @@ ms.localizationpriority: medium
99
#customer intent: As a Windows developer, I want to learn how to connect to a MySQL database from my Windows app so that I can store and retrieve data.
1010
---
1111

12-
# Use a MySQL database in a Windows app
12+
# Tutorial: Use a MySQL database in a Windows app
1313

1414
This article contains the steps required to enable working with a MySQL database from a Windows app. It also contains a small code snippet showing how you can interact with the database in code.
1515

hub/apps/develop/data-access/sql-server-database.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Use a SQL Server database in a Windows app
2+
title: "Tutorial: Use a SQL Server database in a Windows app"
33
description: Learn how to connect a Windows App SDK app directly to a SQL Server database, and store and retrieve data by using System.Data.SqlClient.
44
ms.date: 10/15/2024
55
ms.topic: how-to
@@ -8,13 +8,13 @@ ms.localizationpriority: medium
88
#customer intent: As a Windows developer, I want to learn how to connect my Windows App SDK app directly to a SQL Server database so that I can store and retrieve data.
99
---
1010

11-
# Use a SQL Server database in a Windows app
11+
# Tutorial: Use a SQL Server database in a Windows app
1212

1313
Your app can connect directly to a SQL Server database and then store and retrieve data by using classes in the [System.Data.SqlClient](/dotnet/api/system.data.sqlclient) namespace.
1414

1515
## Getting started
1616

17-
In this guide, we'll show you one way to do that in your Windows App SDK apps. If you install the [Northwind](/dotnet/framework/data/adonet/sql/linq/downloading-sample-databases) sample database onto your SQL Server instance, and then use these snippets, you'll end up with a basic UI that shows products from the Northwind sample database.
17+
In this guide, we'll show you one way to do that in apps that use the Windows App SDK. If you install the [Northwind](/dotnet/framework/data/adonet/sql/linq/downloading-sample-databases) sample database onto your SQL Server instance, and then use these snippets, you'll end up with a basic UI that shows products from the Northwind sample database.
1818

1919
![Northwind products](images/products-northwind.png)
2020

hub/apps/develop/data-access/sqlite-data-access.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Use a SQLite database in a Windows app
2+
title: "Tutorial: Use a SQLite database in a Windows app"
33
description: Learn how to use a SQLite database in a Windows app to store and retrieve data in a lightweight database on the user's device.
44
ms.date: 09/25/2025
55
ms.topic: how-to
@@ -9,7 +9,7 @@ ms.custom: copilot-scenario-highlight
99
#customer intent: As a Windows developer, I want to learn how to use a SQLite database in a Windows app to store and retrieve data in a lightweight database on the user's device.
1010
---
1111

12-
# Use a SQLite database in a Windows app
12+
# Tutorial: Use a SQLite database in a Windows app
1313

1414
[SQLite](https://sqlite.org/index.html) provides a reliable, lightweight database solution for storing data locally in Windows apps. Unlike traditional database systems that require separate server installations and complex configurations, SQLite runs entirely within your application process and stores data in a single file on the user's device.
1515

hub/apps/develop/data-binding/bind-to-hierarchical-data-and-create-a-master-details-view.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
ms.assetid: 6c563dd4-3dd0-4175-a1ab-7a1103fc9559
3-
title: Bind hierarchical data and create a master/details view with WinUI
3+
title: "Tutorial: Bind hierarchical data and create a master/details view with WinUI"
44
description: Create a multi-level master/details view of hierarchical data in WinUI by binding items controls to CollectionViewSource instances. Learn how to implement this structure.
55
ms.date: 11/11/2025
66
ms.topic: how-to
@@ -9,7 +9,7 @@ ms.localizationpriority: medium
99
# customer intent: As a Windows developer, I want to learn how to bind hierarchical data and create a master/details view with WinUI.
1010
---
1111

12-
# Bind hierarchical data and create a master/details view with WinUI 3
12+
# Tutorial: Bind hierarchical data and create a master/details view"
1313

1414
Learn how to create a multilevel master/details view of hierarchical data in WinUI by binding items controls to [CollectionViewSource](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.data.collectionviewsource) instances. This article explains how to use the [{x:Bind} markup extension](/windows/apps/develop/platform/xaml/x-bind-markup-extension) for better performance and the [{Binding} markup extension](/windows/apps/develop/platform/xaml/binding-markup-extension) when flexibility is needed.
1515

@@ -19,8 +19,8 @@ You create a view of a sports team hierarchy that's organized into lists for lea
1919

2020
:::image type="content" source="images/xaml-masterdetails.png" alt-text="Screenshot of a master/details view of a sports hierarchy. The view includes leagues, divisions, and teams.":::
2121

22-
> [!TIP]
23-
> Also see the [Master/detail UWP sample](https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/XamlMasterDetail).
22+
> [!div class="nextstepaction"]
23+
> [Open the WinUI Gallery app and learn about Binding](winui3gallery://item/Binding)
2424
2525
## Prerequisites
2626

0 commit comments

Comments
 (0)