Share via


Create a new user control in your Silverlight 2 project

This page applies to Silverlight 2 projects only

You can design your own customized controls that you can reuse multiple times in a Silverlight 2 project. These controls inherit from the UserControl class and therefore do not use templates. However, you have full control over the appearance of your user control by designing it from the ground up.

To create an empty user control

  1. Open a Silverlight 2 project.

  2. On the File menu, click New Item (CTRL+N).

    Dd185520.b2bd3ff5-22c3-403e-af75-ed0d4d1b7aed(en-us,Expression.10).png

  3. In the New Item dialog box, under Installed templates, select UserControl.

  4. Next to Name, enter a descriptive name for your user control.

  5. If you want a code-behind file to be generated for this user control, select Include code file.

    Tip

    You will need a code-behind file if you want the user control to respond to user interaction, or if a developer will be creating custom behavior for the user control.

  6. Click OK to close the dialog box and open the user control for editing.

    You can now design the look of your user control.

To create a user control from existing objects

  1. Select the existing objects that you want to make part of the new user control.

    Tip

    To select multiple objects, hold the CTRL key when you click each object.

  2. On the Tools menu, click Make Control (F8).

    Dd185520.2a301fcf-3ece-4254-a3d1-654ad98cb9a7(en-us,Expression.10).png

  3. In the Make Control dialog box, enter a descriptive name for your user control.

  4. If you want to leave the selected objects where they are and created duplicates in the user control, select Leave original content as is and create duplicates as necessary.

  5. Click OK to create the user control files and open the XAML file on the artboard for editing.

To draw a new instance of your user control in a document in your project

  1. Save all your files (CTRL+SHIFT+S).

  2. Build your project (CTRL+SHIFT+B) to make the user control appear in the Asset Library.

  3. In the Toolbox, click Asset Library Dd185520.0224cabd-5da1-4e01-bddd-4a647401a098(en-us,Expression.10).png.

  4. In the Asset Library, in the Custom Controls tab, select your user control.

    Dd185520.9cd1da53-f2d2-4f69-8b7d-3cce14b06763(en-us,Expression.10).png

  5. Using your mouse, draw your user control on the artboard.

Tip

Use the Make Button command in Silverlight 2 projects to make a button from selected objects. You can select objects on the artboard, group them into a layout panel such as a Grid, and then click Make Button on the Tools menu. Make Button does not create a user control. Instead, it creates a button style that contains a template made up of the objects that you selected. To draw another button of the same kind, select your style in the Local Styles tab of the Asset Library and then draw on the artboard.

Troubleshooting

  • When you use the Make Control command, if the objects that you selected include factored content such as event handlers or triggers, you may need to restore those event handler methods and triggers in the newly created user control.

Next steps

See also

Concepts

Make an object into a button