Программное добавление элементов управления в Windows Forms во время выполнения с помощью Visual C#

Эта статья поможет программным способом добавлять и настраивать элементы управления в форме Windows Forms с помощью Visual C#.

Исходная версия продукта: Visual C #
Исходный номер статьи базы знаний: 319266

Сводка

В этой статье приведены пошаговые инструкции по добавлению и настройке нескольких часто используемых элементов управления в форме Windows Forms. В примере кода отсутствует обработка событий.

Пакет средств разработки программного обеспечения (SDK) Microsoft .NET Framework предоставляет множество визуальных элементов управления, которые можно использовать для создания приложения Windows Forms. Вы можете добавлять и настраивать элементы управления во время конструирования в Visual Studio .NET или в Visual Studio. Вы можете добавлять и настраивать элементы управления программным способом во время выполнения.

Требования

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

• Синтаксис Visual C#
• Среда Visual Studio .NET, среда Visual Studio
• Назначение распространенных элементов управления Visual C#

Создание приложения Windows Forms

Запустите Visual Studio .NET или Visual Studio и создайте новый проект приложения Visual C# для Windows с именем винконтролс. По умолчанию форма Form1 добавляется в проект.

Дважды щелкните Form1, чтобы создать и просмотреть Form1_Load процедуру обработки события.

Добавьте в класс переменные частных экземпляров Form1 для работы с общими элементами управления Windows. Form1 Класс запускается следующим образом:

Код должен быть изменен в Visual Studio. Когда вы создаете проект Windows Forms, Visual C# добавляет по умолчанию одну форму в проект. Эта форма называется Form1. Два файла, представляющие форму, называются Form1.CS и Form1.Designer.CS. Вы пишете свой код в Form1.CS. Файл Designer.CS — это место, в котором конструктор Windows Forms записывает код, который реализует все действия, выполненные путем добавления элементов управления. Дополнительные сведения о конструкторе Windows Forms в Visual C# приведены в статье Создание проекта (Visual c#).

Настройка свойств формы и элемента управления

Нахождение Form1_Load процедуры обработки события и добавление в процедуру следующего кода для настройки внешнего вида элемента управления формы:

Добавьте следующий код в Form1_Load процедуру обработки события для настройки внешнего вида элемента управления «Кнопка»:

Добавьте следующий код для настройки внешнего вида элемента управления TextBox в Form1_Load :

Добавьте следующий код для настройки внешнего вида элемента управления ListBox в Form1_Load :

Добавьте следующий код, чтобы настроить внешний вид элемента управления CheckBox в Form1_Load :

Добавьте следующий код, чтобы настроить внешний вид элемента управления Label в Form1_Load :

Добавление элементов управления в форму

Добавьте следующий код, чтобы добавить каждый объект в Controls массив формы в конце Form1_Load :

Проверка работы

Чтобы убедиться, что пример работает, выберите команду начать в меню Отладка .

• Хотя отображаются форма и элементы управления, в настоящее время они не выполняют никаких действий, так как вы не записали обработчики событий.
• Помните, что позиции этих элементов управления являются статическими. Чтобы сделать их более надежными при растяжении формы, сделайте точки динамическими относительно положения формы. Если элементы управления статичны, растягивание формы может помешать отображению других элементов управления в форме.

Ссылки

Дополнительные сведения об использовании элементов управления программным способом можно найти в разделе приложения Windows в разделе Visual C# справочной документации по Visual Studio .NET Online или в справочной документации по Visual Studio Online.

Диалоговые окна в Windows Forms Dialog Boxes in Windows Forms

Диалоговые окна используются для взаимодействия с пользователем и получения информации. Dialog boxes are used to interact with the user and retrieve information. Проще говоря, диалоговое окно представляет собой форму со значением ее свойства перечисления FormBorderStyle, установленным в FixedDialog . In simple terms, a dialog box is a form with its FormBorderStyle enumeration property set to FixedDialog . Пользовательские диалоговые окна можно создавать с помощью конструктор Windows Forms в Visual Studio. You can construct your own custom dialog boxes by using the Windows Forms Designer in Visual Studio. Для настройки диалоговых окон под конкретные потребности можно добавить элементы управления, такие как Label , Textbox и Button . Add controls such as Label , Textbox , and Button to customize dialog boxes to your specific needs. .NET Framework также содержит предопределенные диалоговые окна, такие как Открытие файлов и окна сообщений, которые можно адаптировать для собственных приложений. The .NET Framework also includes predefined dialog boxes, such as File Open and message boxes, which you can adapt for your own applications. Дополнительные сведения см. в разделе элементы управления и компоненты диалоговых окон. For more information, see Dialog-Box Controls and Components.

в этом разделе In This Section

Связанные разделы Related Sections

Элементы управления и компоненты диалоговых окон Dialog-Box Controls and Components
Список стандартных элементов управления диалоговых окон. Lists the predefined dialog box controls.

Изменение внешнего вида Windows Forms Changing the Appearance of Windows Forms
Содержит ссылки на разделы, описывающие, как изменить внешний вид приложений Windows Forms. Contains links to topics that describe how to change the appearance of Windows Forms applications.

Общие сведения об элементе управления TabControl TabControl Control Overview
Объясняется, как включить элемент управления «Вкладка» в диалоговое окно. Explains how you incorporate the tab control into a dialog box.

Элементы управления и компоненты диалоговых окон (Windows Forms) Dialog-Box Controls and Components (Windows Forms)

Перечисленные ниже элементы управления и компоненты Windows Forms представляют стандартные диалоговые окна. The following Windows Forms controls and components present standard dialog boxes. Чтобы получить дополнительную информацию о функциях, доступных в каждом диалоговом окне, щелкните соответствующую ссылку. Follow the links for more information about the functions available in each dialog box.

Справочник Reference

ColorDialog
Справочная информация о классе ColorDialog и его членах. Provides reference information about the ColorDialog class and its members.

FontDialog
Справочная информация о классе FontDialog и его членах. Provides reference information about the FontDialog class and its members.

OpenFileDialog
Справочная информация о классе OpenFileDialog и его членах. Provides reference information about the OpenFileDialog class and its members.

PageSetupDialog
Справочная информация о классе PageSetupDialog и его членах. Provides reference information about the PageSetupDialog class and its members.

PrintDialog
Справочная информация о классе PrintDialog и его членах. Provides reference information about the PrintDialog class and its members.

PrintPreviewDialog
Справочная информация о классе PrintPreviewDialog и его членах. Provides reference information about the PrintPreviewDialog class and its members.

SaveFileDialog
Справочная информация о классе SaveFileDialog и его членах. Provides reference information about the SaveFileDialog class and its members.

Связанные разделы Related Sections

Диалоговые окна в Windows Forms Dialog Boxes in Windows Forms
Инструкции по созданию диалогового окна для формы Windows Forms. Describes how to create a dialog box for a Windows Form.

Общие сведения о компоненте ColorDialog ColorDialog Component Overview
Предоставляет стандартное диалоговое окно для выбора цветов из палитры и добавления в нее дополнительных цветов. Enables the user to select a color from a palette in a pre-configured dialog box and to add custom colors to that palette.

Общие сведения о компоненте FontDialog FontDialog Component Overview
Предоставляет приложениям шрифты, установленные в системе на текущий момент. Exposes the fonts that are currently installed on the system.

Общие сведения о компоненте OpenFileDialog OpenFileDialog Component Overview
Позволяет пользователям открывать файлы в стандартном диалоговом окне. Allows users to open files via a pre-configured dialog box.

Общие сведения о компоненте PageSetupDialog PageSetupDialog Component Overview
Предоставляет стандартное диалоговое окно для задания параметров страницы для печати. Sets page details for printing via a pre-configured dialog box.

Общие сведения о компоненте PrintDialog PrintDialog Component Overview
Служит для выбора принтера, печатаемых страниц и других параметров печати. Selects a printer, chooses the pages to print, and determines other print-related settings.

Общие сведения об элементе управления PrintPreviewDialog PrintPreviewDialog Control Overview
Выводит документ в том виде, как он будет выглядеть при печати. Displays a document as it will appear when it is printed.

Общие сведения о компоненте SaveFileDialog SaveFileDialog Component Overview
Служит для выбора сохраняемых файлов и места их сохранения. Selects files to save and where to save them.

Практическое руководство. Отображение диалоговых окон для Windows Forms How to: Display Dialog Boxes for Windows Forms

Диалоговое окно отображается таким же образом, как и любая другая форма в приложении. You display a dialog box in the same way you display any other form in an application. Начальная форма загружается автоматически при запуске приложения. The startup form loads automatically when the application is run. Чтобы в приложении отображалась Вторая форма или диалоговое окно, напишите код для загрузки и отображения. To make a second form or dialog box appear in the application, write code to load and display it. Аналогично, чтобы сделать форму или диалоговое окно видимым, напишите код для выгрузки или скрытия. Similarly, to make the form or dialog box disappear, write code to unload or hide it.

Отображение диалогового окна To display a dialog box

Перейдите к обработчику событий, с помощью которого необходимо открыть диалоговое окно. Navigate to the event handler with which you want to open the dialog box. Это может произойти при выборе команды меню, при нажатии кнопки или при возникновении любого другого события. This can happen when a menu command is selected, when a button is clicked, or when any other event occurs.

В обработчике событий добавьте код, чтобы открыть диалоговое окно. In the event handler, add code to open the dialog box. В этом примере для отображения диалогового окна используется событие нажатия кнопки. In this example, a button-click event is used to show the dialog box:

Практическое руководство. Добавление элементов управления в формы Windows Forms. How to: Add Controls to Windows Forms

Большинство форм разрабатываются путем добавления элементов управления на поверхность формы для определения пользовательского интерфейса. Most forms are designed by adding controls to the surface of the form to define a user interface (UI). Элемент управления — это компонент в форме, используемый для вывода информации или ввода данных пользователем. A control is a component on a form used to display information or accept user input. Дополнительные сведения об элементах управления см. в разделе элементы управления Windows Forms. For more information about controls, see Windows Forms Controls.

Рисование элемента управления в форме To draw a control on a form

Откройте форму. Open the form. Дополнительные сведения см. в разделе инструкции. отображение Windows Forms в конструкторе. For more information, see How to: Display Windows Forms in the Designer.

В области элементов щелкните элемент управления, который необходимо добавить в форму. In the Toolbox, click the control you want to add to your form.

В форме щелкните место, где должен располагаться левый верхний угол элемента управления, и перетащите его в то место, где должен располагаться правый нижний угол элемента управления. On the form, click where you want the upper-left corner of the control to be located, and drag to where you want the lower-right corner of the control to be located.

Элемент управления добавляется в форму с указанными расположением и размером. The control is added to the form with the specified location and size.

Для каждого элемента управления определен размер по умолчанию. Each control has a default size defined. Можно добавить элемент управления в форму в размер элемента управления по умолчанию, перетащив его из области элементов в форму. You can add a control to your form in the control’s default size by dragging it from the Toolbox to the form.

Перетаскивание элемента управления в форму To drag a control to a form

Откройте форму. Open the form. Дополнительные сведения см. в разделе инструкции. отображение Windows Forms в конструкторе. For more information, see How to: Display Windows Forms in the Designer.

На панели элементов щелкните нужный элемент управления и перетащите его в форму. In the Toolbox, click the control you want and drag it to your form.

Элемент управления добавляется в форму в указанном расположении в его размер по умолчанию. The control is added to the form at the specified location in its default size.

Можно дважды щелкнуть элемент управления на панели элементов , чтобы добавить его в левый верхний угол формы в его размер по умолчанию. You can double-click a control in the Toolbox to add it to the upper-left corner of the form in its default size.

Кроме того, можно динамически добавлять элементы управления в форму во время выполнения. You can also add controls dynamically to a form at run time. В следующем примере кода TextBox элемент управления будет добавлен в форму при Button щелчке элемента управления. In the following code example, a TextBox control will be added to the form when a Button control is clicked.

Следующая процедура требует наличия формы с элементом управления Button , Button1 уже размещенным в ней. The following procedure requires the existence of a form with a Button control, Button1 , already placed on it.

Добавление элемента управления в форму программным способом To add a control to a form programmatically

В методе, обрабатывающем событие кнопки Click в классе формы, вставьте код, аналогичный приведенному ниже, чтобы добавить ссылку на переменную элемента управления, задать элемент управления Location и добавить элемент управления. In the method that handles the button’s Click event within your form’s class, insert code similar to the following to add a reference to your control variable, set the control’s Location , and add the control.

Можно также добавить код для инициализации других свойств элемента управления. You can also add code to initialize other properties of the control.

Вы можете предоставить локальному компьютеру угрозу безопасности через сеть, обратившись к вредоносной программе UserControl . You might expose your local computer to a security risk through the network by referencing a malicious UserControl . Это будет проблемой только в случае, если злоумышленник создает вредоносный пользовательский элемент управления, а затем добавляет его в проект по ошибке. This would only be a concern in the case of a malicious person creating a damaging custom control, followed by you mistakenly adding it to your project.