Ввод данных пользователем в Windows Forms User Input in Windows Forms

В Windows Forms включена модель ввода пользователя, основанная на событиях, которые возникают во время обработки соответствующих сообщений Windows. Windows Forms includes a user input model based on events that are raised while processing related Windows messages. Здесь приведены ссылки на разделы с информацией о вводе с помощью мыши и клавиатуры, включая примеры кода, демонстрирующие выполнение определенных задач. The topics in this section provide information on mouse and keyboard user input, including code examples that demonstrate how to perform specific tasks.

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

Ввод данных пользователем в приложении Windows Forms User Input in a Windows Forms Application
Содержит обзор событий пользовательского ввода и методов, которые обрабатывают сообщения Windows. Provides an overview of user input events and the methods that process Windows messages.

Ввод с клавиатуры в приложении Windows Forms Keyboard Input in a Windows Forms Application
Содержит сведения об обработке сообщений клавиатуры, различных типах клавиш и событиях клавиатуры. Provides information on keyboard message handling, the different types of keys, and the keyboard events.

Ввод данных мышью в приложении Windows Forms Mouse Input in a Windows Forms Application
Содержит сведения о событиях мыши и других связанных с мышью возможностях, включая курсоры и отслеживание перемещения мыши. Provides information on the mouse events and other mouse-related features, including mouse cursors and mouse capture.

Практическое руководство. Имитация событий мыши и клавиатуры в коде How to: Simulate Mouse and Keyboard Events in Code
Показано несколько различных способов программной имитации ввода с помощью мыши и клавиатуры. Demonstrates several different ways to programmatically simulate mouse and keyboard input.

Практическое руководство. Обработка событий пользовательского ввода в элементах управления Windows Forms How to: Handle User Input Events in Windows Forms Controls
Пример кода, который обрабатывает большую часть событий пользовательского ввода и сообщает сведения о каждом событии. Presents a code example that handles most user input events and reports information about each event.

Проверка введенных пользователем данных в Windows Forms User Input Validation in Windows Forms
Описываются методы проверки пользовательского ввода в приложениях Windows Forms. Describes the methods to validate user input in Windows Forms applications.

Диалоговые окна в 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 User Input in a Windows Forms Application

В Windows Forms вводимые пользователем данные отправляются в приложения в виде сообщений Windows. In Windows Forms, user input is sent to applications in the form of Windows messages. Ряд переопределяемых методов обрабатывают эти сообщения на уровне приложения, формы и элемента управления. A series of overridable methods process these messages at the application, form, and control level. Когда эти методы получают сообщения мыши и клавиатуры, они вызывают события, которые могут быть обработаны для получения сведений о нажатии мыши или вводе с клавиатуры. When these methods receive mouse and keyboard messages, they raise events that can be handled to get information about the mouse or keyboard input. Во многих случаях Windows Forms приложения смогут обрабатывать все вводимые пользователем данные, просто обрабатывая эти события. In many cases, Windows Forms applications will be able to process all user input simply by handling these events. В других случаях приложению может потребоваться переопределить один из методов, обрабатывающих сообщения, чтобы перехватить конкретное сообщение, прежде чем оно будет получено приложением, формой или элементом управления. In other cases, an application may need to override one of the methods that process messages in order to intercept a particular message before it is received by the application, form, or control.

События мыши и клавиатуры Mouse and Keyboard Events

Все элементы управления Windows Forms наследуют набор событий, связанных с вводом с помощью мыши и клавиатуры. All Windows Forms controls inherit a set of events related to mouse and keyboard input. Например, элемент управления может управлять KeyPress событием, чтобы определить код символа нажатой клавиши, или элемент управления может управлять MouseClick событием для определения местоположения щелчка мышью. For example, a control can handle the KeyPress event to determine the character code of a key that was pressed, or a control can handle the MouseClick event to determine the location of a mouse click. Дополнительные сведения о событиях мыши и клавиатуры см. в разделе Использование событий клавиатуры и событий мыши в Windows Forms. For more information on the mouse and keyboard events, see Using Keyboard Events and Mouse Events in Windows Forms.

Методы, обрабатывающие входные сообщения пользователя Methods that Process User Input Messages

Формы и элементы управления имеют доступ к IMessageFilter интерфейсу и набор переопределяемых методов, которые обрабатывают сообщения Windows в разных точках очереди сообщений. Forms and controls have access to the IMessageFilter interface and a set of overridable methods that process Windows messages at different points in the message queue. Все эти методы имеют Message параметр, который инкапсулирует низкоуровневые сведения о сообщениях Windows. These methods all have a Message parameter, which encapsulates the low-level details of Windows messages. Можно реализовать или переопределить эти методы, чтобы проверить сообщение, а затем либо использовать сообщение, либо передать его следующему потребителю в очереди сообщений. You can implement or override these methods to examine the message and then either consume the message or pass it on to the next consumer in the message queue. В следующей таблице представлены методы, обрабатывают все сообщения Windows в Windows Forms. The following table presents the methods that process all Windows messages in Windows Forms.

Метод Method	Примечания Notes
PreFilterMessage	Этот метод перехватывает сообщения в очереди (также известные как отправленные) на уровне приложения. This method intercepts queued (also known as posted) Windows messages at the application level.
PreProcessMessage	Этот метод перехватывает сообщения Windows на уровне формы и элемента управления до их обработки. This method intercepts Windows messages at the form and control level before they have been processed.
WndProc	Этот метод обрабатывает сообщения Windows на уровне формы и элемента управления. This method processes Windows messages at the form and control level.
DefWndProc	Этот метод выполняет обработку сообщений Windows по умолчанию на уровне формы и элемента управления. This method performs the default processing of Windows messages at the form and control level. Это обеспечивает минимальную функциональность окна. This provides the minimal functionality of a window.
OnNotifyMessage	Этот метод перехватывает сообщения на уровне формы и элемента управления после их обработки. This method intercepts messages at the form and control level, after they have been processed. EnableNotifyMessageДля вызова этого метода необходимо задать бит стиля. The EnableNotifyMessage style bit must be set for this method to be called.

Сообщения клавиатуры и мыши также обрабатываются дополнительным набором переопределяемых методов, характерных для этих типов сообщений. Keyboard and mouse messages are also processed by an additional set of overridable methods that are specific to those types of messages. Дополнительные сведения см. в разделе как работают ввод с клавиатуры и как работает ввод с помощью мыши в Windows Forms. For more information, see How Keyboard Input Works and How Mouse Input Works in Windows Forms.

Элемент управления TextBox (Windows Forms) TextBox Control (Windows Forms)

Windows Forms текстовые поля используются для получения входных данных от пользователя или для вывода текста. Windows Forms text boxes are used to get input from the user or to display text. TextBox Элемент управления обычно используется для редактируемого текста, хотя его также можно сделать доступным только для чтения. The TextBox control is generally used for editable text, although it can also be made read-only. Текстовые поля могут отображать несколько строк, переносить текст в размер элемента управления и добавлять базовое форматирование. Text boxes can display multiple lines, wrap text to the size of the control, and add basic formatting. TextBox Элемент управления допускает один формат текста, отображаемого или вводимых в элементе управления. The TextBox control allows a single format for text displayed or entered in the control.

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

Общие сведения об элементе управления TextBox TextBox Control Overview
Описание элемента управления, его основных возможностей и свойств. Explains what this control is and its key features and properties.

Практическое руководство. Управление положением курсора в элементе управления TextBox в Windows Forms How to: Control the Insertion Point in a Windows Forms TextBox Control
Инструкции по указанию места, где точка вставки появляется при первом получении фокуса элементом управления «поле ввода». Gives directions for specifying where the insertion point appears when an edit control first gets the focus.

Практическое руководство. Создание текстового поля только для чтения How to: Create a Read-Only Text Box
Описывает, как предотвратить изменение содержимого текстового поля. Describes how to prevent the contents of a text box from being changed.

Практическое руководство. Добавление кавычек в строку How to: Put Quotation Marks in a String
Описание добавления кавычек к строке в текстовом поле. Explains adding quotation marks to a string in a text box.

Справочник Reference

Класс TextBox TextBox class
Описание класса и всех его членов. Describes this class and has links to all its members.

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

Элементы управления для использования в формах Windows Forms Controls to Use on Windows Forms
Полный список элементов управления Windows Forms со ссылками на информацию об их применении. Provides a complete list of Windows Forms controls, with links to information on their use.

Практическое руководство. Обработка ввода с клавиатуры на уровне формы How to: Handle Keyboard Input at the Form Level

Windows Forms предоставляет возможность обработки сообщений клавиатуры на уровне формы, прежде чем они достигнут элемента управления. Windows Forms provides the ability to handle keyboard messages at the form level, before the messages reach a control. В этом разделе показано, как выполнить данную задачу. This topic shows how to accomplish this task.

Обработка ввода с клавиатуры на уровне формы To handle a keyboard message at the form level

Чтобы сообщения клавиатуры принимались формой, прежде чем они достигнут элементов управления в форме, нужно обработать события KeyPress или KeyDown начальной формы и присвоить свойству формы KeyPreview значение true . Handle the KeyPress or KeyDown event of the startup form, and set the KeyPreview property of the form to true so that keyboard messages are received by the form before they reach any controls on the form. В следующем примере кода обрабатывается событие KeyPress посредством обнаружения всех цифровых клавиш и использования «1», «4» и «7». The following code example handles the KeyPress event by detecting all of the number keys and consuming ‘1’, ‘4’, and ‘7’.

Пример Example

В следующем примере кода представлено завершенное приложение для предыдущего примера кода. The following code example is the entire application for the above example. Приложение включает TextBox и несколько других элементов управления, предназначенных для перемещения фокуса ввода из TextBox. The application includes a TextBox along with several other controls that allow you to move focus from the TextBox. Событие KeyPress основной формы Form использует «1», «4» и «7», а событие KeyPress в TextBox использует «2», «5» и «8», остальные клавиши отображаются. The KeyPress event of the main Form consumes ‘1’, ‘4’, and ‘7’, and the KeyPress event of the TextBox consumes ‘2’, ‘5’, and ‘8’ while displaying the remaining keys. Сравните выходные данные MessageBox при нажатии цифровой клавиши, когда фокус ввода установлен на TextBox с выходными данными MessageBox при нажатии цифровой клавиши, когда фокус ввода установлен на одном из других элементов управления. Compare the MessageBox output when you press a number key while the TextBox has focus with the MessageBox output when you press a number key while focus is on one of the other controls.

Компиляция кода Compiling the Code

Для этого примера требуются: This example requires: