Merge pull request #5627 from MicrosoftDocs/main

Auto Publish – main to live - 2025-07-25 05:00 UTC

Author: learn-build-service-prod[bot]

hub/apps/develop/ui-input/manage-app-windows.md

@@ -194,6 +194,9 @@ The window should have an owner when IsModal=true.
 
 To set the owner window in a WinUI app requires Win32 interop. For more information and example code, see the AppWindow page in the WinUI Gallery sample app.
 
+- [Launch the WinUI Gallery app](winui3gallery://item/AppWindow)
+- [Open ModalWindow.xaml.cs on GitHub](https://github.com/microsoft/WinUI-Gallery/blob/main/WinUIGallery/Samples/SamplePages/ModalWindow.xaml.cs)
+
 ### Apply a presenter
 
 A presenter can be applied to only a single window at a time. Trying to apply the same presenter to a second window throws an exception. That means that if you have multiple windows, and you want to switch each one into a specific presentation mode, then you need to create multiple presenters of the same kind, and then apply each to its own window.

hub/apps/develop/ui-input/windowing-overview.md

@@ -22,6 +22,11 @@ Windowing functionality in a WinUI app is provided by a combination of the XAML
 >
 > - **Important APIs**: [Window class](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.window), [AppWindow class](/windows/windows-app-sdk/api/winrt/microsoft.ui.windowing.appwindow)
 
+> [!div class="nextstepaction"]
+> [Open the WinUI 3 Gallery app and see Windowing samples in action](winui3gallery://category/MultipleWindows)
+
+[!INCLUDE [winui-3-gallery](../../../includes/winui-3-gallery.md)]
+
 **XAML Window**
 
 In your app, the window object is an instance of the [Microsoft.UI.Xaml.Window](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.window) class (or a derived class) that represents the window in your program code. You create it directly with a call to the constructor. The XAML Window is where you attach your app content and manage the lifecycle of your app's windows.

hub/apps/how-tos/chatgpt-openai-winui3.md

@@ -1,40 +1,34 @@
 ---
 title: How to add OpenAI chat completions to a WinUI desktop app
-description: Get started with WinUI 3 / Windows App SDK desktop apps by integrating OpenAI's chat completions API into the app. 
+description: Get started with WinUI 3 / Windows App SDK desktop apps by integrating OpenAI's text generation and prompting APIs into the app. 
 ms.topic: how-to
-ms.date: 11/26/2024
+ms.date: 07/24/2025
 keywords: windows app sdk, winappsdk, winui3, openai, chatgpt
 ms.localizationpriority: medium
 ms.custom: template-quickstart
 audience: new-desktop-app-developers
 content-type: how-to
-#Customer intent: As a Windows developer, I want to learn how to integrate OpenAI's chat completions API into my WinUI 3 / Windows App SDK desktop app so that I can build a chat-like interface that generates responses to messages.
+#Customer intent: As a Windows developer, I want to learn how to integrate OpenAI's text generation and prompting APIs into my WinUI 3 / Windows App SDK desktop app so that I can build a chat-like interface that generates responses to messages.
 ---
 
 # Add OpenAI chat completions to your WinUI 3 / Windows App SDK desktop app
 
-In this how-to, you'll learn how to integrate OpenAI's API into your WinUI 3 / Windows App SDK desktop app. We'll build a chat-like interface that lets you generate responses to messages using OpenAI's [chat completions API](https://platform.openai.com/docs/guides/text-generation/chat-completions-api):
+In this how-to, you'll learn how to integrate OpenAI's API into your WinUI 3 / Windows App SDK desktop app. We'll build a chat-like interface that lets you generate responses to messages using OpenAI's [text generation and prompting APIs](https://platform.openai.com/docs/guides/text):
 
 :::image type="content" source="images/chatgpt-openai/long-story.png" alt-text="A screenshot of a less minimal WinUI chat app.":::
 
 <!--todo: The source code for the app we're building in this how-to is available todo -->
 
 ## Prerequisites
 
-- Set up your development computer (see [Get started with WinUI](../get-started/start-here.md)).
-- Familiarity with the core concepts in *[How to build a Hello World app using C# and WinUI 3 / Windows App SDK](./hello-world-winui3.md)* - we'll build upon that how-to in this one.
+- Set up your development computer (see [Start developing Windows apps](../get-started/start-here.md)).
+- Familiarity with the core concepts in *[How to build a Hello World app using C# and WinUI / Windows App SDK](./hello-world-winui3.md)* - we'll build upon that how-to in this one.
 - An OpenAI API key from your [OpenAI developer dashboard](https://platform.openai.com/api-keys).
 - An OpenAI SDK installed in your project. Refer to the [OpenAI documentation](https://platform.openai.com/docs/libraries) for a list of community libraries. In this how-to, we'll use the official [OpenAI .NET API library](https://github.com/openai/openai-dotnet).
 
 ## Create a project
 
- 1. Open Visual Studio and create a new project via `File` > `New` > `Project`.
- 1. Search for `WinUI` and select the `Blank App, Packaged (WinUI 3 in Desktop)` C# project template.
- 1. Specify a project name, solution name, and directory. In this example, our `ChatGPT_WinUI3` project belongs to a `ChatGPT_WinUI3` solution, which will be created in `C:\Projects\`.
-
-After creating your project, you should see the following default file structure in your Solution Explorer:
-
-:::image type="content" source="images/chatgpt-openai/collapsed-file-structure-chatgpt.png" alt-text="A screenshot of the default directory structure in Solution Explorer.":::
+You create a new WinUI project in Visual Studio by following the steps in the [Create and launch your first WinUI app](/windows/apps/get-started/start-here#3-create-and-launch-your-first-winui-app) section of the [Start developing Windows apps](../get-started/start-here.md) article. For this example, enter `ChatGPT_WinUI3` as the project name and `ChatGPT_WinUI3` for the solution name when entering the project details in the dialog.
 
 ## Set your environment variable
 
@@ -176,7 +170,7 @@ Let's make the following improvements to the chat interface:
 - Add a `ScrollViewer` to the `StackPanel` to enable scrolling.
 - Add a `TextBlock` to display the GPT response in a way that's more visually distinct from the user's input.
 - Add a `ProgressBar` to indicate when the app is waiting for a response from the GPT API.
-- Center the `StackPanel` in the window, similar to ChatGPT's [web interface](https://chatgpt.com/).
+- Center the `StackPanel` in the window, similar to ChatGPT's [web interface](https://chatgpt.com).
 - Ensure that messages wrap to the next line when they reach the edge of the window.
 - Make the `TextBox` larger and responsive to the `Enter` key.
 
@@ -392,7 +386,7 @@ Your new-and-improved chat interface should look something like this:
 Here's what you accomplished in this how-to:
 
  1. You added OpenAI's API capabilities to your WinUI 3 / Windows App SDK desktop app by installing the official OpenAI library and initializing it with your API key.
- 1. You built a chat-like interface that lets you generate responses to messages using OpenAI's [chat completions API](https://platform.openai.com/docs/guides/text-generation/chat-completions-api).
+ 1. You built a chat-like interface that lets you generate responses to messages using OpenAI's [text generation and prompting APIs](https://platform.openai.com/docs/guides/text).
  1. You improved the chat interface by:
     1. adding a `ScrollViewer`,
     1. using a `TextBlock` to display the GPT response,

hub/apps/how-tos/dall-e-winui3.md

@@ -2,7 +2,7 @@
 title: How to add DALL-E image generation to your WinUI app
 description: Get started with WinUI 3 / Windows App SDK by integrating DALL-E image capabilities into your desktop app. 
 ms.topic: how-to
-ms.date: 11/26/2024
+ms.date: 07/24/2025
 keywords: windows app sdk, winappsdk, winui3
 ms.localizationpriority: medium
 ms.custom: template-quickstart
@@ -17,8 +17,8 @@ In this how-to, we'll integrate DALL-E's image generation capabilities into your
 
 ## Prerequisites
 
-- Set up your development computer (see [Get started with WinUI](../get-started/start-here.md)).
-- A functional chat interface into which this capability will be integrated. See *[How to add OpenAI chat completions to your WinUI 3 / Windows App SDK desktop app](./chatgpt-openai-winui3.md)* - we'll demonstrate how to integrate DALL-E into the chat interface from this how-to.
+- Set up your development computer (see [Start developing Windows apps](../get-started/start-here.md)).
+- A functional chat interface into which this capability will be integrated. See *[How to add OpenAI chat completions to your WinUI / Windows App SDK desktop app](./chatgpt-openai-winui3.md)* - we'll demonstrate how to integrate DALL-E into the chat interface from this how-to.
 - An OpenAI API key from your [OpenAI developer dashboard](https://platform.openai.com/api-keys) assigned to the `OPENAI_API_KEY` environment variable.
 - An OpenAI SDK installed in your project. Refer to the [OpenAI documentation](https://platform.openai.com/docs/libraries) for a list of community libraries. In this how-to, we'll use the official [OpenAI .NET API library](https://github.com/openai/openai-dotnet).
 
@@ -357,6 +357,6 @@ namespace ChatGPT_WinUI3
 
 ## Related content
 
-- [OpenAI API Documentation](https://platform.openai.com/docs/)
+- [OpenAI API Documentation](https://platform.openai.com/docs/overview)
 - [Windows App SDK Samples](../get-started/samples.md)
 - [OpenAI .NET library on GitHub](https://github.com/openai/openai-dotnet)

hub/apps/publish/whats-new-individual-developer.md

@@ -8,9 +8,10 @@ ms.localizationpriority: medium
 
 # What’s new in onboarding for individual developers
 
-Individual developers will be able to use a new onboarding process to publish apps to the Microsoft Store without paying any registration fees. We’ll soon start to progressively roll out the new onboarding process, beginning with the India market.
+A new onboarding process now allows individual developers to publish apps to the Microsoft Store without incurring any registration fees. This process is currently available to developers in India, and will be expanded to other markets gradually.
+ 
+This documentation will be updated as the new onboarding process becomes available to other markets.
 
-This page will be updated when the new onboarding process is available.
 
 ## What’s New
 

hub/powertoys/advanced-paste.md

@@ -27,7 +27,7 @@ From the Settings menu, the following options can be configured:
 
 | Setting | Description |
 | :--- | :--- |
-| Enable Paste with AI | Enables the AI-powered paste feature. An OpenAI API key is required (requires an account on [platform.openai.com](https://platform.openai.com/)). See [Paste text with AI](#paste-text-with-ai) for more information. |
+| Enable Paste with AI | Enables the AI-powered paste feature. An OpenAI API key is required (requires an account on [platform.openai.com](https://platform.openai.com/docs/overview)). See [Paste text with AI](#paste-text-with-ai) for more information. |
 | Enable advanced AI | Enables the Advanced AI feature which allows [Semantic Kernel](/semantic-kernel/overview/) to be used to define a chain of actions to be performed when using "Paste with AI". See [Paste with Advanced AI](#paste-with-advanced-ai) for more information.<br/><br/>This setting is off and disabled when Enable Paste with AI is disabled. When enabling Enable Paste with AI, Enable advanced AI is also enabled by default, allowing users immediate access to the feature. |
 | Custom format preview | Enable to preview the output of the custom format before pasting. |
 | Clipboard history | Enable to automatically save clipboard history. |
@@ -159,7 +159,7 @@ AI output when prompting to "Format the text as if it were written by Mark Twain
 > Say, have you heard the news? The newfangled Advanced Paste feature in PowerToys is finally here! It's a nifty tool that's sure to save you time and spruce up your writing. If you're in the market for a bit of writing wizardry, this here Advanced Paste just might be the ticket for ya.
 
 > [!NOTE]
-> As with any AI tool, the quality of the output is dependent on the quality of the input. The more context you provide, the better the AI will be able to understand and respond to your request. Be sure to carefully review the output before using it. Please see OpenAI's [privacy](https://openai.com/policies/privacy-policy) and [terms](https://openai.com/policies/terms-of-use) pages for more info on AI usage in this feature.
+> As with any AI tool, the quality of the output is dependent on the quality of the input. The more context you provide, the better the AI will be able to understand and respond to your request. Be sure to carefully review the output before using it. Please see OpenAI's [privacy](https://openai.com/policies/privacy-policy/) and [terms](https://openai.com/policies/terms-of-use/) pages for more info on AI usage in this feature.
 
 ### Paste with Advanced AI
 

hub/powertoys/dsc-configure.md

@@ -490,4 +490,4 @@ PowerOcr is the internal name for Text Extractor.
 
 ## Contributing
 
-Refer to the [relevant devdocs](https://github.com/microsoft/PowerToys/tree/main/doc/devdocs/settingsv2/dsc-configure.md) section in the developer documentation to start working on the DSC module.
+Refer to the [relevant devdocs](https://github.com/microsoft/PowerToys/blob/main/doc/devdocs/core/settings/dsc-configure.md) section in the developer documentation to start working on the DSC module.

hub/powertoys/install.md

@@ -86,7 +86,7 @@ Copilot is powered by AI, so surprises and mistakes are possible. For more infor
 
 ### Extracting the MSI from the bundle
 
-Make sure to have [WiX Toolset v3](https://wixtoolset.org/docs/wix3) installed. The command doesn't work with WiX Toolset v4.
+Make sure to have [WiX Toolset v3](https://docs.firegiant.com/wix/wix3/) installed. The command doesn't work with WiX Toolset v4.
 
 This PowerShell example assumes the default install location for WiX Toolset and that the PowerToys installer has been downloaded to the Windows desktop.
 

uwp/security/intro-to-secure-windows-app-development.md

@@ -273,7 +273,7 @@ The app model also manages the app lifecycle. It limits the background execution
 
 When memory resources on the device are running low, Windows frees memory space by terminating apps. This lifecycle model forces apps to persist data whenever they’re suspended, because there is no additional time available between suspension and termination.
 
-For more information, see [It's Universal: Understanding the Lifecycle of a Windows 10/11 Application](https://visualstudiomagazine.com/articles/2015/09/01/its-universal.aspx).
+For more information, see [It's Universal: Understanding the Lifecycle of a Windows 10 Application](https://visualstudiomagazine.com/articles/2015/09/01/its-universal.aspx).
 
 ## 4.2 Stored credential protection