Skip to content

Commit 5b6e03c

Browse files
authored
Merge branch 'main' into whats-new-recent-data
2 parents fa335cd + 331847b commit 5b6e03c

364 files changed

Lines changed: 5025 additions & 4656 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: 180 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,36 @@
11
{
22
"redirections": [
3-
{
3+
{
4+
"source_path": "hub/apps/develop/win2d/hellowin2dworld.md",
5+
"redirect_url": "/windows/apps/develop/win2d/quick-start",
6+
"redirect_document_id": true
7+
},
8+
{
9+
"source_path": "hub/apps/develop/win2d/features.md",
10+
"redirect_url": "/windows/apps/develop/win2d/#features",
11+
"redirect_document_id": false
12+
},
13+
{
14+
"source_path": "hub/apps/develop/win2d/in-a-core-app.md",
15+
"redirect_url": "/windows/apps/develop/win2d/",
16+
"redirect_document_id": true
17+
},
18+
{
19+
"source_path": "hub/apps/windows-app-sdk/system-backdrop-controller.md",
20+
"redirect_url": "/windows/apps/develop/ui/system-backdrops",
21+
"redirect_document_id": true
22+
},
23+
{
24+
"source_path": "hub/apps/winui/winui3/testing/index.md",
25+
"redirect_url": "/windows/apps/develop/testing/",
26+
"redirect_document_id": false
27+
},
28+
{
29+
"source_path": "hub/apps/winui/winui3/testing/create-winui-unit-test-project.md",
30+
"redirect_url": "/windows/apps/develop/testing/",
31+
"redirect_document_id": false
32+
},
33+
{
434
"source_path": "hub/apps/performance/introduction.md",
535
"redirect_url": "/windows/apps/performance/",
636
"redirect_document_id": true
@@ -5925,6 +5955,11 @@
59255955
"redirect_url": "/windows/apps/get-started/start-here",
59265956
"redirect_document_id": false
59275957
},
5958+
{
5959+
"source_path": "hub/apps/get-started/developer-mode-features-and-debugging.md",
5960+
"redirect_url": "/windows/advanced-settings/developer-mode",
5961+
"redirect_document_id": false
5962+
},
59285963
{
59295964
"source_path": "hub/apps/project-reunion/index.md",
59305965
"redirect_url": "/windows/apps/windows-app-sdk/index",
@@ -10755,10 +10790,150 @@
1075510790
"redirect_url": "/windows/uwp/xaml-islands/xaml-islands",
1075610791
"redirect_document_id": false
1075710792
},
10758-
{
10759-
"source_path": "hub/apps/publish/nrt-in-analytics.md",
10760-
"redirect_url": "windows/apps/publish/recent-data-acquisitions-reports",
10793+
{
10794+
"source_path": "hub/apps/winui/winui3/xaml-templated-controls-cppwinrt-winui-3.md",
10795+
"redirect_url": "/windows/apps/winui/winui3/xaml-templated-controls-winui-3",
10796+
"redirect_document_id": false
10797+
},
10798+
{
10799+
"source_path": "hub/apps/winui/winui3/xaml-templated-controls-csharp-winui-3.md",
10800+
"redirect_url": "/windows/apps/winui/winui3/xaml-templated-controls-winui-3",
10801+
"redirect_document_id": false
10802+
},
10803+
{
10804+
"source_path": "hub/apps/develop/input/gamepad-and-remote-interactions.md",
10805+
"redirect_url": "/windows/uwp/ui-input/gamepad-and-remote-interactions",
10806+
"redirect_document_id": false
10807+
},
10808+
{
10809+
"source_path": "hub/apps/develop/input/gaze-interactions.md",
10810+
"redirect_url": "/windows/uwp/ui-input/gaze-interactions",
10811+
"redirect_document_id": false
10812+
},
10813+
{
10814+
"source_path": "hub/apps/develop/input/input-injection.md",
10815+
"redirect_url": "/windows/uwp/ui-input/input-injection",
10816+
"redirect_document_id": false
10817+
},
10818+
{
10819+
"source_path": "hub/apps/develop/input/radialcontroller-walkthrough.md",
10820+
"redirect_url": "/windows/uwp/ui-input/radialcontroller-walkthrough",
10821+
"redirect_document_id": false
10822+
},
10823+
{
10824+
"source_path": "hub/apps/develop/input/windows-wheel-interactions.md",
10825+
"redirect_url": "/windows/uwp/ui-input/windows-wheel-interactions",
10826+
"redirect_document_id": false
10827+
},
10828+
{
10829+
"source_path": "hub/apps/develop/input/convert-ink-to-text.md",
10830+
"redirect_url": "/windows/uwp/ui-input/convert-ink-to-text",
10831+
"redirect_document_id": false
10832+
},
10833+
{
10834+
"source_path": "hub/apps/develop/input/ink-toolbar.md",
10835+
"redirect_url": "/windows/uwp/ui-input/ink-toolbar",
10836+
"redirect_document_id": false
10837+
},
10838+
{
10839+
"source_path": "hub/apps/develop/input/ink-walkthrough.md",
10840+
"redirect_url": "/windows/uwp/ui-input/ink-walkthrough",
10841+
"redirect_document_id": false
10842+
},
10843+
{
10844+
"source_path": "hub/apps/develop/input/pen-and-stylus-interactions.md",
10845+
"redirect_url": "/windows/uwp/ui-input/pen-and-stylus-interactions",
10846+
"redirect_document_id": false
10847+
},
10848+
{
10849+
"source_path": "hub/apps/develop/input/pen-haptics.md",
10850+
"redirect_url": "/windows/uwp/ui-input/pen-haptics",
10851+
"redirect_document_id": false
10852+
},
10853+
{
10854+
"source_path": "hub/apps/develop/input/save-and-load-ink.md",
10855+
"redirect_url": "/windows/uwp/ui-input/save-and-load-ink",
10856+
"redirect_document_id": false
10857+
},
10858+
{
10859+
"source_path": "hub/apps/develop/input/text-handwriting-view.md",
10860+
"redirect_url": "/windows/uwp/ui-input/text-handwriting-view",
10861+
"redirect_document_id": false
10862+
},
10863+
{
10864+
"source_path": "hub/apps/develop/input/define-custom-recognition-constraints.md",
10865+
"redirect_url": "/windows/uwp/ui-input/define-custom-recognition-constraints",
10866+
"redirect_document_id": false
10867+
},
10868+
{
10869+
"source_path": "hub/apps/develop/input/enable-continuous-dictation.md",
10870+
"redirect_url": "/windows/uwp/ui-input/enable-continuous-dictation",
10871+
"redirect_document_id": false
10872+
},
10873+
{
10874+
"source_path": "hub/apps/develop/input/manage-issues-with-audio-input.md",
10875+
"redirect_url": "/windows/uwp/ui-input/manage-issues-with-audio-input",
10876+
"redirect_document_id": false
10877+
},
10878+
{
10879+
"source_path": "hub/apps/develop/input/set-speech-recognition-timeouts.md",
10880+
"redirect_url": "/windows/uwp/ui-input/set-speech-recognition-timeouts",
10881+
"redirect_document_id": false
10882+
},
10883+
{
10884+
"source_path": "hub/apps/develop/input/specify-the-speech-recognizer-language.md",
10885+
"redirect_url": "/windows/uwp/ui-input/specify-the-speech-recognizer-language",
10886+
"redirect_document_id": false
10887+
},
10888+
{
10889+
"source_path": "hub/apps/develop/input/speech-interactions.md",
10890+
"redirect_url": "/windows/uwp/ui-input/speech-interactions",
10891+
"redirect_document_id": false
10892+
},
10893+
{
10894+
"source_path": "hub/apps/develop/input/speech-recognition.md",
10895+
"redirect_url": "/windows/uwp/ui-input/speech-recognition",
10896+
"redirect_document_id": false
10897+
},
10898+
{
10899+
"source_path": "hub/apps/develop/speech.md",
10900+
"redirect_url": "/windows/uwp/ui-input/speech-interactions",
10901+
"redirect_document_id": false
10902+
},
10903+
{
10904+
"source_path": "hub/apps/develop/ui/controls/inking-controls.md",
10905+
"redirect_url": "/windows/uwp/ui-input/inking-controls",
10906+
"redirect_document_id": false
10907+
},
10908+
{
10909+
"source_path": "hub/apps/windows-app-sdk/system-requirements.md",
10910+
"redirect_url": "/windows/apps/windows-app-sdk",
10911+
"redirect_document_id": false
10912+
},
10913+
{
10914+
"source_path": "hub/apps/publish/analyze-app-performance/gdk-xbox.md",
10915+
"redirect_url": "/partner-center/insights/apps-and-games-overview",
10916+
"redirect_document_id": false
10917+
},
10918+
{
10919+
"source_path": "hub/apps/how-tos/chatgpt-openai-winui3.md",
10920+
"redirect_url": "/windows/apps/how-tos/github-copilot-winui-vs",
10921+
"redirect_document_id": false
10922+
},
10923+
{
10924+
"source_path": "hub/apps/how-tos/copilot-chat-winui3.md",
10925+
"redirect_url": "/windows/apps/how-tos/github-copilot-winui-vs",
10926+
"redirect_document_id": false
10927+
},
10928+
{
10929+
"source_path": "hub/apps/how-tos/dall-e-winui3.md",
10930+
"redirect_url": "/windows/apps/how-tos/github-copilot-winui-vs",
10931+
"redirect_document_id": false
10932+
},
10933+
{
10934+
"source_path": "hub/apps/develop/notifications/app-notifications/toast-notifications-overview.md",
10935+
"redirect_url": "/windows/apps/develop/notifications/app-notifications/",
1076110936
"redirect_document_id": false
10762-
}
10937+
}
1076310938
]
1076410939
}

hub/advanced-settings/developer-mode.md

Lines changed: 107 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,9 @@ When you enable Developer Mode on desktop, a package of features is installed, i
5858
5959
### Device Portal
6060

61-
To learn more about Device Portal, see [Windows Device Portal overview](/windows/uwp/debug-test-perf/device-portal) and [Device Portal for desktop](/windows/uwp/debug-test-perf/device-portal-desktop).
61+
To learn more about Device Portal, see [Windows Device Portal overview](/windows/uwp/debug-test-perf/device-portal).
62+
63+
For specific setup instructions, see [Device Portal for desktop](/windows/uwp/debug-test-perf/device-portal-desktop).
6264

6365
### Device Discovery
6466

@@ -82,3 +84,107 @@ SSH login is done via the *DevToolsUser* account, which accepts a password for a
8284
##### Caveats for SSH usage
8385

8486
The existing SSH server used in Windows is not yet protocol compliant. Using an SFTP or SSH client may require special configuration. In particular, the SFTP subsystem runs at version 3 or less, so any connecting client should be configured to expect an old server. The SSH server on older devices uses `ssh-dss` for public key authentication (which OpenSSH has deprecated). To connect to such devices, the SSH client must be manually configured to accept `ssh-dss`.
87+
88+
## Failure to install Developer Mode package
89+
90+
Sometimes, due to network or administrative issues, Developer Mode won't install correctly. The Developer Mode package is required for remote deployment to this PC (using Device Portal from a browser or Device Discovery to enable SSH), but not for local development. Even if you encounter these issues, you can still deploy your app locally using Visual Studio (or from this device to another device).
91+
92+
If Developer Mode doesn't install correctly, we encourage you to file a feedback request using the Feedback Hub app.
93+
94+
> [!NOTE]
95+
> 1. Install the [Feedback Hub app](https://apps.microsoft.com/store/detail/feedback-hub/9NBLGGH4R32N) (if you don't already have it) and open it.
96+
> 2. Click **Add new feedback**.
97+
> 3. Choose the **Developer Platform** category and the **Developer Mode** subcategory.
98+
> 4. Fill out the fields (you may optionally attach a screenshot) and click **Submit**.
99+
>
100+
> Submitting feedback will help Microsoft resolve the issue you encountered.
101+
102+
### Failed to locate the package
103+
104+
> Developer Mode package couldn't be located in Windows Update. Error Code 0x80004005. Learn more.
105+
106+
This error may occur due to a network connectivity problem, Enterprise settings, or the package may be missing.
107+
108+
To fix this issue:
109+
110+
1. Ensure that your computer is connected to the internet.
111+
2. If you're on a domain-joined computer, speak to your network administrator. The Developer Mode package (like all Features on Demand) is blocked by default in WSUS 2.1. In order to unblock the Developer Mode package in the current and previous releases, the following KBs should be allowed in WSUS:
112+
113+
- 4016509
114+
- 3180030
115+
- 3197985
116+
117+
3. Check for Windows updates in **Settings → Updates and Security → Windows Updates**.
118+
1. Verify that the Windows Developer Mode package is present in **Settings → System → Optional features → Add a feature** (on versions older than Windows 10 22H2, look under **Settings** **** **Apps** **** **Apps & features** **→ Optional features** **** **Add a feature**). If it's missing, Windows can't find the correct package for your computer.
119+
120+
5. After performing the above steps, *disable* and then *re-enable* Developer Mode to verify the fix.
121+
122+
### Failed to install the package
123+
124+
> Developer Mode package failed to install. Error code 0x80004005. Learn more.
125+
126+
This error may occur due to incompatibilities between your build of Windows and the Developer Mode package.
127+
128+
To fix this issue:
129+
130+
1. Check for Windows updates in the **Settings → Updates and Security → Windows Updates**.
131+
2. Restart your computer to ensure all updates are applied.
132+
133+
## Use group policies or registry keys to enable a device
134+
135+
For most developers, you'll want to use Windows Settings to enable your device for debugging. In certain scenarios (such as automated tests) you can use other ways to enable your Windows desktop device for development.
136+
137+
> [!NOTE]
138+
> These steps will not enable the SSH server or allow the device to be targeted for remote deployment and debugging.
139+
140+
You can use `gpedit.msc` to set the group policies to enable your device, unless you have *Windows 10 Home* or *Windows 11 Home*. If you do, you'll need to use regedit or PowerShell commands to set the registry keys directly to enable your device.
141+
142+
### Use gpedit to enable your device
143+
144+
1. Run `gpedit.msc`.
145+
146+
2. Go to **Local Computer Policy → Computer Configuration → Administrative Templates → Windows Components → App Package Deployment**.
147+
148+
3. Edit the following policies to enable sideloading:
149+
150+
- Allow all trusted apps to install.
151+
152+
OR
153+
154+
Edit the following policies to enable both sideloading and Developer Mode:
155+
156+
- Allow all trusted apps to install.
157+
- Allows development of UWP apps and installation from an *Integrated Development Environment (IDE)*.
158+
- Reboot your machine.
159+
160+
### Use regedit to enable your device
161+
162+
1. Run `regedit`.
163+
164+
2. To enable sideloading, set the value of this `DWORD` to `1`:
165+
166+
`HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock\AllowAllTrustedApps`
167+
168+
OR
169+
170+
To enable developer mode, set the values of this `DWORD` to `1`:
171+
172+
`HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock\AllowDevelopmentWithoutDevLicense`
173+
174+
### Use PowerShell to enable your device
175+
176+
1. Run PowerShell with administrator privileges.
177+
178+
2. To enable sideloading, run this command:
179+
180+
```powershell
181+
PS C:\WINDOWS\system32> reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock" /t REG_DWORD /f /v "AllowAllTrustedApps" /d "1"
182+
```
183+
184+
OR
185+
186+
To enable developer mode, run this command:
187+
188+
```powershell
189+
PS C:\WINDOWS\system32> reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock" /t REG_DWORD /f /v "AllowDevelopmentWithoutDevLicense" /d "1"
190+
```

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)

0 commit comments

Comments
 (0)