Пример. Автоматическое заполнение панели элементов пользовательскими компонентами

Обновлен: Ноябрь 2007

Если компоненты определяются проектом в открытом в настоящее время решении, они будут автоматически отображаться в панели элементов, никаких дополнительных действий не требуется. Также можно вручную заполнять панель элементов компонентами с помощью Диалоговое окно "Выбор элементов панели элементов" (Visual Studio), однако панель элементов учитывает элементы в результатах построения со всеми следующими характеристиками.

• Реализует метод IComponent.

• Не устанавливает ToolboxItemAttribute равным false.

• Не устанавливает DesignTimeVisibleAttribute равным false.

Примечание.
Панель элементов не отслеживает цепочки ссылок, поэтому в ней не будут показаны элементы, которые не были собраны проектом в вашем решении.

В этом пошаговом руководстве демонстрируется автоматическое появление пользовательского компонента в панели элементов при создании компонента. В этом пошаговом руководстве, в частности, рассматриваются следующие задачи:

• Создание проекта типа Windows Forms

• Создание пользовательского компонента

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

• Выгрузка и повторная загрузка пользовательского компонента

По завершении вы увидите, что в панели элементов есть только что созданный компонент.

Примечание.
Отображаемые диалоговые окна и команды меню могут отличаться от описанных в справке в зависимости от текущих настроек или выпуска среды. Для изменения настроек выберите Параметры импорта и экспорта в меню Сервис. Дополнительные сведения см. в разделе Параметры Visual Studio.

Создание проекта

Для начала следует создать проект и подготовить форму.

Чтобы создать проект

1. Создайте проект приложения Windows под названием ToolboxExample.

   Дополнительные сведения см. в разделе Практическое руководство. Создание проекта приложения Windows.

2. Добавьте новый компонент в проект. Назовите его DemoComponent.

   Дополнительные сведения см. в разделе Практическое руководство. Добавление в проект новых элементов.

3. Постройте проект.

4. В меню Сервис щелкните Параметры. Щелкните Общие в разделе Конструктор Windows Forms и убедитесь, что параметр AutoToolboxPopulate имеет значение True.

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

Далее необходимо создать экземпляр пользовательского компонента в форме. Поскольку новый компонент автоматически учитывается в панели элементов, создать новый компонент так же просто, как и любой другой компонент или элемент управления.

Чтобы создать экземпляра пользовательского компонента, выполните следующие действия.

1. Откройте форму проекта в Конструкторе Windows Forms.

2. В панели элементов перейдите на новую вкладку под названием ToolboxExample Components.

   На этой вкладке вы увидите DemoComponent.

   Примечание.
   Для повышения производительности компоненты в автоматически заполняемой области панели элементов отображаются без нестандартных точечных рисунков, ToolboxBitmapAttribute не поддерживается. Для отображения значка для пользовательского компонента в панели элементов используйте окно Выберите элементы панели элементов для загрузки вашего компонента.

3. Перетащите компонент в форму.

   При этом экземпляр компонента создается и добавляется в область компонентов.

Выгрузка и повторная загрузка пользовательского компонента

В панели элементов отображаются компоненты каждого загруженного проекта, а при выгрузке проекта ссылки на компоненты проекта удаляются.

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

1. Выгрузите проект из решения.

   Дополнительные сведения о выгрузке проектов см. в разделе Практическое руководство. Выгрузка и перезагрузка проектов. Нажмите кнопку Да для сохранения изменений.

2. В решение добавьте новый проект Приложение Windows. Откройте форму в конструкторе.

   Вкладка ToolboxExample Components из предыдущего проекта будет отсутствовать.

3. Заново загрузите проект ToolboxExample.

   Вкладка ToolboxExample Components появится снова.

Следующие действия

Это пошаговое руководство описывает отображение компонентов проектов в панели элементов, однако в области элементов также отображаются элементы управления. Попробуйте поработать с вашими собственными элементами управления, добавляя и проекты с ними в решение и удаляя их.

См. также

Задачи

Практическое руководство. Управление вкладками панели элементов

Ссылки

Без ограничений, конструктор Windows Forms, диалоговое окно параметров

Диалоговое окно "Выбор элементов панели элементов" (Visual Studio)

Другие ресурсы

Размещение элементов управления в формах Windows Forms