ЯЗЫК ПРОГРАММИРОВАНИЯ С# 2005 И ПЛАТФОРМА .NET 2.0. 3-е издание

Замечание. В .NET 2.0 пространство имен System.Drawing предлагает тип BufferedGraphics, который позволяет отображать графику, используя систему двойной буферизации, чтобы ослабить или исключить возможное мерцание, происходящее при визуализации данных. Подробная информация об этом есть в документации .NET Framework 2.0 SDK.

Обращаем ваше внимание на то, что класс Graphics не допускает непосредственного создания своего экземпляра с помощью ключевого слова new, поскольку этот класс не имеет открытых конструкторов. Но тогда как получить объект Graphics? Я рад, что вы спросили об этом.

Сеансы Paint

Наиболее общий способ получения объекта Graphics заключается во взаимодействии с событием Paint. Вспомните из предыдущей главы о том, что класс Control определяет виртуальный метод с именем OnPaint. Чтобы форма отображала графические данные на своей поверхности, вы можете переопределить этот метод и извлечь объект Graphics из входного параметра PaintEventArgs. Для примера создайте новое приложение Windows Forms с именем BasicPaintForm и обновите полученный класс Form так, как предлагается ниже.

public partial class MainForm: Form {
 public MainForm {
 InitializeComponent;
 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;