microsoftdocs/windows-dev-docs

Conceptual and overview content for developing Windows apps

Rename Notification

This repo has recently been renamed from "windows-uwp" to "windows-dev-docs" to better represent the content source files contained.

If you have a copy of the repo on your local machine, you will need to update the associated URL following these steps:

1. cd to your local Git directory for the repo and find the remote name with the command: git remote -v

You will receive a response like the following example: origin https://github.com/MicrosoftDocs/windows-uwp.git (fetch) origin https://github.com/MicrosoftDocs/windows-uwp.git (push)

2. Set the new URL using the command: git remote set-url origin https://github.com/MicrosoftDocs/windows-dev-docs.git

*Alternatively, you can just delete your local copy of the repo and reclone it if you don't have any active work on the repo that you are concerned with losing.

Following the rename of this repo, the content team will also be working on renaming and restructuring the source file directories within the repo to align more closely with the structure of our live documentation. We are aiming to have this work complete by September 16, 2022.

Legal Notices

Microsoft and any contributors grant you a license to the Microsoft documentation and other content in this repository under the Creative Commons Attribution 4.0 International Public License, see the LICENSE file, and grant you a license to any code in the repository under the MIT License. See the LICENSE-CODE file.

Microsoft, Windows, Microsoft Azure, and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at https://go.microsoft.com/fwlink/?LinkID=254653.

Privacy information can be found at https://privacy.microsoft.com/en-us/

Microsoft and any contributors reserve all others rights, whether under their respective copyrights, patents, or trademarks, whether by implication, estoppel, or otherwise.

windows-dev-docs's Issues

Images disappearing in dark theme

In article 'Icons for UWP apps' there are transparent images with black stroke. So they are invisible in dark theme.

"Test your Windows app for Windows 10 s" -Is using an Enterprise Policy on PRO really the right way?

In my conversations with Scott Anderson [email protected] about these policy files, there are 2 types; Enterprise and Windows. The policy files mentioned in this article are Enterprise Policies, and copied to the %windir%\System32\CodeIntegrity directory. The other type is a Windows Policy and is Windows signed. This is what Window 10 S uses. It's WinSiPolicy.p7b and is stored in the EFI boot partition EFI\Microsoft\Boot\WinSiPolicy.p7b since the enforcement on the signature is done early in the boot.

If this article audience is only intended for APP developers and not IHV Driver developers, then the article is correct. But, I believe IHV driver developers may also find their way here and for them, they will need the WinSiPolicy file copied over to the EFI boot partition to properly mirror all the Policies of Windows 10 S. The WinSiPolicy files can be found here: \winsect\scratch\ConfigCI\CloudSKUPolicies\Tools

Missing info how to access new Windows Settings sections in Creators Update

This page contains links to various sections in the Windows Settings and how to reach them programmatically:
https://docs.microsoft.com/en-us/windows/uwp/launch-resume/launch-settings-app
but it was not yet updated to cover new sections and subsections added in Windows 10 Creators Update like Settings -> Apps, Settings -> Gaming and other.

It would be also helpful to have Uri scheme for accessing single app setting in:
Settings -> Apps -> Apps & Features -> [My app name]
so I can navigate user directly from my app to app settings, where the user should be able to Move the app to another drive, Reset app data, etc.

Attaching to email using Outlook does not work

Attaching email to a new email generated by Outlook is not working in desktop Windows 10 environment.

This is a reported issue all over the net and a known issue for at least 2 years already:

https://stackoverflow.com/questions/46534908/uwp-app-sending-email-with-emailmanager-showcomposenewemailasync-wont-add-attach

https://stackoverflow.com/questions/33053358/sending-email-attachments-via-uwp-emailmanager-not-working

STEPS TO REPRODUCE

1. Set Outlook (in my case Outlook 2016) as default email app in Windows 10 Settings
2. Close Outlook so it is not running
3. Create a simple UWP app to send email using EmailManager.ShowComposeNewEmailAsync
4. New email dialog opens shortly, recipient, subject and email body is created but attachment is not added

EXPECTED OUTCOME
App should offer user to choose which app to use to send email with attachment or simply use default email app including Outlook as set in Windows 10 Settings and send the email including the attachments.

ACTUAL OUTCOME
Attachments are ignored

ENVIRONMENT
Windows 10 Desktop
Visual Studio 2015
Xamarin UWP Application
Outlook 2016 (but any Outlook should work since many many customers are using it)

Request for more VB Samples in the documentation @ https://docs.microsoft.com/en-us/windows/uwp

From "Digging Deeper into the Visual Basic Language Strategy" by The Visual Basic Team blog:

...The fourth force is an accelerated development cycle. Shipping software quickly is hard. Shipping quality software quickly is harder. Shipping quality software quickly for two (or three) languages so that they all get there on the same day is insanely hard. Realizing the software you shipped quickly was perhaps shipped too quickly and was possibly not the right design two (or three) times and now all the samples have to be redone is just wasteful. And when you’re a team putting out a minimum viable product looking for feedback to drive rapid iteration it makes sense to target the largest and most diverse set of developers you can with the highest probability of using it early and providing valuable feedback. Based on numbers and past behavior that’s C#. This isn’t always the case, as technologies such as the Universal Windows Platform, Windows 8.x apps, and Roslyn were all released with both VB and C# support out of the gate. These technologies had very long development cycles that lent themselves to the kind of planning and execution coordination required to deliver both as the same time. But agile products are increasingly the norm at Microsoft (and beyond), and in most cases we will draft in C# and follow with Visual Basic based on telemetry and talking to customers to identify high value scenarios. ...

When I started professionally developing for .NET 1.0 in the year 2000, I could immediately see (as a seasoned Visual Basic developer since 1993) that C# was merely VB.NET hidden behind a C style language wrapper. This made great sense to me as a means for legacy C++ code (and legacy coders) to feel much more comfortable with (and encouraged to) port and rewrite old C++ MFC (and such) applications to .NET. But I knew that both languages were really VB, under the hood.

I mention this because, if we look as far as 20 years to the future, long after these surges in technologies for development of the 21st Century teens decade have matured, Visual Basic is the far superior language at embedding UML-quality code structure indications by way of the syntax of VB, in contrast to C#. This is no insult to C and the C legacy languages. Initially paper punch cards were used, long ago, and the most concise syntax, in terms of Chars needed to define code structure, was a real serious issue in terms of time consumption in just getting that code defined. The "logic per UNICODE character" efficiency of C# wins hugely over Visual Basic. But for well over 10 years, now we have IntelliSense, and that changes everything. I think the better UML-quality to all VB syntax is a great boon while coding, or when returning to review code written weeks earlier, and especially for peer review. FOR statement (i,t,i){} deciphering alone can cost lots for a peer trying to grasp another coder's work, when holding on to a truly archaic syntax of old C++ and Java, when we can do much better.

I believe VB.NET is the language of the future. It will no longer be the nineties and zeros in future decades, with worldwide software industries being beyond-full to the brim of C++ coders in need of assistance with their syntax impairment and addiction to obsolete editor syntax (as if IntelliSense didn't change everything in coding). The 21st century twenties decade might really surprise us at how superior VB is to work with and maintain, and I believe Microsoft should now start pushing VB again, especially since Xamarin is soon to support VB. That crosses the hump of needed maturity in Microsoft supporting technologies to free the VB coder from having to time-travel back to C syntax to leverage apps on various smart phones and such. Subroutine wins over silly VOID. I'm just teasing.

With all that discussed, I would be impressed to see the UWP documentation apply strong effort toward an eventual goal of each and every C# example code illustrated being accompanied by a Visual Basic version as well. C, C++, C#, and Java syntax need not shackle us all for decades ahead.

C++ unmanaged has an excuse: driver coding and tweaks akin to Assembly language. .NET managed means that C# has no such powers as C++ unmanaged, and thus has no excuse for the syntax impairment other than familiarity to old coders, and greater ease in porting an old C++ project into .NET and/or UWP. That has been, and maybe will remain to be for another 5-7 years (I am guessing), a major and important backward-compatibility with C++ syntax issue to even keep up with the onslaught of technology changes.

But I would not want to give up on Visual Basic as the superior syntax just to hold onto backward-compatibility with the syntax in old coders' (like me) brains much beyond the year 2025, or Microsoft is begging to be sideswiped by some new language developer creating a modern and super-readable, super-understandable syntax of keyword structure, for some other company, and making us Microsoft fans like me look bad.

Please get those VB code snippets going, please do realize that code maintenance is far superior when working with a superiorly illustrative syntax of keywords, and maybe even please check for yourself if rereading some code you've created, just as little as when 2 weeks stale and away from it, is a breeze in VB to recall the gist of it all, as compared to an ugly affair with C#.

Please also pass on the following text I quote from above, to any and all Microsoft personnel who have an interest in the classic battle between C++ and VB. (I used Visual Basic from version 1 through 6, and I fully know that VB pioneered so much of what Visual Studio can do today. When VS.NET was released in 2000, it was great to see Visual Basic take over all the new technologies and basically take charge of Visual Studio, fitting like a glove after VB6 usage.)

PLEASE PASS ON MY POWER-QUOTE:

...Visual Basic is the far superior language at embedding UML-quality code structure indications by way of the syntax of VB, in contrast to C#. This is no insult to C and the C legacy languages. Initially paper punch cards were used, long ago, and the most concise syntax, in terms of Chars needed to define code structure, was a real serious issue in terms of time consumption in just getting that code defined. The "logic per UNICODE character" efficiency of C# wins hugely over Visual Basic. But for well over 10 years, now we have IntelliSense, and that changes everything. I think the better UML-quality to all VB syntax is a great boon while coding, also when returning to review code written weeks earlier, and especially for peer review...
(Feel free to paraphrase or add your own wisdoms, if you forward or share this...)

Microsoft Windows: Life Without Walls

No dictionary entry causes NavigationViewSample to freeze and die

As this code hasn't reference to SettingsPage, it causes the sample app to crash:

Dictionary<Type, string> lookup = new Dictionary<Type, string>()
    {
        {typeof(HomePage), "home"},
        {typeof(AppsPage), "apps"},
        {typeof(GamesPage), "games"},
        {typeof(MusicPage), "music"},
        {typeof(MyContentPage), "content"}    
    };

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 745ab6c5-cfbe-a56f-dccd-ab55123f9223
• Version Independent ID: 54455a9f-a92f-e462-558d-78fb696dba8c
• Content: Navigation view - UWP app developer
• Content Source: windows-apps-src/design/controls-and-patterns/navigationview.md
• Service: unspecified
• GitHub Login: @serenaz
• Microsoft Alias: sezhen

Extending acrylic into your title bar code must not be in the constructor of App.xaml.cs

Issue related to Acrylic material doc

CoreApplication.GetCurrentView().TitleBar.ExtendViewIntoTitleBar = true;

If we use the about code in the constructor of App.xaml.cs then the System.AccessViolationException

System.AccessViolationException: 'Attempted to read or write protected memory. This is often an indication that other memory is corrupt.'

So we should ask devs to use this code in OnLaunched or OnActivated method

The line of issue: acrylic.md#L242

Cannot reference a windows runtime project in UWP

I think that we should change the documentation of create-and-register-a-background-task.md, because of a bug causing errors when referencing a windows runtime component project to UWP project

Video link leads to nowhere

On this doc, the user expects a how-to video, instead sees a lot of white space. The link in the iframe is broken.

Use small t instead of caps T in uap4:SupportsMultipleInstances="true"

In Create and consume an app service doc you have used caps T in uap4:SupportsMultipleInstances="true".

Here is the code from that document

<Package
    xmlns:uap4="http://schemas.microsoft.com/appx/manifest/uap/windows10/4"
    ...
    <Applications>
        <Application Id="App"
          Executable="$targetnametoken$.exe"
          EntryPoint="AppServiceProvider.App">
          <Extensions>
            <uap:Extension Category="windows.appService" EntryPoint="MyAppService.Inventory">
              <uap:AppService Name="com.microsoft.inventory" uap4:SupportsMultipleInstances="True"/>
            </uap:Extension>
          </Extensions>
          ...
        </Application>
    </Applications>

Documentation for inProcessMediaExtension app capability

(Moved from MSDN)

I found that there is an MPEG2 extension for UWP apps. Then I found that the required permission is inProcessMediaExtension, which seems to help creating UWP media extensions which was not possible before. It's an interesting feature but I couldn't find any information about this permission.

Probably this is currently a private restricted capability, so can you please add documentation about it here? https://github.com/MicrosoftDocs/windows-uwp/blob/docs/windows-apps-src/packaging/app-capability-declarations.md

Published Articles are Stale

Today I saw some feedback on twitter where customers were getting upset because they didn't see their contributor avatars on articles that they had contributed to. I looked into it and saw that it was because their contributions had not been published, even after 5 months. The article in question is here:

https://github.com/MicrosoftDocs/windows-uwp/blob/docs/windows-apps-src/porting/desktop-to-uwp-extensions.md

It would be great to look into seeing if you can update the published content.

The page has invalid markdowns.

See screenshot

Back Button Requested

Hi;

I try you're solution, but the BackButtonRequested doesn't work !!
Have you got a solution for.....

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 745ab6c5-cfbe-a56f-dccd-ab55123f9223
• Version Independent ID: 54455a9f-a92f-e462-558d-78fb696dba8c
• Content: Navigation view - UWP app developer
• Content Source: windows-apps-src/design/controls-and-patterns/navigationview.md
• Service: unspecified
• GitHub Login: @serenaz
• Microsoft Alias: sezhen

Docs for BluetoothLEDevice.GattServicesChanged event fail to show how to correctly handle the event

The BluetoothLEDevice.GattServicesChanged event's documentation provides no information about how to properly handle said event being fired. The only thing stated is why the event would ever be fired.

What's worse, since the event's second parameter is an object (rather than a class), developers also cannot infer how to handle the event. Referring to the APIs source code (through decompilation or otherwise) in order to determine how to handle the event is also a no-go since the UWP APIs are native code and closed source.

With this in mind, I would greatly appreciate it if someone could inform me of exactly how this event should be properly handled, either here or by updating the documentation.

As an aside, I feel it's worth noting that the UWP Bluetooth LE API docs don't feel very fleshed-out in general. I've been working with them closely for about a month, and this specific question showcases one of the more severe deficiencies, but there are plenty of areas across the Windows.Devices.Bluetooth.GenericAttributeProfile namespace, as well as the BLE-related APIs classes in the Windows.Devices.Bluetooth namespace, where improvements could be made.

It does not work, strange error

I tried using this method and i had added winmd and windows.runtime.windowsruntime.dll using this link,https://blogs.windows.com/buildingapps/2017/01/25/calling-windows-10-apis-desktop-application/
, i need to use the graphics library for brightness override and it requires systemManagement capability but as soon as i add packaging project , the solution will not build , it does not display the error , on warning on capabilities. squiggly on systemmanagement or <rescap:Capability Name="runFullTrust" />. I need help .

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: f9f4864c-3cf6-a957-dd26-c16cb4a3015e
• Version Independent ID: c9543586-cf91-3c13-50e0-1837cf4138a4
• Content: Package an app by using Visual Studio (Desktop Bridge) - UWP app developer
• Content Source: windows-apps-src/porting/desktop-to-uwp-packaging-dot-net.md
• Service: unspecified
• GitHub Login: @normesta
• Microsoft Alias: normesta

Incomplete directions to locate and install C++/WinRT extension.

The documentation states "you'll need to download and install the C++/WinRT Visual Studio Extension (VSIX) from the Visual Studio Marketplace."

This statement isn't enough to locate the extension in the Visual Studio Marketplace.
I was unable to find it.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: f6f7d77e-7253-cfa2-ef6f-b58820138faa
• Version Independent ID: deb39be4-4af1-17ff-cd4e-6bb998f76d9e
• Content: Events; how to author and handle them in C++/WinRT - UWP app developer
• Content Source: windows-apps-src/cpp-and-winrt-apis/events-author-handle.md
• Service: unspecified
• GitHub Login: @stevewhims
• Microsoft Alias: stwhi

GATT Server documentation is outdated

The documentation at windows-uwp/windows-apps-src/devices-sensors/gatt-server.md is not accurate for the release version of the 15063 SDK.

Some property names have changed; the GattUuid class has disappeared and some other things have changed.

Some links on "Asynchronous programming in C++" go to the old VS 2015 documentation

Relevant page "Asynchronous programming in C++":

• Source
• Doc on MSDN

For example, if I click on the "task class" link or the "concurrency" link near the top of the page, I'm brought to the old VS 2015 documentation. Instead, I should be brought to the latest VS 2017 documentation.

Additional Feedback

Frustratingly, clicking on the "Visual Studio 2017 Documentation" link on the "task class" or "concurrency" page just brings me to the VS 2017 documentation homepage rather than bringing me to the matching page in the VS 2017 documentation. Then when I try to find the "task class" page by using search, it has a default tag of "VS IDE":

I'm not sure what that means but it doesn't sound relevant for the "task class" page I just came from in the VS 2015 docs. I searched for "task class" using that tag but I didn't see the page I was looking for. I tried removing the "VS IDE" tag and searching for "c++ task" but this surprisingly returned 0 results. Next I searched for "task class" with no tags and found "task_canceled Class" which is not quite what I was looking for but it's close. On that page, I put "task" into the "Filter" box and finally found the page I wanted. It's frustrating that it took me a couple of minutes to find this page.

On that final page, I noticed that searching has a tag of "C++":

How can I set the tag myself? For example, maybe I want to switch the tag from "VS IDE" to "C++".

Adam Comella
Microsoft Corp.

how could you guys publish the document "Package an app by using Visual Studio (Desktop Bridge)" without checking everything?

This doc is a joke I have to say. So many obvious errors in this doc and there is absolutely no way you can package your app successfully using this method. I am so disappointed with this document, Microsoft. Wasted me hours of time. If you are not ready to publish this document, do not publish it!!!!!!!!!!!!!!!! Check everything before posting it. Anyone in Microsoft should read this doc, try it and see how bad it is. @zastrowm 's reference is better, Thank you! I spent hours to debug this manual and those people who wrote this should go back to school and learn how to become the qualified engineer. I usually do not leave a comment. I am always grateful to those engineers who write documents as detailed and accurate as possible. This doc completely destroys my impression with Microsoft. A wrong document is even worse than nothing. I am an engineer, so I know how hard it is to build something and achieve the goal. And before this, I always think Microsoft is a great company with a great number of highly skilled and responsible engineers. I am so disappointed to read this doc. Although I am still a student, at least I know whenever I plan to publish a product in the industry, I will check everything and make sure there is no obvious error. Because I know somebody will use it and I should help them as much as I can. I just found out the comment section in the following link is disabled? After I post this comment? Seriously? See the link: https://docs.microsoft.com/en-us/windows/uwp/porting/desktop-to-uwp-packaging-dot-net

Update UWP gaming content for Visual Studio 2017

Please update this section for Visual Studio 2017

https://docs.microsoft.com/en-us/windows/uwp/gaming/e2e

Change Sageo UI Images to white Font when Black Theme is enabled

Change Sageo UI Images to white Font when Black Theme is enabled.

Can't see the icons on black theme,

ColorPicker and MVVM using Converter: Unexpected COM Object

When using a ValueConverter in a Binding to the Color property of this control, the incoming value in the ConvertBack method is a COM Object that cannot be casted to a Color. Please, check this question in StackOverflow to see more details (and snaphots!) https://stackoverflow.com/questions/47398653/colorpicker-uwp-com-exception-in-converter

How to test purchasing an app several times by the same user

Hello,

I have a game leveraging UWP that has a free trial portion (demo) where the rest of the game is only available after purchasing. I need to test the purchase code and understand that I must submit the app for certification before testing using the Windows.Services.Store code.

I would like to test purchasing the game a couple of times using my own account before going through the trouble of sending it to Beta testers. Is there a way for me to test it a couple of times on my own (IE purchase it and then have my account forget that I purchased it)? I didn't see it explained in the article.

Thanks,
Brett

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 50e4f08b-3a66-b4d8-292a-99dec9e65145
• Version Independent ID: a612ada5-d632-aa87-3c58-457c9decacb3
• Content: Beta testing and targeted distribution - UWP app developer
• Content Source: windows-apps-src/publish/beta-testing-and-targeted-distribution.md
• Service: unspecified
• GitHub Login: @JnHs
• Microsoft Alias: wdg-dev-content

Contents of MenuItemTemplate get placed inside a NavigationViewItem's ContentPresenter

See this StackOverflow question for details. It means you cannot bind the Icon property of the NavgationViewItem. This behaviour is unexpected and should be mentioned.

In my opinion, the behaviour should be changed so that the contents of MenuItemTemplate can be a custom control, which could be a NavigationViewItem if you wanted.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 745ab6c5-cfbe-a56f-dccd-ab55123f9223
• Version Independent ID: 54455a9f-a92f-e462-558d-78fb696dba8c
• Content: Navigation view - UWP app developer
• Content Source: windows-apps-src/design/controls-and-patterns/navigationview.md
• Service: unspecified
• GitHub Login: @serenaz
• Microsoft Alias: sezhen

Please provide a working sample

Followed as-is, this NavigationView code example produces over 90 compiler errors, warnings and messages. Please provide a working sample code, so that it can be really useful.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 745ab6c5-cfbe-a56f-dccd-ab55123f9223
• Version Independent ID: 54455a9f-a92f-e462-558d-78fb696dba8c
• Content: Navigation view - UWP app developer | Microsoft Docs
• Content Source: windows-apps-src/design/controls-and-patterns/navigationview.md
• Service: unspecified
• GitHub Login: @serenaz
• Microsoft Alias: sezhen

Sample project

Hello,

When there is a lot of code like the page above, it would be more convenient if the code would be in a sample project that can be downloaded via a ZIP file.

Thanks

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 12703330-b5a0-8523-3a89-c630c8514fb2
• Version Independent ID: 56f77244-5342-d30a-7ee4-ba062f5b86a5
• Content: C# sample - submissions for apps, add-ons, and flights - UWP app developer
• Content Source: windows-apps-src/monetize/csharp-code-examples-for-the-windows-store-submission-api.md
• Service: unspecified
• GitHub Login: @mcleanbyron
• Microsoft Alias: mcleans

Links under 'Examples' not clickable + layout issue

I noticed that some links are not clickable and that there is an issue with the layout (I think the two things might be related).
If you go for example to the Command Bar page and scroll to 'Examples', the links 'Get the XAML Controls Gallery app (Microsoft Store)' and 'Get the source code (GitHub)' aren't clickable. Also the link 'open the app and see the CommandBar in action' is not clickable from time to time.

On the Buttons page I see the exact same behavior.

However, on the Checkbox page all links in the Examples section are clickable, although I don't see any differences (at first sight) in de md files.

I've seen this on different PCs on Edge (Microsoft Edge 38.14393.1066.0, Microsoft EdgeHTML 14.14393), in Chrome (63.0.3239.108) and IE 11.

When I look closer, I might think this is related to the alignment of the first element under the 'Examples' table :


On these screenshots, you can clearly see that the alignment is a bit off for the first element(s) under the 'Examples'. And it seems to me that every time there is an image underneath it, that the links above it aren't clickable.

OpenCV for UWP libraries are abandoned

Here you are using "OpenCV.Win.Core" and other nuggets last published in 2016 year and their Project URL is abandoned: https://github.com/cvwin/cvwin
There are problems with all MSDN articles about UWP + 'C++/CX' + OpenCV.
Look at related issues below:

1. ""OpenCVExample/CPP" sample depends on abandoned "Microsoft/opencv" repository" - microsoft/Windows-iotcore-samples#119
2. "Microsoft you should support OpenCV!!!" - microsoft/opencv#82
3. "VS Git clone doesnt' download nested folders" - https://developercommunity.visualstudio.com/content/problem/214893/vs-git-clone-doesnt-download-nested-folders.html

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 46cb9af7-d8dc-cc44-dbb2-d2b097f604ee
• Version Independent ID: cc2d4d5d-2698-299b-1e71-dae2a984f95b
• Content: Process bitmaps with OpenCV - UWP app developer
• Content Source: windows-apps-src/audio-video-camera/process-software-bitmaps-with-opencv.md
• Service: unspecified
• GitHub Login: @drewbatgit
• Microsoft Alias: drewbatgit

Order of Sections change suggestion - for https://docs.microsoft.com/en-us/windows/uwp

Hello and thanks for considering my suggestions. I find that while using the UWP documentation, the structure of App basic considerations is difficult to navigate, unable find what I need to know about "under the hood" issues of a UWP app that would be the bare basics of knowing before laying out design and playing with controls. I feel that somewhere before "> Design and UI" there should be several sections of basic "App Structural Essentials" (or something like that) to alert the new UWP developer, reading through and expecting to get to know essentials right away and before diving into control design, of key things to know to make just about any App work properly. To find this information now, I must scour through such sections as: ">App Resources", ">Data Binding", ">Debugging, Testing, and Performance", ">Launching, Resuming, and Background Tasks", ">Files, Folders, and Libraries", and ">XAML Platform", as well as a few other sections. The idea I am getting at is like from an old Metro programming book for Windows 8 Runtime, whereby the authors usually ensure to layout some of these basics at the beginning, before going into design methods and philosophy. I was thinking that not all the content in these sections I listed need go into some sort of "App Structural Essentials" article, and maybe just links to key parts of these sections I mentioned, as sort of a primer of basic links to your more detailed references, and I would place it just after ">Get Started" and before ">Design and UI". Or alternatively, just some introductory touch of discussion of such things as data binding, local and remote storage, and other issues every new developer would be well served to at least be alerted to (if not explain it all) right at the beginning. I wonder if anyone has delved into the UWP user's guide and found themselves designing an app, and then later wondering why all the wasted time of starting over or revision, and why it was due to things like data binding and event handling were tucked away in sections low down the docs tree, and with titles sounding much like esoteric advanced issues, when in fact the issues are crucial for any developer to apply to his or her coding, immediately. Thanks for reading, and please know that overall I think the personnel writing this documentation are doing an absolutely excellent job, and putting together some of the best-written coding discussions and examples I have ever seen yet in any documentation for any system, and I have been at this since QuickBasic and Visual Basic version 1.0.

Go Microsoft Windows! -- Life Without Walls!

Null pointer in "Did you mean to switch apps" system dialog

Code snippet below throws null pointer when.

// The URI to launch
var uriBing = new Uri(@"http://www.bing.com");

// Set the option to show a warning
var promptOptions = new Windows.System.LauncherOptions();
promptOptions.TreatAsUntrusted = true;

// Launch the URI
var success = await Windows.System.Launcher.LaunchUriAsync(uriBing, promptOptions);

Null pointer deals

System.NullReferenceException occurred
  HResult=0x80004003
  Message=Object reference not set to an instance of an object.
  Source=<Cannot evaluate the exception source>

When will this control be available ?

The document at https://docs.microsoft.com/en-us/uwp/api/windows.ui.xaml.controls.treeview says that this control is in prerelease state, It would be helpful if anybody tell me about the targeted release date

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: d5ba995b-8bf3-407c-7b87-015d22d813f1
• Version Independent ID: 52c553b6-e94d-2810-4123-8ee215b002bf
• Content: Tree view - UWP app developer
• Content Source: windows-apps-src/design/controls-and-patterns/tree-view.md
• Service: unspecified
• GitHub Login: @jwmsft
• Microsoft Alias: jimwalk

Improper exception handling

There are several catch(Exception) blocks that just swallow an exception.
For example, StartPreviewAsync:
catch (Exception ex)
{
System.Diagnostics.Debug.WriteLine("MediaCapture initialization failed. {0}", ex.Message);
}
First of all, this exception is not always related to MediaCapture. It is possible this exception to be OutOfMemoryException or any other (like DevideByZeroException).
From debugging perspective this just does not make sense as any unhandled exception will be put into debugger output by itself.
From the user perspective it is unresponsive solution: user presses - nothing happening.
According to c# best practices: https://msdn.microsoft.com/en-us/library/ms173160.aspx better to remove this catch block, or if we expect some errors there should be also "when" instructions that will expect some exact HRESULT codes.
If we want to prevent application from crashing it's better to submit to Application.UnhandledException and put e.Handled=true. Anyway there is no reason to catch "everything"

Thank you!

This page is very helpful!

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 2d80bc1b-b76b-e140-1cc4-e36f0968e2f1
• Version Independent ID: 667ed2c3-cb70-9a07-d47c-8d49d4e20e4a
• Content: Export restrictions on cryptography - UWP app developer | Microsoft Docs
• Content Source: windows-apps-src/security/export-restrictions-on-cryptography.md
• Service: unspecified
• GitHub Login: @awkoren
• Microsoft Alias: alkoren

C++/WinRT Visual Studio (VSIX) does not exist in the Visual Studio Marketplace

"For C++/WinRT project templates, as well as C++/WinRT MSBuild properties and targets, download and install the C++/WinRT Visual Studio Extension (VSIX) from the Visual Studio Marketplace."

The C++/WinRT Visual Studio Extension mentioned in the above paragraph on the "Introduction to C++/WinRT" docs page could not be found.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: dcf7899f-689a-80c4-2c94-9575f8fc5055
• Version Independent ID: b8873e37-f4cb-de98-46f2-f2eaf01e275d
• Content: Introduction to C++/WinRT - UWP app developer | Microsoft Docs
• Content Source: windows-apps-src/cpp-and-winrt-apis/intro-to-using-cpp-with-winrt.md
• Service: unspecified
• GitHub Login: @stevewhims
• Microsoft Alias: stwhi

Does GATT Server need special capabilities in the package manifest?

I tried running the Gatt server code on a Raspberry Pi 3 using Windows IoT Core build 15063 and minimum SDK version 15063.

I enabled the Bluetooth capability in the package manifest but when calling

GattServiceProviderResult result = await GattServiceProvider.CreateAsync(
                GattServiceUuids.HumanInterfaceDevice);

I get

result.Error == BluetoothError.DisabledByPolicy

Too many characters in character literal

ContentFrame.Navigated += 'On_Navigated'; raises CS1012.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 745ab6c5-cfbe-a56f-dccd-ab55123f9223
• Version Independent ID: 54455a9f-a92f-e462-558d-78fb696dba8c
• Content: Navigation view - UWP app developer | Microsoft Docs
• Content Source: windows-apps-src/design/controls-and-patterns/navigationview.md
• Service: unspecified
• GitHub Login: @serenaz
• Microsoft Alias: sezhen

Machine learning: CNTK generates CNTKv2 models that aren't supported by WinML

Using Fast-RCNN to do some object detection/localization (https://docs.microsoft.com/en-us/cognitive-toolkit/Object-Detection-using-Fast-R-CNN#train-on-your-own-data), recommended via the Train AI Model (https://docs.microsoft.com/en-us/windows/uwp/machine-learning/train-ai-model) and I discovered it spits out a model in CNTKv2 format, which isn't supported by WinML or conversion tools.

A note about Microsoft not supporting their own CNTKv2 format might be relevant on the Conversion Samples page at a minimum (https://docs.microsoft.com/en-us/windows/uwp/machine-learning/conversion-samples).

Improve discoverability of x:Load

The x:Load markup extension isn't listed in the sidebar with the other markup extensions. I just learned about its existence today--I'd been using x:DeferLoadStrategy!

Screenshot of the sidebar in question:

Side-loading

It might be helpful to add a topic on side-loading a manually-signed package for testing purposes.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: a92bb7ba-dc1f-611d-1e70-11af24430aa6
• Version Independent ID: 18cd627e-e660-3b61-c8f4-11ede5ae2bf3
• Content: Manual app packaging - UWP app developer
• Content Source: windows-apps-src/packaging/manual-packaging-root.md
• Service: unspecified
• GitHub Login: @laurenhughes
• Microsoft Alias: lahugh

Something wrong with the markdown table

I'm seeing the vertical bars, headers, dashes, and contents of the markdown table on this page.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: b317978e-12a2-09ab-ca25-33835878d538
• Version Independent ID: c654c9f0-4813-8b88-e2fc-4636612fba36
• Content: Windows Runtime components - UWP app developer
• Content Source: windows-apps-src/winrt-components/index.md
• Service: unspecified
• GitHub Login: @msatranjr
• Microsoft Alias: misatran

Formatting issues in "windows-apps-src/input-and-devices/speech-recognition.md"

https://docs.microsoft.com/en-us/windows/uwp/input-and-devices/speech-recognition

Ink toolbar sample missing InkPresenter.InputDeviceTypes

I was browsing the docs page about adding a Ink Toolbar

I noticed that nowhere on this page it is stated that you should set the InputDevicesTypes on the InkPresenter of your canvas in order to be able to draw something on it.
For example, the very first sample XAML looks like you can just grab it and paste it in your own app. However, you wouldn't be able to draw anything on the canvas as the InputDevicesTypes property is not set and defaults to None. (If you want, I can do a PR for that, just showing the ctor of a page in which the InputDevicesTypes is set)

Moreover, the downloadable sample on that page also doesn't set the InputDevicesTypes.

Although this page and code sample really is about the InkToolbar, I think it might confuse developers: they download the sample code, or paste the code listed on the page in their own app, but they won't be able to draw on the canvas.

Common Excepiton handling should be removed

Comment inside is not true. A lot of exceptions not related to file can come here. Actually any exception can be received if default task factory was reimplemented

catch (Exception) { // Timestamp not found }
Also was discussed here #20

xaml-basics-ui.md Part 4: Modify the item container style

I'm not sure what's going on when I follow the instructions at Part 4 of XAML-basics-ui.md.

1. In Document Outline, right-click ImageGridView. On the context menu, select Edit Additional Templates > Edit Generated Item Container (ItemContainerStyle) > Edit a Copy.... The Create Resource dialog opens.
2. In the dialog, change the Name (key) value to ImageGridView_DefaultItemContainerStyle, then click OK.

Instead of getting

<Style x:Key="ImageGridView_DefaultItemContainerStyle" TargetType="GridViewItem">
    <Setter Property="FontFamily" Value="{ThemeResource ContentControlThemeFontFamily}"/>
    <Setter Property="FontSize" Value="{ThemeResource ControlContentThemeFontSize}"/>
    <Setter Property="Background" Value="{ThemeResource GridViewItemBackground}"/>
    <Setter Property="Foreground" Value="{ThemeResource GridViewItemForeground}"/>
    <!-- And lots of other Setters -->
</Style>

I instead get

<Style x:Key="ImageGridView_DefaultItemContainerStyle" TargetType="GridView">
    <Setter Property="Padding" Value="0,0,0,10"/>
    <Setter Property="IsTabStop" Value="False"/>
    <Setter Property="TabNavigation" Value="Once"/>
    <Setter Property="ScrollViewer.HorizontalScrollBarVisibility" Value="Disabled"/>
    <!-- And lots of other Setters that are different to the above example -->
</Style>

Note the TargetType is GridView instead of the GridViewItem that the instructions say it will be.

When I start debugging, an uncaught exception occurs. This also happens if I delete all the Setters and just have <Style x:Key="ImageGridView_DefaultItemContainerStyle" TargetType="GridView"/>. Changing the TargetType to GridViewItem makes it work.

I don't know if the instructions are wrong or if it is a problem in Visual Studio?

Provide more information about input and output binding

Please provide more information about how binding of inputs and outputs to the model work so one can better debug binding issues.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 0bd018cd-e51b-b15b-3460-8ff4a4a83f3b
• Version Independent ID: 4f95e997-6554-9384-5f57-a193e4c85bf8
• Content: Get started with Windows Machine Learning - UWP app developer | Microsoft Docs
• Content Source: windows-apps-src/machine-learning/get-started.md
• Service: unspecified
• GitHub Login: @serenaz
• Microsoft Alias: sezhen

Binding ColorPicker.Color TwoWay to a DependencyProperty causes StackOverflowException

A DependencyProperty of type Color incorrectly reports that its value has changed, even if the new value being set is a Color with exactly the same A, R, G and B values.
As a result, if in a ColorPicker you set Color="{x:Bind Path=MyBoundColor, Mode=TwoWay}", where MyBoundColor is the CLR accessor for a DependencyProperty of type Color, you will get a StackOverflowException, as the binding continually bounces back and forth between the two DPs.
For example, if you set MyBoundColor = Colors.Red, this change will propagate to the ColorPicker's Color property, which will then attempt to ensure that MyBoundColor is 'in sync' by settings its value to Colors.Red. However, as mentioned, that DP perceives the SetValue to Colors.Red to be a 'change', even though it's not. So the binding sets ColorPicker.Color to Colors.Red, which again tries to synchronize MyBoundColor -- and so on and so forth.
I think this is likely to be a common scenario in a Page or ContentDialog -- it's really quite a similar scenario to binding ListView.SelectedItem to some 'backing' property or DP.

Checkboxes don't render in table.

Readers of the documentation see ':heavy_check_mark:' instead of a rendered check mark.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 07a43e99-2699-6568-6d37-6fe72286ae3c
• Version Independent ID: dfe8c8e7-a573-32e0-cb6c-efbdadc9b00f
• Content: Extend your app with services, extensions, and packages - UWP app developer
• Content Source: windows-apps-src/launch-resume/extend-your-app-with-services-extensions-packages.md
• Service: unspecified
• GitHub Login: @TylerMSFT
• Microsoft Alias: twhitney

MessageWebSocket description

In the WebSockets page, MessageWebSocket is described as being "similar to a UDP to datagram socket". I find that claim surprising, since it literally it is built on top of TCP.

I understand that the goal of that table is to point that it is intended for frequent, small messages, as opposed to StreamWebSocket, but maybe there is a less confusing way to word it? Readers who are not familiar with the WebSocket protocol might understand (incorrectly) that the MessageWebSocket is not reliable, does not guarantee same order reception or does not include congestion control.

How do I use this documentation for my developer portal?

Hi Team,

To publish my API I am using Azure API Management and want to develop a developer portal and use similar kind of documentation, do you have any getting started guide to create documentation?