CenterToScreen();
this.Text = "Basic Paint Form";
}
protected override void OnPaint(PaintEventArgs e) {
// При переопределении OnPaint() не забудьте вызвать
// реализацию базового класса.
base.OnPaint(e);
// Получение объекта Graphics из поступившего на вход
// PaintEventArgs.
Graphics g = e.Graphics;
// Визуализация текстового сообщения с заданными
// цветом и шрифтом.
g.DrawString("Привет GDI + ", new Font("Times New Roman", 20), Brushes. Green, 0, 0);
}
}
Но, хотя переопределение OnPaint() и допустимо, более типичным подходом является обработка события Paint с помощью связанного делегата PaintEventHandler (именно это делается по умолчанию в Visual Studio 2005 при обработке событий с помощью окна свойств). Данный делегат может указывать на любой метод, получающий в качестве первого параметра System.Object, а в качестве второго – PaintEventArgs. В предположении о том, что вы обработали событие Paint (с помощью инструментов режима проектирования Visual Studio 2005 или в программном коде вручную), вы снова можете извлечь объект Graphics из поступающего на вход PaintEventArgs. Вот соответствующим образом модифицированный программный код.
public partial class MainForm: Form {
public MainForm() {
InitializeComponent();
CenterToScreen();
this.Text = "Basic Paint Form";
// В Visual Studio 2005 поместите этот программный код
// в InitializeComponent().
this.Paint += new PaintEventHandler(MainForm_Paint);
}
private void MainForm_Paint(object sender, PaintEventArgs e) {
Graphics g = e.Graphics;
g.DrawString("Привет GDI+", new Font("Times New Roman", 20), Brushes.Green, 0, 0);
}
}
Независимо от того, как вы отвечаете на событие Paint, следует знать, что событие Раint генерируется всегда, когда окно становится "грязным". Вы, возможно, знаете, что окно считается "грязным", если переопределяется его размер, окно (или его часть) открывается из-под другого окна, или окно сначала минимизируется, а затем восстанавливается. Во все случаях, когда требуется перерисовка формы, платформа .NET гарантирует, что обработчик события Paint (или переопределенный метод OnPaint() будет вызван автоматичеcки.
Обновление области клиента формы
В ходе выполнения приложения GDI+ может возникнуть необходимость в явном вызове события Paint вместо ожидания того, что окно станет "естественно грязным". Например, вы создаете программу, которая позволяет пользователю выбрать подходящий рисунок из набора точечных изображений в пользовательском диалоговом окне. После закрытия диалогового окна нужна отобразить выбранный пользователем рисунок в области клиента формж. Очевидно, если ждать, когда окно станет "естественно грязным", пользователь не увидит изменений до того, как изменятся размеры окна или его часть откроется из-под другого окна. Чтобы вызвать перерисовку окна программно, просто вызовите наследуемый метод Invalidate().
public partial class MainForm: Form {
…
private void MainForm_Paint(object sender, PaintEventArgs e) {
Graphics g = e.Graphics;
// Здесь выполняется визуализация изображения.
}
private void GetNewBitmap() {
// Отображение диалогового окна и получение нового образа.
// Перерисовка клиентской области.
Invalidate();
}
}
Метод Invalidate() является перегруженным, чтобы вы могли указать прямоугольную область для перерисовки, а не перерисовывать все области клиента (что делается до умолчанию). Чтобы обновить только заданный прямоугольник слева вверху области клиента, вы можете использовать следующее.
// Перерисовка прямоугольной части формы.
private void UpdateUpperArea() {
Rectangle myRect = new Rectangle(0, 0, 75, 150);
Invalidate(myRect);
}
Доступ к объекту Graphics вне обработчика Paint
В некоторых редких случаях может понадобиться доступ к объекту Graphics вне контекста обработчика события Paint. Предположим, например, что нужно перерисовать небольшой круг с центром в точке (х, у), где был выполнен щелчок кнопки мыши. Чтобы получить действительный объект Graphics в рамках контекста обработчика событий MouseDown, можно, например, вызвать статический метод Graphics.FromHwnd(). Имея опыт использования Win32, вы можете знать, что HWND является структурой данных, представляющей окно Win32. В рамках платформы .NET наследуемое свойство Handle извлекает соответствующую структуру HWND, которую затем можно использовать в качестве параметра для Graphics. FromHwnd().
private void MainForm_MouseDown(object sender, MouseEventArgs e) {
// Получение объекта Graphics через Hwnd.
Graphics g = Graphics.FromHwnd(this.Handle);
// Рисование круга 10*10 по щелчку мыши.
g.FillEllipse(Brushes.Firebrick, e.X, e.Y, 10, 10);
// Освобождение объектов Graphic, созданных напрямую.
g.Dispose();
}
Эта логика отображает круг за пределами обработчика OnPaint(), но очень важно понимать, что когда выполняется обновление формы, все такие круги стираются! Это разумно, поскольку соответствующая визуализация выполнялась в контексте события MouseDown. Значительно лучшим подходом Является создание в обработчике события MouseDown нового типа Point, который добавляется к некоторой внутренней коллекции (например, List‹T›), и только затем вызывается Invalidate(). Тогда обработчик события Раint может просто "пройти" по коллекции и перерисовать каждый Point.
public partial class MainForm: Form {
// Используется для хранения всех Point.
private List‹Point› myPts = new List‹Point›();
publiс MainForm() {
…
this.MouseDown += new MouseEventHandler(MainForm_MouseDown);
}
private void MainForm_MouseDown(object sender, MouseEventArgs e) {
// Добавление в коллекцию.
myPts.Add(new Point(e.X, e.Y));
Invalidate();
}
private void MainForm_Paint(object sender, PaintEventArgs e) {
Graphics g = e.Graphics;
g.DrawString("Привет GDI+", new Font("Times New Roman", 20), new SolidBrush(Color.Black), 0, 0);
foreach(Point p in myPts) g.FillEllipse(Brushes.Firebrick, p.X, p.Y, 10, 10);
}
}
При таком подходе уже отображенные круги будут оставаться на месте, поскольку графическая визуализация обрабатывается в рамках события Paint. На рис. 20.1 показано окно тестового запуска этого приложения.
Рис 20.1. Простое графическое приложение
Исходный код. Проект BasiсPaintForm размещен в подкаталоге, соответствующем главе 20.
Освобождение объекта Graphics
Если вы внимательно читали несколько последних страниц, то могли заметить, что в некоторых примерах программного кода непосредственно вызывается метод Dispose() объекта Graphics, тогда как в других примерах этого не делается. Поскольку тип Graphics работает с самыми разными неуправляемыми ресурсами, имеет смысл освободить указанные ресурсы как можно быстрее с помощью Dispose() (не дожидаясь, когда это сделает сборщик мусора в процессе финализации). То же самое можно сказать о любом типе, поддерживающем интерфейс IDisposable. При работе с объектами Graphics нужно придерживаться следующих правил.
• Если объект Graphics был создан вами непосредственно, после окончания его использования его следует освободить.
• Если вы ссылаетесь на существующий объект Graphics, его освобождать не следует.
Для того чтобы это стало более понятным, рассмотрите следующий обработчик события Paint.
private void MainForm Paint(object sender, PaintEventArgs e) {
// Загрузка локального файла *.jpg.
image myImageFile = Image.FromFile("landscape.jpg");
// Создание нового объекта Graphics на основе изображения.
Graphics imgGraphics = Graphics.FromImage(myImageFile);
// Визуализация новых данных.
imgGraphics.FillEllipse(Brushes.DarkOrange, 50, 50, 150, 150);
// Нанесение изображения на форму.
Graphics g = e.Graphics;
g.DrawImage(myImageFile, new PointF(0.0F, 0.0F));
// Освобождение созданного нами объекта Graphics.
imgGraphics.Dispose();
}
На данном этапе обсуждения не беспокойтесь о том, что некоторые элементы программной логики GDI+ могут быть для вас не вполне понятны. Однако обратите внимание на то, что здесь объект Graphics получается из файла *.jpg, загружаемого (с помощью статического метода Graphics.FromImage()) из локального каталога приложения. Поскольку объект Graphics создается явно, после окончания использовании этого объекта лучше использовать Dispose(), чтобы освободить внутренние ресурсы и сделать их снова доступными для использования другими компонентами системы.
