Skip to content

Commit e469baa

Browse files
nschonninschonni
committed
fix: Renormalize line endings
1 parent 29bc54a commit e469baa

File tree

121 files changed

+15397
-15393
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

121 files changed

+15397
-15393
lines changed

‎.gitattributes

+4
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
###############################################################################
2+
# Set default behavior to automatically normalize line endings.
3+
###############################################################################
4+
* text=auto

‎docs/Getting-Started.md

+45-45
Original file line numberDiff line numberDiff line change
@@ -1,45 +1,45 @@
1-
---
2-
title: Getting Started with the Windows Community Toolkit
3-
author: nmetulev
4-
description: Overview of how to get started with the Windows Community Toolkit to build amazing UWP apps
5-
keywords: windows 10, uwp, windows community toolkit, uwp community toolkit, uwp toolkit, get started, visual studio
6-
---
7-
8-
# Getting Started with the Windows Community Toolkit
9-
10-
The toolkit is available as NuGet packages that can be added to any existing or new project using Visual Studio.
11-
12-
1. Download [Visual Studio 2017](https://developer.microsoft.com/windows/downloads) and ensure you choose the **Universal Windows Platform development** Workload in the Visual Studio installer.
13-
14-
> [!NOTE]
15-
> Visual Studio 2015 is not supported with the Windows Community Toolkit 2.0 or higher
16-
17-
2. Open an existing project, or create a new project using the Blank App template under Visual C# -> Windows -> Universal. **Important**: Build 16299 or higher is supported by current version of the Toolkit.
18-
19-
3. In Solution Explorer panel, right click on your project name and select **Manage NuGet Packages**. Search for **Microsoft.Toolkit.UWP**, and choose your desired [NuGet Packages](Nuget-Packages.md) from the list.
20-
21-
![NuGet Packages](resources/images/ManageNugetPackages.png "Manage NuGet Packages Image")
22-
23-
4. Add a reference to the toolkit in your XAML pages or C#
24-
25-
* In your XAML page, add a reference at the top of your page:
26-
27-
```xaml
28-
xmlns:controls="using:Microsoft.Toolkit.Uwp.UI.Controls"
29-
```
30-
31-
* In your C# page, add the namespaces to the toolkit:
32-
33-
```csharp
34-
using Microsoft.Toolkit.Uwp;
35-
```
36-
37-
5. You can copy and paste code snippets for each feature from the [Windows Community Toolkit Sample App](https://aka.ms/windowstoolkitapp).
38-
39-
## Other Resources
40-
41-
Download the [Windows Community Toolkit Sample App](https://aka.ms/windowstoolkitapp) from the Windows store to see the controls in an actual app.
42-
43-
We recommend developers who are new to UWP to visit the [Getting Started with UWP Development](https://developer.microsoft.com/windows/getstarted) pages on the Developer portal.
44-
45-
Visit the [Windows Community Toolkit Github Repository](https://aka.ms/uwptoolkit) to see the current source code, what is coming next, and clone the repository. Community contributions are welcome!
1+
---
2+
title: Getting Started with the Windows Community Toolkit
3+
author: nmetulev
4+
description: Overview of how to get started with the Windows Community Toolkit to build amazing UWP apps
5+
keywords: windows 10, uwp, windows community toolkit, uwp community toolkit, uwp toolkit, get started, visual studio
6+
---
7+
8+
# Getting Started with the Windows Community Toolkit
9+
10+
The toolkit is available as NuGet packages that can be added to any existing or new project using Visual Studio.
11+
12+
1. Download [Visual Studio 2017](https://developer.microsoft.com/windows/downloads) and ensure you choose the **Universal Windows Platform development** Workload in the Visual Studio installer.
13+
14+
> [!NOTE]
15+
> Visual Studio 2015 is not supported with the Windows Community Toolkit 2.0 or higher
16+
17+
2. Open an existing project, or create a new project using the Blank App template under Visual C# -> Windows -> Universal. **Important**: Build 16299 or higher is supported by current version of the Toolkit.
18+
19+
3. In Solution Explorer panel, right click on your project name and select **Manage NuGet Packages**. Search for **Microsoft.Toolkit.UWP**, and choose your desired [NuGet Packages](Nuget-Packages.md) from the list.
20+
21+
![NuGet Packages](resources/images/ManageNugetPackages.png "Manage NuGet Packages Image")
22+
23+
4. Add a reference to the toolkit in your XAML pages or C#
24+
25+
* In your XAML page, add a reference at the top of your page:
26+
27+
```xaml
28+
xmlns:controls="using:Microsoft.Toolkit.Uwp.UI.Controls"
29+
```
30+
31+
* In your C# page, add the namespaces to the toolkit:
32+
33+
```csharp
34+
using Microsoft.Toolkit.Uwp;
35+
```
36+
37+
5. You can copy and paste code snippets for each feature from the [Windows Community Toolkit Sample App](https://aka.ms/windowstoolkitapp).
38+
39+
## Other Resources
40+
41+
Download the [Windows Community Toolkit Sample App](https://aka.ms/windowstoolkitapp) from the Windows store to see the controls in an actual app.
42+
43+
We recommend developers who are new to UWP to visit the [Getting Started with UWP Development](https://developer.microsoft.com/windows/getstarted) pages on the Developer portal.
44+
45+
Visit the [Windows Community Toolkit Github Repository](https://aka.ms/uwptoolkit) to see the current source code, what is coming next, and clone the repository. Community contributions are welcome!

‎docs/Nuget-Packages.md

+52-52
Original file line numberDiff line numberDiff line change
@@ -1,52 +1,52 @@
1-
---
2-
title: Windows Community Toolkit Nuget Packages
3-
author: nmetulev
4-
description: The Windows Community Toolkit is updated regularly with new controls, services, APIs, and more importantly, bug fixes. Make sure to regularly update your nuget packages
5-
keywords: windows 10, uwp, windows community toolkit, uwp community toolkit, uwp toolkit, nuget, visual studio
6-
---
7-
8-
# Windows Community Toolkit Nuget Packages
9-
10-
NuGet is a standard package manager for .Net applications that is built into Visual Studio. From your open solution choose the *Tools* menu, *NuGet Package Manager*, *Manage NuGet packages for solution...* to open the UI. Enter one of the package names below to search for it online.
11-
12-
| NuGet Package Name | Description |
13-
| --- | --- |
14-
| Microsoft.Toolkit | .NET Standard NuGet package containing common code |
15-
| Microsoft.Toolkit.HighPerformance | .NET Standard and .NET Core NuGet package with performance oriented helpers, extensions, etc. |
16-
| Microsoft.Toolkit.Parsers | .NET Standard NuGet package containing cross-platform parsers, such as Markdown and RSS |
17-
| Microsoft.Toolkit.Services | .NET Standard NuGet package containing cross-platform services |
18-
| Microsoft.Toolkit.Uwp | Main NuGet package includes code only helpers such as Colors conversion tool, Storage file handling, a Stream helper class, etc. |
19-
| Microsoft.Toolkit.Uwp.Notifications | Notifications Package - Generate tile, toast, and badge notifications for Windows 10 via code. Includes intellisense support to avoid having to use the XML syntax |
20-
| Microsoft.Toolkit.Uwp.Notifications.Javascript | Notification Packages for JavaScript |
21-
| Microsoft.Toolkit.Uwp.Services | Services Package - This NuGet package includes the service helpers for Facebook, LinkedIn, Microsoft Graph, Twitter and more |
22-
| Microsoft.Toolkit.Uwp.UI | UI Packages - XAML converters, Visual tree extensions, and other extensions and helpers for your XAML UI |
23-
| Microsoft.Toolkit.Uwp.UI.Animations | Animations and Composition behaviors such as Blur, Fade, Rotate, etc. |
24-
| Microsoft.Toolkit.Uwp.UI.Controls | XAML Controls such as RadialGauge, RangeSelector, etc. |
25-
| Microsoft.Toolkit.Uwp.UI.Controls.DataGrid | XAML DataGrid control |
26-
| Microsoft.Toolkit.Uwp.UI.Controls.Layout | XAML layout controls such as WrapLayout, StaggeredLayout, etc. |
27-
| Microsoft.Toolkit.Uwp.UI.Lottie | Library for rendering Adobe AfterEffects animations natively in Windows apps |
28-
| Microsoft.Toolkit.Uwp.UI.Media | Brushes, Win2D/Composition effects, and helpers to create visual effects |
29-
| Microsoft.Toolkit.Uwp.Connectivity | API helpers such as BluetoothLEHelper and Networking |
30-
| Microsoft.Toolkit.Uwp.DeveloperTools | XAML user controls and services to help developer building their app |
31-
32-
## Search in Visual Studio
33-
34-
Searching in Visual Studio package manager you should see a list similar to the one below (version numbers may be different, but names should be the same).
35-
36-
![NuGet packages](resources/images/NugetPackages.png "Nuget Packages")
37-
38-
## Update Nuget Packages
39-
40-
The Windows Community Toolkit is updated regularly with new controls, services, APIs, and more importantly, bug fixes. To make sure you are on the latest version, open your project in Visual Studio, choose the **Tools** menu, select **NuGet Package Manager** -> **Manage NuGet Packages for Solution...** and select the *Updates* tab. Select the package you want to update and click Instal to update to the latest version.
41-
42-
## Getting Started
43-
44-
Read the [getting Started with the Windows Community Toolkit](getting-started.md) for more instructions on using these NuGet Packages in your own projects.
45-
46-
## Windows 10 Store App
47-
48-
Want to see the controls and animations in action before jumping into the code? We have published the [Windows Community Toolkit Sample App](https://aka.ms/windowstoolkitapp) to the Windows 10 store. Download the app and play with the controls live to see what they do before ever writing a line of code.
49-
50-
## GitHub Repository
51-
52-
Visit the [Windows Community Toolkit Github Repository](https://aka.ms/uwptoolkit) to see the current source code, what is coming next, and to clone the repository. Community contributions are welcome!
1+
---
2+
title: Windows Community Toolkit Nuget Packages
3+
author: nmetulev
4+
description: The Windows Community Toolkit is updated regularly with new controls, services, APIs, and more importantly, bug fixes. Make sure to regularly update your nuget packages
5+
keywords: windows 10, uwp, windows community toolkit, uwp community toolkit, uwp toolkit, nuget, visual studio
6+
---
7+
8+
# Windows Community Toolkit Nuget Packages
9+
10+
NuGet is a standard package manager for .Net applications that is built into Visual Studio. From your open solution choose the *Tools* menu, *NuGet Package Manager*, *Manage NuGet packages for solution...* to open the UI. Enter one of the package names below to search for it online.
11+
12+
| NuGet Package Name | Description |
13+
| --- | --- |
14+
| Microsoft.Toolkit | .NET Standard NuGet package containing common code |
15+
| Microsoft.Toolkit.HighPerformance | .NET Standard and .NET Core NuGet package with performance oriented helpers, extensions, etc. |
16+
| Microsoft.Toolkit.Parsers | .NET Standard NuGet package containing cross-platform parsers, such as Markdown and RSS |
17+
| Microsoft.Toolkit.Services | .NET Standard NuGet package containing cross-platform services |
18+
| Microsoft.Toolkit.Uwp | Main NuGet package includes code only helpers such as Colors conversion tool, Storage file handling, a Stream helper class, etc. |
19+
| Microsoft.Toolkit.Uwp.Notifications | Notifications Package - Generate tile, toast, and badge notifications for Windows 10 via code. Includes intellisense support to avoid having to use the XML syntax |
20+
| Microsoft.Toolkit.Uwp.Notifications.Javascript | Notification Packages for JavaScript |
21+
| Microsoft.Toolkit.Uwp.Services | Services Package - This NuGet package includes the service helpers for Facebook, LinkedIn, Microsoft Graph, Twitter and more |
22+
| Microsoft.Toolkit.Uwp.UI | UI Packages - XAML converters, Visual tree extensions, and other extensions and helpers for your XAML UI |
23+
| Microsoft.Toolkit.Uwp.UI.Animations | Animations and Composition behaviors such as Blur, Fade, Rotate, etc. |
24+
| Microsoft.Toolkit.Uwp.UI.Controls | XAML Controls such as RadialGauge, RangeSelector, etc. |
25+
| Microsoft.Toolkit.Uwp.UI.Controls.DataGrid | XAML DataGrid control |
26+
| Microsoft.Toolkit.Uwp.UI.Controls.Layout | XAML layout controls such as WrapLayout, StaggeredLayout, etc. |
27+
| Microsoft.Toolkit.Uwp.UI.Lottie | Library for rendering Adobe AfterEffects animations natively in Windows apps |
28+
| Microsoft.Toolkit.Uwp.UI.Media | Brushes, Win2D/Composition effects, and helpers to create visual effects |
29+
| Microsoft.Toolkit.Uwp.Connectivity | API helpers such as BluetoothLEHelper and Networking |
30+
| Microsoft.Toolkit.Uwp.DeveloperTools | XAML user controls and services to help developer building their app |
31+
32+
## Search in Visual Studio
33+
34+
Searching in Visual Studio package manager you should see a list similar to the one below (version numbers may be different, but names should be the same).
35+
36+
![NuGet packages](resources/images/NugetPackages.png "Nuget Packages")
37+
38+
## Update Nuget Packages
39+
40+
The Windows Community Toolkit is updated regularly with new controls, services, APIs, and more importantly, bug fixes. To make sure you are on the latest version, open your project in Visual Studio, choose the **Tools** menu, select **NuGet Package Manager** -> **Manage NuGet Packages for Solution...** and select the *Updates* tab. Select the package you want to update and click Instal to update to the latest version.
41+
42+
## Getting Started
43+
44+
Read the [getting Started with the Windows Community Toolkit](getting-started.md) for more instructions on using these NuGet Packages in your own projects.
45+
46+
## Windows 10 Store App
47+
48+
Want to see the controls and animations in action before jumping into the code? We have published the [Windows Community Toolkit Sample App](https://aka.ms/windowstoolkitapp) to the Windows 10 store. Download the app and play with the controls live to see what they do before ever writing a line of code.
49+
50+
## GitHub Repository
51+
52+
Visit the [Windows Community Toolkit Github Repository](https://aka.ms/uwptoolkit) to see the current source code, what is coming next, and to clone the repository. Community contributions are welcome!

‎docs/Toolbox-Support.md

+33-33
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,33 @@
1-
---
2-
title: Windows Community Toolkit controls in the Visual Studio Toolbox
3-
author: nmetulev
4-
description: Adding the Windows Community Toolkit to your Visual Studio Toolbox simplifies the development workflow with the Visual Studio designer
5-
keywords: windows 10, uwp, windows community toolkit, uwp community toolkit, uwp toolkit, visual studio, toolbox
6-
---
7-
8-
# Adding the Windows Community Toolkit to your Visual Studio Toolbox (for version 2.0 or below)
9-
10-
> [!NOTE]
11-
> Starting with version 2.1, the Windows Community Toolkit controls will be automatically available in the Visual Studio Toolbox as soon as the NuGet package is installed.
12-
13-
Add the Windows Community Toolkit controls into the Visual Studio toolbox by following these steps:
14-
15-
1) Add the *Microsoft.Toolkit.Uwp.UI.Controls* NuGet package to your application.
16-
17-
2) Open any XAML page and select the Toolbox on the left side of Visual Studio.
18-
19-
3) Right click in a blank area and select *Add Tab*. Name the tab *Windows Community Toolkit Controls*.
20-
21-
4) Right click in the tab you just created and select *Choose Items...*. Then select *Browse* from the *Choose Toolbox Items* dialog and navigate to the folder on your machine:
22-
23-
```
24-
c:\Users\%USERNAME%\.nuget\packages\Microsoft.Toolkit.Uwp.UI.Controls\
25-
```
26-
27-
a. Choose the folder name matching the version you have installed, then continue to the *lib\uap10.0* folder and select the *Microsoft.Toolkit.Uwp.UI.Controls.dll* file. You should end up with a dialog similar to the one shown below.
28-
29-
![UI Toolbox Items](resources/images/choosetoolboxitems.png "Choose Toolbox Image")
30-
31-
5) Your toolbox should now have a list of UI Controls from the toolkit that you can drag and drop onto your XAML surfaces.
32-
33-
![Completed Toolbox Items](resources/images/toolboxfinal.png "Toolbox Final Image")
1+
---
2+
title: Windows Community Toolkit controls in the Visual Studio Toolbox
3+
author: nmetulev
4+
description: Adding the Windows Community Toolkit to your Visual Studio Toolbox simplifies the development workflow with the Visual Studio designer
5+
keywords: windows 10, uwp, windows community toolkit, uwp community toolkit, uwp toolkit, visual studio, toolbox
6+
---
7+
8+
# Adding the Windows Community Toolkit to your Visual Studio Toolbox (for version 2.0 or below)
9+
10+
> [!NOTE]
11+
> Starting with version 2.1, the Windows Community Toolkit controls will be automatically available in the Visual Studio Toolbox as soon as the NuGet package is installed.
12+
13+
Add the Windows Community Toolkit controls into the Visual Studio toolbox by following these steps:
14+
15+
1) Add the *Microsoft.Toolkit.Uwp.UI.Controls* NuGet package to your application.
16+
17+
2) Open any XAML page and select the Toolbox on the left side of Visual Studio.
18+
19+
3) Right click in a blank area and select *Add Tab*. Name the tab *Windows Community Toolkit Controls*.
20+
21+
4) Right click in the tab you just created and select *Choose Items...*. Then select *Browse* from the *Choose Toolbox Items* dialog and navigate to the folder on your machine:
22+
23+
```
24+
c:\Users\%USERNAME%\.nuget\packages\Microsoft.Toolkit.Uwp.UI.Controls\
25+
```
26+
27+
a. Choose the folder name matching the version you have installed, then continue to the *lib\uap10.0* folder and select the *Microsoft.Toolkit.Uwp.UI.Controls.dll* file. You should end up with a dialog similar to the one shown below.
28+
29+
![UI Toolbox Items](resources/images/choosetoolboxitems.png "Choose Toolbox Image")
30+
31+
5) Your toolbox should now have a list of UI Controls from the toolkit that you can drag and drop onto your XAML surfaces.
32+
33+
![Completed Toolbox Items](resources/images/toolboxfinal.png "Toolbox Final Image")

0 commit comments

Comments
 (0)