diff --git a/hub/apps/design/app-settings/store-and-retrieve-app-data.md b/hub/apps/design/app-settings/store-and-retrieve-app-data.md index 6d6faab30c..375f9c9833 100644 --- a/hub/apps/design/app-settings/store-and-retrieve-app-data.md +++ b/hub/apps/design/app-settings/store-and-retrieve-app-data.md @@ -163,7 +163,7 @@ Roaming data for an app is available in the cloud as long as it is accessed by t > See important note about [roaming data](#roaming-data). - Use roaming for user preferences and customizations, links, and small data files. For example, use roaming to preserve a user's background color preference across all devices. -- Use roaming to let users continue a task across devices. For example, roam app data like the contents of an drafted email or the most recently viewed page in a reader app. +- Use roaming to let users continue a task across devices. For example, roam app data like the contents of a drafted email or the most recently viewed page in a reader app. - Handle the [**DataChanged**](/uwp/api/windows.storage.applicationdata.datachanged) event by updating app data. This event occurs when app data has just finished syncing from the cloud. - Roam references to content rather than raw data. For example, roam a URL rather than the content of an online article. - For important, time critical settings, use the *HighPriority* setting associated with [**RoamingSettings**](/uwp/api/windows.storage.applicationdata.roamingsettings). diff --git a/hub/apps/design/controls/dialogs-and-flyouts/teaching-tip.md b/hub/apps/design/controls/dialogs-and-flyouts/teaching-tip.md index 226951644a..c800ffc631 100644 --- a/hub/apps/design/controls/dialogs-and-flyouts/teaching-tip.md +++ b/hub/apps/design/controls/dialogs-and-flyouts/teaching-tip.md @@ -27,7 +27,7 @@ Because teaching tip is transient, it would not be the recommended control for p ## Recommendations * Tips are impermanent and should not contain information or options that are critical to the experience of an application. -* Try to avoid showing teaching tips too often. Teaching tips are most likely to each recieve individual attention when they are staggered throughout long sessions or across multiple sessions. +* Try to avoid showing teaching tips too often. Teaching tips are most likely to each receive individual attention when they are staggered throughout long sessions or across multiple sessions. * Keep tips succinct and their topic clear. Research shows users, on average, only read 3-5 words and only comprehend 2-3 words before deciding whether to interact with a tip. * Gamepad accessibility of a teaching tip is not guaranteed. For applications that predict gamepad input, please see [gamepad and remote control interactions]( ../../input/gamepad-and-remote-interactions.md#xy-focus-navigation-and-interaction). It is encouraged to test gamepad accessibility of each teaching tip using all possible configurations of an app's UI. * When enabling a teaching tip to escape the xaml root, it is encouraged to also enable the IsLightDismissEnabled property and set the PreferredPlacement mode nearest to the center of the xaml root. diff --git a/hub/apps/design/controls/item-templates-gridview.md b/hub/apps/design/controls/item-templates-gridview.md index c5e286a56f..8a4e87c3da 100644 --- a/hub/apps/design/controls/item-templates-gridview.md +++ b/hub/apps/design/controls/item-templates-gridview.md @@ -13,7 +13,7 @@ This section contains item templates that you can use with a [**GridView**](/win To demonstrate data binding, these templates bind **GridViewItems** to the example Recording class from the [data binding overview](/windows/uwp/data-binding/data-binding-quickstart). > [!NOTE] -> Currently, when a **DataTemplate** contains multiple controls (for example, more than a single **TextBlock**), the default accessible name for screenreaders comes from .ToString() on the item. As a convenience you can instead set the [**AutomationProperties.Name**](/uwp/api/windows.ui.xaml.automation.automationproperties) on the root element of the **DataTemplate**. For more on accessibility, see [Accessibililty overview](../accessibility/accessibility-overview.md). +> Currently, when a **DataTemplate** contains multiple controls (for example, more than a single **TextBlock**), the default accessible name for screenreaders comes from .ToString() on the item. As a convenience you can instead set the [**AutomationProperties.Name**](/uwp/api/windows.ui.xaml.automation.automationproperties) on the root element of the **DataTemplate**. For more on accessibility, see [Accessibility overview](../accessibility/accessibility-overview.md). ## Icon and text Use these templates to display a collection of apps in a grid with an icon and text. @@ -152,6 +152,6 @@ Use this template to display a media collection with text overlay. ## Related articles - [GridView class](/windows/windows-app-sdk/api/winrt/microsoft.UI.Xaml.Controls.GridView) - [Data binding overview](/windows/uwp/data-binding/data-binding-quickstart) -- [Accessibililty overview](../accessibility/accessibility-overview.md) +- [Accessibility overview](../accessibility/accessibility-overview.md) - [ListView and GridView sample](https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/XamlListView) - [Thumbnail images](/windows/uwp/files/thumbnails) diff --git a/hub/apps/design/controls/item-templates-listview.md b/hub/apps/design/controls/item-templates-listview.md index c51aa51d52..9dc0ac2a9f 100644 --- a/hub/apps/design/controls/item-templates-listview.md +++ b/hub/apps/design/controls/item-templates-listview.md @@ -13,7 +13,7 @@ This section contains item templates that you can use with a [**ListView**](/win To demonstrate data binding, these templates bind **ListViewItems** to the example Recording class from the [data binding overview](/windows/uwp/data-binding/data-binding-quickstart). > [!NOTE] -> Currently, when a **DataTemplate** contains multiple controls (for example, more than a single **TextBlock**), the default accessible name for screenreaders comes from .ToString() on the item. As a convenience you can instead set the [**AutomationProperties.Name**](/uwp/api/windows.ui.xaml.automation.automationproperties) on the root element of the **DataTemplate**. For more on accessibility, see [Accessibililty overview](../accessibility/accessibility-overview.md). +> Currently, when a **DataTemplate** contains multiple controls (for example, more than a single **TextBlock**), the default accessible name for screenreaders comes from .ToString() on the item. As a convenience you can instead set the [**AutomationProperties.Name**](/uwp/api/windows.ui.xaml.automation.automationproperties) on the root element of the **DataTemplate**. For more on accessibility, see [Accessibility overview](../accessibility/accessibility-overview.md). ## Single line list item Use this template to display a list of items with an image and a single line of text. @@ -125,6 +125,6 @@ Use this template to display a list of items with text in defined columns. ## Related articles - [ListView class](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.listview) - [Data binding overview](/windows/uwp/data-binding/data-binding-quickstart) -- [Accessibililty overview](../accessibility/accessibility-overview.md) +- [Accessibility overview](../accessibility/accessibility-overview.md) - [ListView and GridView sample](https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/XamlListView) - [Thumbnail images](/windows/uwp/files/thumbnails) diff --git a/hub/apps/design/input/guidelines-for-visualfeedback.md b/hub/apps/design/input/guidelines-for-visualfeedback.md index f321e546c5..a83a82c896 100644 --- a/hub/apps/design/input/guidelines-for-visualfeedback.md +++ b/hub/apps/design/input/guidelines-for-visualfeedback.md @@ -89,7 +89,7 @@ The thickness, margin, or whether or not the app-developer wishes to have the fo ### Color Properties -There are only two color properties for the focus visuals: the primary border color, and the secondary border color. These focus visual border colors can be changed per-control on an page level, and globally on an app-wide level: +There are only two color properties for the focus visuals: the primary border color, and the secondary border color. These focus visual border colors can be changed per-control on a page level, and globally on an app-wide level: To brand focus visuals app-wide, override the system brushes: ```XAML diff --git a/hub/apps/design/motion/directionality-and-gravity.md b/hub/apps/design/motion/directionality-and-gravity.md index fab0cedbe8..80ddaf7aab 100644 --- a/hub/apps/design/motion/directionality-and-gravity.md +++ b/hub/apps/design/motion/directionality-and-gravity.md @@ -38,7 +38,7 @@ Directional signals help to solidify the mental model of the journey a user take :::row::: :::column::: Direction of movement corresponds to physical motion. Just like in nature, objects can move in any world axis - X,Y,Z. This is how we think of the movement of objects on the screen. -When you move objects, avoid unnatural collisions. ​Keep in mind where objects come from and go to, and alway support higher level constructs that may be used in the scene, such as scroll direction or layout hierarchy.​ +When you move objects, avoid unnatural collisions. ​Keep in mind where objects come from and go to, and always support higher level constructs that may be used in the scene, such as scroll direction or layout hierarchy.​ :::column-end::: :::column::: ![Short video showing a circle and then the addition of an X axis, a Y axis, and a Z axis.](images/direction.gif) diff --git a/hub/apps/design/style/iconography/app-icon-construction.md b/hub/apps/design/style/iconography/app-icon-construction.md index 52d2450dff..a0177128d4 100644 --- a/hub/apps/design/style/iconography/app-icon-construction.md +++ b/hub/apps/design/style/iconography/app-icon-construction.md @@ -183,7 +183,7 @@ Windows 10 supports four tile sizes: small, medium, wide, and large. * LargeTile.scale-125_altform-colorful_theme-light.png * LargeTile.scale-150_altform-colorful_theme-light.png * LargeTile.scale-200_altform-colorful_theme-light.png -8 LargeTile.scale-400_altform-colorful_theme-light.png +* LargeTile.scale-400_altform-colorful_theme-light.png > [!NOTE] > Windows 11 does not use the tile assets, but currently at minimum the Medium tile assets at 100% are required to publish to the Microsoft Store. If your app is Windows 10 & 11 compatible it is suggested that you include as many tile assets as possible. diff --git a/hub/apps/desktop/modernize/modernize-wpf-tutorial-4.md b/hub/apps/desktop/modernize/modernize-wpf-tutorial-4.md index 3e0e15348f..7ff33e6c32 100644 --- a/hub/apps/desktop/modernize/modernize-wpf-tutorial-4.md +++ b/hub/apps/desktop/modernize/modernize-wpf-tutorial-4.md @@ -387,7 +387,7 @@ To add a notification to the app: } ``` - Toast notifications are represented by an XML payload, which can include text, images, actions, and more. You can find all the supported elements [here](/windows/uwp/design/shell/tiles-and-notifications/toast-schema). This code uses a very simple schema with two lines of text: the title and the body. After the code defines the XML payload and loads it in a **XmlDocument** object, it wraps the XML in a **ToastNotification** object and shows it by using the **ToastNotificationManager** class. + Toast notifications are represented by an XML payload, which can include text, images, actions, and more. You can find all the supported elements [here](/windows/uwp/design/shell/tiles-and-notifications/toast-schema). This code uses a very simple schema with two lines of text: the title and the body. After the code defines the XML payload and loads it in an **XmlDocument** object, it wraps the XML in a **ToastNotification** object and shows it by using the **ToastNotificationManager** class. 5. In the **ContosoExpenses.Core** project, expand the **ViewModels** folder and open the **AddNewExpenseViewModel.cs** file. diff --git a/hub/apps/desktop/modernize/modernize-wpf-tutorial.md b/hub/apps/desktop/modernize/modernize-wpf-tutorial.md index bf73c67674..4acae50e74 100644 --- a/hub/apps/desktop/modernize/modernize-wpf-tutorial.md +++ b/hub/apps/desktop/modernize/modernize-wpf-tutorial.md @@ -85,7 +85,7 @@ The following sections provide background for some of the key concepts discussed In Windows 8, Microsoft introduced a new API set as part of the Windows Runtime (WinRT). Unlike the .NET Framework, WinRT is a native layer of APIs which are exposed directly to apps. WinRT also introduced language projections, which are layers added on top of the runtime to allow developers to interact with it using languages such as C# and JavaScript in addition to C++. Projections enable developers to build apps on top of WinRT that leverage the same C# and XAML knowledge they acquired in building apps with the .NET Framework. -In Windows 10, Microsoft introduced the [Universal Windows Platform (UWP)](/windows/uwp/get-started/universal-application-platform-guide), which is built on top of WinRT. The most important feature of UWP is that it offers a common set of APIs across every device platform: no matter if the app is running on a desktop, on a Xbox One or on a HoloLens, you’re able to use the same APIs. +In Windows 10, Microsoft introduced the [Universal Windows Platform (UWP)](/windows/uwp/get-started/universal-application-platform-guide), which is built on top of WinRT. The most important feature of UWP is that it offers a common set of APIs across every device platform: no matter if the app is running on a desktop, on an Xbox One or on a HoloLens, you’re able to use the same APIs. Going forward, most new Windows features are exposed via WinRT APIs, including features such as Timeline, Project Rome, and Windows Hello. diff --git a/hub/apps/develop/feeds/implement-feed-provider-cs.md b/hub/apps/develop/feeds/implement-feed-provider-cs.md index da5cb53190..092d483930 100644 --- a/hub/apps/develop/feeds/implement-feed-provider-cs.md +++ b/hub/apps/develop/feeds/implement-feed-provider-cs.md @@ -451,3 +451,7 @@ To convert the console app created in this walkthrough to a Windows app, right-c After you have developed and tested your feed provider you can publish your app on the Microsoft Store in order for users to install your feeds on their devices. For step by step guidance for publishing an app, see [Publish your app in the Microsoft Store](/windows/apps/publish/publish-your-app/overview?pivots=store-installer-msix). +### The Feeds Store Collection + +After your app has been published on the Microsoft Store, you can request for your app to be included in the feeds Store Collection that helps users discover apps that feature Windows feeds. To submit your request, see [Submit your Feed/Board for addition to the Store Collection](https://forms.office.com/Pages/ResponsePage.aspx?id=v4j5cvGGr0GRqy180BHbR33MBPKauFRGiaSf7B00-UBUMk9FU1M0TEVOTjA4R0xGQTQwNU1aTFVQNi4u). + diff --git a/hub/apps/develop/feeds/implement-feed-provider-win32.md b/hub/apps/develop/feeds/implement-feed-provider-win32.md index 8b1c9df776..40e942597d 100644 --- a/hub/apps/develop/feeds/implement-feed-provider-win32.md +++ b/hub/apps/develop/feeds/implement-feed-provider-win32.md @@ -466,3 +466,6 @@ To convert the console app created in this walkthrough to a Windows app: After you have developed and tested your feed provider you can publish your app on the Microsoft Store in order for users to install your feeds on their devices. For step by step guidance for publishing an app, see [Publish your app in the Microsoft Store](/windows/apps/publish/publish-your-app/overview?pivots=store-installer-msix). +### The Feeds Store Collection + +After your app has been published on the Microsoft Store, you can request for your app to be included in the feeds Store Collection that helps users discover apps that feature Windows feeds. To submit your request, see [Submit your Feed/Board for addition to the Store Collection](https://forms.office.com/Pages/ResponsePage.aspx?id=v4j5cvGGr0GRqy180BHbR33MBPKauFRGiaSf7B00-UBUMk9FU1M0TEVOTjA4R0xGQTQwNU1aTFVQNi4u). diff --git a/hub/apps/develop/win2d/offscreen-drawing.md b/hub/apps/develop/win2d/offscreen-drawing.md index 2a220cf453..3e8b30b711 100644 --- a/hub/apps/develop/win2d/offscreen-drawing.md +++ b/hub/apps/develop/win2d/offscreen-drawing.md @@ -47,7 +47,7 @@ GaussianBlurEffect blurEffect = new GaussianBlurEffect() }; ``` -An app can close, and re-open drawing sessions on a `CanvasRenderTarget` abitrarily many times. +An app can close, and re-open drawing sessions on a `CanvasRenderTarget` arbitrarily many times. Drawing operations are not committed to the `CanvasRenderTarget` until the drawing session object is disposed. In C#, a `using` block can organize this. diff --git a/hub/apps/index.yml b/hub/apps/index.yml index 32762530ca..b6056783d2 100644 --- a/hub/apps/index.yml +++ b/hub/apps/index.yml @@ -50,7 +50,7 @@ productDirectory: - url: ./get-started/start-here.md text: Get started with WinUI - url: ./windows-app-sdk/support.md - text: Windows App SDK and suppported Windows releases + text: Windows App SDK and supported Windows releases - url: ./windows-app-sdk/set-up-your-development-environment.md text: Install tools for the Windows App SDK - url: ./get-started/samples.md diff --git a/hub/apps/publish/store-policies.md b/hub/apps/publish/store-policies.md index d8d2e7fbb6..50f616c461 100644 --- a/hub/apps/publish/store-policies.md +++ b/hub/apps/publish/store-policies.md @@ -1,7 +1,7 @@ --- title: Microsoft Store Policies description: Products on the Store must meet our certification standards, offer customers a truly useful and engaging experience, and provide a good fit for the Store. -ms.date: 01/16/2024 +ms.date: 07/2/2024 ms.topic: article keywords: store policies agreement ms.localizationpriority: high @@ -584,18 +584,19 @@ All products should adhere to the Microsoft Store Policies listed above. If your ### Microsoft Store complaint and appeal statistics -Numbers reported on 8/1/2023 (from 7/1/2022 through 6/30/2023) - -| Statistic | Count | -|----------------------------------------------|----------| -| App and/or Account Enforcement Action Appeals | 1,616 | -| Complaints about Technological Issues | 54 | -| Regulatory Compliance Complaints | 0 | -| Questions about certification, policy, submission, and technical help | 1,772 | -| Miscellaneous | 357 | -| Total Issues | 4,212 | -| Overturned decisions | 842 | -| Average Processing Time | 5.95 days | +Numbers reported on umbers reported on 7/2/2024 (from 7/1/2023 – 6/30/2024) + + +| Statistic (FY2024) | Count | +|--------------------|----------| +| App and/or Account Enforcement Action Appeals | 829 | +| Complaints about Technological Issues | 36 | +| Regulatory Compliance Complaints | 0 | +| Questions about certification, policy, submission, and technical help | 2,554 | +| Miscellaneous | 663 | +| Total Issues | 4,542 | +| Overturned decisions | 587 | +| Average Processing Time | 2.10 days | ### See also diff --git a/hub/apps/toc.yml b/hub/apps/toc.yml index 524b5e110e..08ca50e9ea 100644 --- a/hub/apps/toc.yml +++ b/hub/apps/toc.yml @@ -677,6 +677,8 @@ items: href: windows-app-sdk/release-notes-archive/preview-channel-1.0.md - name: Experimental channel release notes items: + - name: Windows App SDK 1.5 + href: windows-app-sdk/release-notes-archive/experimental-channel-1.5.md - name: Windows App SDK 1.4 href: windows-app-sdk/release-notes-archive/experimental-channel-1.4.md - name: Windows App SDK 1.3 diff --git a/hub/apps/windows-app-sdk/check-windows-app-sdk-versions.md b/hub/apps/windows-app-sdk/check-windows-app-sdk-versions.md index ce1f969971..008ff0b9f0 100644 --- a/hub/apps/windows-app-sdk/check-windows-app-sdk-versions.md +++ b/hub/apps/windows-app-sdk/check-windows-app-sdk-versions.md @@ -148,7 +148,7 @@ Status : Ok ## Related topics -- [Windows App SDK and suppported Windows releases](support.md) +- [Windows App SDK and supported Windows releases](support.md) - [Runtime architecture](deployment-architecture.md) - [Windows App SDK deployment guide for framework-dependent apps packaged with external location or unpackaged](deploy-unpackaged-apps.md) - [Windows App SDK deployment guide for framework-dependent packaged apps](deploy-packaged-apps.md) diff --git a/hub/apps/windows-app-sdk/downloads.md b/hub/apps/windows-app-sdk/downloads.md index 9fec9216f7..728b3f7a23 100644 --- a/hub/apps/windows-app-sdk/downloads.md +++ b/hub/apps/windows-app-sdk/downloads.md @@ -42,6 +42,7 @@ For all the latest Windows App SDK downloads, refer to the tables and links belo | Version | Runtime downloads | |---|---| +| [1.6 Experimental2 (1.6.240701003-experimental2) ](/windows/apps/windows-app-sdk/experimental-channel#version-16-experimental-160-experimental2)
07/02/2024
[Release notes](/windows/apps/windows-app-sdk/experimental-channel#version-16-experimental-160-experimental2)
[Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.6-experimental2) | [Installer (x64)](https://aka.ms/windowsappsdk/1.6/1.6.240701003-experimental2/windowsappruntimeinstall-x64.exe)
[Installer (x86)](https://aka.ms/windowsappsdk/1.6/1.6.240701003-experimental2/windowsappruntimeinstall-x86.exe)
[Installer (arm64)](https://aka.ms/windowsappsdk/1.6/1.6.240701003-experimental2/windowsappruntimeinstall-arm64.exe)
[Redistributable](https://aka.ms/windowsappsdk/1.6/1.6.240701003-experimental2/Microsoft.WindowsAppRuntime.Redist.1.6.zip) | | [1.6 Experimental1 (1.6.240531000-experimental1) ](/windows/apps/windows-app-sdk/experimental-channel#version-16-experimental-160-experimental1)
06/04/2024
[Release notes](/windows/apps/windows-app-sdk/experimental-channel#version-16-experimental-160-experimental1)
[Source](https://github.com/microsoft/microsoft-ui-xaml/releases/tag/winui3%2Frelease%2F1.6-experimental1) | [Installer (x64)](https://aka.ms/windowsappsdk/1.6/1.6.240531000-experimental1/windowsappruntimeinstall-x64.exe)
[Installer (x86)](https://aka.ms/windowsappsdk/1.6/1.6.240531000-experimental1/windowsappruntimeinstall-x86.exe)
[Installer (arm64)](https://aka.ms/windowsappsdk/1.6/1.6.240531000-experimental1/windowsappruntimeinstall-arm64.exe)
[Redistributable](https://aka.ms/windowsappsdk/1.6/1.6.240531000-experimental1/Microsoft.WindowsAppRuntime.Redist.1.6.zip) | Depending on your development scenario, you might require the following: diff --git a/hub/apps/windows-app-sdk/experimental-channel.md b/hub/apps/windows-app-sdk/experimental-channel.md index 1f435af8f2..577813923a 100644 --- a/hub/apps/windows-app-sdk/experimental-channel.md +++ b/hub/apps/windows-app-sdk/experimental-channel.md @@ -28,6 +28,409 @@ The experimental channel includes releases of the Windows App SDK with [experime - [Experimental channel release notes for the Windows App SDK 1.0](release-notes-archive/experimental-channel-1.0.md) - [Experimental channel release notes for the Windows App SDK 0.8](release-notes-archive/experimental-channel-0.8.md) +## Version 1.6 Experimental (1.6.0-experimental2) + +This is the latest release of the experimental channel. + +To download, retarget your WinAppSDK NuGet version to `1.6.240701003-experimental2`. + +> [!NOTE] +> Phi Silica and OCR APIs are not included in this release. These will be coming in a future 1.6 release. + +### Native AOT support updates + +In 1.6-experimental1, the XAML compiler was generating `XamlTypeInfo.g.cs` with code that wasn’t safe for AOT/Trimming. This relates to GitHub issue [#9675](https://github.com/microsoft/microsoft-ui-xaml/issues/9675), though it does not fully fix that issue. + +### Changed Edge WebView2 SDK Integration + +The Windows App SDK now consumes the Edge WebView2 SDK as a NuGet reference rather than embedding a hardcoded version of the Edge WebView2 SDK. The new model allows apps to choose a newer version of the `Microsoft.Web.WebView2` package instead of being limited to the version with which the Windows App SDK was built. The new model also allows apps to reference NuGet packages which also reference the Edge WebView2 SDK. For more info, see GitHub issue [#5689](https://github.com/microsoft/microsoft-ui-xaml/issues/5689). + +### New Package Deployment APIs + +The Package Management API has received several enhancements including Is\*ReadyOrNewerAvailable\*(), EnsureReadyOptions.RegisterNewerIfAvailable, Is\*Provisioned\*(), IsPackageRegistrationPending(), and several bug fixes. See [PackageManagement.md](https://github.com/microsoft/WindowsAppSDK/blob/main/specs/packagemanager/PackageManagement.md) and [Pull Request #4453](https://github.com/microsoft/WindowsAppSDK/pull/4453) for more details. + +### Other notable changes + +- Starting with 1.6-experimental2, the latest WinUI 3 source will now publish to the main branch in the microsoft-ui-xaml GitHub repo, which will enable source searching in that repo. +- We added a new `ColorHelper.ToDisplayName()` API, filling that gap from UWP. + - **Known issue:** Some language translations have character encoding issues. This will be fixed in the next 1.6 release. +- Added a new `Microsoft.Windows.Globalization.ApplicationLanguages` class, which notably includes a new `PrimaryLanguageOverride` feature. For more info, see GitHub issue [#4523](https://github.com/microsoft/WindowsAppSDK/pull/4523). +- New extensions enable Widget Providers to provide Widgets with web content and announcements for Widgets. + +### New APIs for 1.6-experimental2 + +1.6-experimental2 includes the following new APIs. These APIs are not experimental, but are not yet included in a stable release version of the WinAppSDK. + +```C# +Microsoft.UI.Xaml.Controls + + PipsPager + WrapMode + WrapModeProperty + + PipsPagerWrapMode +``` + +```C# +Microsoft.Windows.Globalization + + ApplicationLanguages +``` + +```C# +Microsoft.Windows.Management.Deployment + + EnsureReadyOptions + RegisterNewerIfAvailable + + PackageDeploymentFeature + PackageDeploymentManager + IsPackageDeploymentFeatureSupported + IsPackageProvisioned + IsPackageProvisionedByUri + IsPackageReadyOrNewerAvailable + IsPackageReadyOrNewerAvailableByUri + IsPackageSetProvisioned + IsPackageSetReadyOrNewerAvailable + + PackageReadyOrNewerAvailableStatus +``` + +### Additional 1.6-experimental1 APIs + +This release includes the following new and modified experimental APIs: + +```C# +Microsoft.UI + + ColorHelper + ToDisplayName +``` + +```C# +Microsoft.UI.Composition + + CompositionNotificationDeferral +``` + +```C# +Microsoft.UI.Composition.Experimental + + ExpCompositionVisualSurface + ExpExpressionNotificationProperty + IExpCompositionPropertyChanged + IExpCompositionPropertyChangedListener + IExpCompositor + IExpVisual +``` + +```C# +Microsoft.UI.Content + + AutomationOptions + ChildContentLink + ContentAppWindowBridge + ContentDisplayOrientations + ContentExternalBackdropLink + ContentExternalOutputLink + ContentIsland + Children + Compositor + Connected + ConnectionInfo + ConnectRemoteEndpoint + Create + Disconnected + FindAllForCompositor + FragmentRootAutomationProvider + GetByVisual + IsRemoteEndpointConnected + NextSiblingAutomationProvider + Offset + ParentAutomationProvider + PreviousSiblingAutomationProvider + Root + RotationAngleInDegrees + + ContentIslandEnvironment + AutomationOption + CurrentOrientation + DisplayScale + NativeOrientation + ThemeChanged + + ContentSite + Compositor + Offset + RotationAngleInDegrees + SetContentNodeParent + SetIsInputPassThrough + SiteVisual + TryGetAutomationProvider + + ContentSiteAutomationProviderRequestedEventArgs + ContentSiteEnvironment + CurrentOrientation + DisplayScale + NativeOrientation + NotifyThemeChanged + + ContentSiteView + Offset + RotationAngleInDegrees + + CoreWindowSiteBridge + CoreWindowTopLevelWindowBridge + DesktopChildSiteBridge + AcceptRemoteEndpoint + ConnectionInfo + IsRemoteEndpointConnected + RemoteEndpointConnecting + RemoteEndpointDisconnected + RemoteEndpointRequestedStateChanged + + DesktopSiteBridge + TryCreatePopupSiteBridge + + EndpointConnectionEventArgs + EndpointRequestedStateChangedEventArgs + IContentIslandEndpointConnectionPrivate + IContentLink + IContentNodeOwner + IContentSiteBridge2 + IContentSiteBridgeAutomation + IContentSiteBridgeEndpointConnectionPrivate + PopupWindowSiteBridge + ProcessStarter + ReadOnlyDesktopSiteBridge + SystemVisualSiteBridge +``` + +```C# +Microsoft.UI.Input + + EnteredMoveSizeEventArgs + EnteringMoveSizeEventArgs + ExitedMoveSizeEventArgs + InputKeyboardSource + GetForWindowId + + InputLayoutPolicy + InputLightDismissAction + GetForIsland + + InputNonClientPointerSource + EnteredMoveSize + EnteringMoveSize + ExitedMoveSize + WindowRectChanged + WindowRectChanging + + InputPointerActivationBehavior + InputPointerSource + ActivationBehavior + DirectManipulationHitTest + GetForVisual + GetForWindowId + RemoveForVisual + TouchHitTesting + TrySetDeviceKinds + + MoveSizeOperation + ProximityEvaluation + TouchHitTestingEventArgs + WindowRectChangedEventArgs + WindowRectChangingEventArgs +``` + +```C# +Microsoft.UI.Input.Experimental + + ExpInputSite + ExpPointerPoint +``` + +```C# +Microsoft.UI.Windowing + + AppWindow + DefaultTitleBarShouldMatchAppModeTheme + + DisplayArea + GetMetricsFromWindowId +``` + +```C# +Microsoft.UI.Xaml + + XamlIsland + XamlRoot + CoordinateConverter + TryGetContentIsland +``` + +```C# +Microsoft.UI.Xaml.Automation.Peers + + PagerControlAutomationPeer + ScrollPresenterAutomationPeer +``` + +```C# +Microsoft.UI.Xaml.Controls + + ContentDialogPlacement + UnconstrainedPopup + + ElementFactory + FlowLayout + FlowLayoutAnchorInfo + FlowLayoutLineAlignment + FlowLayoutState + IApplicationViewSpanningRects + IndexPath + ISelfPlayingAnimatedVisual + ItemContainer + CanUserInvoke + CanUserInvokeProperty + CanUserSelect + CanUserSelectProperty + ItemInvoked + MultiSelectMode + MultiSelectModeProperty + + ItemContainerInteractionTrigger + ItemContainerInvokedEventArgs + ItemContainerMultiSelectMode + ItemContainerUserInvokeMode + ItemContainerUserSelectMode + LayoutPanel + NumberBox + InputScope + InputScopeProperty + TextAlignment + TextAlignmentProperty + + PagerControl + PagerControlButtonVisibility + PagerControlDisplayMode + PagerControlSelectedIndexChangedEventArgs + PagerControlTemplateSettings + ProgressRing + DeterminateSource + DeterminateSourceProperty + IndeterminateSource + IndeterminateSourceProperty + + RecyclePool + RecyclingElementFactory + ScrollingViewChangingEventArgs + ScrollView + ViewChanging + + SelectionModel + SelectionModelChildrenRequestedEventArgs + SelectionModelSelectionChangedEventArgs + SelectTemplateEventArgs + StackLayout + IsVirtualizationEnabled + IsVirtualizationEnabledProperty + + StackLayoutState + TabView + CanTearOutTabs + CanTearOutTabsProperty + ExternalTornOutTabsDropped + ExternalTornOutTabsDropping + TabTearOutRequested + TabTearOutWindowRequested + + TabViewExternalTornOutTabsDroppedEventArgs + TabViewExternalTornOutTabsDroppingEventArgs + TabViewTabTearOutRequestedEventArgs + TabViewTabTearOutWindowRequestedEventArgs + TitleBar + TitleBarAutomationPeer + TitleBarTemplateSettings + UniformGridLayoutState +``` + +```C# +Microsoft.UI.Xaml.Controls.Primitives + + ScrollPresenter + ViewChanging +``` + +```C# +Microsoft.Windows.ApplicationModel.WindowsAppRuntime + + DeploymentManager + Repair + + DeploymentStatus + PackageRepairFailed + + ReleaseInfo + RuntimeInfo + VersionInfoContract +``` + +```C# +Microsoft.Windows.Widgets.Feeds.Providers + + FeedManager + TryRemoveAnnouncementById + + IFeedManager3 +``` + +```C# +Microsoft.Windows.Widgets.Notifications + + WidgetAnnouncement + WidgetAnnouncementInvokedArgs +``` + +```C# +Microsoft.Windows.Widgets.Providers + + IWidgetAnnouncementInvokedTarget + IWidgetManager2 + IWidgetManager3 + IWidgetProviderMessage + IWidgetResourceProvider + WidgetManager + SendMessageToContent + TryRemoveAnnouncementById + TryShowAnnouncement + + WidgetMessageReceivedArgs + WidgetResourceRequest + WidgetResourceRequestedArgs + WidgetResourceResponse +``` + +### Known issues + +- For TabView tab tear-out, pointer input behavior for *CanTearOutTabs* is incorrect on monitors with scale factor different from 100%. This will be fixed in the next 1.6 release. + +### Bug fixes + +- Fixed an issue from 1.6-experimental1 where `NumberBox` wasn't using the correct foreground and background colors. For more info, see GitHub issue [#9714](https://github.com/microsoft/microsoft-ui-xaml/issues/9714). +- Fixed an issue where duplicate `KeyUp` events were raised for arrow and tab keys. For more info, see GitHub issue [#9399](https://github.com/microsoft/microsoft-ui-xaml/issues/9399). +- Fixed an issue where the `PowerManager.SystemSuspendStatusChanged` event was unusable to get the `SystemSuspendStatus`. For more info, see GitHub issue [#2833](https://github.com/microsoft/WindowsAppSDK/issues/2833). +- Fixed an issue where initial keyboard focus was not correctly given to a `WebView2` when that was the only control in the window. +- Fixed an issue when using `ExtendsContentIntoTitleBar=true` where the Min/Max/Close buttons did not correctly appear in the UI Automation, which prevented Voice Access from showing numbers for those buttons. +- Fixed an issue where an app might crash in a lock check due to unexpected reentrancy. +- Fixed an issue from 1.6-experimental1 where `TitleBar` only shows the Icon and Title because some elements did not show up on load. +- Fixed an issue where `Hyperlink` colors did not correctly update when switching into a high contrast theme. +- Fixed an issue where changing the collection of a `ListView` in a background window may incorrectly move that window to the foreground and take focus. +- Fixed an issue from 1.6-experimental1 where setting `AcrylicBrush.TintLuminosityOpacity` in .xaml in a class library project would crash with a type conversion error. +- Fixed an issue where calling `ItemsRepeater.StartBringIntoView` could sometimes cause items to disappear. +- Fixed an issue where touching and dragging on a `Button` in a `ScrollViewer` would leave it in a pressed state. +- Updated IntelliSense, which was missing information for many newer types and members. + ## Version 1.6 Experimental (1.6.0-experimental1) This is the latest release of the experimental channel. @@ -178,7 +581,7 @@ Microsoft.UI.Xaml.Controls Wrap ``` -## Additional 1.6-experimental1 APIs +### Additional 1.6-experimental1 APIs This release includes the following new and modified experimental APIs: @@ -208,7 +611,9 @@ Microsoft.UI.Content IContentLink IContentSiteBridge2 ReadOnlyDesktopSiteBridge +``` +```C# Microsoft.UI.Input EnteredMoveSizeEventArgs @@ -224,18 +629,24 @@ Microsoft.UI.Input MoveSizeOperation WindowRectChangedEventArgs WindowRectChangingEventArgs +``` +```C# Microsoft.UI.Windowing AppWindow DefaultTitleBarShouldMatchAppModeTheme +``` +```C# Microsoft.UI.Xaml XamlRoot CoordinateConverter TryGetContentIsland +``` +```C# Microsoft.UI.Xaml.Controls ScrollingViewChangingEventArgs @@ -261,7 +672,9 @@ Microsoft.UI.Xaml.Controls TitleBar TitleBarAutomationPeer TitleBarTemplateSettings +``` +```C# Microsoft.UI.Xaml.Controls.Primitives ScrollPresenter diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/api-mapping-table.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/api-mapping-table.md index 7e2f2125dc..3df542371f 100644 --- a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/api-mapping-table.md +++ b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/api-mapping-table.md @@ -107,4 +107,4 @@ This section documents various libraries that were supported in UWP, and need to ## See Also -- [Windows App SDK and suppported Windows releases](../support.md) +- [Windows App SDK and supported Windows releases](../support.md) diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/case-study-1.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/case-study-1.md index 6bbbf951f0..df94e998cd 100644 --- a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/case-study-1.md +++ b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/case-study-1.md @@ -311,4 +311,4 @@ Now build the project, and run the app to test it. Select an image, set a zoom l ## See Also -- [Windows App SDK and suppported Windows releases](../support.md) +- [Windows App SDK and supported Windows releases](../support.md) diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/case-study-2.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/case-study-2.md index da5bd78e57..d3b15a6323 100644 --- a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/case-study-2.md +++ b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/case-study-2.md @@ -439,7 +439,7 @@ From here, the remaining steps to migrate the code that you copied are the same ## Related topics -* [Windows App SDK and suppported Windows releases](../support.md) +* [Windows App SDK and supported Windows releases](../support.md) * [UWP Photo Editor sample app](/samples/microsoft/windows-appsample-photo-editor/photo-editor-cwinrt-sample-application/) * [Overall migration strategy](overall-migration-strategy.md) * [Mapping UWP APIs to the Windows App SDK](api-mapping-table.md) diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/feature-mapping-table.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/feature-mapping-table.md index ce1445e405..7fdedc9269 100644 --- a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/feature-mapping-table.md +++ b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/feature-mapping-table.md @@ -31,4 +31,4 @@ This topic compares major feature areas in the different forms in which they app ## See Also -- [Windows App SDK and suppported Windows releases](../support.md) +- [Windows App SDK and supported Windows releases](../support.md) diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/applifecycle.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/applifecycle.md index af51414b9e..3ab60060f8 100644 --- a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/applifecycle.md +++ b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/applifecycle.md @@ -214,6 +214,6 @@ See the [File type association](#file-type-association) section above for more d ## Related topics -* [Windows App SDK and suppported Windows releases](../../support.md) +* [Windows App SDK and supported Windows releases](../../support.md) * [App instancing with the app lifecycle API](../../applifecycle/applifecycle-instancing.md) * [Do I need to implement page navigation?](winui3.md#do-i-need-to-implement-page-navigation) diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/dwritecore.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/dwritecore.md index 236c98f005..14cc31b4d5 100644 --- a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/dwritecore.md +++ b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/dwritecore.md @@ -32,7 +32,7 @@ Also see the [DWriteCoreGallery](https://github.com/microsoft/WindowsAppSDK-Samp ## Related topics -* [Windows App SDK and suppported Windows releases](../../support.md) +* [Windows App SDK and supported Windows releases](../../support.md) * [DWriteCore overview](/windows/win32/directwrite/dwritecore-overview) * [DWriteCoreGallery](https://github.com/microsoft/WindowsAppSDK-Samples/tree/main/Samples/TextRendering) sample app * [DirectWrite](/windows/win32/directwrite/direct-write-portal) diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/feature-area-guides-ovw.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/feature-area-guides-ovw.md index b912a3cf0e..26dc428199 100644 --- a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/feature-area-guides-ovw.md +++ b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/feature-area-guides-ovw.md @@ -28,4 +28,4 @@ A collection of migration guidance topics, each focusing on a specific feature a ## See Also -* [Windows App SDK and suppported Windows releases](../../support.md) +* [Windows App SDK and supported Windows releases](../../support.md) diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/mrtcore.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/mrtcore.md index fd158bd8d0..5390fa328c 100644 --- a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/mrtcore.md +++ b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/mrtcore.md @@ -112,7 +112,7 @@ Also see the [Load resources using MRT Core](https://github.com/microsoft/Window ## Related Topics -* [Windows App SDK and suppported Windows releases](../../support.md) +* [Windows App SDK and supported Windows releases](../../support.md) * [Manage resources with MRT Core](../../mrtcore/mrtcore-overview.md) * [MRT Core images](https://github.com/MicrosoftDocs/windows-uwp/tree/docs/hub/apps/windows-app-sdk/mrtcore/images) * [Resource Management System](/windows/uwp/app-resources/resource-management-system) diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/notifications.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/notifications.md index 58ea24e57c..13624e8989 100644 --- a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/notifications.md +++ b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/notifications.md @@ -92,4 +92,4 @@ Content-Length: 46 ## See Also -* [Windows App SDK and suppported Windows releases](../../support.md) +* [Windows App SDK and supported Windows releases](../../support.md) diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/threading.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/threading.md index 7cf58c1b66..87f6305689 100644 --- a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/threading.md +++ b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/threading.md @@ -210,4 +210,4 @@ winrt::fire_and_forget MainPage::ClickHandler(IInspectable const&, RoutedEventAr ## See Also -* [Windows App SDK and suppported Windows releases](../../support.md) +* [Windows App SDK and supported Windows releases](../../support.md) diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/toast-notifications.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/toast-notifications.md index 07a5d2b2db..8abff4ec0a 100644 --- a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/toast-notifications.md +++ b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/toast-notifications.md @@ -420,6 +420,6 @@ new ToastContentBuilder() ## Related topics -* [Windows App SDK and suppported Windows releases](../../support.md) +* [Windows App SDK and supported Windows releases](../../support.md) * [Send a local toast notification from C# apps](../../../design/shell/tiles-and-notifications/send-local-toast.md) * [Send a local toast notification from Win32 C++ WRL apps](../../../design/shell/tiles-and-notifications/send-local-toast-desktop-cpp-wrl.md) diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/windowing.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/windowing.md index a63fed16c6..90fc6f298a 100644 --- a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/windowing.md +++ b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/windowing.md @@ -216,5 +216,5 @@ For more info, and code examples, see [Change Windows.UI.Core.CoreDispatcher to ## Related topics -* [Windows App SDK and suppported Windows releases](../../support.md) +* [Windows App SDK and supported Windows releases](../../support.md) * [Migrate your threading functionality](threading.md) diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/winui3.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/winui3.md index 091b039ce5..da77ff544d 100644 --- a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/winui3.md +++ b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/guides/winui3.md @@ -257,5 +257,5 @@ So if you're accessing the **AcrylicBrush.BackgroundSource** property in the sou ## Related topics -* [Windows App SDK and suppported Windows releases](../../support.md) +* [Windows App SDK and supported Windows releases](../../support.md) * [Display WinRT UI objects that depend on CoreWindow](../../../develop/ui-input/display-ui-objects.md) \ No newline at end of file diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/migrate-to-windows-app-sdk-ovw.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/migrate-to-windows-app-sdk-ovw.md index acb668d008..747af0467a 100644 --- a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/migrate-to-windows-app-sdk-ovw.md +++ b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/migrate-to-windows-app-sdk-ovw.md @@ -53,4 +53,4 @@ When transitioning to the Windows App SDK, UWP applications might lose the inher ## See Also -- [Windows App SDK and suppported Windows releases](../support.md) +- [Windows App SDK and supported Windows releases](../support.md) diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/misc-info.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/misc-info.md index 93c60dbe37..cb0599c7a9 100644 --- a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/misc-info.md +++ b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/misc-info.md @@ -69,4 +69,4 @@ In a C++/WinRT project, you can manually revoke (unregister) an event handler su ## See Also -- [Windows App SDK and suppported Windows releases](../support.md) +- [Windows App SDK and supported Windows releases](../support.md) diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/overall-migration-strategy.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/overall-migration-strategy.md index 04cae9c80e..0aa6cddede 100644 --- a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/overall-migration-strategy.md +++ b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/overall-migration-strategy.md @@ -111,7 +111,7 @@ For example, in the case study [A Windows App SDK migration of the UWP PhotoLab ## Related topics -* [Windows App SDK and suppported Windows releases](../support.md) +* [Windows App SDK and supported Windows releases](../support.md) * [Windows Runtime (WinRT)](/uwp/api/) APIs * [WinUI](../../winui/index.md) * [Stable release channel for the Windows App SDK](../stable-channel.md) diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/upgrade-assistant.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/upgrade-assistant.md index a381e45810..daa0dbc8c7 100644 --- a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/upgrade-assistant.md +++ b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/upgrade-assistant.md @@ -200,4 +200,4 @@ But for more troubleshooting tips and known issues, see the [Upgrade Assistant]( ## See Also -- [Windows App SDK and suppported Windows releases](../support.md) +- [Windows App SDK and supported Windows releases](../support.md) diff --git a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/what-is-supported.md b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/what-is-supported.md index dc0ea3366f..9afb4428c4 100644 --- a/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/what-is-supported.md +++ b/hub/apps/windows-app-sdk/migrate-to-windows-app-sdk/what-is-supported.md @@ -50,4 +50,4 @@ The **Design** tab of the XAML Designer in Visual Studio (and Blend for Visual S ## See Also -- [Windows App SDK and suppported Windows releases](../support.md) +- [Windows App SDK and supported Windows releases](../support.md) diff --git a/hub/apps/windows-app-sdk/release-channels.md b/hub/apps/windows-app-sdk/release-channels.md index 1001d549ba..12c618d8fc 100644 --- a/hub/apps/windows-app-sdk/release-channels.md +++ b/hub/apps/windows-app-sdk/release-channels.md @@ -18,7 +18,7 @@ The latest version of the Windows App SDK ships via three release channels: Expe |---------|---------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------|------------|-----------------------------------------------------------------------------------------------------| | **✅** | Stable ([release notes](stable-channel.md)) | This channel is supported for use by apps in production environments. It includes only stable APIs. | No more frequent than every six months
(+ servicing) | Yes | [1.5.4 (1.5.240607001)](stable-channel.md#version-154-15240607001) (06/11/2024) | | **❇️** | Preview ([release notes](preview-channel.md)) | This channel provides a preview of the next stable release. There may be breaking API changes between a given preview channel release and the next stable release. | At least one preview per stable version | No | [1.5.0-preview1](preview-channel.md#version-15-preview-1-150-preview1) (02/06/2024) | -| **🔄️** | Experimental ([release notes](experimental-channel.md)) | This channel includes experimental features that are in early stages of development. Experimental features may be removed from the next release, or may never be released. | As needed when requiring feedback for features in early design or prototype stages | No | [1.6.0-experimental1](experimental-channel.md#version-16-experimental-160-experimental1) (06/04/2024) | +| **🔄️** | Experimental ([release notes](experimental-channel.md)) | This channel includes experimental features that are in early stages of development. Experimental features may be removed from the next release, or may never be released. | As needed when requiring feedback for features in early design or prototype stages | No | [1.6.0-experimental2](experimental-channel.md#version-16-experimental-160-experimental2) (07/02/2024) | For a comprehensive list of all current and previous releases of the Windows App SDK, including download locations, see [Downloads for the Windows App SDK](downloads.md). diff --git a/hub/apps/windows-app-sdk/release-notes-archive/experimental-channel-1.3.md b/hub/apps/windows-app-sdk/release-notes-archive/experimental-channel-1.3.md index f1177b9931..14131b1a1a 100644 --- a/hub/apps/windows-app-sdk/release-notes-archive/experimental-channel-1.3.md +++ b/hub/apps/windows-app-sdk/release-notes-archive/experimental-channel-1.3.md @@ -53,7 +53,7 @@ public MainWindow() ### Window.AppWindow -Replacing several lines of boilerplate code, you're now able to use AppWindow APIs directly from an **Window** through `Window.AppWindow`. See the [Window.AppWindow API spec](https://github.com/microsoft/microsoft-ui-xaml/blob/main/specs/appwindow-spec.md) on GitHub for additional background and usage information. +Replacing several lines of boilerplate code, you're now able to use AppWindow APIs directly from a **Window** through `Window.AppWindow`. See the [Window.AppWindow API spec](https://github.com/microsoft/microsoft-ui-xaml/blob/main/specs/appwindow-spec.md) on GitHub for additional background and usage information. ### New features from across WinAppSDK diff --git a/hub/apps/windows-app-sdk/release-notes-archive/preview-channel-1.3.md b/hub/apps/windows-app-sdk/release-notes-archive/preview-channel-1.3.md index d96788ba02..28205438f4 100644 --- a/hub/apps/windows-app-sdk/release-notes-archive/preview-channel-1.3.md +++ b/hub/apps/windows-app-sdk/release-notes-archive/preview-channel-1.3.md @@ -52,7 +52,7 @@ public MainWindow() ### Window.AppWindow -Replacing several lines of boilerplate code, you're now able to use AppWindow APIs directly from an **Window** through `Window.AppWindow`. See the [Window.AppWindow API spec](https://github.com/microsoft/microsoft-ui-xaml/blob/main/specs/appwindow-spec.md) on GitHub for additional background and usage information. +Replacing several lines of boilerplate code, you're now able to use AppWindow APIs directly from a **Window** through `Window.AppWindow`. See the [Window.AppWindow API spec](https://github.com/microsoft/microsoft-ui-xaml/blob/main/specs/appwindow-spec.md) on GitHub for additional background and usage information. ### New features from across WinAppSDK diff --git a/hub/apps/windows-app-sdk/set-up-your-development-environment.md b/hub/apps/windows-app-sdk/set-up-your-development-environment.md index c07614a30e..b0d588a6a8 100644 --- a/hub/apps/windows-app-sdk/set-up-your-development-environment.md +++ b/hub/apps/windows-app-sdk/set-up-your-development-environment.md @@ -186,7 +186,7 @@ Also see [Use the Windows App SDK in an existing project](use-windows-app-sdk-in * [Windows App SDK release channels](./release-channels.md) * [Install tools for preview and experimental channels of the Windows App SDK](./preview-experimental-install.md) * [System requirements for Windows app development](system-requirements.md) -* [Windows App SDK and suppported Windows releases](support.md) +* [Windows App SDK and supported Windows releases](support.md) * [Downloads for the Windows App SDK](downloads.md) * [Create your first WinUI 3 project](../winui/winui3/create-your-first-winui3-app.md) * [Use the Windows App SDK in an existing project](use-windows-app-sdk-in-existing-project.md) diff --git a/hub/apps/windows-app-sdk/stable-channel.md b/hub/apps/windows-app-sdk/stable-channel.md index 063a85a4f9..2e402fe688 100644 --- a/hub/apps/windows-app-sdk/stable-channel.md +++ b/hub/apps/windows-app-sdk/stable-channel.md @@ -215,6 +215,7 @@ In 1.5, we made progress on the following features that we announced on our road - Tabbed windows - Drag-n-drop support for WebView2 + - To clarify, in 1.5 dragging *into* WebView2 is supported, such as dragging a PNG from File Explorer into Bing for Visual Search. Work is ongoing in 1.6 to support dragging *out* of WebView2. - Investigations into the table view and ink controls Dynamic lighting has been removed from the roadmap for the time being. diff --git a/hub/apps/windows-app-sdk/system-requirements.md b/hub/apps/windows-app-sdk/system-requirements.md index 81b2c7f061..33733ccfda 100644 --- a/hub/apps/windows-app-sdk/system-requirements.md +++ b/hub/apps/windows-app-sdk/system-requirements.md @@ -58,4 +58,4 @@ You can build, run, and deploy apps built with stable versions of the Windows Ap ## See Also -- [Windows App SDK and suppported Windows releases](support.md) +- [Windows App SDK and supported Windows releases](support.md) diff --git a/hub/apps/windows-app-sdk/use-windows-app-sdk-in-existing-project.md b/hub/apps/windows-app-sdk/use-windows-app-sdk-in-existing-project.md index e215f58948..11f4942222 100644 --- a/hub/apps/windows-app-sdk/use-windows-app-sdk-in-existing-project.md +++ b/hub/apps/windows-app-sdk/use-windows-app-sdk-in-existing-project.md @@ -65,4 +65,4 @@ If you encounter a *Class not registered* error when you try to use a Windows Ap - [Release channels and release notes](release-channels.md) - [Install tools for the Windows App SDK](set-up-your-development-environment.md) - [Deploy apps that use the Windows App SDK](../package-and-deploy/index.md#use-the-windows-app-sdk) -- [Windows App SDK and suppported Windows releases](support.md) +- [Windows App SDK and supported Windows releases](support.md) diff --git a/hub/apps/windows-app-sdk/use-windows-app-sdk-run-time.md b/hub/apps/windows-app-sdk/use-windows-app-sdk-run-time.md index fcd166f422..7ac3914a81 100644 --- a/hub/apps/windows-app-sdk/use-windows-app-sdk-run-time.md +++ b/hub/apps/windows-app-sdk/use-windows-app-sdk-run-time.md @@ -114,7 +114,7 @@ Replace the **Id** attribute of the **maxversiontested** element with the versio ## See Also -- [Windows App SDK and suppported Windows releases](support.md) +- [Windows App SDK and supported Windows releases](support.md) - [Windows App SDK deployment guide for framework-dependent apps packaged with external location or unpackaged](deploy-unpackaged-apps.md) - [Dynamic dependencies specification](https://github.com/microsoft/WindowsAppSDK/blob/main/specs/dynamicdependencies/DynamicDependencies.md) - [MSIX framework packages and dynamic dependencies](../desktop/modernize/framework-packages/framework-packages-overview.md) diff --git a/hub/apps/winui/index.md b/hub/apps/winui/index.md index 589c0dbd3b..a775d9d1be 100644 --- a/hub/apps/winui/index.md +++ b/hub/apps/winui/index.md @@ -50,7 +50,7 @@ The following table highlights some of most significant differences between WinU - [Windows App SDK](../windows-app-sdk/index.md) - [Stable channel release notes for the Windows App SDK](../windows-app-sdk/stable-channel.md) -- [Windows App SDK and suppported Windows releases](../windows-app-sdk/support.md) +- [Windows App SDK and supported Windows releases](../windows-app-sdk/support.md) - [Windows App SDK API docs](/windows/windows-app-sdk/api/winrt/) - [WinUI 2 API docs](/windows/winui/api/) - [Windows App SDK Samples](https://github.com/microsoft/WindowsAppSDK-Samples) diff --git a/hub/apps/winui/winui3/testing/index.md b/hub/apps/winui/winui3/testing/index.md index a58d3807d6..de39f30f34 100644 --- a/hub/apps/winui/winui3/testing/index.md +++ b/hub/apps/winui/winui3/testing/index.md @@ -10,7 +10,7 @@ ms.localizationpriority: medium In this topic we provide some recommendations for how to test and validate functionality in apps created with the [Windows App SDK](/windows/apps/windows-app-sdk/) using [Windows UI Library (WinUI)](/windows/apps/winui/winui3/) user interface (UI) features. -## Test WinUI functionality +## How do I test WinUI functionality in my app? Most object types under the Microsoft.UI.Xaml namespaces must be used from a UI thread in a Xaml application process. (For details on testing apps created with Windows App SDK that don't use WinUI, see the following section, [How do I test non-WinUI functionality in my app?](#how-do-i-test-non-winui-functionality-in-my-app).) diff --git a/hub/dev-environment/javascript/react-native-for-android.md b/hub/dev-environment/javascript/react-native-for-android.md index f608246777..80b5cdd490 100644 --- a/hub/dev-environment/javascript/react-native-for-android.md +++ b/hub/dev-environment/javascript/react-native-for-android.md @@ -5,7 +5,7 @@ author: drewbatgit ms.author: drewbat manager: jken ms.topic: article -ms.date: 03/30/2021 +ms.date: 06/19/2024 --- # Get started developing for Android using React Native diff --git a/hub/dev-home/environments.md b/hub/dev-home/environments.md index e1a25778c0..428e03597c 100644 --- a/hub/dev-home/environments.md +++ b/hub/dev-home/environments.md @@ -1,7 +1,7 @@ --- title: Environments in Dev Home description: Learn about interacting with your virtual or cloud environments from Dev Home. -ms.date: 05/09/2024 +ms.date: 07/01/2024 ms.topic: overview --- @@ -21,14 +21,16 @@ A virtual environment is a self-contained workspace that allows you to maintain ## Get started with Environments in Dev Home -1. Ensure that you have the latest version of Dev Home by running the command: `winget upgrade Microsoft.DevHome`. -2. Enable the Environments features in the Dev Home Experimental settings (**Settings** > **Experimental features** > toggle to **On**). -3. Each type of virtual environment in Dev Home is supported by a Dev Home extension. To add a new environment, you must first ensure that the supporting extension is installed. +To get started using virtual environments in Dev Home, select the **Environments** tab in the left column user interface inside Dev Home. Once the Environments pane is open, select **+ Create Environment**. + +Each type of virtual environment in Dev Home is supported by a Dev Home extension. To add a new environment, you must ensure that the Dev Home extension supporting the associated virtual environment that you wish to use is installed. + - **Hyper-V extension**: Installed by default in Dev Home. By default, your local Hyper-V VMs will be visible on the Dev Home Environments page. - **Microsoft Dev Box**: To display Dev Box virtual environments, install the [Dev Home Azure extension](extensions.md#dev-home-azure-extension). Once installed, each Dev Box that you have set up on your Azure account will be visible on the Dev Home Environments page. -![Screenshot of Experimental settings in Dev Home](../images/devhome-experimental-settings.png) +> [!TIP] +> If you do not see the Environments tab in Dev Home or are having trouble, ensure that you have the latest version of Dev Home by running the command: `winget upgrade Microsoft.DevHome`. ## Manage your Environments in Dev Home diff --git a/hub/powertoys/powerrename.md b/hub/powertoys/powerrename.md index b028a07314..734f0e8be5 100644 --- a/hub/powertoys/powerrename.md +++ b/hub/powertoys/powerrename.md @@ -110,6 +110,21 @@ A _Replace with_ text `Image_${padding=4;increment=2;start=10}_` would produce t - Image_0012_b.jpg - Image_0014_bc.jpg +### Random string values + +If selected, you can use the following patterns as part of the _Replace with_ text: + +| Variable pattern | Explanation | +| :------------------ | :----------------------------------------------------------------------------------------- | +| `${rstringalnum=X}` | Random string with uppercase letters, lowercase letters and 0-9 digits, customized length. | +| `${rstringalpha=X}` | Random string with uppercase letters and lowercase letters, customized length. | +| `${rstringdigit=X}` | Random string with 0-9 digits, customized length. | +| `${ruuidv4}` | Random UUID according to v4 specification. | + +By default, random string values created are mixed case. You can adjust the generating behavior with the general [text formatting options that PowerRename provides](#text-formatting). + +If you wish to create UUID values with braces, you can add `{` and `}` to the _Replace with_ input in combination with the ruuidv4 pattern accordingly: `{${ruuidv4}}`. + ## Replace using file creation date and time The creation date and time attributes of a file can be used in the _Replace with_ text by entering a variable pattern according to the table below. Selecting the tool-tip in the _Replace with_ field allows you to view and select from the supported patterns. diff --git a/uwp/audio-video-camera/basic-photo-video-and-audio-capture-with-MediaCapture.md b/uwp/audio-video-camera/basic-photo-video-and-audio-capture-with-MediaCapture.md index e3de7d2a34..ac78f24bfc 100644 --- a/uwp/audio-video-camera/basic-photo-video-and-audio-capture-with-MediaCapture.md +++ b/uwp/audio-video-camera/basic-photo-video-and-audio-capture-with-MediaCapture.md @@ -60,7 +60,7 @@ Starting with Windows 10, version 1803, you can get the metadata, such as EXIF i frame control values, such as exposure and flash settings, used when the image was captured by accessing the [**ControlValues**](/uwp/api/windows.media.capture.capturedframe.controlvalues) property. For more information, see [Capture device controls for photo and video capture](capture-device-controls-for-photo-and-video-capture.md). ## Capture a photo to a file -A typical photography app will save a captured photo to disk or to cloud storage and will need to add metadata, such as photo orientation, to the file. The following example shows you how to capture an photo to a file. You still have the option of creating a **SoftwareBitmap** from the image file later. +A typical photography app will save a captured photo to disk or to cloud storage and will need to add metadata, such as photo orientation, to the file. The following example shows you how to capture a photo to a file. You still have the option of creating a **SoftwareBitmap** from the image file later. The technique shown in this example captures the photo to an in-memory stream and then transcode the photo from the stream to a file on disk. This example uses [**GetLibraryAsync**](/uwp/api/windows.storage.storagelibrary.getlibraryasync) to get the user's pictures library and then the [**SaveFolder**](/uwp/api/windows.storage.storagelibrary.savefolder) property to get a reference default save folder. Remember to add the **Pictures Library** capability to your app manifest to access this folder. [**CreateFileAsync**](/uwp/api/windows.storage.storagefolder.createfileasync) creates a new [**StorageFile**](/uwp/api/Windows.Storage.StorageFile) to which the photo will be saved. diff --git a/uwp/audio-video-camera/camera-privacy-setting.md b/uwp/audio-video-camera/camera-privacy-setting.md index dd8a1fb4fa..bf1fb5482c 100644 --- a/uwp/audio-video-camera/camera-privacy-setting.md +++ b/uwp/audio-video-camera/camera-privacy-setting.md @@ -76,7 +76,7 @@ try } catch (System.UnauthorizedAccessException ex) { - // E_ACCESSDENIED, 0x80070005 in hexidecimal, -2147024891 in decimal + // E_ACCESSDENIED, 0x80070005 in hexadecimal, -2147024891 in decimal if (ex.HResult == -2147024891) { StatusTextBlock.Text = "Access to the camera has been denied." + diff --git a/uwp/audio-video-camera/capture-device-controls-for-video-capture.md b/uwp/audio-video-camera/capture-device-controls-for-video-capture.md index 0cc6350ff6..06070d9fb2 100644 --- a/uwp/audio-video-camera/capture-device-controls-for-video-capture.md +++ b/uwp/audio-video-camera/capture-device-controls-for-video-capture.md @@ -72,7 +72,7 @@ When the app enables frame processing, it sets the denoising mode to **Off** if :::code language="csharp" source="~/../snippets-windows/windows-uwp/audio-video-camera/BasicMediaCaptureWin10/cs/MainPage.ManualControls.xaml.cs" id="SnippetEnableFrameProcessing"::: -When the app disables frame prcessing, it sets the denoising mode to **On** or **Auto**, depending on which mode is supported. +When the app disables frame processing, it sets the denoising mode to **On** or **Auto**, depending on which mode is supported. :::code language="csharp" source="~/../snippets-windows/windows-uwp/audio-video-camera/BasicMediaCaptureWin10/cs/MainPage.ManualControls.xaml.cs" id="SnippetDisableFrameProcessing"::: diff --git a/uwp/audio-video-camera/media-compositions-and-editing.md b/uwp/audio-video-camera/media-compositions-and-editing.md index 6d0c7db50b..8c88c29b5a 100644 --- a/uwp/audio-video-camera/media-compositions-and-editing.md +++ b/uwp/audio-video-camera/media-compositions-and-editing.md @@ -38,7 +38,7 @@ Media compositions typically contain one or more video clips. You can use a [**F - A **MediaClip** can only be included in a composition once. Attempting to add a **MediaClip** that is already being used by the composition will result in an error. To reuse a video clip multiple times in a composition, call [**Clone**](/uwp/api/windows.media.editing.mediaclip.clone) to create new **MediaClip** objects which can then be added to the composition. -- Universal Windows apps do not have permission to access the entire file system. The [**FutureAccessList**](/uwp/api/windows.storage.accesscache.storageapplicationpermissions.futureaccesslist) property of the [**StorageApplicationPermissions**](/uwp/api/Windows.Storage.AccessCache.StorageApplicationPermissions) class allows your app to store a record of a file that has been selected by the user so that you can retain permissions to access the file. The **FutureAccessList** has a maxium of 1000 entries, so your app needs to manage the list to make sure it does not become full. This is especially important if you plan to support loading and modifying previously created compositions. +- Universal Windows apps do not have permission to access the entire file system. The [**FutureAccessList**](/uwp/api/windows.storage.accesscache.storageapplicationpermissions.futureaccesslist) property of the [**StorageApplicationPermissions**](/uwp/api/Windows.Storage.AccessCache.StorageApplicationPermissions) class allows your app to store a record of a file that has been selected by the user so that you can retain permissions to access the file. The **FutureAccessList** has a maximum of 1000 entries, so your app needs to manage the list to make sure it does not become full. This is especially important if you plan to support loading and modifying previously created compositions. - A **MediaComposition** supports video clips in MP4 format. diff --git a/uwp/audio-video-camera/media-playback-with-mediasource.md b/uwp/audio-video-camera/media-playback-with-mediasource.md index 0fcccaa6ee..12f23b49d8 100644 --- a/uwp/audio-video-camera/media-playback-with-mediasource.md +++ b/uwp/audio-video-camera/media-playback-with-mediasource.md @@ -258,5 +258,5 @@ Starting with Windows 10, version 1703, you can supply an [**AdaptiveMediaSource ## Related topics * [Media playback](media-playback.md) * [Play audio and video with MediaPlayer](play-audio-and-video-with-mediaplayer.md) -* [Integrate with the Sytem Media Transport Controls](integrate-with-systemmediatransportcontrols.md) +* [Integrate with the System Media Transport Controls](integrate-with-systemmediatransportcontrols.md) * [Play media in the background](background-audio.md) diff --git a/uwp/audio-video-camera/playready-encrypted-media-extension.md b/uwp/audio-video-camera/playready-encrypted-media-extension.md index c279e03c25..d9f880575f 100644 --- a/uwp/audio-video-camera/playready-encrypted-media-extension.md +++ b/uwp/audio-video-camera/playready-encrypted-media-extension.md @@ -199,7 +199,7 @@ function addPlayreadyKeyEventHandler() // TODO: send the secure stop challenge to a server that handles the secure stop challenge - // TODO: Receive and response and call event.target.Update() to proecess the response + // TODO: Receive and response and call event.target.Update() to process the response }); // add 'keyerror' eventhandler diff --git a/uwp/audio-video-camera/process-media-frames-with-mediaframereader.md b/uwp/audio-video-camera/process-media-frames-with-mediaframereader.md index 937fcd4360..88880e615c 100644 --- a/uwp/audio-video-camera/process-media-frames-with-mediaframereader.md +++ b/uwp/audio-video-camera/process-media-frames-with-mediaframereader.md @@ -119,7 +119,7 @@ Because the frames will arrive as **SoftwareBitmap** objects, you need to create :::code language="csharp" source="~/../snippets-windows/windows-uwp/audio-video-camera/Frames_Win10/cs/Frames_Win10/MainPage.xaml.cs" id="SnippetImageElementSource"::: -Now it's time to implement the **FrameArrived** event handler. When the handler is called, the *sender* parameter contains a reference to the **MediaFrameReader** object which raised the event. Call [**TryAcquireLatestFrame**](/uwp/api/windows.media.capture.frames.mediaframereader.tryacquirelatestframe) on this object to attempt to get the latest frame. As the name implies, **TryAcquireLatestFrame** may not succeed in returning a frame. So, when you access the VideoMediaFrame and then SoftwareBitmap properties, be sure to test for null. In this example the null condtional operator ? is used to access the **SoftwareBitmap** and then the retrieved object is checked for null. +Now it's time to implement the **FrameArrived** event handler. When the handler is called, the *sender* parameter contains a reference to the **MediaFrameReader** object which raised the event. Call [**TryAcquireLatestFrame**](/uwp/api/windows.media.capture.frames.mediaframereader.tryacquirelatestframe) on this object to attempt to get the latest frame. As the name implies, **TryAcquireLatestFrame** may not succeed in returning a frame. So, when you access the VideoMediaFrame and then SoftwareBitmap properties, be sure to test for null. In this example the null conditional operator ? is used to access the **SoftwareBitmap** and then the retrieved object is checked for null. The **Image** control can only display images in BRGA8 format with either pre-multiplied or no alpha. If the arriving frame is not in that format, the static method [**Convert**](/uwp/api/windows.graphics.imaging.softwarebitmap.convert) is used to convert the software bitmap to the correct format. diff --git a/uwp/audio-video-camera/supported-codecs.md b/uwp/audio-video-camera/supported-codecs.md index 6d209354f0..abbd56e871 100644 --- a/uwp/audio-video-camera/supported-codecs.md +++ b/uwp/audio-video-camera/supported-codecs.md @@ -1475,7 +1475,7 @@ The following tables show the video codec and format support for each device fam * MPEG-2/MPEG-1 codec is available with install of optional Microsoft UWP DVD application. -** H.265 and AV1 are avaliable with the install of the corresponding optional codec pack. +** H.265 and AV1 are available with the install of the corresponding optional codec pack. ### Mobile @@ -1842,7 +1842,7 @@ The following tables show the video codec and format support for each device fam * MPEG-2/MPEG-1 codec is available with install of optional Microsoft UWP DVD application. -** H.265 and AV1 are avaliable with the install of the corresponding optional codec pack. +** H.265 and AV1 are available with the install of the corresponding optional codec pack.   diff --git a/uwp/audio-video-camera/system-media-transport-controls.md b/uwp/audio-video-camera/system-media-transport-controls.md index 8918f38de9..26260f5167 100644 --- a/uwp/audio-video-camera/system-media-transport-controls.md +++ b/uwp/audio-video-camera/system-media-transport-controls.md @@ -112,6 +112,6 @@ For more information on playing audio in the background, see [Play media in the ## Related topics * [Media playback](media-playback.md) * [Integrate with the System Media Transport Controls](integrate-with-systemmediatransportcontrols.md)  -* [System Media Tranport sample](https://github.com/Microsoft/Windows-universal-samples/tree/dev/Samples/SystemMediaTransportControls) +* [System Media Transport sample](https://github.com/Microsoft/Windows-universal-samples/tree/dev/Samples/SystemMediaTransportControls)   diff --git a/uwp/composition/composition-lighting.md b/uwp/composition/composition-lighting.md index d9f3e4e5d1..e4287e5155 100644 --- a/uwp/composition/composition-lighting.md +++ b/uwp/composition/composition-lighting.md @@ -91,7 +91,7 @@ Property | Description Property | Description --- | --- **Intensity** | Controls the brightness of the light. -**Attenuation** | Attenuation controls how a light's intensity decreases toward the maximum distance specified by the range property. Constant, Quadradic and Linear attenuation properties can be used. +**Attenuation** | Attenuation controls how a light's intensity decreases toward the maximum distance specified by the range property. Constant, Quadratic and Linear attenuation properties can be used. ## Getting Started with Lighting diff --git a/uwp/launch-resume/hosted-apps.md b/uwp/launch-resume/hosted-apps.md index 301a67d6e4..2205b202fd 100644 --- a/uwp/launch-resume/hosted-apps.md +++ b/uwp/launch-resume/hosted-apps.md @@ -144,7 +144,7 @@ The hosted app consists of a python script and package artifacts such as the pac The package manifest for the hosted app (the NumberGuesser/AppxManifest.xml file) contains the following items: -* The **Publisher** attribute of the [**Identity**](/uwp/schemas/appxpackage/uapmanifestschema/element-identity) element contains the `OID.2.25.311729368913984317654407730594956997722=1` identifer, which is required for an unsigned package. +* The **Publisher** attribute of the [**Identity**](/uwp/schemas/appxpackage/uapmanifestschema/element-identity) element contains the `OID.2.25.311729368913984317654407730594956997722=1` identifier, which is required for an unsigned package. * The **uap10:HostId** attribute of the [**Application**](/uwp/schemas/appxpackage/uapmanifestschema/element-application) element identifies **PythonHost** as its host. ### Run the sample diff --git a/uwp/security/companion-device-unlock.md b/uwp/security/companion-device-unlock.md index 8bb0d6bf96..b9595ce088 100644 --- a/uwp/security/companion-device-unlock.md +++ b/uwp/security/companion-device-unlock.md @@ -528,7 +528,7 @@ namespace SecondaryAuthFactorSample // Register canceled event for this task taskInstance.Canceled += TaskInstanceCanceled; - // Find all device registred by this application + // Find all device registered by this application IReadOnlyList deviceInfoList = await SecondaryAuthenticationFactorRegistration.FindAllRegisteredDeviceInfoAsync( SecondaryAuthenticationFactorDeviceFindScope.AllUsers); diff --git a/uwp/whats-new/windows-10-build-16299.md b/uwp/whats-new/windows-10-build-16299.md index 546696a244..a7e9b80e38 100644 --- a/uwp/whats-new/windows-10-build-16299.md +++ b/uwp/whats-new/windows-10-build-16299.md @@ -59,7 +59,7 @@ Map Layers | You can add points of interest elements to a [map layer](../maps-an Map Place Info | You can show users a map inside of a [light-weight pop-up window](../maps-and-location/display-maps.md#display-map-in-a-placecard) above, below or to the side of a UI element or an area of the app where the user touches. This window dismisses itself when the user changes context. This keeps users from having to switch to another app or browser window to obtain information about a location. Map Services | Going sightseeing? Use the new [MapRouteOptimization.Scenic](/uwp/api/windows.services.maps.maprouteoptimization) value to optimize a route to include the most scenic roads, and [MapRoute.IsScenic](/uwp/api/windows.services.maps.maproute) to discover whether an existing route includes scenic roads. Media Capture | The article [Process media frames with MediaFrameReader](../audio-video-camera/process-media-frames-with-mediaframereader.md) has been updated to show the usage of the new [Multi​Source​Media​Frame​Reader](/uwp/api/windows.media.capture.frames.multisourcemediaframereader) class, which allows you to obtain time-correlated frames from multiple media sources.

[Process media frames with MediaFrameReader](../audio-video-camera/process-media-frames-with-mediaframereader.md) has been updated to include a description of buffered frame acquisition mode that allows apps to request that acquired frames be provided to the app in sequence, without dropping frames acquired while the app was processing a previous frame.

Also, when a **MediaCapture** object has been initialized with a media frame source group containing one or more media frame sources, you can create a **[MediaSource](/uwp/api/windows.media.core.mediasource)** object that allows you to present the media frames in a **MediaPlayerElement** control in a XAML page.

For more information, see [Process media frames with MediaFrameReader](../audio-video-camera/process-media-frames-with-mediaframereader.md). -Media Playback | New sections have been added to the basic media playback article, [Play audio and video with MediaPlayer](../audio-video-camera/play-audio-and-video-with-mediaplayer.md).

* The section [Play spherical video with MediaPlayer](../audio-video-camera/play-audio-and-video-with-mediaplayer.md) shows you how to playback spherically encodeded video, including adjusting the field of view and view orientation for supported formats.

* The section [Use MediaPlayer in frame server mode](../audio-video-camera/play-audio-and-video-with-mediaplayer.md#use-mediaplayer-in-frame-server-mode) shows you how to copy frames from media played back with [MediaPlayer](/uwp/api/Windows.Media.Playback.MediaPlayer) to a Direct3D surface. This enables scenarios such as applying real-time effects with pixel shaders. The example code shows a quick implementation of a blur effect for video playback using Win2D. +Media Playback | New sections have been added to the basic media playback article, [Play audio and video with MediaPlayer](../audio-video-camera/play-audio-and-video-with-mediaplayer.md).

* The section [Play spherical video with MediaPlayer](../audio-video-camera/play-audio-and-video-with-mediaplayer.md) shows you how to playback spherically encoded video, including adjusting the field of view and view orientation for supported formats.

* The section [Use MediaPlayer in frame server mode](../audio-video-camera/play-audio-and-video-with-mediaplayer.md#use-mediaplayer-in-frame-server-mode) shows you how to copy frames from media played back with [MediaPlayer](/uwp/api/Windows.Media.Playback.MediaPlayer) to a Direct3D surface. This enables scenarios such as applying real-time effects with pixel shaders. The example code shows a quick implementation of a blur effect for video playback using Win2D. My People | My People allows users to pin contacts from an application directly to their taskbar. [Learn how to add My People support to your application.](../contacts-and-calendar/my-people-support.md)

* [My People sharing](../contacts-and-calendar/my-people-sharing.md) allows users to share files through your application, right from the taskbar.
* [My People notifications](../contacts-and-calendar/my-people-support.md) are a new kind of toast notification that users can send to their pinned contacts. .NET Standard 2.0 | The Universal Windows Platform has fully implemented the [.NET Standard 2.0](/dotnet/standard/net-standard#net-implementation-support). This new version of the standard includes a massive increase in the number of .NET APIs along with a compatibility shim for your favorite NuGet packages and third party libraries.

If you intend to target other platforms such as iOS and Android, or if you have a desktop application and want to create a UWP app, move code into .NET Standard 2.0 class libraries and then reuse that code in each version of your app. Pin to taskbar | The new TaskbarManager class allows you to ask your user to [pin your app to the taskbar](/windows/apps/design/shell/pin-to-taskbar). diff --git a/uwp/whats-new/windows-10-build-17763.md b/uwp/whats-new/windows-10-build-17763.md index a1efea1300..61f202b374 100644 --- a/uwp/whats-new/windows-10-build-17763.md +++ b/uwp/whats-new/windows-10-build-17763.md @@ -129,7 +129,7 @@ The [Customer database tutorial](../enterprise/customer-database-tutorial.md) cr ### Photo Editor C++/WinRT -The [Photo Editor sample app](https://github.com/Microsoft/Windows-appsample-photo-editor) showcases development with the [C++/WinRT](../cpp-and-winrt-apis/intro-to-using-cpp-with-winrt.md) language projection. The app allows you to retrieve photos from the **Pictures** library, and then edit a elected image with associated photo effects. +The [Photo Editor sample app](https://github.com/Microsoft/Windows-appsample-photo-editor) showcases development with the [C++/WinRT](../cpp-and-winrt-apis/intro-to-using-cpp-with-winrt.md) language projection. The app allows you to retrieve photos from the **Pictures** library, and then edit an elected image with associated photo effects. ### Windows Machine Learning diff --git a/uwp/xaml-platform/custom-dependency-properties.md b/uwp/xaml-platform/custom-dependency-properties.md index 1cc1ddc453..cf46903be7 100644 --- a/uwp/xaml-platform/custom-dependency-properties.md +++ b/uwp/xaml-platform/custom-dependency-properties.md @@ -75,7 +75,7 @@ For C++/CX, you have options for how you split the implementation between the he ```csharp public static readonly DependencyProperty LabelProperty = DependencyProperty.Register( - "Label", + nameof(Label), typeof(String), typeof(ImageWithLabelControl), new PropertyMetadata(null) @@ -257,7 +257,7 @@ This next example modifies the previously shown [**DependencyProperty.Register** ```csharp public static readonly DependencyProperty LabelProperty = DependencyProperty.Register( - "Label", + nameof(Label), typeof(String), typeof(ImageWithLabelControl), new PropertyMetadata(null,new PropertyChangedCallback(OnLabelChanged)) @@ -458,6 +458,32 @@ Nevertheless, scenarios for collection-type dependency properties do exist. The When you create a dependency property, you can establish a default value by means of dependency property metadata. But be careful to not use a singleton static collection as the default value. Instead, you must deliberately set the collection value to a unique (instance) collection as part of class-constructor logic for the owner class of the collection property. +```csharp +// WARNING - DO NOT DO THIS +public static readonly DependencyProperty ItemsProperty = DependencyProperty.Register( + nameof(Items), + typeof(IList), + typeof(ImageWithLabelControl), + new PropertyMetadata(new List()) +); + +// DO THIS Instead +public static readonly DependencyProperty ItemsProperty = DependencyProperty.Register( + nameof(Items), + typeof(IList), + typeof(ImageWithLabelControl), + new PropertyMetadata(null) +); + +public ImageWithLabelControl() +{ + // Need to initialize in constructor instead + Items = new List(); +} +``` + +A DependencyProperty and its PropertyMetadata's default value are part of the static definition of the DependencyProperty. By providing a default collection (or other instanced) value as the default value, it will be shared across all instances of your class instead of each class having its own collection, as would typically be desired. + ### Change notifications Defining the collection as a dependency property does not automatically provide change notification for the items in the collection by virtue of the property system invoking the "PropertyChanged" callback method. If you want notifications for collections or collection items—for example, for a data-binding scenario— implement the **INotifyPropertyChanged** or **INotifyCollectionChanged** interface. For more info, see [Data binding in depth](../data-binding/data-binding-in-depth.md).