You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: hub/apps/design/input/drag-and-drop.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -102,7 +102,7 @@ See [**ListViewBase.CanReorderItems**](/uwp/api/windows.ui.xaml.controls.listvie
102
102
103
103
The [UIElement](/uwp/api/windows.ui.xaml.uielement) class does most of the work of implementing drag-and-drop for you. But if you want, you can implement your own version by using the APIs below.
104
104
105
-
| Functionality |WinAppSDK API </br> Microsoft.UI.Input.DragDrop namespace | UWP API <br/> Windows.Applicationmodel.DataTransfer.DragDrop.Core namespace |
Copy file name to clipboardExpand all lines: hub/apps/develop/win2d/custom-effects.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: Implementing custom effects
3
3
description: An in-depth guide on implementing custom D2D effects with Win2D.
4
-
ms.date: 05/26/2023
4
+
ms.date: 10/28/2025
5
5
ms.topic: concept-article
6
6
keywords: windows 10, windows 11, uwp, xaml, windows app sdk, winui, windows ui, graphics, games, effect win2d d2d d2d1 direct2d interop cpp csharp
7
7
ms.localizationpriority: medium
@@ -267,11 +267,11 @@ Let's go over how they can be used:
267
267
As we mentioned, if you're using C# and want to implement a custom effect, the recommended approach is to use the [ComputeSharp](https://github.com/Sergio0694/ComputeSharp) library. It enables you to both implement custom D2D1 pixel shaders entirely in C#, as well as to easily define custom effects graphs that are compatible with Win2D. The same library is also used in the Microsoft Store to power several graphics components in the application.
268
268
269
269
You can add a reference to ComputeSharp in your project through NuGet:
270
-
* On UWP, select the [**ComputeSharp.D2D1.Uwp**](https://www.nuget.org/packages/ComputeSharp.D2D1.Uwp/) package.
271
-
* On WinAppSDK, select the [**ComputeSharp.D2D1.WinUI**](https://www.nuget.org/packages/ComputeSharp.D2D1.WinUI/) package.
270
+
* For UWP, select the [**ComputeSharp.D2D1.Uwp**](https://www.nuget.org/packages/ComputeSharp.D2D1.Uwp/) package.
271
+
* For WinUI, select the [**ComputeSharp.D2D1.WinUI**](https://www.nuget.org/packages/ComputeSharp.D2D1.WinUI/) package.
272
272
273
273
> [!NOTE]
274
-
> Many APIs in ComputeSharp.D2D1.\* are identical across the UWP and WinAppSDK targets, the only difference being the namespace (ending in either `.Uwp` or `.WinUI`). However, the UWP target is in sustained maintenance and not receiving new features. As such, some code changes might be needed compared to the samples shown here for WinUI. The snippets in this document reflect the API surface as of ComputeSharp.D2D1.WinUI 3.0.0 (the last release for the UWP target is instead 2.1.0).
274
+
> Many APIs in ComputeSharp.D2D1.\* are identical across the UWP and WinUI targets, the only difference being the namespace (ending in either `.Uwp` or `.WinUI`). However, the UWP target is in sustained maintenance and not receiving new features. As such, some code changes might be needed compared to the samples shown here for WinUI. The snippets in this document reflect the API surface as of ComputeSharp.D2D1.WinUI 3.0.0 (the last release for the UWP target is 2.1.0).
275
275
276
276
There are two main components in ComputeSharp to interop with Win2D:
277
277
- `PixelShaderEffect<T>`: a Win2D effect that is powered by a D2D1 pixel shader. The shader itself is written in C# using the APIs provided by ComputeSharp. This class also provides properties to set effect sources, constant values, and more.
@@ -443,7 +443,7 @@ You can see there are four sections in this class:
443
443
> The `PremultiplyEffect` node after the noise effect is very important: this is because Win2D effects assume that the output is premultiplied, whereas pixel shaders generally work with unpremultiplied pixels. As such, remember to manually insert premultiply/unpremultiply nodes before and after custom shaders, to ensure colors are correctly preserved.
444
444
445
445
> [!NOTE]
446
-
> This sample effect is using WinUI 3 namespaces, but the same code can be used on UWP as well. In that case, the namespace for ComputeSharp will be `ComputeSharp.Uwp`, matching the package name.
446
+
> This sample effect is using WinUI namespaces, but the same code can be used on UWP as well. In that case, the namespace for ComputeSharp will be `ComputeSharp.Uwp`, matching the package name.
Copy file name to clipboardExpand all lines: hub/apps/develop/win2d/hellowin2dworld.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: Win2D "Hello, World!" quickstart
3
3
description: "This topic shows you how to create a very simple \"Hello, World!\" project for Win2D."
4
-
ms.date: 10/25/2023
4
+
ms.date: 10/28/2025
5
5
ms.topic: quickstart
6
6
keywords: windows 11, windows 10, uwp, xaml, windows app sdk, winui, windows ui, graphics, games, win2d
7
7
ms.localizationpriority: medium
@@ -13,7 +13,7 @@ In this topic you'll create a very simple "Hello, World!" project for Win2D.
13
13
14
14
In Visual Studio, create a new project from one of the following project templates:
15
15
16
-
***WinUI 3 (Windows App SDK)**. To create a new WinUI 3 project, use the **Blank App, Packaged (WinUI 3 in Desktop)** project template. You can find that project template by choosing language: either *C#* or *C++*; platform: *Windows*; project type: *Desktop*.
16
+
***WinUI (Windows App SDK)**. To create a new WinUI project, use the **WinUI Blank App (Packaged)** project template. You can find that project template by choosing language: either *C#* or *C++*; platform: *Windows*; project type: *Desktop*.
17
17
***Universal Windows Platform (UWP)**. To create a new UWP project, use the **Blank App (Universal Windows)** or **Blank App (C++/WinRT)** or **Blank App (Universal Windows - C++/CX)** project template. For language, choose: either *C#* or *C++*; platform: *Windows*; project type: *UWP*.
18
18
19
19
> [!IMPORTANT]
@@ -37,7 +37,7 @@ And then add a **CanvasControl**, prefixed with that xml namespace. For example,
37
37
38
38
The project won't build at the moment, due to the referenced-but-not-implemented **Draw** event handler. So we'll remedy that next, while we add some drawing code to interact with the **CanvasControl**.
39
39
40
-
## For a WinUI 3 (Windows App SDK) project
40
+
## For a WinUI (Windows App SDK) project
41
41
42
42
For a C# project, add the following event handler to `MainWindow.xaml.cs`:
43
43
@@ -87,7 +87,7 @@ You can now build and run the project. You'll see some Win2D content—a bla
87
87
88
88
## For a UWP project
89
89
90
-
For a C# project, you can use the same C# code as for a WinUI 3 project (see the [For a WinUI 3 project](#for-a-winui-3-windows-app-sdk-project) section above). The only differences are that you'll be editing `MainPage.xaml.cs` instead of `MainWindow.xaml.cs`. And you'll need to change `Microsoft.UI.Colors` to `Windows.UI.Colors`.
90
+
For a C# project, you can use the same C# code as for a WinUI project (see the [For a WinUI project](#for-a-winui-windows-app-sdk-project) section above). The only differences are that you'll be editing `MainPage.xaml.cs` instead of `MainWindow.xaml.cs`. And you'll need to change `Microsoft.UI.Colors` to `Windows.UI.Colors`.
91
91
92
92
For a C++/WinRT project, add the following code to `pch.h`, `MainPage.h`, and `MainPage.cpp`:
93
93
@@ -124,8 +124,8 @@ For a C++/CX project, add the following event handler to `MainPage.xaml.h` and `
Copy file name to clipboardExpand all lines: hub/apps/develop/win2d/index.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: Overview of Win2D
3
3
description: Win2D is an easy-to-use Windows Runtime API for immediate-mode 2D graphics rendering with GPU acceleration.
4
-
ms.date: 10/23/2023
4
+
ms.date: 10/28/2025
5
5
ms.topic: concept-article
6
6
keywords: windows 10, windows 11, uwp, xaml, windows app sdk, winui, windows ui, graphics, games
7
7
ms.localizationpriority: medium
@@ -11,20 +11,20 @@ ms.localizationpriority: medium
11
11
12
12
Win2D is an easy-to-use Windows Runtime (WinRT) API for immediate-mode 2D graphics rendering with GPU acceleration. It's ideal for creating simple games, displays such as charts, and other simple 2D graphics.
13
13
14
-
You can use Win2D in your WinUI 3 (Windows App SDK) apps or Universal Windows Platform (UWP) apps, using either C#, C++, or VB. Win2D utilizes the power of Direct2D, and it integrates seamlessly with XAML on both WinUI 3 (Windows App SDK) and UWP.
14
+
You can use Win2D in your WinUI (Windows App SDK) apps or Universal Windows Platform (UWP) apps, using either C#, C++, or VB. Win2D utilizes the power of Direct2D, and it integrates seamlessly with XAML on both WinUI (Windows App SDK) and UWP.
15
15
16
16
> [!IMPORTANT]
17
-
> Win2D for WinUI 3 (Windows App SDK) is a work-in-progress, and some features aren't supported. This documentation refers to both the WinUI 3 and UWP versions, which mostly share the same API surface and functionality. Whenever there's any relevant differences between the two, we'll call it out in the documentation. But otherwise, the info being presented applies to both platforms in the same way.
17
+
> Win2D for WinUI (Windows App SDK) is a work-in-progress, and some features aren't supported. This documentation refers to both the WinUI and UWP versions, which mostly share the same API surface and functionality. Whenever there's any relevant differences between the two, we'll call it out in the documentation. But otherwise, the info being presented applies to both platforms in the same way.
18
18
19
19
## Get started
20
20
21
21
Win2D is available as a NuGet package, or as source code (for the source code, see the [Win2D](https://github.com/microsoft/Win2D) repo on GitHub).
22
22
23
23
### Reference the Win2D NuGet package
24
24
25
-
In a WinUI 3 or UWP project in Visual Studio, click **Tools** > **NuGet Package Manager** > **Manage NuGet Packages for Solution...** > **Browse**. Make sure that **Include prerelease** is unchecked, and type or paste into the search box:
25
+
In a WinUI or UWP project in Visual Studio, click **Tools** > **NuGet Package Manager** > **Manage NuGet Packages for Solution...** > **Browse**. Make sure that **Include prerelease** is unchecked, and type or paste into the search box:
26
26
27
-
* For a WinUI 3 project, [*Microsoft.Graphics.Win2D*](https://www.nuget.org/packages/Microsoft.Graphics.Win2D/).
27
+
* For a WinUI project, [*Microsoft.Graphics.Win2D*](https://www.nuget.org/packages/Microsoft.Graphics.Win2D/).
28
28
* For a UWP project, [*Win2D.uwp*](https://www.nuget.org/packages/Win2D.uwp/).
29
29
30
30
Select the correct item in search results, check your project, and click **Install** to install the package into that project. Accept the license agreement.
Copy file name to clipboardExpand all lines: hub/apps/develop/win2d/quick-start.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: Build a simple Win2D app
3
3
description: This tutorial introduces some of the basic drawing capabilities of Win2D.
4
-
ms.date: 10/25/2023
4
+
ms.date: 10/28/2025
5
5
ms.topic: how-to
6
6
keywords: windows 11, windows 10, uwp, xaml, windows app sdk, winui, windows ui, graphics, games
7
7
ms.localizationpriority: medium
@@ -26,7 +26,7 @@ Make sure to set up your machine with all the necessary tools:
26
26
27
27
## Create a new Win2D project
28
28
29
-
Follow the steps in the [Win2D "Hello, World!" quickstart](./hellowin2dworld.md) to create a new project using Win2D, and to add a reference to the Win2D NuGet package. You can use either WinUI 3 (Windows App SDK) or the Universal Windows Platform (UWP).
29
+
Follow the steps in the [Win2D "Hello, World!" quickstart](./hellowin2dworld.md) to create a new project using Win2D, and to add a reference to the Win2D NuGet package. You can use either WinUI (Windows App SDK) or the Universal Windows Platform (UWP).
Copy file name to clipboardExpand all lines: hub/apps/develop/win2d/using-win2d-without-built-in-controls.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: Using Win2D without built-in controls
3
3
description: A guide on how to use the lower level APIs of Win2D, without any of its built-in XAML controls.
4
-
ms.date: 05/28/2023
4
+
ms.date: 10/28/2025
5
5
ms.topic: concept-article
6
6
keywords: windows 10, windows 11, uwp, xaml, windows app sdk, winui, windows ui, graphics, games, effect win2d d2d d2d1 direct2d interop cpp csharp
7
7
ms.localizationpriority: medium
@@ -66,7 +66,7 @@ swapChain.Present();
66
66
The size of the swap chain should match the size of the `CoreWindow`. If the size of the window changes, call [`ResizeBuffers(Size)`](https://microsoft.github.io/Win2D/WinUI2/html/M_Microsoft_Graphics_Canvas_CanvasSwapChain_ResizeBuffers_3.htm) on the swap chain with the new size. For more information, see the `CoreWindow` Win2D sample.
67
67
68
68
> [!NOTE]
69
-
> `CoreWindow` is only supported on UWP. For WinAppSDK apps, use either composition or HWND swapchains.
69
+
> `CoreWindow` is only supported on UWP. For Windows App SDK, use either composition or HWND swapchains.
Copy file name to clipboardExpand all lines: hub/apps/develop/windows-integration/integrate-sharesheet-overview.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
description: Learn how to integrate apps with the Windows Share Sheet, a system-provided UI that enables users to share content from your app with other Windows apps.
3
3
title: Integrate Share options in your Windows app - A comprehensive guide
4
4
ms.topic: concept-article
5
-
ms.date: 11/01/2024
5
+
ms.date: 10/28/2025
6
6
ms.localizationpriority: medium
7
7
keywords: windows, windows share, share sheet, share charm, file sharing, sharesheet, share button, share option, pwa, packaged apps, windows 11, c++
8
8
#customer intent: As a Windows developer, I want to learn how to integrate share options in my Windows app so that users can share content with other Windows apps.
@@ -33,5 +33,5 @@ In this comprehensive guide, you'll learn how to add the share feature to your p
33
33
-[Migrate from UWP to the Windows App SDK](/windows/apps/windows-app-sdk/migrate-to-windows-app-sdk/migrate-to-windows-app-sdk-ovw)
34
34
-[Advantages and Disadvantages of packaging an application - Deployment overview](/windows/apps/package-and-deploy/#advantages-and-disadvantages-of-packaging-your-app)
35
35
-[Identity, Registration and Activation of Non-packaged Win32 Apps](https://blogs.windows.com/windowsdeveloper/2019/10/29/identity-registration-and-activation-of-non-packaged-win32-apps/)
36
-
-[Share Contract Implementation for WinAppSDK App](https://github.com/kmahone/WindowsAppSDK-Samples/tree/user/kmahone/shareapp/Samples/AppLifecycle/ShareTarget/WinUI-CS-ShareTargetSampleApp)
36
+
-[Share Contract Implementation for Windows App SDK](https://github.com/kmahone/WindowsAppSDK-Samples/tree/user/kmahone/shareapp/Samples/AppLifecycle/ShareTarget/WinUI-CS-ShareTargetSampleApp)
37
37
-[Share Contract Implementation for Apps Packaged with External Location](https://github.com/microsoft/AppModelSamples/blob/master/Samples/PackageWithExternalLocation/cs/PhotoStoreDemo/StartUp.cs)
-[Migrate from UWP to the Windows App SDK](/windows/apps/windows-app-sdk/migrate-to-windows-app-sdk/migrate-to-windows-app-sdk-ovw)
128
128
-[Advantages and Disadvantages of packaging an application - Deployment overview](/windows/apps/package-and-deploy/#advantages-and-disadvantages-of-packaging-your-app)
129
129
-[Identity, Registration and Activation of Non-packaged Win32 Apps](https://blogs.windows.com/windowsdeveloper/2019/10/29/identity-registration-and-activation-of-non-packaged-win32-apps/)
130
-
-[Share Contract Implementation for WinAppSDK App](https://github.com/kmahone/WindowsAppSDK-Samples/tree/user/kmahone/shareapp/Samples/AppLifecycle/ShareTarget/WinUI-CS-ShareTargetSampleApp)
130
+
-[Share Contract Implementation for Windows App SDK](https://github.com/kmahone/WindowsAppSDK-Samples/tree/user/kmahone/shareapp/Samples/AppLifecycle/ShareTarget/WinUI-CS-ShareTargetSampleApp)
131
131
-[Share Contract Implementation for Apps Packaged with External Location](https://github.com/microsoft/AppModelSamples/blob/master/Samples/PackageWithExternalLocation/cs/PhotoStoreDemo/StartUp.cs)
132
132
-[Get activation info for packaged apps](/windows/apps/desktop/modernize/get-activation-info-for-packaged-apps)
Copy file name to clipboardExpand all lines: hub/apps/get-started/windows-developer-glossary.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
title: Windows developer glossary
3
3
description: A glossary of terms related to Windows application development.
4
4
ms.topic: glossary
5
-
ms.date: 9/24/2025
5
+
ms.date: 10/28/2025
6
6
ms.localizationpriority: medium
7
7
ms.collection: windows11
8
8
audience: new-desktop-app-developers
@@ -166,7 +166,7 @@ Windows AI Foundry offers AI-backed features and APIs on Windows 11 PCs. These f
166
166
167
167
#### Windows API
168
168
169
-
Refers to the entire set of Windows APIs including Win32 APIs, COM APIs, UWP WinRT APIs, and the WinRT/Win32 APIs that are part of WinAppSDK and WinUI 3.
169
+
Refers to the entire set of Windows APIs including Win32 APIs, COM APIs, UWP WinRT APIs, and the WinRT/Win32 APIs that are part of the Windows App SDK and WinUI.
0 commit comments