Немного истории
Для работы с формами в прежних версиях VB использовался механизм Ruby Forms. Он представлял собой версию программы Ruby, написанной Аланом Купером (Alan Cooper); в результате объединения Ruby с QuickBasic появился VB11. Таким образом, разработка графических приложений в прежних версиях VB зависела от механизма форм, работа которого была практически полностью скрыта от программиста. Стартовая форма,
словно по волшебству, появлялась на экране, а элементы размещались на форме программистом на стадии конструирования [ В VB6 элементы могли добавляться и во время работы программы, но данная возможность почти не использовалась из-за крайне неудобного механизма перехвата событий в этих элементах. ]. В программах С/С++ процесс ручного создания окон и элементов на формах был делом в лучшем случае непростым, и в этой области VB обладал несомненными преимуществами. Впрочем, у этого волшебства была и оборотная сторона — механизм Ruby Forms был недостаточно гибким. Он плохо расширялся, и программисту приходилось мириться со всеми недочетами в его реализации. Возможности использования форм и элементов VB были ограничены; в любых нестандартных ситуациях программисту приходилось широко использовать функции API и перехватывать стандартные сообщения Windows в уродливых конструкциях с субклассированием [ Некоторые пакеты независимых фирм (например, Desa ware Spy Works) упрощали процесс субклас-сирования, но задача все равно оставалась непростой. ]. Даже такая простая задача, как создание списка с ускоренным поиском, требовала вызова функции API; стандартная операция включения новых строк в список усложнялась тем, что свойство Items списка было доступно только для чтения (к счастью, в VB .NET эти проблемы решаются элементарно [ Например, чтобы быстро заполнить список, достаточно присвоить коллекцию свойству DataSource. ]).
Более того, многие программисты не понимали, чем же в действительности были формы VB — классами или экземплярами классов? В каком-то смысле и тем и другим. В результате программа выглядела весьма странно:
Forml.Show ' Я - экземпляр
Dim newForm As New Forml ' А теперь я - класс
newForm.Show
Программисты предпочитают работать с логичными и последовательными моделями, а с точки зрения ООП механизм форм в ранних версиях часто выглядел как нагромождение искусственных и несогласованных «заплат». В VB .NET ситуация полностью изменилась. Здесь формы являются экземплярами класса Windows. Forms. Form, и поведение форм может изменяться посредством наследования точно так же, как и поведение любых других классов .NET Framework. Например, код специализированной формы может начинаться со следующего заголовка:
Public Class MyForm
Inherits System.Windows.Forms.Form
После этого форма наделяется новыми возможностями, для чего программист либо переопределяет члены родительского класса Form, либо добавляет в него новые члены, как для любого другого класса (см. главу 5).
В прежних версиях VB элементы даже не считались полноценными классами, поэтому команды вроде следующей были недопустимыми:
Dim myButton As New CommandButton
Перед нами классический пример логической связи «является частным случаем», идеально подходящий для наследования, однако программист не мог определить новый вариант кнопки как производный от базового класса стандартной кнопки.
Возможности создания нестандартных элементов, появившиеся в VB5, были основаны на включении и делегировании, причем в этом процессе использовалась одна из самых непредсказуемых программ-мастеров (wizards) — не говоря уже о том, что элементы, построенные в VB5 и 6, несколько отличались от элементов, построенных на других языках (например, C++ и Delphi).
В .NET элементы и формы являются классами. Как будет показано ниже в этой главе, VB .NET позволяет определить новый класс текстового поля, начинающийся с заголовка следующего вида:
Public Class PositivelntegerTextBox
Inherits System.Windows.Forms.TextBox
Далее программист переопределяет или добавляет методы, как в любом другом классе, причем полученный элемент ничем не отличается от элементов, написанных на С# или управляемом C++.
Короче говоря, в предыдущих версиях VB графические приложения строились на весьма шаткой и ненадежной основе, которая к тому же не была в полной мере объектно-ориентированной. Переход к единой программной модели в рамках объектно-ориентированной версии VB потребовал коренного пересмотра этой структуры. Так появилось новое пространство имен Windows.Forms.
Дизайнер форм
Программисты VB6 легко привыкают к особенностям работы с формами и элементами в VS .NET IDE. В вашем распоряжении оказывается пара новых (притом весьма полезных) инструментов, кратко описанных далее, однако общие принципы работы с панелью элементов (toolbox) почти не изменились.
Для читателей, никогда не работавших в старой версии VB IDE, мы кратко опишем процесс включения нового элемента в окно формы.
- Дважды щелкните на
элементе или перетащите его с панели элементов на форму.
- Расположите элемент
в нужной позиции (щелкните внутри элемента и перетащите его мышью).
- Измените размеры элемента
при помощи маленьких квадратных маркеров, показанных на рис. 8.1 (при необходимости
можно выполнить более точную настройку размеров при помощи комбинации Shift+клавиши
со стрелками).
Рис.
8.1. Маркеры изменения размеров элемента
- На панели элементов
щелкните на кнопке элемента, размещаемого на форме.
- Расположите курсор
над формой (в отличие от прежних версий VB внешний вид курсора теперь изменяется
в зависимости от выбранного элемента).
- Щелкните в точке,
где должен находиться левый верхний угол элемента, и перетащите курсор в позицию
правого нижнего угла (при необходимости размеры элемента можно изменить при
помощи комбинации Shift+клавиши со стрелками).
Позицию и размеры элементов, размещенных на форме, можно изменить командами меню Format. Некоторые команды меню Format (в частности, команды подменю Align) работают только с группами элементов. Группу можно выделить несколькими способами; например, щелкните на первом элементе группы, а затем, удерживая нажатой клавишу Shift, последовательно щелкайте на всех остальных элементах, включаемых в группу. Рядом со всеми выделенными элементами появляются маркеры изменения размеров, но лишь у одного элемента они будут темными, как у кнопки на рис. 8.2.
Элемент с темными маркерами используется в качестве эталона при выполнении команд меню Format — например, Format > Make Same Width > Width. При ручном масштабировании все элементы в группе изменяются пропорционально независимо от того, какой элемент выбран эталонным.
Рис.
8.2. Объединение элементов в группы
Сохранение
пропорций: свойства Anchor и Dock
Значение свойства Anchor задается в окне свойств при помощи небольшого мини-редактора, показанного на рис. 8.3.
Свойство Anchor привязывает элемент к одному или нескольким краям формы. В этом случае расстояние между элементом и краем остается постоянным при любых изменениях размеров контейнера. Элемент, привязанный к противоположным краям контейнера, автоматически масштабируется с изменением размеров контейнера. Ниже приведен пример кода, сгенерированного при установке свойства Anchor с привязкой элемента по левому и правому краю:
Me.Button1.Anchor = (System.Windows.Forms.AnchorStyles.Left _ Or System.Windows.Forms.AnchorStyles.Right)
Свойство Dock обладает значительно большей гибкостью по сравнению со старым свойством Al ign, которое оно заменяет. Элемент, пристыкованный к краю формы, остается совмещенным с этим краем при любых изменениях размеров формы. Значение свойства Dock задается в мини-редакторе, показанном на рис. 8.4.
Рис.
8.3. Мини-редактор для свойства Anchor
Рис.
8.4. Мини-редактор для свойства Dock
При стыковке нескольких элементов с одним краем контейнера первый элемент совмещается с краем, а остальные располагаются как можно ближе к нему, не перекрывая предыдущие элементы, как показано на рис. 8.5.
Поскольку и стыковка, и привязка выполняются по отношению к контейнеру, вы можете сначала стыковать/привязать групповые поля (GroupBox) или панели к краям формы, а затем проделать то же самое с элементами внутри этих контейнеров. Как правило, необходимость в программировании изменения размеров при этом пропадает. Например, в процессе построения формы, показанной на рис. 8.6, три групповых поля были пристыкованы к левому краю формы, после чего три кнопки были пристыкованы к нижнему краю первого группового поля.
Рис. 8.5. Стыковка элементов с краем формы
Рис.
8.6. Будущий калькулятор
Изменение порядка перебора элементов (tab order) в прежних версиях VB было делом утомительным и неприятным, которое несколько упрощалось только специальной надстройкой (add-in). В VB .NET существует команда View > Tab Order, которая делает эту задачу элементарной. Все, что от вас потребуется, — ввести нужную позицию элемента в небольшом поле, которое при выполнении команды View > Tab Order появляется рядом с элементом (рис. 8.7). Для элементов, находящихся внутри контейнера, позиция задается в формате «х.у». Например, если групповому полю в порядке перебора была присвоена позиция 3, то расположенные внутри него элементы будут иметь номера 3.0, 3.1 и т. д. (чтобы отключить режим ввода порядка перебора, снова выполните команду Tab Order).
Рис.
8.7. Команда Tab Order
Элементы меню и новый редактор меню Visual Studio
Хотя визуальное конструирование форм в книге почти не рассматривается, мы просто не могли не упомянуть новый редактор меню. Программисты VB уже давно ждали чего-то подобного. Впрочем, при всем удобстве нового редактора вы извлечете из него максимум пользы лишь при полном понимании кода, сгенерированного IDE.
Построить меню в редакторе меню (Menu Editor) несложно. Сначала с панели элементов на форму перетаскивается элемент MainMenu; на форме появляется заготовка меню (рис. 8.10).
Теперь можно переходить к вводу команд меню. При вводе очередной команды в редакторе появляются поля для ввода следующей команды или команд, находящихся на других уровнях иерархии меню (рис. 8.11). Чтобы отредактировать команду меню, созданную ранее, достаточно щелкнуть на ней (для изменения существующих меню щелчок делается на элементе MainMenu на панели под формой). Порядок команд меню изменяется операциями вырезания/вставки (эти операции работают даже в главной строке меню). Как и в прежних версиях VB, перед клавишами ускоренного вызова ставится префикс &. На рис. 8.11 показано меню с клавишей ускоренного вызова и разделительной чертой.
Прежде чем переходить к коду, сгенерированному для меню на рис. 8.11, необходимо знать, что меню формы инкапсулируется в классе System.Windows.Forms.MainMenu. Объект MainMenu выполняет функции контейнера для экземпляров Menu Item. Для организации подменю в экземплярах Menultem определяется свойство Menultems; значение этого свойства представляет собой коллекцию класса Menu.MenuItemCollection, содержащую другие объекты Menultem.
Что касается кода, соответствующего рис. 8.11, то он начинается с объявления команд меню. Имена, принятые по умолчанию, были заменены более содержательными: вместо Menulteml используется имя mnuFile и т. д.
Рис.
8.10. Начало построения меню в редакторе меню
Рис.
8.11. Построение меню в новом редакторе меню Visual Studio
Экземпляр главного меню создается командой, которую IDE включает в метод
InitializeComponent:
Me. MainMenul =New System. Windows. Forms. MainMenu ()
Следующий фрагмент создает в методе Initial! zeComponent объекты отдельных команд меню:
Me.mnuFile = New System. Windows. Forms. MenuItem()
Me.mnuNew = New System. Windows. Forms. MenuItem()
Me.mnuOpen = New System. Windows. Forms. MenuItem()
Как видно из этого фрагмента, меню File верхнего уровня тоже представлено экземпляром класса Menultem. Объекты команд включаются в экземпляр Mai nMenu вызовом метода AddRange класса Menultems. В следующем примере метод AddRange включает в меню сразу три команды:
Me . Mai nMenul . Menultems . AddRange( New System . Windows . Forms . Menultem( )
{Me.mnuFile. Me.mnuEdit, Me.mnuHelp})
Поскольку у объектов отдельных команд тоже имеется свойство Menultems, автоматически сгенерированный код включения команд выглядит практически так же: Me . mnuFile . Menu Items . AddRange ( New System . Windows . Forms . Menul tem( )_
{Me.mnuNew. Me.mnuOpen. Me.mnuExit. Me.mnuSep})
На последнем шаге IDE подключает события Click для команд меню. Сгенерированный код выглядит так: Private Sub mnuExit_Click(ByVal sender As System. Object, _
ByVal e As System. EventArgs)Handles mnuExit. Click
В прежних версиях VB создавать контекстные меню было неудобно. В .NET контекстное меню представляется экземпляром класса ContextMenu и редактируется в визуальном режиме. Чтобы связать контекстное меню с элементом или формой, достаточно задать значение свойства ContextMenu этого элемента или формы. По стандартам Windows контекстные меню вызываются щелчком правой кнопки мыши; в .NET это происходит автоматически благодаря наследованию. Вам не придется программировать событие MouseDown — поддержка контекстных меню реализована в классе Control , производными от которого являются формы и элементы. При перетаскивании на форму элемента ContextMenu IDE генерирует почти такой же код, как для команд главного меню:
Friend WithEvents ContextMenul As System.Windows.Forms.ContextMenu
Me.ContextMenul =New System,Windows.Forms.ContextMenu() Так же вызывается метод AddRange:
Me.ContextMenul.MenuIterns.AddRange(New System.Windows.Forms.MenuItem() {Me.MenuIteml})
Чтобы быстро задать значение свойства Name команд контекстного меню, перейдите в режим редактирования имен щелчком правой кнопкой мыши.
В прежних версиях VB при программировании приложений с интерфейсом MDI (Multiple Document Interface) родительская форма MDI выбиралась на стадии конструирования. В .NET эта задача решается иначе — свойству IsMdiContainer формы задается значение True. Программист создает дочерние формы MDI на стадии конструирования или выполнения, а затем заносит в их свойство Mdi Parent ссылку на форму со свойством I sMdi Conta i пег, равным True. Таким образом, в программах VB .NET можно сделать то, что было практически нереально в предыдущих версиях VB, — изменять связи MDI во время работы программы. Кроме того, приложение может содержать несколько родительских форм MDI; в VB6 такая возможность не поддерживалась.
Рассмотрим пример. Создайте приложение со следующей процедурой Forml_Load:
Private Sub Forml_Load(ByVal sender As System.Object._ ByVal e As System.EventArgs) Handles MyBase.Load
Me.Text = "I'm an MDI Parent"
Me.IsMdiContainer - True
Dim MyChild As New System.Windows.Forms.Form()
MyChiId.MdiParent = Me
MyChild.Show()
MyChild.Text ="MDI Child" End Sub
Примерный вид окна показан на рис. 8.12.
Конечно, это весьма жалкое подобие приложения MDI. В приложениях MDI обычно присутствует меню Window, позволяющее расположить открытые дочерние окна «черепицей» или «мозаикой», а также активизировать любое дочернее окно. Меню Window реализуется в родительском окне, причем его код может быть достаточно простым:
Public Sub InitializeMenu()
Dim mnuWindow As New MenuItem("&Window") MainMenu1.MenuIterns.Add(mnuWindow) mnuWindow.MenuItems.AddCNew Menultem _
("&Cascade", AddressOf WindowCascade_Clicked)) mnuWindow.MenuItems.Add(New Menultem
("Tile &Horizontal", AddressOf WindowTileHoriz_C1icked)) mnuWindow.MenuItems.Add(New Menultem _
("Tile &Vertical". AddressOf WindowTileVert_Clicked)) mnuWindow.MdiList = True End Sub
Protected Sub WindowCascade_Clicked(ByVal Sender As Object. ByValeAs System.EventArgs)
Me.LayoutMdi(MdiLayout.Cascade) End Sub
Protected Sub WindowTileHoriz_Clicked(ByVal Sender As Object._ ByVal e As System.EventArgs)
Me.LayoutMdi(MdiLayout.TileHorizonta1) End Sub
Protected Sub WindowTileVert_Clicked(ByVal Sender As Object, ByVal e As System.EventArgs)
Me.LayoutMdi(MdiLayout.TileVertica1) End Sub
Примерный вид окна, полученного при вызове InitializeMenu для формы из предыдущего примера, показан на рис. 8.13.
Рис.
8.12. Простейшее приложение MDI
Рис.
8.13. Типичное меню Window в приложении MDI
Protected Sub MdiChi1dActivated(sender As object, e As System.EventArgs)
If (Me.ActiveMdiChild <> Nothing) Then statusBarl.Text Me.ActiveMdiChild.Text
End If End Sub
Диалоговые
формы и диалоговые окна
Рис.
8.14. Стандартные диалоговые окна на панели элементов
Классы всех стандартных диалоговых окон являются производными от абстрактного класса CommonDialog. Важнейший метод этого класса ShowDialog предназначен для отображения диалогового окна. По возвращаемому значению этого метода можно узнать, какую кнопку нажал пользователь в диалоговом окне — ОК или Cancel. Метод ShowDialog имеет следующий синтаксис: Public Function ShowDialogO As DialogResult
При проверке возвращаемое значение сравнивается с константами DialogResult .ОК и DialogResult.Cancel.
При использовании диалогового окна выбора цвета (Col orDialog) программа обычно запрашивает свойство Color и назначает его свойству ForeColor или BackColor элемента или формы. Например, приведенная ниже процедура изменяет фоновый цвет формы при нажатии на кнопку:
Private Sub btnCo1or_Click(ByVal sender As System.Object. _ ByVale As System.EventArgs)Handles btnColor.Click Dim myDialog As New ColorDialog() Dim Temp As Color = btnColor.BackColor If myDialog.ShowDialog() = DialogResult.OK Then Me.BackColor = myDialog.Color btnColor.BackColor = Temp End If End Sub
На экране появляется стандартное диалоговое окно, в котором выбирается нужный цвет.
Диалоговое окно выбора шрифта (FontDialog) хорошо знакомо всем пользователям текстовых редакторов Windows. В свойстве Font объекта диалогового окна возвращается объект Font, обычно назначаемый свойству Font элемента или формы. В следующем примере предполагается, что на форме находится текстовое поле TextBoxl и кнопка Buttonl:
Private Sub Buttonl_Click_l(ByVal sender As System.Object. _ ByVal e As System.EventArgs) Handles Buttonl.Click
Dim myDialog As New FontDialog()
If myDialog.ShowDialog() = DialogResult.OK Then TextBoxl.Font myDialog.Font
End If End Sub
(обратите внимание, как однострочное текстовое поле автоматически подстраивается под размеры нового шрифта).
Абстрактный класс FileDialog является базовым для двух специализированных подклассов:
- OpenFileDialog;
- SaveFileDialog.
Private Sub mnuOpen_Click(ByVal sender As System.Object,_ ByVal e As System.EventArgs)Handles mnuOpen.Click Dim myDialog As New OpenFileDialog() myDialog.Filter = "text (*.txt),RTF (*.rtf)|*.txt:*rtf" If myDialog.ShowDialog =DialogResult.OK Then
' При загрузке текстовых файлов во втором параметре ' необходимо передавать признак типа файла. Dim Temp As String = myDialog.FileName.Tollpper If Temp.EndsWith("TXT") Then
RichTextBoxl.LoadFi1e(myDialog.FileName,
Ri chTextBoxStreamType.Plai nText) Else
Ri chTextBoxl. LoadFiletmyDialog.File_Name.
Ri ChTextBoxStreamType.RichText) End If
End If End Sub
Создание диалоговых окон
Чтобы вывести собственное диалоговое окно, создайте форму, задайте ее свойствам ControlBox, MinimizeBox и MaximizeBox значение False, а свойству Modal — значение True. Форму следует выводить методом ShowDialog в режиме модального диалогового окна. Если при этом задать свойство TopMost равным True, диалоговое окно будет располагаться поверх всех окон на экране (и вам уже не придется использовать функцию API SetWindowPos).
Однако поведение стандартных кнопок несколько изменилось по сравнению с VB6. Свойства Default и Cancel не поддерживаются, поэтому соответствующие элементы-кнопки назначаются свойствам AcceptButton и Cancel Button:
Me.AcceptButton = btnOK Me.Cancel Button = btnCancel
После вызова ShowDialog программа может узнать, какая кнопка была нажата на форме, при помощи свойства Dial ogResult кнопки или самой формы (нажатие кнопки с заданным свойством DialogResul t приводит к автоматическому закрытию формы, на которой эта кнопка находится).
Размещение
элементов на форме во время выполнения
1 Private Sub Forml_Load(ByVal sender As System.Object,ByVal e As _
2 System.EventArgs) Handles MyBase.Load
3 Dim newButton As New System.Windows.Forms.Button()
4 ' Задать свойства newButton
5 With newButton
6 .Visible =True
7 .Size =New Size(l00.l00)
8 ' .Text ="I'm a new button"
9 ' Обычно здесь задаются и другие свойства
10 End With
11 Me.Controls.Add(newButton)
12 AddHandler newButton.Click.AddressOf Me.newButton_Click
13 End Sub
14 Public Sub newButton_Click(ByVal sender As _
15 System.Object.ByVal e As System.EventArgs)
16 MsgBox("You clicked on my new button")
17 End Sub
В строке З создается новая кнопка, а в строках 5-10 удобная сокращенная запись With используется для задания ряда свойств объекта newButton. Только в строке 11 новая кнопка размещается на форме. Строка 12 снова демонстрирует замечательную гибкость механизма обработки событий .NET: код, содержащийся в строках 14-17, назначается обработчиком события для кнопки. Возможный результат выполнения программы показан на рис. 8.15.
Рис.
8.15. Создание кнопки во время выполнения программы
Прежде всего следует сказать, что «визуальное наследование», часто упоминаемое в рекламных материалах по VB .NET, существует лишь в больном воображении специалистов по маркетингу. На самом деле речь идет о том, что формы, созданные в программе, могут использоваться как основа для определения новых форм посредством наследования. Конечно, это весьма удобно и полезно, но ничего принципиально нового в таком наследовании нет. Класс формы, производный от Windows. Forms. Form и дополненный специализированными свойствами, методами и событиями, в дальнейшем может использоваться в качестве базового для определения новых классов.[ История с «визуальным наследованием» как нельзя лучше демонстрирует тупость специалистов по рекламе. Возможно, эффектный термин поразит некомпетентноге менеджера, но у программистов он лишь вызывает раздражение. ]
Предположим, вы хотите создать для своей организации окно-заставку (splash screen), которое отдельные подразделения будут дополнять своими данными. Базовая форма создается следующим образом:
- Выполните команду File
> New > Project.
- Выберите тип приложения
Windows Application, введите в поле Name строку SplashScreeriBase и нажмите
кнопку ОК.
- Щелкните правой кнопкой
мыши в строке SplashScreenBase окна решения и выберите в контекстном меню
команду Properties.
- Выберите в раскрывающемся
списке Output Type строку Class Library (вместо Windows Application). Нажмите
кнопку ОК.
- Сконструируйте форму,
разместите на ней нужные элементы, реализуйте свойства, методы и события.
- Откомпилируйте программу.
Public Class Form1
Inherits SplashScreenBase. Form1
Все остальное за вас сделает механизм наследования! Этот способ особенно хорош тем, что работа дизайнера автоматически синхронизируется с унаследованной формой.
Построение
нестандартных элементов на базе наследования
Public Class PositivelntegerTextBox
Inherits System . Windows . Forms . TextBox
Остается лишь запрограммировать поле на нужное поведение. В оставшейся части этого раздела будет показано, как класс Positi velntegerTexBox наполняется специализированными свойствами, событиями и методами.
Итак, создайте новую библиотеку классов и включите в решение ссылку на сборку Windows.Forms.dll.
Начнем с переопределения событий базового класса. Например, событие OnChange поможет предотвратить ввод в поле всего, что не является целым числом. Следующий обработчик разрешает вводить или вставлять из буфера только положительные целые числа:
1 Public Class PositivelntegerTextBox
2 Inherits System.Windows.Forms.TextBox
3 Protected Overrides Sub OnTextChanged(ByVal e As EventArgs)
4 MyBase.OnTextChanged(e)
5 If Not (IsNumeric(Me.Text))Then
6 Me.Text - String.Empty
7 Else
8 Dim temp As Decimal
9 temp = CType(Me.Text.Decimal)
10 If temp - Math.Round(temp.0) <> 0 Then
11 Me.Text = String.Empty
12 End If
13 End If
14 End Sub
15 End Class
В строках 1 и 2 объявляется специализированная версия обычного текстового поля. Поскольку при специализации на базе наследования сохраняются все члены базового класса, которые не подверглись явным изменениям, вам не придется прибегать к услугам программы-мастера (как в VB6), чтобы решить вопрос с неизменными свойствами — например, с основным цветом. При переопределении событий в производном классе обычно вызывается обработчик базового класса, как в строке 4. Необходимость этой строки связана с тем, что мы не программируем обработку этого события от начала и до конца, а хотим воспользоваться унаследованными аспектами поведения базового класса. В строках 5-6 предотвращается ввод нечисловых данных типа 32Skiddoo. В строках 9-12 из текстового поля удаляются дробные числа; при помощи встроенной функции Round программа убеждается в том, что округленное число совпадает с исходным. Следует заметить, что простое уничтожение введенного текста выглядит несколько жестоко по отношению к пользователю. В более изощренной программе следовало бы сохранить предыдущий текст, чтобы восстановить его при необходимости. В этом случае одна ошибка ввода не будет приводить к полной потере введенных данных.
На этой стадии приведенный выше фрагмент можно откомпилировать в DLL и получить вполне работоспособный элемент. Чтобы протестировать элемент после компиляции, создайте новое приложение Windows и поместите элемент на панель элементов:
- Выполните команду Tools
> Customize Toolbox (или нажмите Ctrl+T).
- Перейдите на вкладку
.NET Framework Components.
- Нажмите кнопку Browse
и выберите DLL нужнопа^лемента (библиотека находится в подкаталоге \bin основного
каталога решения).
Рис.
8.16. Нестандартный элемент на вкладке .NET Framework Components
Рис.
8.17. Нестандартный элемент на панели элементов
Добавить поддержку нового события в элемент ничуть не сложнее, чем включить обработчик события в класс (эта тема рассматривалась в главе 6). Предположим, каждый раз, когда пользователь вводит нечто отличное от положительного целого числа, элемент должен инициировать событие BadDataEntered. Новый код класса выделен жирным шрифтом:
Public Class PositivelntegerTextBox Inherits System.Windows.Forms.TextBox Public Event BadDataEntered(ByVal Sender As Object, _ ByVal e As EventArgs)
Protected Overrides Sub OnTextChanged(ByVal e As EventArgs) MyBase.OnTextChanged(e)
If Not (IsNumeric(Me.Text)) Then Me.Text = String.Empty
RaiseEvent BadDataEntered(Me. New System.EventArgs()) Else
Dim temp As Decimal temp = CType(Me.Text,Decimal) If temp = Math.Round(temp.0) <> 0 Then Me.Text = String.Empty
RaiseEvent BadDataEntered(Me, New System.EventArgs()) End If End If End Sub End Class
В элементах VB существует понятие события по умолчанию (default event). Событие по умолчанию срабатывает автоматически при двойном щелчке на экземпляре элемента в дизайнере форм. Событие по умолчанию задается при помощи специального атрибута. Атрибуты соответствуют экземплярам класса System.Attribute; атрибут Def aul tEvent входит в пространство имен System. ComponentModel. В программе атрибуты заключаются в угловые скобки, а при установке атрибута Defaul tEvent указывается имя события в кавычках. Чтобы назначить событие BadDataEntered событием по умолчанию для данного элемента, приведите начало класса к следующему виду:
Imports System.ComponentModel <DefaultEvent("BadDataEntered")> Public Class _
PositivelntegerTextBox Inherits System.Windows.Forms.TextBox
Добавление новых свойств
На следующем шаге класс будет дополнен свойствами MinValue и MaxValue. Программная реализация этих свойств выглядит весьма прямолинейно. При создании экземпляра переменным присваиваются значения 1 и максимальное значение типа Long соответственно. В дальнейшем необходимо проследить за тем, чтобы свойство MinValue не оказалось меньше 1, а свойство MaxVal ue не превышало предельной величины:
Private m_Min As Long = 1 Private m_Max As Long = Long.MaxValue Public Property MinValue()As Long Get
Return m_Min End Get SetCByVal Value As Long)
m_Min = Math.Maxd,Value) End Set End Property
Public Property MaxValue()As Long Get
Return m_Max End Get Set(ByVal Value As Long)
m_Max =Math.Min(m_Min.Value) End Set End Property
Если включить этот код в проект и откомпилировать его, свойство будет поддерживаться элементом, но не будет отображаться в окне свойств. Проблема решается установкой атрибута Browsable для имени свойства:
<Browsable(True)> Public Property MinValue
Примерный вид окна свойств при установке атрибута Browsable для свойств MinValue и MaxValue показан на рис. 8.18.
Рис.
8.18. Свойства MaxValue и MinValue в окне свойств
Чтобы свойство не отображалось в окне свойств, достаточно установить для него атрибут <Browsable(False)>. Запрет может устанавливаться как для новых, так и для переопределяемых свойств. Например, следующий фрагмент убирает стандартное свойство Text специализированного текстового поля из окна свойств:
<Browsable(False)> Public Overrides Property Text() As String Get
Return MyBase.Text End Get Set(ByVal Value As String)
MyBase.Text = Value End Set End Property
Как видно из рис. 8.19, свойство Text перестает отображаться в окне свойств.
Рис.
8.19. При установке атрибута Browsable свойство Text не отображается
Иерархия
пространства имен System.Windows.Forms
Диаграмма выглядит весьма устрашающе, но мы уделим основное внимание главной линии наследования:
System.ComponentModel .Component > Control
Из рис. 8.20 видно, что классы форм и элементов являются производными от класса Control. Например, генеалогия класса Form выглядит так:
ScrollableControl
>ContainerControl > Form
Рис.
8.20. Иерархия классов пространства имен Windows.Forms
Control
> TextBoxBase > RichTextBox > TextBox
Иерархия основных разновидностей кнопочных элементов выглядит так:
Control
> ButtonBase > Button
> CheckBox
> RadioButton
Класс Control вмещает в себя наибольшее количество функций (более 300) и обладает наибольшими функциональными возможностями. Классы форм и элементов объявляются производными от членов класса Control.
Класс Component является базовым классом для всех компонентов пространства имен System. Wi ndows. Forms. В нем собраны члены, необходимые для реализации включения (в частности, размещения элементов на форме или дочерних окон MDI в родительском окне MDI). В основном они реализованы в виде методов интерфейса IComponent. Поскольку класс Component также занимается освобождением ресурсов, расходуемых при визуальной разработке, он реализует IDisposable.
Поскольку класс Control является базовым для элементов и форм, он поддерживает многие операции пользовательского интерфейса, в том числе обработку событий клавиатуры и мыши. Кроме того, он определяет цвет, позицию и размер формы или элемента.
Использование средств базового класса Control (и в частности, обработка ключевых событий) рассматривается в следующем разделе. Тем не менее сначала мы продолжим путь к формам в иерархии классов System. Windows. Forms. Поскольку среди предков класса Form числится ScrollableControl, формы VB обладают полезной особенностью, которую оценит каждый, кто пытался реализовать форму с прокруткой в VB6:
При выходе за грашцы текущего содержимого форма автоматически прокручивается. Взгляните на рис. 8.21 — на нем изображена форма, позволяющая прокручивать очень большую фрактальную картинку (более 5 Мбайт в запакованном виде!) с базовым множеством Мандельброта. За информацией о множестве Мандельброта обращайтесь по адресу www.olympus.net/personal/dewey/mandelbrot.html.
Прокрутку форм можно протестировать на любом изображении достаточно больших размеров:
- Разместите на форме
графическое поле и задайте его свойству SizeMode значение AutoSize.
- Найдите большой
графический файл.
Рис.
8.21. Прокрутка изображения базового множество Мандельброта
- Приведите процедуру
Form_Load к следующему виду:
2 Me.AutoScroll = True
3 Me.VScroll = True
4 Me.HScroll = True
5 Dim aBigBox As Rectangle = Rectangle.Inflate _
6 (Me.ClientRectangle. 6. 6)
7 PictureBoxl.Bounds = aBigBox
8 ' Предполагается, что графический файл находится в подкаталоге \bin
9 PictureBoxl.Image = Image.FromFile("Mandelbrot Set.bmp")
10 End Sub
Главное место в этом листинге занимает строка 2, в которой свойству AutoScrol 1, определяемому в классе Scrollabl e Control, задается значение True. Без этого прокрутка работать не будет. Строки 3 и 4 указывают на то, что в окне должны отображаться обе полосы прокрутки (вертикальная и горизонтальная). В строке 5 общий метод класса System.Drawing.Rectangle создает прямоугольный объект, в 6 раз больший клиентской области формы. Строка 7 приводит графическое поле к заданному размеру, присваивая прямоугольник свойству Bounds, присутствующему во всех элементах. Как указано в комментарии, строка 9 предполагает, что файл с растровым изображением находится в подкаталоге \bin каталога решения — в реальной программе для определения местонахождения файла следовало бы вызвать диалоговое окно Open File.
Средства
базового класса Control
События клавиатуры
Три события клавиатуры инициируются в тех же ситуациях, что и их аналоги из прежних версий VB.
- KeyPress: происходит
при нажатии клавиши, когда элемент обладает фокусом.
- KeyDown: происходит
при переходе клавиши в нажатое состояние, когда элемент обладает фокусом.
- Key Up: происходит
при отпускании клавиши, когда элемент обладает фокусом.
Private Sub TextBoxl_KeyPress(ByVal sender As Object._ ByVal e As System.Windows.Forms.KeyPressEventArgs) Handles TextBoxl.KeyPress
If e.KeyChar < "0" Or e.KeyChar > "9" Then MsgBox("only digits allowed")
End If End Sub
События KeyDown и KeyUp, как и в VB6, могут использоваться для проверки клавиш-модификаторов (таких, как Ctrl и Alt). Класс KeyEventArgs, передаваемый этим событиям, обладает несколько большими возможностями, чем класс KeyPressEventArgs события KeyPress. Класс KeyEventArgs содержит свойство KeyData, в котором при помощи перечисляемого типа Key передается полная информация о комбинациях клавиш и о состоянии клавиш-модификаторов в момент нажатия. Свойства Modi f i ers и Shi ft позволяют узнать об одновременном нажатии трех клавиш (Alt+ +Shift+другая клавиша). Например, следующая команда проверяет, была ли нажата клавиша-модификатор Alt: If e.Modifiers =Keys.Alt Then
К сожалению, значения свойств KeyChar и KeyData нельзя сбросить, поскольку они доступны только для чтения [ Возможно, этот недочет будет исправлен в окончательной версии. ]. Впрочем, введенный символ можно «поглотить» и тем самым предотвратить его появление в элементе; для этого свойству Handled объекта события задается значение True. Пример:
If e.KeyChar < "0" Or e.KeyChar >"9" Then
e.Handled = True End If
В результате неверный символ не появится в текстовой поле.
В .NET вместо одного события проверки существуют целых два: Validating и Validated. Событие Validating инициируется перед утратой фокуса элементом. Например, следующий фрагмент гарантирует, что пользователь не оставит текстовое поле пустым:
Public Sub TextBoxl_Validating(ByVa1 sender As Object.
ByVal e As System.ComponentModel.CancelEventArgs)
Handles TextBoxl.Validating
' Если текстовое поле не содержит символов, отменить передачу фокуса If TextBoxl.Text.Trim = String.Empty Then e.Cancel = True
End Sub
Команда e.Cancel = True отменяет передачу фокуса от текстового поля другому элементу, если в поле нет ни одного символа.
С другой стороны, событие Val idated инициируется после утраты фокуса элементом, но до передачи его другому элементу. Таким образом, в обработчике события Validated можно обновить состояние других элементов формы.
Графическое программирование в .NET Framework полностью отличается от всего, что было реализовано в прежних версиях VB. Знакомые графические команды (частично позаимствованные еще из QuickBasic) исчезли. Из числа принципиальных изменений также следует обратить внимание на отсутствие свойства AutoRedraw или его аналогов. В прежних версиях VB свойство AutoRedraw, равное True, избавляло программиста от необходимости программировать процедуру события Pal nt для того, чтобы обеспечить восстановление графического изображения в элементе.
Программирование графики в VB .NET основано на концепции графического контекста — отдаленного родственника контекстов устройств Windows GDI. Любопытная подробность: новая система называется GDI+, хотя с GDI она имеет очень мало общего.
Классы GDI+ находятся в пространствах имен System.Drawing, System.Drawing. Drawing2D, System. Drawing. Imagi ng и System. Drawing. Text [ Каждое из этих пространств имен заслуживает отдельной книги, и здесь мы ограничимся лишь кратким упоминанием. ]. Эти пространства имен входят в сборку System.Drawing, ссылка на которую создается автоматически при выборе типа приложения Windows Application в диалоговом окне New Project.
Большая часть графического вывода в GDI+ осуществляется переопределением процедуры [ Это не событие, хотя в конечном счете перерисовка и приводит к |ызову события OnPaint базового класса Form. ]OnPaint формы или элемента. Процедура OnPaint играет столь же важную роль, как и в прежних версиях VB: она обеспечивает восстановление изображения при временном скрытии или свертывании формы. Сигнатура этой важной процедуры выглядит следующим образом: Protected Overrides Sub OnPaint(ByVal e As PaintEventArgs)
Вывод осуществляется на графической поверхности GDI+, представленной экземпляром класса Graphics. Процедура OnPaint класса Form инкапсулирует такую поверхность в виде значения свойства e.Graphics.
Рассмотрим очень простой пример графического вывода. Следующая программа выводит растровый файл sample.bmp (находящийся в каталоге \bin решения) в левом верхнем углу формы:
Protected Overrides Sub OnPaint(ByVal e As PaintEventArgs)
MyBase.OnPaint(e)
Dim g As Graphics
g = e.Graphics()
g.Draw!mage(New Bitmap("sample.bmp"). 0. 0)
g.Dispose() End Sub
Обратите внимание на вызов Dispose в строке, выделенной жирным шрифтом. Поскольку сборщик мусора не освобождает графические контексты, привыкайте делать это самостоятельно в конце процедуры Paint.
Напоминаем: если объект поддерживает метод Dispose, этот метод следует вызвать по завершении работы с объектом.
Следующий этап — рисование линий, прямоугольников и других фигур. Перед операциями такого рода следует получить объект пера, который является экземпляром класса System.Drawing.Pen. Самый распространенный конструктор класса Реп имеет следующий синтаксис:
Public Sub New(Color.Single)
Первый параметр определяет цвет пера (и входит в перечисляемый тип System. DrawingColor), а второй определяет толщину пера (другие конструкторы также позволяют задать кисть для заполнения внутренней части объекта). Например, чтобы нарисовать прямоугольник, вы определяете его размеры и вызываете g. DrawRectangle. Результат выполнения следующей программы показан на рис. 8.22:
Protected Overrides Sub OnPaint(ByVa1 e As PaintEventArgs)
MyBase.OnPaint(e)
Dim g As Graphics
g = e.Graphics()
Dim myPen As New PerKColor,Purple. 6)
Dim aRectangle As New Rectangle(Me.ClientRectangle.Width \4,_
Me.ClientRectangle.Height \ 4. . Me.ClientRectangle.Height \2,_
Me.ClientRectangle.Width \ 2))
g.DrawRectangle(myPen,aRectangle)
g.Dispose() End Sub
Рис.
8.22. Результат вызова DrawRectangle: прямоугольник в рамке толщиной
6 пикселов
Метод DrawString объекта Graphics предназначен для вывода текста. При вызове этого метода задается объект шрифта, цвет, кисть и начальная точка вывода. Например, следующий фрагмент выводит текст «Hello World» — в современных книгах по программированию это превратилось в традицию. При выводе используется текущий шрифт формы, текст выводится фиолетовой кистью на белом фоне:
Protected Overrides Sub OnPaint(ByVal e As _ System.Wi ndows.Forms.PaintEventArgs)
MyBase.OnPaint(e)
Dim g As Graphics = e.Graphics
Dim theColor As Color = Color.Purple
Dim theFont As New Font("Arial", 22._ FontStyle.Bold Or FontStyle.Italic)
Me.BackColor = Col or.White
g.DrawString("Hello World!". theFont.New SolidBrush(theColor). 0, 0)
g.Dispose() End Sub
Рис.
8.23. Вывод текста «Hello World!» средствами GDI+
Пример: вывод всех шрифтов в системе
Для демонстрации вывода текста была написана программа, которая воспроизводит в графическом поле все установленные шрифты с указанием имен (попутно мы столкнулись с проблемой, описанной в конце раздела). Программа состоит из нестандартного элемента и формы с прокруткой (рис. 8.24).
Рис.
8.24. Вывод списка установленных шрифтов в форме с прокруткой
For Each aFontFamily In TheFonts.Families
If aFontFamily.IsStyleAvailable(FontStyle.Regular) Then
Мы решили оформить программу в виде специализированного графического поля (элемент PictureBox), которое размещается на форме при загрузке. При этом на форме также включаются обе полосы прокрутки:
Private Sub Form1_Load(ByVal sender As System.Object._ ByVal e As System. EventArgs)Hand.les MyBase.Load
Me.VScroll = True
Me.HScroll = True
Me.AutoScroll = True
FontPictureBoxl.Left = 0
FontPictureBoxl.Top = 0 End Sub
Ниже приведен полный код специализированного графического поля:
1 Public Class FontPictureBox
2 Inherits System.Windows.Forms.PictureBox
3 Protected Overrides Sub OnPaint(ByVal pe As _ System.Windows.Forms.PaintEventArgs)
4 ' Всегда вызывайте Mybase.OnPaint!
5 MyBase.OnPaint(pe)
6 DisplayFonts(pe.Graphics)
7 End Sub
8 Private Sub OisplayFonts(ByVal g As Graphics)
9 ' HE РАБОТАЕТ: Dim g As Graphics = Me.CreateGraphics()
10 Dim aFontFamily As FontFamily
11 Dim curx.curY As Single
12 Dim TheFonts As System.Drawing.Text.FontCollection
13 Dim tempFont As Font
14 Dim spacing As Integer = 2 ' Вывод с интервалом 2 пиксела
15 TheFonts =New System.Drawing.Text.InstalledFontCollection()
16 For Each aFontFamily In TheFonts.Families
17 Me.Height += 2
18 If aFontFamily.IsStyleAvailable(FontStyle.Regular) Then
19 tempFont =New Font(aFontFamily. 14. FontStyle.Regular)
20 Elself aFontFamily.IsStyleAvailable(FontStyle.Bold) Then
21 tempFont =New Font(aFontFamily, 14. FontStyle.Bold)
22 Elself aFontFamily.IsStyleAvailable(FontStyle.Italic) Then
23 tempFont =New Font(aFontFamily, 14. FontStyle.Italic)
24 End If
25 g.DrawString("Thls is displayed in " & aFontFamily.Name._
26 tempFont. Brushes.Black, curx, curY)
27 DimtheSizeAs SizeF = g.MeasureString("This text is displayed in "_
28 & aFontFamily.Name. tempFont)
29 curY = curY + theSize.Height + spacing
30 Me.Height = Me.Height + CIntCtheSize.Height) + spacing
31 Me.Width = Math.Max(CInt(theSize.Width). Me.Width)
32 Next
33 End Sub
34 End Class
Обратите внимание: в строке 6 функции Displayfonts, определяемой в строках 8-33, передается текущий графический контекст — вместо того, чтобы создавать новый графический контекст вызовом Me.CreateGraphics(). В исходной версии эта вспомогательная процедура получала собственный контекст вместо использования контекста ре.Graphics, переданного в объекте PaintEventArgs. По каким-то загадочным причинам такое решение не работало. Закомментированный вызов Me. CreateGraphics0 остался в строке 9; при желании снимите комментарий и посмотрите, к чему это приведет.
При выводе текста необходимо знать высоту каждой строки. Высота вычисляется
в строках 27 и 28 очень полезной функцией MeasureString: Public Function MeasureString(String.Font) As SizeF
Функция возвращает объект класса Si zeF — разновидность структуры Si ze, в которой вместо типа Integer используется тип Single. Поскольку класс SizeF содержит вещественные числа, в строках 30 и 31 преобразование осуществляется функцией CInt. В строке 30 происходит наращивание высоты графического поля, а строка 31 гарантирует, что ширина поля позволяет вместить самую длинную из выводимых строк. Проверка осуществляется методом Мах класса Math.
Печать в .NET — дело непростое, однако богатство возможностей окупает все хлопоты. В этом разделе мы подробно опишем процесс печати одной страницы (в основном на примере автоматически сгенерированного кода), а затем покажем, как напечатать несколько страниц. Также будет показано, как запрограммировать собственную процедуру печати с использованием делегата. Начнем с печати изображения, хранящегося в графическом поле.
Печать в конечном счете сводится к выводу информации в графическом контексте, но вместо экранного контекста используется контекст, ассоциированный с принтером или окном предварительного просмотра печати.
Как при выводе на принтер, так и при использовании поддержки предварительного просмотра (Print Preview) в .NET работа всегда начинается с создания объекта класса System. Drawl ng. Pri nti ng. Pri ntDocument. Для получения этого объекта можно применить один из следующих способов:
- Воспользоваться элементом
Pri ntDocument на панели элементов и положиться на автоматически сгенерированный
код или воспользоваться оператором New в конструкции вида
Dim aPrintDocument As New PrintDocument()
- Присвоить значение свойства
Document экземпляра класса объекту, объявленному с типом Pri ntDocument.
При использовании панели элементов на форме размещается элемент Pri ntDocument, не обладающий визуальным интерфейсом. При этом генерируется фрагмент следующего вида:
Friend WithEvents PrintDocumentl As System.Drawing.Printing.PrintDocument
Непосредственное создание экземпляра происходит в следующей строке, включенной в процедуруInitializeComponent: Me.PrintDocumentl = New
System.Drawing.Printing.PrintDocument()
- BeginPrint;
- PrintPage (при печати
нескольких страниц может инициироваться многократно);
- EndPrint.
Во втором параметре события Pri ntPage передается объект PagePri ntEventArgs. В этом объекте хранится много полезных данных, в том числе:
- Графический объект,
определяемый значением свойства Graphi cs. С этим объектом выполняются все
операции вывода, и его содержимое будет в итоге напечатано на принтере.
- Объект PageSetti ngs
содержит инструкции, относящиеся к печати страниц. Среди свойств этого объекта
— признак печати в альбомной (landscape) ориентации, разрешение принтера,
размеры полей и т. д.
Private Sub Buttonl_Click(ByVal sender As System.Object,_ ByVal e As System.EventArgs) Handles Buttonl.Click
PrintDocumentl.Print() End Sub
Метод Print вызывает событие PrintPage, поэтому на следующем этапе следует запрограммировать обработчик события PrintDocumentl_PrintPage, в котором и происходит непосредственная печать. Если обработчик был сгенерирован с помощью дизайнера, в заголовок автоматически включается соответствующая секция Handles:
1 Private Sub Pri ntDocumentl_PrintPage( ByVal sender As System.Object. ByVal e As System.Drawing.Printing.PrintPageEventArgs) Handles PrintDocument1.PrintPage
2 Dim g As Graphics
3 g = e.Graphics
4 g.DrawImageCPictureBoxl.Image. 0. 0)
5 g.Dispose()
6 e.HasMorePages = False
7 End Sub
При выполнении этого фрагмента изображение печатается на принтере по умолчанию (о том, как сменить принтер, будет рассказано в следующем разделе). Хотя наш пример относительно прост, каждая строка в нем играет важную роль и заслуживает объяснения. В строке 1 событие связывается с процедурой, имеющей правильную сигнатуру, не требуя от вас прямого использования делегата (см. главу 6).
В строке 3 мы получаем объект Graphics, представляющий поверхность вывода текущего принтера. Строка 4 выводит изображение начиная с левого верхнего угла. Вывод происходит на принтере, с которым связан графический контекст. Присутствие вызова D1 spose в строке 5 связано с тем, что графические контексты (как было сказано выше) не освобождаются сборщиком мусора. Строка 6 сообщает об отсутствии дальнейших страниц для печати.