Пространство имен System. Windows. Forms содержит классы для создания приложений Windows, которые позволяют наиболее эффективно использовать расширенные возможности пользовательского интерфейса, доступные в операционной системе Microsoft Windows.
В следующей таблице приведены сгруппированные по категориям классы, относящиеся к пространству имен System. Windows. Forms.
Категория класса | Подроб. |
| Большинство классов в пространстве имен System. Windows. Forms являются производными от класса Control. Класс Control предоставляет основные функциональные возможности для всех элементов управления, отображаемых в Form. КлассFormпредставляет окно в приложении. Оно включает диалоговые окна, немодальные окна, а также клиентские и родительские окна интерфейса MDI. Можно также создать собственные элементы управления путем наследования от класса UserControl. |
| Windows Forms включает широкий набор классов, которые позволяют создавать пользовательские панели инструментов и меню, отличающиеся современным обликом и поведением. ToolStrip , MenuStrip, ContextMenuStrip и StatusStrip позволяют создавать панели инструментов, строки меню, контекстные меню и строки состояния, соответственно. |
| Пространство имен System. Windows. Forms предоставляет большое количество классов элементов управления, которые позволяют создавать пользовательские интерфейсы с расширенными возможностями. Некоторые элементы управления предназначены для ввода данных в приложении, например элементы TextBox и ComboBox. Другие элементы управления отображают данные приложений, например Label и ListView. Это пространство имен также предоставляет элементы управления для вызова команд в приложении, например Button. Элемент управления WebBrowser и такие классы управляемых HTML-страниц, как HtmlDocument, позволяют отображать HTML-страницы и выполнять с ними определенные действия в области управляемого приложения Windows Forms. Элемент управления MaskedTextBox представляет собой улучшенный элемент управления вводом данных, который позволяет создавать маску для принятия или отклонения введенных пользователем данных в автоматическом режиме. |
| Несколько важных классов в Windows Forms помогают контролировать расположение элементов управления на отображаемой поверхности, например в форме или элементе управления. FlowLayoutPanel располагает все элементы управления которые содержит в последовательном режиме, а TableLayoutPanel позволяет определять ячейки и строчки для расположения элементов управления в фиксированной сетке. SplitContainer разделяет поверхность отображения на две или более корректируемых части. |
| Windows Forms обеспечивает расширенную архитектуру для привязывания к таким источникам данных, как базы данных и XML-файлы. Элемент управленияDataGridView предоставляет настраиваемую таблицу для отображения данных и позволяет настраивать формат ячеек, строк, столбцов и границ. |
| Помимо элементов управления пространство имен System. Windows. Forms предоставляет другие классы, которые не являются производными от класса Control, но также обеспечивают визуальные функции для приложений Windows. Такие классы, как ToolTip и ErrorProvider, расширяют возможности или предоставляют сведения пользователям. Классы Help и HelpProvider позволяют отображать текст справки для пользователя, который работает с приложениями. |
| Windows предоставляет несколько основных диалоговых окон, позволяющих обеспечить единообразие пользовательского интерфейса в приложениях Windows при выполнении таких операций как открытие и сохранение файлов, задание цвета шрифта или текста и печать. КлассыOpenFileDialog и SaveFileDialog предоставляют возможность отображения диалогового окна, в котором пользователь может выполнить поиск файла, а также ввести имя файла, который необходимо открыть или сохранить. Класс FontDialog отображает диалоговое окно для изменения элементов Font, используемого приложением. Классы PageSetupDialog, PrintPreviewDialog и PrintDialog отображают диалоговые окна, позволяющие пользователю управлять параметрами печати документов. Дополнительные сведения о печати с помощью приложений Windows см. в разделе, посвященном пространству имен System. Drawing. Printing. Помимо основных диалоговых окон пространство имен System. Windows. Forms предоставляет класс MessageBox для отображения окна сообщения, в котором могут отображаться и извлекаться данные пользователя. |
В пространстве имен System. Windows. Forms имеется ряд классов, обеспечивающих поддержку вышеупомянутых классов. Примерами вспомогательных классов могут служить перечисления, классы аргументов событий и делегаты, используемые событиями в элементах управления и компонентах.
Form Представляет окно или диалоговое окно, которое составляет пользовательский интерфейс приложения.
public ref class Form : public ContainerControl
public:
virtual property String^ Text {
String^ get () override;
void set (String^ value) override;
}
ActiveControlВозвращает или задает Активный элемент управления в контейнерном элементе управления. (Унаследовано от ContainerControl.)
ActiveFormПолучает текущий момент активную форму для этого приложения. AllowDropВозвращает или задает значение, указывающее, может ли элемент управления принимать данные, перетаскиваемые в него пользователем. (Унаследовано от Control.)AllowTransparencyИнфраструктура. Возвращает или задает значение, показывающее, является ли уровень непрозрачности формы может быть настроено.
AnchorВозвращает или задает границы контейнера, с которым связан элемент управления, и определяет способ изменения размеров элемента управления при изменении размеров его родительского элемента. (Унаследовано от Control.)
public:
virtual property AnchorStyles Anchor {
AnchorStyles get ();
void set (AnchorStyles value);
}
Значение свойства
Тип: System. Windows. Forms::AnchorStyles
Поразрядное сочетание значений AnchorStyles.Значения по умолчанию — Top и Left.
Заметки
Свойство Anchor используется для определения способа автоматического изменения размеров элемента управления при изменении размеров родительского элемента управления. Привязка элемента управления к родительскому элементу управления обеспечивает, что при изменении размеров родительского элемента управления закрепленные границы останутся на прежней позиции относительно границ родительского элемента управления.
Элемент управления можно привязать к одной или нескольким границам контейнера. Например, если имеется объект Form с объектом Button, для свойства Anchor которого заданы значения Top и Bottom, то объект Button растягивается, чтобы сохранить закрепленное расстояние до верхней и нижней границ объекта Form при увеличении значения свойства Height объекта Form.
|
Свойства Anchor и Dock являются взаимоисключающими. Одновременно может быть задано только одно из них, которое и получает преимущество. |
Примечания для наследующих объектов
При переопределении свойства Anchor в производном классе используйте свойство базового класса Anchor для расширения базовой реализации. В противном случае необходимо предоставить полную реализацию. Не требуется переопределять оба метода доступа — get и set — свойства Anchor; при необходимости можно переопределить только один из них.
Примеры
В следующем примере кода объект Button добавляется к форме и задаются его некоторые общие свойства. В этом примере кнопка закреплена в правом нижнем углу формы, что позволяет сохранять ее относительное положение при изменении размеров формы. Далее задается свойство BackgroundImage и выполняется изменение размеров кнопки до того же размера, какой имеет объект Image.После этого в примере для свойства TabStop задается значение true, а также задается свойство TabIndex.Наконец, добавляется обработчик событий для обработки события Click кнопки. В этом примере требуется наличие объекта ImageList с именем imageList1.
C#
C++
VB
// Add a button to a form and set some of its common properties.
private:
void AddMyButton()
{
// Create a button and add it to the form.
Button^ button1 = gcnew Button;
// Anchor the button to the bottom right corner of the form
button1->Anchor = static_cast<AnchorStyles>(AnchorStyles::Bottom | AnchorStyles::Right);
// Assign a background image.
button1->BackgroundImage = imageList1->Images[ 0 ];
// Specify the layout style of the background image. Tile is the default.
button1->BackgroundImageLayout = ImageLayout::Center;
// Make the button the same size as the image.
button1->Size = button1->BackgroundImage->Size;
// Set the button's TabIndex and TabStop properties.
button1->TabIndex = 1;
button1->TabStop = true;
// Add a delegate to handle the Click event.
button1->Click += gcnew System::EventHandler( this, &Form1::button1_Click );
// Add the button to the form.
this->Controls->Add( button1 );
}
AutoScale... - задают масштабирование
AutoScroll... - расположение и размеры прокрутки
AutoScrollPositionВозвращает или задает расположение позиции автоматической прокрутки. (Унаследовано от ScrollableControl.)
AutoSize Измените размер формы в соответствии с параметром
AutoSizeMode. (Переопределяет Control::AutoSize.)AutoSizeModeВозвращает или задает режим, в котором автоматически изменяет размер формы.
BackColor Получает или задает цвет фона для элемента управления. (Переопределяет Control::BackColor.)
BackgroundImage Возвращает или задает фоновое изображение, выводимое на элементе управления. (Унаследовано от Control.)
Bottom Получает расстояние (в пикселях) между нижней границей элемента управления и верхней границей клиентской области контейнера. (Унаследовано от Control.)
Bounds Возвращает или задает размер и местоположение (в пикселях) элемента управления, включая его неклиентские элементы, относительно его родительского элемента управления. (Унаследовано от Control.)
CancelButton Возвращает или задает элемент управления " Кнопка ", щелчок ключа, когда пользователь нажимает клавишу ESC.
CanFocus Получает значение, показывающее, может ли элемент управления получать фокус. (Унаследовано от Control.)
CanSelect Получает значение, показывающее, доступен ли элемент управления для выбора. (Унаследовано от Control.)
ClientRectangleПолучает прямоугольник, представляющий клиентскую область элемента управления. (Унаследовано от Control.)
ClientSize Возвращает или задает размер клиентской области формы.
ContainsFocus Получает значение, указывающее, имеет ли элемент управления или один из его дочерних элементов фокус ввода в данный момент. (Унаследовано от Control.)
ContextMenu Возвращает или задает контекстное меню, сопоставленное с элементом управления. (Унаследовано от Control.)
ContextMenuStrip Возвращает или задает объект ContextMenuStrip, сопоставленный с этим элементом управления. (Унаследовано от Control.)
ControlBoxВозвращает или задает значение, показывающее, отображается ли распределительный ящик в заголовке формы.
Cursor Возвращает или задает курсор, отображаемый, когда указатель мыши находится на элементе управления. (Унаследовано от Control.)
DefaultCursor Получает или задает курсор по умолчанию для элемента управления. (Унаследовано от Control.)
DefaultMaximumSize Получает длину и высоту (в пикселях), которые были указаны в качестве максимального размера элемента управления по умолчанию. (Унаследовано от Control.)DefaultMinimumSize Получает длину и высоту (в пикселях), которые были указаны в качестве минимального размера элемента управления по умолчанию. (Унаследовано от Control.) DefaultSizeПолучает размер элемента управления по умолчанию. (Переопределяет Control::DefaultSize.)
DesignModeВозвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время. (Унаследовано от Component.)
DesktopBounds Возвращает или задает размер и расположение формы на рабочем столе windows.DesktopLocationВозвращает или задает расположение формы на рабочем столе windows.DialogResult Возвращает или задает результат диалогового окна формы.
Enabled Возвращает или задает значение, показывающее, сможет ли элемент управления отвечать на действия пользователя. (Унаследовано от Control.)
Events Возвращает список обработчиков событий, которые прикреплены к этому объекту Component. (Унаследовано от Component.)
Focused Получает значение, показывающее, имеется ли в элементе управления фокус ввода. (Унаследовано от Control.)
Font Возвращает или задает шрифт текста, отображаемого элементом управления. (Унаследовано от Control.)
FontHeightВозвращает или задает высоту шрифта элемента управления. (Унаследовано от Control.)ForeColor Получает или задает основной цвет элемента управления. (Унаследовано от Control.)FormBorderStyle Возвращает или задает стиль границы формы.
HasChildren Получает значение, определяющее, содержит ли элемент управления один или несколько дочерних элементов. (Унаследовано от Control.)
Height Возвращает или задает высоту элемента управления. (Унаследовано от Control.)
HelpButton Возвращает или задает значение, показывающее, отображается ли кнопка справка в окне заголовка формы.
HorizontalScroll Получает характеристики, связанные с горизонтальной полосой прокрутки. (Унаследовано от ScrollableControl.)
HScrollВозвращает или задает значение, указывающее, является ли горизонтальная полоса прокрутки видима. (Унаследовано от ScrollableControl.)
IconВозвращает или задает значок для формы.
KeyPreview Возвращает или задает значение, указывающее, производит ли форма ключевые события до события передаются элементу управления, имеющий фокус.
Lef tВозвращает или задает расстояние (в пикселях) между левой границей элемента управления и левой границей клиентской области его контейнера. (Унаследовано от Control.)
Location Возвращает или задает Point, представляющий верхний левый угол Form в экранных координатах.
MainMenuStrip Возвращает или задает основной контейнер меню для формы.
Margin Получает или задает расстояние между элементами управления.
MaximizeBox Возвращает или задает значение, определяющее, отображается ли кнопка Развернуть в заголовке формы.
MaximizedBounds Возвращает и задает размер формы, когда он развернут.
MaximumSize Возвращает максимальный размер формы возможность изменения размера. (Переопределяет Control::MaximumSize.)
Menu Возвращает или задает MainMenu, отображаемое в форме.
MinimizeBox Возвращает или задает значение, определяющее, отображается ли кнопка Свернуть в заголовке формы.
MinimumSize Возвращает или задает минимальный размер формы возможность изменения размера. (Переопределяет Control::MinimumSize.)
Modal Возвращает значение, указывающее, отображается ли эта форма является модальным.Name Возвращает или задает имя элемента управления. (Унаследовано от Control.)
Opacity Возвращает или задает уровень непрозрачности формы.
RestoreBounds Возвращает расположение и размер формы в своем обычном состоянии окна.Right Получает расстояние (в пикселях) между правой границей элемента управления и левой границей клиентской области его контейнера. (Унаследовано от Control.)
RightToLeftLayout Возвращает или задает значение, указывающее, включено ли зеркальное размещение справа налево.
ShowFocusCues Получает значение, показывающее, должен ли элемент управления отображать прямоугольники фокуса. (Унаследовано от Control.)
ShowIcon Возвращает или задает значение, указывающее, отображается ли значок в заголовке формы.
ShowInTaskba rВозвращает или задает значение, указывающее, отображается ли форма в панели задач windows
Site Возвращает или задает подложку элемента управления. (Унаследовано от Control.)
Size Возвращает или задает размер формы.
SizeGripStyle Возвращает или задает стиль захвата для изменения размера, которая будет отображаться в правом нижнем углу формы.
StartPosition Возвращает или задает начальное положение формы во время выполнения.
TabIndex Возвращает или задает последовательность табуляции элементов управления внутри контейнера.
TabStop Возвращает или задает значение, указывающее, может ли пользователь может получить фокус к этому элементу управления с помощью клавиши tab.
Tag Получает или задает объект, содержащий данные элемента управления. (Унаследовано от Control.)
Text Получает или задает текст, сопоставленный с этим элементом управления. (Переопределяет Control::Text.)
Top Возвращает или задает расстояние (в пикселях) между верхней границей элемента управления и верхней границей клиентской области его контейнера. (Унаследовано от Control.)TopLevel Возвращает или задает значение, указывающее, следует ли отображать формы в качестве окна верхнего уровня.
TopMost Возвращает или задает значение, показывающее, необходимо ли отображать форму как форму переднего плана.
TransparencyKey Возвращает или задает цвет, который будет представлять прозрачные области формы.
UseWaitCursor Возвращает или задает значение, указывающее, следует ли использовать курсор ожидания для текущего элемента управления и всех дочерних элементов управления. (Унаследовано от Control.)
VerticalScroll Получает характеристики, связанные с вертикальной полосой прокрутки. (Унаследовано от ScrollableControl.)
Visible Получает или задает значение, указывающее, отображаются ли элемент управления и все его дочерние элементы управления. (Унаследовано от Control.)
VScroll Возвращает или задает значение, указывающее, является ли вертикальная полоса прокрутки отображается на экране. (Унаследовано от ScrollableControl.)
Width Возвращает или задает ширину элемента управления. (Унаследовано от Control.)WindowState Возвращает или задает значение, указывающее, развернут ли форма свернута или обычный.
Методы
Activate
Активизирует форму и присваивает ей фокус.
CloseЗакрывает форму.
DoDragDropНачинает операцию перетаскивания. (Унаследовано от Control.)
FocusЗадает фокус ввода элемента управления. (Унаследовано от Control.)
HideСкрывает элемент управления от пользователя. (Унаследовано от Control.)
Invalidate()Делает недействительной всю поверхность элемента управления и вызывает его перерисовку. (Унаследовано от Control.)
OnActivatedВызывает событие Activated
OnClickСоздает событие Click. (Унаследовано от Control.)
OnClientSizeChanged
Создает событие ClientSizeChanged. (Унаследовано от Control.)
OnClosedВызывает событие Closed
OnClosingВызывает событие Closing
OnDeactivateВызывает событие Deactivate
OnDoubleClickСоздает событие DoubleClick. (Унаследовано от Control.)
OnDragDropСоздает событие DragDrop. (Унаследовано от Control.)
DragOver. (Унаследовано от Control.)
OnEnter Вызывает событие Enter (Переопределяет Control::OnEnter(EventArgs).)Происходит при входе в элемент управления.
OnFormClosedВызывает событие FormClosed
OnFormClosingВызывает событие FormClosingПроисходит перед закрытием формы.
Событие FormClosing происходит во время закрытия формы. Когда форма закрыть, он освобождается, освобождая все ресурсы, связанные с формой. Если отменить это событие, то форма остается открытой. Чтобы отменить закрытие формы, установите свойство CancelFormClosingEventArgs, передаваемого в обработчик событий к true.
Если форма отображается как модальное диалоговое окно, нажатие кнопки Закрыть (кнопка с Х в правом верхнем углу формы) приводит к скрытию формы и присваиванию свойству DialogResult значения DialogResult. Cancel. Можно переопределить значение, присвоенное свойству DialogResult, когда пользователь нажимает кнопку Завершить работу, присвоив свойству DialogResult в обработчике событий для события FormClosing формы.
|
После Close метод вызывается во a Form показано, как окно modeless нельзя вызывать Show метод, чтобы сделать форму видимой, поскольку формы уже ресурсы освобождаются. Чтобы скрыть форму, а затем сделать ее видимой, используйте метод Hide |
OnGotFocusСоздает событие GotFocus. (Унаследовано от Control.)Генерируется при получении фокуса элементом управления.
OnLeaveСоздает событие Leave. (Унаследовано от Control.)Происходит, когда фокус ввода покидает элемент управления.
OnInvalidatedСоздает событие Invalidated. (Унаследовано от Control.)OnKeyDownСоздает событие KeyDown. (Унаследовано от Control.)OnKeyPressСоздает событие KeyPress. (Унаследовано от Control.)OnKeyUpСоздает событие KeyUp. (Унаследовано от Control.)
OnMouseClickСоздает событие MouseClick. (Унаследовано от Control.)OnMouseDoubleClickСоздает событие MouseDoubleClick. (Унаследовано от Control.)OnMouseDownСоздает событие MouseDown. (Унаследовано от Control.)OnMouseEnterСоздает событие MouseEnter. (Унаследовано от Control.)OnMouseHoverСоздает событие MouseHover. (Унаследовано от Control.)OnMouseLeaveСоздает событие MouseLeave. (Унаследовано от Control.)OnMouseMoveСоздает событие MouseMove. (Унаследовано от Control.)OnMouseUpСоздает событие MouseUp. (Унаследовано от Control.)
