Skip to content

Commit c28a6d6

Browse files
niels9001GrantMeStrengthCopilotjwmsft
authored
docs: develop-input (#6523)
* docs: develop-input Modernize documentation by updating legacy references. Batch: develop-input Files changed: 4 Proposals applied: 11 * docs: develop-performance Modernize documentation by updating legacy references. Batch: develop-performance Files changed: 1 Proposals applied: 1 * docs: develop-platform-xaml Modernize documentation by updating legacy references. Batch: develop-platform-xaml Files changed: 4 Proposals applied: 6 * docs: develop-security Modernize documentation by updating legacy references. Batch: develop-security Files changed: 4 Proposals applied: 4 * docs: develop-ui Modernize documentation by updating legacy references. Batch: develop-ui Files changed: 1 Proposals applied: 1 * docs: develop-ui-controls Modernize documentation by updating legacy references. Batch: develop-ui-controls Files changed: 6 Proposals applied: 12 * docs: develop-ui-controls-dialogs-and-flyouts Modernize documentation by updating legacy references. Batch: develop-ui-controls-dialogs-and-flyouts Files changed: 1 Proposals applied: 3 * docs: develop-ui-navigation Modernize documentation by updating legacy references. Batch: develop-ui-navigation Files changed: 1 Proposals applied: 1 * docs: develop-win2d Modernize documentation by updating legacy references. Batch: develop-win2d Files changed: 1 Proposals applied: 3 * docs: develop-windows-integration Modernize documentation by updating legacy references. Batch: develop-windows-integration Files changed: 8 Proposals applied: 10 * docs: get-started Modernize documentation by updating legacy references. Batch: get-started Files changed: 1 Proposals applied: 1 * docs: publish-faq Modernize documentation by updating legacy references. Batch: publish-faq Files changed: 1 Proposals applied: 1 * docs: publish-msstore-dev-cli Modernize documentation by updating legacy references. Batch: publish-msstore-dev-cli Files changed: 1 Proposals applied: 3 * docs: winui-winui3 Modernize documentation by updating legacy references. Batch: winui-winui3 Files changed: 1 Proposals applied: 1 * fix: remove blank line in nextstepaction block in split-view.md Co-authored-by: niels9001 <[email protected]> Agent-Logs-Url: https://github.com/MicrosoftDocs/windows-dev-docs-pr/sessions/01c50673-e462-43e6-88cc-4bd2092cbc2f * fix: correct include path for winui-3-gallery in split-view.md Co-authored-by: niels9001 <[email protected]> Agent-Logs-Url: https://github.com/MicrosoftDocs/windows-dev-docs-pr/sessions/1e61ef2b-4164-4ba0-9eab-91927422679e * Revert UWP app reference in packaging instructions It's the actual title of the linked article. * Revert to UWP in packaging article link text It's the actual title of the linked article. * Restore original link text for packaging article It's the actual title of the linked article. --------- Co-authored-by: John Kennedy <[email protected]> Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: niels9001 <[email protected]> Co-authored-by: Jim Walker <[email protected]>
1 parent e2a3f2d commit c28a6d6

28 files changed

Lines changed: 58 additions & 145 deletions

hub/apps/develop/performance/index.md

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

1313
Improving the performance and fundamentals of your application gives it a feeling of polish and craftsmanship, while saving your customers time, money, battery life, and development effort. Your app will consume less power, improving battery life and reducing carbon emissions. Apps run more smoothly on less expensive hardware. Your customers' productivity increases.
1414

15-
This page provides an overview of the technologies and development tools for measuring, understanding, and refining the performance of your Windows application. If you are writing a UWP application, be sure to also consult the [UWP Performance](/windows/uwp/debug-test-perf/performance-and-xaml-ui) documentation.
15+
This page provides an overview of the technologies and development tools for measuring, understanding, and refining the performance of your Windows application.
1616

1717
## What is application performance and why is it important?
1818

hub/apps/develop/platform/xaml/dependency-properties-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -191,7 +191,7 @@ You can deliberately set a property to the default value even after you have alr
191191
All [**DependencyObject**](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.dependencyobject) instances must be created on the UI thread which is associated with the current [**Window**](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.Window) that is shown by a WinUI app. Although each **DependencyObject** must be created on the main UI thread, the objects can be accessed using a dispatcher reference from other threads, by accessing the [**DispatcherQueue**](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.dependencyobject.dispatcherqueue) property. Then you can call methods such as [**TryEnqueue**](/windows/windows-app-sdk/api/winrt/microsoft.ui.dispatching.dispatcherqueue.tryenqueue) and execute your code within the rules of thread restrictions on the UI thread.
192192

193193
> [!NOTE]
194-
> For UWP apps, access the [**Dispatcher**](/uwp/api/windows.ui.xaml.dependencyobject.dispatcher) property. Then you can call methods such as [**RunAsync**](/uwp/api/windows.ui.core.coredispatcher.runasync) on the [**CoreDispatcher**](/uwp/api/Windows.UI.Core.CoreDispatcher) object, and execute your code within the rules of thread restrictions on the UI thread. For more info about differences between UWP and WinUI 3 for the Windows App SDK, see [Threading functionality migration](../../../windows-app-sdk/migrate-to-windows-app-sdk/guides/threading.md).
194+
> For more info about differences between UWP and WinUI 3 for the Windows App SDK, see [Threading functionality migration](../../../windows-app-sdk/migrate-to-windows-app-sdk/guides/threading.md).
195195
196196
The threading aspects of [**DependencyObject**](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.dependencyobject) are relevant because it generally means that only code that runs on the UI thread can change or even read the value of a dependency property. Threading issues can usually be avoided in typical UI code that makes correct use of **async** patterns and background worker threads. You typically only run into **DependencyObject**-related threading issues if you are defining your own **DependencyObject** types and you attempt to use them for data sources or other scenarios where a **DependencyObject** isn't necessarily appropriate.
197197

hub/apps/develop/platform/xaml/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
ms.assetid: b632a6cc-3503-4ab8-bfd1-dde731bd89ab
3-
description: This section includes topics that explain the XAML framework for Universal Windows Platform (UWP) apps.
3+
description: This section includes topics that explain the XAML framework for WinUI apps.
44
title: XAML platform
55
ms.date: 09/08/2025
66
ms.topic: article
@@ -9,7 +9,7 @@ ms.localizationpriority: medium
99
---
1010
# XAML platform
1111

12-
This section includes topics that explain programming concepts that are generally applicable to any app that you write using the Windows Runtime and XAML for your UI definition. This section applies to both WinUI 3 and UWP.
12+
This section includes topics that explain programming concepts that are generally applicable to any app that you write using the Windows Runtime and XAML for your UI definition.
1313

1414
| Topic | Description |
1515
|-------|-------------|

hub/apps/develop/platform/xaml/x-name-attribute.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ CombiningCharacter::= none
4242

4343
## Remarks
4444

45-
The specified **x:Name** becomes the name of a field that is created in the underlying code when XAML is processed, and that field holds a reference to the object. The process of creating this field is performed by the MSBuild target steps, which also are responsible for joining the partial classes for a XAML file and its code-behind. This behavior is not necessarily XAML-language specified; it is the particular implementation that Universal Windows Platform (UWP) programming for XAML applies to use **x:Name** in its programming and application models.
45+
The specified **x:Name** becomes the name of a field that is created in the underlying code when XAML is processed, and that field holds a reference to the object. The process of creating this field is performed by the MSBuild target steps, which also are responsible for joining the partial classes for a XAML file and its code-behind. This behavior is not necessarily XAML-language specified; it is the particular implementation that WinUI programming applies to use **x:Name** in its programming and application models.
4646

4747
Each defined **x:Name** must be unique within a XAML namescope. Generally, a XAML namescope is defined at the root element level of a loaded page and contains all elements under that element in a single XAML page. Additional XAML namescopes are defined by any control template or data template that is defined on that page. At run time, another XAML namescope is created for the root of the object tree that is created from an applied control template, and also by object trees created from a call to [**XamlReader.Load**](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.markup.xamlreader.load). For more info, see [XAML namescopes](xaml-namescopes.md).
4848

hub/apps/develop/platform/xaml/x-uid-directive.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
---
2-
description: Provides a unique identifier for markup elements. For Universal Windows Platform (UWP) XAML, this unique identifier is used by XAML localization processes and tools, such as using resources from a .resw resource file.
2+
description: Provides a unique identifier for markup elements. For WinUI XAML, this unique identifier is used by XAML localization processes and tools, such as using resources from a .resw resource file.
33
title: xUid directive
44
ms.assetid: 9FD6B62E-D345-44C6-B739-17ED1A187D69
55
ms.date: 09/09/2025
66
ms.topic: article
7-
keywords: windows 10, uwp
7+
keywords: windows 10, winui
88
ms.localizationpriority: medium
99
---
1010
# x:Uid directive
1111

12-
Provides a unique identifier for markup elements. For Universal Windows Platform (UWP) XAML, this unique identifier is used by XAML localization processes and tools, such as using resources from a .resw resource file.
12+
Provides a unique identifier for markup elements. For WinUI XAML, this unique identifier is used by XAML localization processes and tools, such as using resources from a .resw resource file.
1313

1414
## XAML attribute usage
1515

hub/apps/develop/security/credential-locker.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.topic: how-to
1010

1111
This article describes how Windows apps can use the Credential Locker to securely store and retrieve user credentials, and roam them between devices with the user's Microsoft account.
1212

13-
The Windows Runtime (WinRT) APIs for Credential Locker access are part of the [Windows Software Development Kit (SDK)](https://developer.microsoft.com/windows/downloads/windows-sdk/). These APIs were created for use in Universal Windows Platform (UWP) apps, but they can also be used in WinUI apps or in packaged desktop apps, including WPF and Windows Forms. For more information about using WinRT APIs in your Windows desktop app, see [Call Windows Runtime APIs in desktop apps](/windows/apps/desktop/modernize/desktop-to-uwp-enhance).
13+
The Windows Runtime (WinRT) APIs for Credential Locker access are part of the [Windows Software Development Kit (SDK)](https://developer.microsoft.com/windows/downloads/windows-sdk/). These APIs can be used in WinUI as well as other desktop apps, such as WPF and WinForms. For more information about using WinRT APIs in your Windows desktop app, see [Call Windows Runtime APIs in desktop apps](/windows/apps/desktop/modernize/desktop-to-uwp-enhance).
1414

1515
## Overview of the sample scenario
1616

hub/apps/develop/security/fingerprint-biometrics.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.topic: how-to
1010

1111
This article explains how to add fingerprint biometrics to your Windows app, including a request for fingerprint authentication when the user must consent to a particular action increases the security of your app. For example, you could require fingerprint authentication before authorizing an in-app purchase, or access to restricted resources. Fingerprint authentication is managed using the [UserConsentVerifier](/uwp/api/Windows.Security.Credentials.UI.UserConsentVerifier) class in the [Windows.Security.Credentials.UI](/uwp/api/Windows.Security.Credentials.UI) namespace.
1212

13-
The Windows Runtime (WinRT) APIs for fingerprint biometrics are part of the [Windows Software Development Kit (SDK)](https://developer.microsoft.com/windows/downloads/windows-sdk/). These APIs were created for use in Universal Windows Platform (UWP) apps, but they can also be used in WinUI apps or in packaged desktop apps, including WPF and Windows Forms. For more information about using WinRT APIs in your Windows desktop app, see [Call Windows Runtime APIs in desktop apps](/windows/apps/desktop/modernize/desktop-to-uwp-enhance).
13+
The Windows Runtime (WinRT) APIs for fingerprint biometrics are part of the [Windows Software Development Kit (SDK)](https://developer.microsoft.com/windows/downloads/windows-sdk/). These APIs can be used in WinUI as well as other desktop apps, such as WPF and WinForms. For more information about using WinRT APIs in your Windows desktop app, see [Call Windows Runtime APIs in desktop apps](/windows/apps/desktop/modernize/desktop-to-uwp-enhance).
1414

1515
## Check the device for a fingerprint reader
1616

hub/apps/develop/security/oauth2.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -11,10 +11,6 @@ keywords: windows, winui, winrt, dotnet, security
1111

1212
The [OAuth2Manager](/windows/windows-app-sdk/api/winrt/microsoft.security.authentication.oauth.oauth2manager) in Windows App SDK enables desktop applications such as WinUI 3 to seamlessly perform OAuth 2.0 authorization on Windows. The **OAuth2Manager** API doesn't provide APIs for the implicit request and resource owner password credential because of the security concerns that entails. Use the authorization code grant type with Proof Key for Code Exchange (PKCE). For more information, see the [PKCE RFC](https://tools.ietf.org/html/rfc7636).
1313

14-
## OAuth 2.0 background for Windows apps
15-
16-
The Windows Runtime (WinRT) [WebAuthenticationBroker](/uwp/api/windows.security.authentication.web.webauthenticationbroker), primarily designed for UWP apps, presents several challenges when used in desktop apps. Key issues include the dependency on [ApplicationView](/uwp/api/windows.ui.viewmanagement.applicationview), which isn't compatible with desktop app frameworks. As a result, developers must resort to workarounds involving interop interfaces and additional code to implement OAuth 2.0 functionality into WinUI and other desktop apps.
17-
1814
## OAuth2Manager API in Windows App SDK
1915

2016
The **OAuth2Manager** API for Windows App SDK provides a streamlined solution that meets the expectations of developers. It offers seamless OAuth 2.0 capabilities with full feature parity across all Windows platforms supported by Windows App SDK. The new API eliminates the need for cumbersome workarounds and simplifies the process of incorporating OAuth 2.0 functionality into desktop apps.

hub/apps/develop/security/smart-cards.md

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

1414
This topic explains how Windows apps can use smart cards to connect users to secure network services, including how to access physical smart card readers, create virtual smart cards, communicate with smart cards, authenticate users, reset user PINs, and remove or disconnect smart cards.
1515

16-
The Windows Runtime (WinRT) APIs for smart cards are part of the [Windows Software Development Kit (SDK)](https://developer.microsoft.com/windows/downloads/windows-sdk/). These APIs were created for use in Universal Windows Platform (UWP) apps, but they can also be used in WinUI apps or in packaged desktop apps, including WPF and Windows Forms. For more information about using WinRT APIs in your Windows desktop app, see [Call Windows Runtime APIs in desktop apps](/windows/apps/desktop/modernize/desktop-to-uwp-enhance).
16+
The Windows Runtime (WinRT) APIs for smart cards are part of the [Windows Software Development Kit (SDK)](https://developer.microsoft.com/windows/downloads/windows-sdk/). These APIs can be used in WinUI as well as other desktop apps, such as WPF and WinForms. For more information about using WinRT APIs in your Windows desktop app, see [Call Windows Runtime APIs in desktop apps](/windows/apps/desktop/modernize/desktop-to-uwp-enhance).
1717

1818
## Configure the app manifest
1919

0 commit comments

Comments
 (0)