You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/Guides/Create-UWP-Controls.md
+9-9Lines changed: 9 additions & 9 deletions
Original file line number
Diff line number
Diff line change
@@ -66,14 +66,14 @@ The structure of the file is as follows:
66
66
67
67
where:
68
68
69
-
-*your_package_file*: the name of your control file, such as `ManagedPackage.winmd`.
69
+
-*your_package_file*: the name of your control file, such as `ManagedPackage.winmd` ("ManagedPackage" is an arbitrary named used for this example and has no other meaning).
70
70
-*vs_category*: The label for the group in which the control should appear in the Visual Studio designer’s toolbox. A `VSCategory` is necessary for the control to appear in the toolbox.
71
71
-*blend_category*: The label for the group in which the control should appear in the Blend designer’s Assets pane. A `BlendCategory` is necessary for the control to appear in Assets.
72
72
-*type_full_name_n*: The fully-qualified name for each control, including the namespace, such as `ManagedPackage.MyCustomControl`. Note that the dot format is used for both managed and native types.
73
73
74
74
In more advanced scenarios, you can also include multiple `<File>` elements within `<FileList>` when a single package contains multiple control assemblies. You can also have multiple `<ToolboxItems>` nodes within a single `<File>` if you want to organize your controls into separate categories.
75
75
76
-
In the following example, the control implemented in `ManagedPackage.winmd` will appear in Visual Studio and Blend in a group named “Managed Package”, and “MyCustomControl” will appear in that group.
76
+
In the following example, the control implemented in `ManagedPackage.winmd` will appear in Visual Studio and Blend in a group named “Managed Package”, and “MyCustomControl” will appear in that group. All these names are arbitrary.
77
77
78
78
```xml
79
79
<FileList>
@@ -143,12 +143,12 @@ For example, let’s say you’ve set the TPMinV for you controls package to Win
143
143
\ref\uap10.0\*
144
144
```
145
145
146
-
To enforce the appropriate TPMinV check, create an [MSBuild targets file](https://docs.microsoft.com/visualstudio/msbuild/msbuild-targets) and package it under the build folder:
146
+
To enforce the appropriate TPMinV check, create an [MSBuild targets file](https://docs.microsoft.com/visualstudio/msbuild/msbuild-targets) and package it under the build folder (replacing "your_assembly_name" with the name of your specific assembly):
147
147
148
148
```
149
149
\build
150
150
\uap10.0
151
-
MyManagedPackage.targets
151
+
your_assembly_name.targets
152
152
\lib
153
153
\tools
154
154
```
@@ -174,15 +174,16 @@ Here is an example of what the targets file should look like:
174
174
175
175
## Add design-time support
176
176
177
-
To configure where the control properties show up in the property inspector, add custom adorners, etc., place your `design.dll` file inside the `lib\<platform>\Design` folder as appropriate to the target platform:
177
+
To configure where the control properties show up in the property inspector, add custom adorners, etc., place your `design.dll` file inside the `lib\<platform>\Design` folder as appropriate to the target platform. Also, to ensure that the **[Edit Template > Edit a Copy](https://docs.microsoft.com/windows/uwp/controls-and-patterns/xaml-styles#modify-the-default-system-styles)** feature works, you must include the `Generic.xaml` and any resource dictionaries that it merges in the `<AssemblyName>\Themes` folder. (This file has no impact on the runtime behavior of a control.)
178
+
178
179
179
180
```
180
181
\build
181
182
\lib
182
183
\uap10.0.14393.0
183
184
\Design
184
185
\MyControl.design.dll
185
-
\ManagedPackage
186
+
\your_assembly_name
186
187
\Themes
187
188
Generic.xaml
188
189
\tools
@@ -191,7 +192,6 @@ To configure where the control properties show up in the property inspector, add
191
192
> [!Note]
192
193
> By default, control properties will show up under the Miscellaneous category in the property inspector.
193
194
194
-
To ensure that the **[Edit Template > Edit a Copy](https://docs.microsoft.com/windows/uwp/controls-and-patterns/xaml-styles#modify-the-default-system-styles)** feature works, you must include the `Generic.xaml` and any resource dictionaries that it merges in the `<AssemblyName>\Themes` folder.
195
195
196
196
## Use strings and resources
197
197
@@ -201,14 +201,14 @@ For an example, refer to [MyCustomControl.cs](https://github.com/NuGet/Samples/b
201
201
202
202
## Package content such as images
203
203
204
-
To package content such as images that can be used by your control or the consuming UWP project. add those files `lib\uap10.0.14393.0` folder as follows:
204
+
To package content such as images that can be used by your control or the consuming UWP project. add those files `lib\uap10.0.14393.0` folder as follows ("your_assembly_name" should again match your particular control):
0 commit comments