Форма является основным компонентом графического интерфейса программы. Именно на ней размещаются управляющие интерфейсы.
Рассмотрим некоторые из свойств формы, которые влияют на её внешний вид.
Объявляем форму
Для того что бы объявить форму, нам надо добавить библиотеку System.Windows.Forms.dll
1 |
Add-Type -assembly System.Windows.Forms |
После объявляем форму $main_form
1 |
$main_form = New-Object System.Windows.Forms.Form |
Отобразим форму $main_form.
1 |
$main_form.ShowDialog() |
В результате получилась вот такая форма:
Что бы в загаловке формы отобразить текст нужно присвоить его свойству Text нашей формы:
1 |
$main_form.Text="Hello" |
Текст отобразится в заголовке:
Изменение размера формы:
Давайте изменим размер формы.
Это можно сделать через свойства Width(ширина) и Height(высота) формы, где значения параметров это кол-во пикселей.
Пример:
1 2 |
$main_form.Width = 300 $main_form.Height = 500 |
Этого же результата можно добиться используя параметр формы Size:
1 |
$main_form.Size = New-object System.Drawing.Size(300, 500) |
Так же можно задать размер с помощью параметра DesktopBounds:
1 |
$main_form.DesktopBounds = New-object System.Drawing.Rectangle(0,0, 300, 500) |
Так же для изменения размеров можно воспользоваться свойством ClientSize
1 |
$main_form.ClientSize = New-object System.Drawing.Size(300,500) |
Однако этот параметр задаёт клиентскую область формы, которая по размерам меньше самой формы. Поэтом получившаяся форма, по размерам окажется больше, чем в предыдущих примерах.
Однако данные свойства не ограничивают размер формы в период жизни программы, пользователь может изменить размер формы или распахнуть её на весь экран, что может существенно сказаться на внешнем виде формы. Поэтому иногда форму приходится ограничить возможность сжимать и/или растягивать форму.
Для этогу существуют такие параметры , как MinimumSize(минимальный размер формы) и MaximumSize (максимальный размер формы). Если задать эти параметры, то в период жизни форма не сможет за них выйти.
Пример объявления данных свойств:
1 2 |
$main_form.MinimumSize = New-object System.Drawing.Size(100, 100)#Минимальный размер окна $main_form.MaximumSize = New-object System.Drawing.Size(600, 600)#Максимальный размер окна |
Но вычислять область окна бывает довольно сложно, удобнее всего отдать эту задачу автоматическим средствам управления окнами.
Для этого с начала надо разрешить менять размер формы, в зависимости от расположения объектов в области видимости свойством AutoSize перевести его в значение true
1 |
$main_form.AutoSize = $true |
После надо выбрать режим автоматического подбора размера формы и указать его в свойстве AutoSizeMode. Существует два режима этого свойства GrowOnly и GrowAndShrink:
GrowOnly — режим разрешает ужимать размер формы если в этой области нет элементов управления, но не меньше, чем указанов параметрах Width и Height
GrowAndShrink — режим разрешает ужимать размер формы если в этой области нет элементов управления, игнорируя параметры Width и Height но не меньше чем MinimumSize, при этом форма не будет растягиваться по требованию пользователя, но форму можно будет развернуть на всё окно.
1 |
$main_form.AutoSizeMode =[System.Windows.Forms.AutoSizeMode]::GrowOnly |
или
1 |
$main_form.AutoSizeMode =[System.Windows.Forms.AutoSizeMode]::GrowAndShrink |
Шрифты
Так же не малую роль в отображении формы влияют шрифты. К тому же настройки шрифтов наследуются на управляющие элементы принадлежащие этой форме.
Настройки шрифта хранятся в свойстве формы Font данное свойство наследуется другим упавляющим компонентам на форме. Изменять свойства Font по отдельности нельзя, но можно переопределить его польностью следующим образом:
1 |
$main_form.Font = New-Object System.Drawing.Font ("Calibri",24) |
Что бы поменять цвет шрифта существует следующее свойство ForeColor:
1 |
$main_form.ForeColor = "#FF0000" # цвет шрифта |
Не малуюроль в определении размеров управляющих элементов играет размер шрифта его можно узнать из свойства AutoScaleBaseSize, его так же можно перераспределить.
1 |
#$main_form.AutoScaleBaseSize="10,10"; |
Шаблон окна
Шаблон окна формы опредиляется парметром FormBorderStyle, который может принимать семь значений Fixed3D, FixedDialog, FixedSingle, FixedToolWindow, None, Sizabl, SizableToolWindow по умолчанию стоит значение Sizable. Заметим, что внешний вид формы на примерах может существенно отличаться на разных компьютерах и существенно зависит от OC. Так же после назначения определённого шаблона окна в дальнейшем его можно будет редактировать другими свойствами формы.
Рассмотрим шаблоны формы:
Fixed3D — Фиксированная трехмерная граница. Форме запрещено менять размер, однако её можно развернуть на весь экран или свернуть.
1 |
$main_form.FormBorderStyle = [System.Windows.Forms.FormBorderStyle]::Fixed3D |
FixedDialog — Толстая фиксированная граница в диалоговом окне-стиля. Так же как и в Fixed3D запрещено менять размер. Однако иконка в левой верхней части окна не отображается.
1 |
$main_form.FormBorderStyle = [System.Windows.Forms.FormBorderStyle]::FixedDialog |
FixedSingle — фиксированная, одно строковая граница.
1 |
$main_form.FormBorderStyle = [System.Windows.Forms.FormBorderStyle]::FixedSingle |
FixedToolWindow — Граница окна инструментов, которое нельзя изменить. Окно инструментов не отображается в панели задач или в окно, которое появляется при нажатии пользователем клавиши ALT+TAB. Хотя форма FixedToolWindow не отображается в панели задач, однако лучше явно необходимо установить свойство ShowInTaskbar в значение false.
1 |
$main_form.FormBorderStyle = [System.Windows.Forms.FormBorderStyle]::FixedToolWindow |
None — Форма без рамки. Она не умеет изменять размер, и свёртываться в панель задач, но её можно развернуть.
1 |
$main_form.FormBorderStyle = [System.Windows.Forms.FormBorderStyle]::None |
Sizable — Граница с изменяемыми размерами. Данная форма может изменять размер, разворачиваться и сворачиваться в панель задач.
1 |
$main_form.FormBorderStyle = [System.Windows.Forms.FormBorderStyle]::Sizable |
SizableToolWindow — Окно может изменять размер окна, разворачивать окно на всё окно, сворачивать в панель задач. Однако кнопки MaximizeBox и MinimizeBox не отображаются. Так же окно не отображается в панели задач однако окно появляется при нажатии клавиш ALT+TAB.
1 |
$main_form.FormBorderStyle = [System.Windows.Forms.FormBorderStyle]::SizableToolWindow |
Управляющие кнопки
Для управления отображения управляющими кнопками используются следующие свойства ControlBox, MaximizeBox и MinimizeBox.
Свойство ControlBox управляет видимостью всей областью управляющих кнопок. По умолчанию она находиться в состоянии true.
Зададим данному свойству значение false
1 |
$main_form.ControlBox = $false |
Если в форме свойству Text присвоить пустое значение, то шапка формы совсем исчезнет.
1 |
$main_form.Text="" |
Вот так будет выглядеть форма:
Включим назад ControlBox и рассмотрим следующие свойства: MaximizeBox и MinimizeBox. Они тоже булевые и служат для того, что бы выключать кнопки развернуть окно и свернуть окно. По умолчанию они имеют свойство true. Рассмотрим как выглядит их выключение:
1 2 |
$main_form.MaximizeBox = $false $main_form.MinimizeBox = $true |
1 2 |
$main_form.MaximizeBox = $true $main_form.MinimizeBox = $false |
Однако, если выключить и MaximizeBox и MinimizeBox кнопки перестают быть видимыми:
1 2 |
$main_form.MaximizeBox = $false $main_form.MinimizeBox = $false |
Заметим так же, что отключение кнопок по одиночке или одновременно влияет не только на отображение этих кнопок и возможностями их использовать, но так же и на свойство формы. Так на форме с выключенным свойством MaximizeBox пользователю отключаются все стандартные возможности распахнуть форму на весь экран. Так же дела обстоят и с MinimizeBox.
С отключённым ControlBox отключается возможность изменять размер формы, но её можно распахнуть и свернуть, например сочитанием клваишь «win»+»up» и «win»+»down».
Иконка.
Иконка отображаемая в левом верхнем углу формы, а так же отображаемая в панели задач может определить через свойство формы Icon например вот так:
1 |
$main_form.Icon = New-Object System.Drawing.Icon("d:\favicon.ico") |
Где «d:\favicon.ico» это путь к иконке.
Если же мы не хотим, что бы иконка отображалась, то её можно скрыть, с помощью свойства ShowIcon установив его в состояние false. Если же шаблон окна не подразумевает наличия иконки, её так же можно включить через это свойство установи параметр truе
1 |
$main_form.ShowIcon = $false |
Элемент захвата
Для того, чтобы задать видимость захвата для изменения размера, отображаемого в правом нижнем углу формы. Нужно воспользоваться свойством SizeGripStyle. Оно имеет 3 значенич Auto, Hide, Show
Auto
Данное значение стоит по умолчанию. Форма сама решает отображать этот элемент или нет.
$main_form.SizeGripStyle = [System.Windows.Forms.SizeGripStyle]::Auto
Hide
Элемент будет скрыт с формы.
1 |
$main_form.SizeGripStyle = [System.Windows.Forms.SizeGripStyle]::Hide |
Show
элемент отображается на форме
1 |
$main_form.SizeGripStyle = [System.Windows.Forms.SizeGripStyle]::Show |
Цвет и прозрачность.
Что бы задасть цвет формы нужно воспользоваться свойством BackColor, этот параметр будет наследоваться размещённым на данной форме управляющим элементам. Сделаем цвет рабочей области, например синим:
1 |
$main_form.BackColor = "0x000099" |
Но однотонный цвет може не совсем удовлетворять нашим потребностям… для этого можно указать картинку в качестве заднего фона, с помощью свойства формы BackgroundImage
1 |
$main_form.BackgroundImage = [System.Drawing.Image]::FromFile("d:\favicon.png") |
Мы так же можем определить, какой цвет на форме будет являтся «прозрачным» но этот эфект больше похож на вырезание дырок в форме, так как клик по прозрачной части формы будет обрабатываться не формой, а окном за ней. Для этого сначало, надо разрешить использовать прозрачность, для этого в свойстве AllowTransparency мы должны присвоить знчение true
$main_form.AllowTransparency =$true
А в свойстве TransparencyKey формы мы должны указать, какой цвет будет заменяться на прозрачный.
1 |
$main_form.TransparencyKey = "0xFFFFFF" |
Эти параметры прозрачности будут так же наследоваться на управляющие элементы формы.
Это свойство можно использовать для рисования не стандартных окон убрав перед этим рамку формы
1 |
$main_form.FormBorderStyle = [System.Windows.Forms.FormBorderStyle]::None |
Если же мы не хотим делать дырки в форме, а всеволишь сделать её слегка прозрачной, мы можем воспользоваться свойством Opacity, значения в ней колеблятся от 0 это полностью прозрачная до 1, не прозрачная.
1 |
$main_form.Opacity = 0.6 |
Курсор
Для изменения вида курсора в приложении можно воспользоваться свойством формы Cursor:
1 |
$main_form.Cursor = New-Object System.Windows.Forms.Cursor("d:\Cursor.cur") |
После данного действия курсор над приложением будет заменятся на «d:\Cursor.cur».
Так же можно узнать перехватывается ли курсор приложением в даннй момент, для этого нужно посмотреть данные свойства формы Capture
Что бы уведомить пользователя о текущем процессе, можно так же включить курсор ожидания указав в свойстве UseWaitCursor значение true
1 |
#$main_form.UseWaitCursor = $true |
Состояние окна.
Что бы узнать в каком состоянии находиться окно или изменить его, можно воспользоваться свойством формы WindowState оно принимает три значения Maximized, Minimized, Normal.
Что бы развернуть окно:
1 |
$main_form.WindowState =[System.Windows.Forms.FormWindowState]::Maximized |
Свернуть в панель задач:
1 |
$main_form.WindowState =[System.Windows.Forms.FormWindowState]::Minimized#свёрнуто |
Перевести в обычный(свободный) режим:
1 |
$main_form.WindowState =[System.Windows.Forms.FormWindowState]::Normal |
Зеркальный вид окна
Так же есть возможность показать зеркальную форму обычно это используют для приложений в которых ввод текста происходит с права на лево.
Для этого нам нужно сначала включить поддержку ввода текста с права на лево свойством формы RightToLeft
1 |
$main_form.RightToLeft = [System.Windows.Forms.RightToLeft]::YES |
У этого свойства кроме значения YES, который включает поддержку ввода текста с права на лево, существуют другие параметры. Это NO выключает поддержку ввода текста с права на лево. И Inherit — наследовать значения от родительского элемента, установленно по умолчанию.
Только после этого можно отобразить форму зеркально установив свойство формы RightToLeftLayout в значение true
1 |
$main_form.RightToLeftLayout = $true |
Посмотреть отображается ли форма в зеркальном виде можно из свойства формы IsMirrored.
Отображение в Панели задач.
Для того, что бы скрыть форму из панели задач, есть следующее свойство формы ShowInTaskbar. Это свойство имеет булевый тип и чтобы форма скрылась из пнели задач надо указать значение false. Однако эту форму можно будет найти по «Alt»+»Tab»
1 |
$main_form.ShowInTaskbar = $false |
Видимость окна.
Так же если надо сделать, что бы форма не закрывалась другими окнами можно воспользоваться свойством TopMost. Если установить его в значение true то другие окна не смогут заслонить его.
1 |
$main_form.TopMost = $true |
Для формы существуют параметры видимости, но для отображения формы лучше пользоваться функция Enabled если установить его в значение false, то его не удасться отобразить методом ShowDialog().
Так же если надо скрыть форму, то это можно сделать изменив свойство Visible на false. Можно так же отобразить форму, но это может быть не всегда хорошей идеей, лучше пользоваться методом ShowDialog.
1 |
$main_form.Visible = $false |
Огромное спасибо за подробный разбор!
Очень сильно помогло в пониманиии концепции построения GUI для повершела =)
Приятно осознавать, что мой блог помогает людям. 🙂
Действительно подробно, практически на пальцах. Сохранил в избранном.;)
Но можно задать вопрос? 😉 Во всех «мануалах» рассказывается как сделать окно, как сделать кнопки, поля и т.д. Но я нигде не нашёл информации (тем более в доходчивой, простой форме как у Вас) — как сделать так, что бы окно не закрывалось при нажатии кнопок. Что бы окно было полноценным, т.с.
Например — есть поле ввода ФИО сотрудника, рядом кнопка «Выбор» или «Поиск» — ввел в поле часть фамилии, нажал на кнопку, запустилась часть скрипта которая делает выборку пользователей, открывается окно ISE со списком найденных пользователей, выбрал необходимого пользователя, нажал Ок, окно ISE закрылось, и в поле ввода уже появилось полное ФИО сотрудника, плюс в этом же окне сразу отобразилась необходимая информация (домен, срок действия пароля и т.д…. не суть), потом, если надо можно было бы воспользоваться еще какими нибудь кнопками, а вот когда нажмешь кнопку «Ок» или «Запустить», тогда уже запустится основная часть скрипта, сделает своё дело, и в этом же окне напишет результат. После этого можно либо закрыть окно кнопкой «Закрыть», «Отмена», кнопкой закрытия окна, либо воспользоваться скриптом (этим окном) еще раз.
Всё, что я не пробовал — ведёт к одному — как только нажму любую кнопку — окно закрывается. 🙁
Немного удивила проблема. А разве всё работает не так, как вы описали? 🙂
Как добирусь до винды с powershell попытаюсь состряпать какойнить пример… предположительно это будет завтра.
Спасибо большое. Возможно я просто не так его «готовлю». 🙂
Вот получился не большой скриптик…
Текстовое поле и кнопка.
нажимаем на кнопку в консоль пишеться то, что в текстовом поле.
форма не закрывается. изменяем значение в тектовом поле. Нажимаем кнопку.. опять выводиться. форма не закрывается…
О! Спасибо огромное! 😉 Когда сравнил с тем, что у меня, тогда дошло в чём подковырка. У меня на всех кнопках .DialogResult стоит. А без него действительно форма не закрывается.
Обращайтесь ещё. 🙂
Огромное спасибо! Очень помогло при работе с формами в PascalABC.Net.
Рад, что это кому то надо. 🙂
Спасибо огромное, с вашей помощью удалось быстро набросать GUI к своим скриптам.
спасибо!