Элементы управления и компоненты диалоговых окон (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.

Устранение неполадок с созданием элементов управления и компонентов Troubleshoot Control and Component Authoring

В этом разделе перечислены следующие распространенные проблемы, возникающие при разработке компонентов и элементов управления. This topic lists the following common problems that arise when developing components and controls:

Не удается добавить элемент управления на панель элементов Cannot Add Control to Toolbox

Не удается выполнить отладку пользовательского элемента управления или компонента Windows Forms Cannot Debug the Windows Forms User Control or Component

Событие в производном элементе управления или компоненте вызывается дважды Event Is Raised Twice in Inherited Control or Component

Ошибка времени разработки: «Не удалось создать компонент имя компонента» Design-Time Error: «Failed to Create Component ‘Component Name‘»

Значок компонента не отображается на панели элементов Component Icon Does Not Appear in Toolbox

Не удается добавить элемент управления на панель элементов Cannot Add Control to Toolbox

Если вы хотите добавить на панель элементов настраиваемый элемент управления, созданный в другом проекте, или сторонний элемент управления, это необходимо сделать вручную. If you want to add a custom control that you created in another project or a third-party control to the Toolbox, you must do so manually. Если ваш элемент управления или компонент уже находится в текущем проекте, он отобразится на панели элементов автоматически. If the current project contains your control or component, it should appear in the Toolbox automatically. Дополнительные сведения см. в разделе Пошаговое руководство. Автоматическое заполнение панели элементов пользовательскими компонентами. For more information, see Walkthrough: Automatically Populating the Toolbox with Custom Components.

Добавление элемента управления на панель элементов To add a control to the Toolbox

Щелкните панель инструментов правой кнопкой мыши и выберите команду Выбрать элементы. Right-click the Toolbox and from the shortcut menu, select Choose Items.

Добавьте компонент в диалоговом окне Выбор элементов панели элементов. In the Choose Toolbox Items dialog box, add the component:

Чтобы добавить компонент или элемент управления .NET Framework, откройте вкладку Компоненты .NET Framework. If you want to add a .NET Framework component or control, click the .NET Framework Components tab.

Чтобы добавить COM-компонент или элемент управления ActiveX, откройте вкладку COM-компоненты. If you want to add a COM component or ActiveX control, click the COM Components tab.

Если элемент управления указан в диалоговом окне, выделите его и нажмите кнопку ОК. If your control is listed in the dialog box, confirm it is selected, and then click OK.

Элемент управления будет добавлен на панель элементов. The control is added to the Toolbox.

Если элемент управления не указан в диалоговом окне, выполните следующие действия. If your control is not listed in the dialog box, do the following:

Нажмите кнопку Обзор . Click the Browse button.

Найдите папку с DLL-файлом, содержащим ваш элемент управления. Browse to the folder that contains the .dll file that contains your control.

Выберите этот DLL-файл и нажмите кнопку Открыть. Select the .dll file and click Open.

Элемент управления отобразится в диалоговом окне. Your control appears in the dialog box.

Выберите элемент управления и нажмите кнопку ОК. Confirm that your control is selected, and then click OK.

Элемент управления будет добавлен на панель элементов. Your control is added to the Toolbox.

Не удается выполнить отладку пользовательского элемента управления или компонента Windows Forms Cannot Debug the Windows Forms User Control or Component

Если элемент управления является производным от UserControl класса, можно отладить его поведение во время выполнения с тестовым контейнером. If your control derives from the UserControl class, you can debug its run-time behavior with the test container. Дополнительные сведения см. в разделе как проверить поведение Run-Time UserControl. For more information, see How to: Test the Run-Time Behavior of a UserControl.

Другие настраиваемые элементы управления и компоненты не являются автономными проектами Other custom controls and components are not stand-alone projects. и должны размещаться в приложении, таком как проект Windows Forms. They must be hosted by an application such as a Windows Forms project. Для выполнения отладки элемент управления или компонент необходимо добавить в проект Windows Forms. To debug a control or component, you must add it to a Windows Forms project.

Отладка элемента управления или компонента To debug a control or component

В меню Сборка выберите пункт Сборка решения, чтобы создать решение. From the Build menu, click Build Solution to build your solution.

В меню Файл выберите пункт Добавить, и затем Новый проект, чтобы добавить в приложение тестовый проект. From the File menu, choose Add, and then New Project to add a test project to your application.

В диалоговом окне Добавление нового проекта выберите в качестве типа проекта Приложение Windows. In the Add New Project dialog box choose Windows Application for the type of project.

В обозревателе решений щелкните узел Ссылки для своего нового проекта правой кнопкой мыши. In Solution Explorer, right-click the References node for the new project. В контекстном меню выберите пункт Добавить ссылку, чтобы добавить ссылку на проект, содержащий элемент управления или компонент. On the shortcut menu, click Add Reference to add a reference to the project containing the control or component.

Создайте экземпляр элемента управления или компонента в тестовом проекте. Create an instance of your control or component in the test project. Если компонент находится на панели элементов, его можно перетащить в область конструктора или создать экземпляр программными средствами, как показано в следующем примере кода. If your component is in the Toolbox, you can drag it to your designer surface, or you can create the instance programmatically, as shown in the following code example.

После этого отладку элемента управления или компонента можно выполнить в обычном режиме. You can now debug your control or component as usual.

Событие в производном элементе управления или компоненте вызывается дважды Event Is Raised Twice in Inherited Control or Component

Это может быть связано с дублированием предложения Handles . This is likely due to a duplicated Handles clause. Дополнительные сведения см. в разделе Устранение неполадок, связанных с унаследованными обработчиками событий в Visual Basic. For more information, see Troubleshooting Inherited Event Handlers in Visual Basic.

Ошибка времени разработки: «Не удалось создать компонент ‘имя компонента'» Design-Time Error: «Failed to Create Component ‘Component Name'»

Компонент или элемент управления должен предоставлять конструктор без параметров без аргументов. Your component or control must provide a parameterless constructor with no parameters. Если в среде разработки создается экземпляр компонента или элемента управления, он не пытается предоставить какие-либо параметры для перегрузок конструктора, принимающих параметры. When the design environment creates an instance of your component or control, it does not attempt to provide any parameters to constructor overloads that take parameters.

STAThreadAttribute STAThreadAttribute

Компонент STAThreadAttribute сообщает среде CLR, что Windows Forms использует модель однопотокового подразделения. The STAThreadAttribute informs the common language runtime (CLR) that Windows Forms uses the single-threaded apartment model. Если не применить этот атрибут к методу Main приложения Windows Forms, может возникнуть непредусмотренное поведение. You may notice unintended behavior if you do not apply this attribute to your Windows Forms application’s Main method. Например, фоновые изображения могут не отображаться для таких элементов управления, как ListView . For example, background images may not appear for controls like ListView. Некоторым элементам управления этот атрибут может требоваться также для правильного выполнения операций автозаполнения и перетаскивания. Some controls may also require this attribute for correct AutoComplete and drag-and-drop behavior.

Значок компонента не отображается на панели элементов Component Icon Does Not Appear in Toolbox

При использовании ToolboxBitmapAttribute для связывания значка с пользовательским компонентом точечный рисунок не отображается на панели элементов для автоматически сформированных компонентов. When you use ToolboxBitmapAttribute to associate an icon with your custom component, the bitmap does not appear in the Toolbox for autogenerated components. Чтобы увидеть растровое изображение, перезагрузите элемент управления с помощью диалогового окна Выбор элементов панели элементов. To see the bitmap, reload the control by using the Choose Toolbox Items dialog box. Дополнительные сведения см. в разделе Практическое руководство. Предоставление точечного рисунка панели элементов для элемента управления. For more information, see How to: Provide a Toolbox Bitmap for a Control.

Диалоговые окна Windows XP

Диалоговые окна, о которых уже упоминалось в статье Основные элементы окна Windows XP, пользователь видит в процессе работы с приложениями (программами) и самой операционной системой. Они появляются в момент обращения системы или программы к пользователю с запросом какой-либо необходимой информации для продолжения работы или подтверждения каких-то действий.

Диалоговые окна всегда находятся на переднем плане, закрывая остальные открытые (работающие) окна. Как правило, они не изменяются в размерах, а закрывать их можно только: после подтверждения выбора (ОК, Применить, Отмена) или кликом на закрывающей кнопке.

Диалоговые окна Windows могут быть модальными или немодальными.

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

Модальные диалоговые окна могут быть вида:

Окно диалога. Необходимо для ввода (выбора) данных или параметров, требующихся для продолжения работы с программой.
Окно сообщения. Оповещает пользователя, что совершено какое-то действие или завершена операция.
Окно запроса. Дает пользователю возможность выбрать действие, итогом которого станет продолжение работы с программой или ее завершение.

Немодальные окна работу приложения (программы) не останавливают. Не закрывая окна, щелчком мыши, можно перейти в окно документа или программы и работать с ними, возвращаясь также щелчком мыши в диалоговое окно. Пример — окно Справка.

Диалоговые окна могут быть самого разного назначения и иметь различные поля и кнопки для ответа на запрос. Сложные диалоговые окна многостраничны, состоят из нескольких вкладок (закладок).

Диалоговое окно Windows обычно состоит из строки заголовка и элементов окна.

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

Основные элементы диалогового окна

От назначения окна зависит его содержимое, но в целом, набор элементов повторяется во всех приложениях операционной системы Windows. Это:

Рассмотрим основные разновидности элементов:

	закрытие окна с сохранением всех параметров и внесенных изменений
	закрытие окна без сохранения параметров и внесенных изменений
	сохранение всех параметров и изменений без закрытия окна
	пользователь может с клавиатуры вводить в прямоугольную область текст, для этого нужно щелкнуть внутри поля мышью
	в данное поле значения можно ввести как с клавиатуры, так и нажимая на кнопки справа, стрелка вверх увеличивает значения параметра, стрелка вниз — уменьшает
	в нем содержится список, доступных для выбора объектов, если список больше размера поля, то будут видны полосы прокрутки для просмотра всего списка полностью, выбрать объект можно щелкнув на нужном мышью
	в нем отображается значение текущего параметра, просмотреть все возможные значения можно щелкнув мышью на кнопке — треугольнике справа
	кружок с цветной точкой внутри или без точки (радиокнопка) — выбор только одного из взаимоисключающих, заменяющих друг друга параметров (как в русском языке союз «или») Щелчком ЛКМ мышки отмечается выбор пользователя, с других кнопок отметка снимается
	«галочка» внутри квадратного поля (чекбокса), с ее помощью можно включить/отключить параметры, описание которых расположено рядом, одновременно можно выбрать несколько параметров одновременно (соответствует союзу «и»)
	щелчок по кнопке активирует режим контекстной справки диалогового окна, для этого кликните по выбранному элементу, сразу появится прямоугольная область с текстом — пояснением
	закрытие окна
	перемещение влево/вправо вдоль линейки позволяет плавно настраивать значение параметра в определенном диапазоне (увеличение/уменьшение), к примеру, громкость, чувствительность мыши, скорость автоповтора клавиатуры и т.п.
	в ряде диалоговых окон сходные параметры группируются во вкладках: от двух и более; располагаются вкладки сразу под строкой заголовка окна; одновременно можно работать только с одной вкладкой, активная находится на переднем плане, полностью занимая окно; сменить вкладку можно щелкнув мышью на ее названии
	предварительный просмотр, показывает, как будет выглядеть настраиваемый объект после сделанных изменений и выбранных параметров

Горячие клавиши для диалоговых окон.

Alt+F4 — закрывает текущий элемент или же выход из активной программы

Ctrl+Tab – переключение вкладок в правую сторону (вперед)

Ctrl+Shift+Tab — переключение вкладок в левую сторону (назад)

Tab – последовательное перемещение по кнопкам, полям, спискам, меню, панелям и т. д. (вправо вниз)

Shift + Tab — последовательное перемещение по пунктам, кнопкам, полям, спискам, меню, панелям и др. в обратном порядке (влево вверх)

Space (Пробел) – позволяет выделить (нажать) на выбранную кнопку, поставить флажок

Alt + подчеркнутая буква — нажав и удерживая клавишу Alt, посмотрите на название вкладки окна, списка, поля и т.д., одна из букв подчеркнута, нажмите ее на клавиатуре и вы перейдете к выбранному элементу

Клавиши со стрелками — навигация по пунктам, опциям

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

Если статья может быть полезной вашим знакомым, друзьям или родственникам, можете поделиться с ними, нажав кнопки социальных сетей блога КомпАс.