Поделиться через


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

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

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

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

  1. Создайте проект VSIX с именем MyToolboxControl. Шаблон проекта VSIX можно найти в диалоговом окне "Новый проект ", выполнив поиск vsix.

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

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

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

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

    В конструкторе показан элемент управления Grid, содержащий элемент управления Button.

  2. Упорядочение макета сетки. При выборе Grid элемента управления на верхней и левой краях сетки отображаются синие панели управления. Строки и столбцы можно добавить в сетку, щелкнув их.

  3. Добавьте дочерние элементы управления в сетку. Дочерний элемент управления можно разместить, перетащив его из панели элементов в раздел сетки или установив его 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 .

  1. Откройте MyToolboxControl.xaml.cs в представлении кода.

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

  3. Перейдите к атрибуту ProvideToolboxControl и измените значение первого параметра на Test. Это имя группы, которая будет содержать элемент управления на панели элементов.

    Полученный код должен выглядеть следующим образом:

    [ProvideToolboxControl("Test", true)]
    public partial class TestControl : UserControl
    {
        public TestControl()
        {
            InitializeComponent();
        }
    }
    

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

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

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

  1. Перестройте проект и запустите отладку.

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

  3. Найдите свой элемент управления в панели элементов и перетащите его в рабочую область конструирования.

  4. Начните отладку приложения WPF.

  5. Убедитесь, что элемент управления отображается.

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

  1. После сборки тестового проекта можно найти VSIX-файл в папке *\bin\debug* проекта.

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

  3. Отправьте VSIX-файл в сеть или на веб-сайт.

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