Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/communitytoolkit/microsoft.toolkit.win32

ARCHIVE - This repository contained XAML Islands wrapper controls and tooling for XAML Islands with WinUI 2, see readme for more info about XAML Islands with WinUI 3 and the WindowsAppSDK.
https://github.com/communitytoolkit/microsoft.toolkit.win32

uwp windows-10 windows-forms windows-toolkit windows-xaml-host winforms wpf xaml-islands

Last synced: 3 days ago
JSON representation

ARCHIVE - This repository contained XAML Islands wrapper controls and tooling for XAML Islands with WinUI 2, see readme for more info about XAML Islands with WinUI 3 and the WindowsAppSDK.

Host: GitHub
URL: https://github.com/communitytoolkit/microsoft.toolkit.win32
Owner: CommunityToolkit
License: other
Archived: true
Created: 2018-11-13T18:59:04.000Z (almost 6 years ago)
Default Branch: main
Last Pushed: 2023-08-30T20:45:19.000Z (about 1 year ago)
Last Synced: 2024-05-21T07:03:58.418Z (5 months ago)
Topics: uwp, windows-10, windows-forms, windows-toolkit, windows-xaml-host, winforms, wpf, xaml-islands
Language: C#
Homepage: https://aka.ms/windowsappsdk
Size: 1.38 MB
Stars: 380
Watchers: 33
Forks: 88
Open Issues: 150
Metadata Files:
- Readme: readme.md
- Contributing: contributing.md
- License: license.md

Awesome Lists containing this project

README

        ---

topic: sample

languages:

- csharp

products:

- windows

---

# Windows Community Toolkit - WPF and Windows Forms 

This repository contains all controls for WPF and WinForms to simplify and demonstate usage of UWP controls.

For everything else in the Windows Community Toolkit (UWP controls, .NET Standard web services, helpers and more), [start here](https://github.com/windows-toolkit/WindowsCommunityToolkit)

## 🚨 Archival Notice - 8/30/2023

With the release of [Xaml Islands for Windows App SDK 1.4](https://learn.microsoft.com/windows/apps/windows-app-sdk/stable-channel#xaml-islands-no-longer-experimental) this repo is being archived.

All feature/issue/discussion inquires related to XAML Islands should be directed to the [WindowsAppSDK repository here](https://github.com/microsoft/WindowsAppSDK).

## XAML Islands Notice

The set of WPF and WinForms controls found here are _only designed to work with .NET Core 3.1_, **not** .NET 5 and above. These controls are using the XAML Islands Windows 10 APIs included within the Windows 10 OS which won't be improved anymore. 

WinUI 3's XAML Islands is the path forward to these .NET apps that want to use .NET 5 and WinUI. WinUI 3's XAML Islands are still in development, and we recommend reviewing the [WinUI 3 roadmap](https://github.com/Microsoft/microsoft-ui-xaml/blob/master/docs/roadmap.md) to get the latest updates. This repository will be archived once WinUI 3's XAML Islands is released.

In the meantime, we suggest you investigate WinUI 3 Desktop as a solution to access Win32 APIs while using the latest native UX platform. See [here](https://aka.ms/winui3) for more details.

## Build Status

| Target | Branch | Status | Recommended NuGet packages version |

| ------ | ------ | ------ | ------ |

| Pre-release beta testing | master | [![Build Status](https://dev.azure.com/dotnet/WindowsCommunityToolkit/_apis/build/status/nmetulev.Win32Test)](https://dev.azure.com/dotnet/WindowsCommunityToolkit/_build/latest?definitionId=59) | [![MyGet](https://img.shields.io/dotnet.myget/uwpcommunitytoolkit/vpre/Microsoft.Toolkit.Forms.UI.XamlHost.svg)](https://dotnet.myget.org/gallery/uwpcommunitytoolkit) |

## Getting Started

Please read the [getting Started with the Windows Community Toolkit](https://docs.microsoft.com/windows/communitytoolkit/getting-started) page for more detailed information about using the toolkit.

## Documentation

All documentation for the toolkit is hosted on [Microsoft Docs](https://docs.microsoft.com/windows/communitytoolkit/). All API documentation can be found at the [.NET API Browser](https://docs.microsoft.com/en-us/dotnet/api/?term=microsoft.toolkit).

## Windows Community Toolkit Sample App

Want to see the toolkit in action before jumping into the code? Download and play with the [Windows Community Toolkit Sample App](https://www.microsoft.com/store/apps/9nblggh4tlcq) from the Store.

## Controls

| Control | Minimum supported OS | Description |

|-----------------|-------------------------------|-------------|

| [WindowsXamlHost](https://docs.microsoft.com/windows/communitytoolkit/controls/wpf-winforms/windowsxamlhost) | Windows 10, version 1809 | Adds built-in or custom UWP controls to the User Interface (UI) of WPF or Windows Forms desktop application. |

| [WebView](https://docs.microsoft.com/windows/communitytoolkit/controls/wpf-winforms/webview) | Windows 10, version 1803 | Uses the Microsoft Edge rendering engine to show web content. |

| [WebViewCompatible](https://docs.microsoft.com/windows/communitytoolkit/controls/wpf-winforms/webviewcompatible) | Windows 7 | Provides a version of **WebView** that is compatible with more OS versions. This control uses the Microsoft Edge rendering engine to show web content on Windows 10 version 1803 and later, and the Internet Explorer rendering engine to show web content on earlier versions of Windows 10, Windows 8.x, and Windows 7. |

| [InkCanvas](https://docs.microsoft.com/windows/communitytoolkit/controls/wpf-winforms/inkcanvas)
[InkToolbar](https://docs.microsoft.com/windows/communitytoolkit/controls/wpf-winforms/inktoolbar) | Windows 10, version 1809 | Provide a surface and related toolbars for Windows Ink-based user interaction in your Windows Forms or WPF desktop application. |

| [MediaPlayerElement](https://docs.microsoft.com/windows/communitytoolkit/controls/wpf-winforms/mediaplayerelement) | Windows 10, version 1809 | Embeds a view that streams and renders media content such as video in your Windows Forms or WPF desktop application. |

| [MapControls](https://docs.microsoft.com/windows/communitytoolkit/controls/wpf-winforms/mapcontrol) | Windows 10, version 1809 | Enables a symbolic or photorealistic map in your Windows Forms or WPF desktop application. |

## WebView Notice

**New:** _Try out the pre-release preview of WebView2 for .NET [here](https://docs.microsoft.com/en-us/microsoft-edge/webview2/releasenotes#09515-prerelease)._ 🎉🎉🎉

WebView2 will replace the WebView control in the toolkit, as laid out in the introduction to [WebView2 here](https://aka.ms/WebView2). This means that we've deprecated the WebView control within the Toolkit and are working with the Edge team to convey all the requirements from the open issues here.

Over the next few months, they'll be processing the open requests to ensure the scenarios folks are using WebView for will be supported with its replacement in the future. You can provide feedback directly to the Edge team [here](https://github.com/MicrosoftEdge/WebViewFeedback). Thank you for using WebView!

## Feedback and Requests

Please use [GitHub Issues](https://github.com/windows-toolkit/WindowsCommunityToolkit/issues) for bug reports and feature requests.

For feature requests, please also create an entry in our [UserVoice](https://wpdev.uservoice.com/forums/110705-universal-windows-platform/category/193402-uwp-community-toolkit).

For general questions and support, please use [Stack Overflow](https://stackoverflow.com/questions/tagged/windows-community-toolkit) where questions should be tagged with the tag `windows-community-toolkit`.

## Contributing

Do you want to contribute? Here are our [contribution guidelines](https://github.com/windows-toolkit/WindowsCommunityToolkit/blob/master/contributing.md).

## Principles

* Principle **#1**: The toolkit will be kept simple.

* Principle **#2**: As soon as a comparable feature is available in the Windows SDK for Windows 10, it will be marked as deprecated.

* Principle **#3**: All features will be supported for two Windows SDK for Windows 10 release cycles or until another principle supersedes it.

This project has adopted the code of conduct defined by the [Contributor Covenant](http://contributor-covenant.org/) to clarify expected behavior in our community.

For more information see the [.NET Foundation Code of Conduct](http://dotnetfoundation.org/code-of-conduct).

## Roadmap

Read what we [plan for next iterations](https://github.com/windows-toolkit/WindowsCommunityToolkit/milestones), and feel free to ask questions.

By adding this ([NuGet repo](https://dotnet.myget.org/F/uwpcommunitytoolkit/api/v3/index.json) | [Gallery](https://dotnet.myget.org/gallery/uwpcommunitytoolkit)) to your NuGet sources in Visual Studio, you can also get pre-release packages of upcoming versions.

## .NET Foundation

This project is supported by the [.NET Foundation](http://dotnetfoundation.org).