Создание элемента управления панели элементов WPF

Статья
12/21/2023

Шаблон элемента управления панели элементов WPF (Windows Presentation Framework) позволяет создавать элементы управления WPF, которые автоматически добавляются на панель элементов при установке расширения. В этом пошаговом руководстве показано, как использовать шаблон для создания элемента управления панели элементов , который можно распространять другим пользователям.

Создание элемента управления панели элементов

Создание расширения с помощью элемента управления панели элементов WPF

Создайте проект VSIX с именем MyToolboxControl. Шаблон проекта VSIX можно найти в диалоговом окне "Новый проект ", выполнив поиск vsix.
Когда проект откроется, добавьте шаблон элемента управления панелью элементов WPF с именем MyToolboxControl. Щелкните правой кнопкой мыши узел проекта в Обозревателе решений, а затем выберите Добавить>Новый элемент. В диалоговом окне "Добавление нового элемента" перейдите в Visual C#>Extensibility и выберите элемент управления панели элементов WPF. В поле "Имя" в нижней части окна измените имя файла команды на MyToolboxControl.cs.

Теперь решение содержит элемент управления пользователем, который ProvideToolboxControlAttributeRegistrationAttribute добавляет элемент управления в панель элементов и запись ресурса Microsoft.VisualStudio.ToolboxControl в манифесте VSIX для развертывания.

Создание пользовательского интерфейса элемента управления

Откройте MyToolboxControl.xaml в конструкторе.

В конструкторе показан элемент управления Grid, содержащий элемент управления Button.
Упорядочение макета сетки. При выборе Grid элемента управления на верхней и левой краях сетки отображаются синие панели управления. Строки и столбцы можно добавить в сетку, щелкнув их.
Добавьте дочерние элементы управления в сетку. Дочерний элемент управления можно разместить, перетащив его из панели элементов в раздел сетки или установив его Grid.Row и Grid.Column атрибуты в XAML. В следующем примере добавляются две метки в верхней строке сетки и кнопка во второй строке.
```
<Grid>
    <Label Grid.Row="0" Grid.Column="0" Name="label1" />
    <Label Grid.Row="0" Grid.Column="1" Name="label2" />
    <Button Name="button1" Click="button1_Click" Grid.Row="1" Grid.ColumnSpan="2" />
</Grid>
```

Переименование элемента управления

По умолчанию элемент управления появится на панели элементов в качестве MyToolboxControl в группе с именем MyToolboxControl.MyToolboxControl. Эти имена можно изменить в файле MyToolboxControl.xaml.cs .

Откройте MyToolboxControl.xaml.cs в представлении кода.
MyToolboxControl Найдите класс и переименуйте его в TestControl. (Самый быстрый способ сделать это — переименовать класс, а затем выбрать Переименуйте из контекстного меню и выполните действия. (Дополнительные сведения о Команда переименования см. в разделе "Переименовать рефакторинг( C#)".)
Перейдите к атрибуту ProvideToolboxControl и измените значение первого параметра на Test. Это имя группы, которая будет содержать элемент управления на панели элементов.

Полученный код должен выглядеть следующим образом:
```
[ProvideToolboxControl("Test", true)]
public partial class TestControl : UserControl
{
    public TestControl()
    {
        InitializeComponent();
    }
}
```

Сборка, тестирование и развертывание

При отладке проекта необходимо найти элемент управления, установленный на панели элементов экспериментального экземпляра Visual Studio.

Сборка и тестирование элемента управления

Перестройте проект и запустите отладку.
В новом экземпляре Visual Studio создайте проект приложения WPF. Убедитесь, что конструктор XAML открыт.
Найдите свой элемент управления в панели элементов и перетащите его в рабочую область конструирования.
Начните отладку приложения WPF.
Убедитесь, что элемент управления отображается.

Развертывание элемента управления

После сборки тестового проекта можно найти VSIX-файл в папке *\bin\debug* проекта.
Его можно установить на локальном компьютере, дважды щелкнув VSIX-файл и выполнив процедуру установки. Чтобы удалить элемент управления, перейдите в раздел "Расширения инструментов>" и Обновления и найдите расширение элемента управления, а затем нажмите кнопку "Удалить".
Отправьте VSIX-файл в сеть или на веб-сайт.

При отправке файла на веб-сайт Visual Studio Marketplace другие пользователи могут использовать расширения инструментов>и Обновления в Visual Studio, чтобы найти элемент управления в Интернете и установить его.

Share via

Создание элемента управления панели элементов WPF