Пошаговое руководство: Автоматическое заполнение панели инструментов пользовательскими компонентами

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

• Реализует IComponent;

• Не установлено значение ToolboxItemAttribute на false.

• Не задано DesignTimeVisibleAttribute значение false.

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

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

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

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

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

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

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

1. В Visual Studio создайте проект приложения на основе Windows под названием ToolboxExample (Файл >Создать >Проект >Visual C# или Visual Basic >Классическое >Приложение Windows Forms).

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

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

3. Создайте проект.

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

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

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

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

2. На панели элементов щелкните новую вкладку с именем "Компоненты Панели элементовExample".

   Щелкнув вкладку, вы увидите DemoComponent.

   Замечание

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

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

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

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

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

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

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

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

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

3. Перезагрузите ToolboxExample проект.

   Теперь снова появится вкладка "Компоненты Панели элементовExample ".

Дальнейшие шаги

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

См. также

• Общие, конструктор Windows Forms, диалоговое окно "Параметры"
• Как управлять вкладками панели инструментов
• Диалоговое окно "Выбор элементов панели элементов" (Visual Studio)
• размещение элементов управления в Windows Forms