How to: Create Graphics Objects for Drawing

Before you can draw lines and shapes, render text, or display and manipulate images with GDI+, you need to create a Graphics object. The Graphics object represents a GDI+ drawing surface, and is the object that is used to create graphical images.

There are two steps in working with graphics:

Creating a Graphics object.

Using the Graphics object to draw lines and shapes, render text, or display and manipulate images.

Creating a Graphics Object

A graphics object can be created in a variety of ways.

To create a graphics object

Receive a reference to a graphics object as part of the PaintEventArgs in the Paint event of a form or control. This is usually how you obtain a reference to a graphics object when creating painting code for a control. Similarly, you can also obtain a graphics object as a property of the PrintPageEventArgs when handling the PrintPage event for a PrintDocument.

Call the CreateGraphics method of a control or form to obtain a reference to a Graphics object that represents the drawing surface of that control or form. Use this method if you want to draw on a form or control that already exists.

Create a Graphics object from any object that inherits from Image. This approach is useful when you want to alter an already existing image.

The following sections give details about each of these processes.

PaintEventArgs in the Paint Event Handler

When programming the PaintEventHandler for controls or the PrintPage for a PrintDocument, a graphics object is provided as one of the properties of PaintEventArgs or PrintPageEventArgs.

To obtain a reference to a Graphics object from the PaintEventArgs in the Paint event

Declare the Graphics object.

Assign the variable to refer to the Graphics object passed as part of the PaintEventArgs.

Insert code to paint the form or control.

The following example shows how to reference a Graphics object from the PaintEventArgs in the Paint event:

CreateGraphics Method

You can also use the CreateGraphics method of a control or form to obtain a reference to a Graphics object that represents the drawing surface of that control or form.

To create a Graphics object with the CreateGraphics method

Call the CreateGraphics method of the form or control upon which you want to render graphics.

Create from an Image Object

Additionally, you can create a graphics object from any object that derives from the Image class.

To create a Graphics object from an Image

Call the Graphics.FromImage method, supplying the name of the Image variable from which you want to create a Graphics object.

The following example shows how to use a Bitmap object:

You can only create Graphics objects from nonindexed .bmp files, such as 16-bit, 24-bit, and 32-bit .bmp files. Each pixel of nonindexed .bmp files holds a color, in contrast to pixels of indexed .bmp files, which hold an index to a color table.

Drawing and Manipulating Shapes and Images

After it is created, a Graphics object may be used to draw lines and shapes, render text, or display and manipulate images. The principal objects that are used with the Graphics object are:

The Pen class—Used for drawing lines, outlining shapes, or rendering other geometric representations.

The Brush class—Used for filling areas of graphics, such as filled shapes, images, or text.

The Font class—Provides a description of what shapes to use when rendering text.

The Color structure—Represents the different colors to display.

To use the Graphics object you have created

Work with the appropriate object listed above to draw what you need.

For more information, see the following topics:

Управление состоянием объекта Graphics Managing the State of a Graphics Object

GraphicsКласс является ОСНОВОЙ GDI+. The Graphics class is at the heart of GDI+. Чтобы нарисовать что-либо, вы получаете Graphics объект, устанавливаете его свойства и вызываете его методы DrawLine ,, DrawImage DrawString и Like). To draw anything, you obtain a Graphics object, set its properties, and call its methods DrawLine, DrawImage, DrawString, and the like).

В следующем примере вызывается DrawRectangle метод Graphics объекта. The following example calls the DrawRectangle method of a Graphics object. Первым аргументом, передаваемым в DrawRectangle метод, является Pen объект. The first argument passed to the DrawRectangle method is a Pen object.

Состояние графики Graphics State

GraphicsОбъект выполняет больше, чем предоставление методов рисования, таких как DrawLine и DrawRectangle . A Graphics object does more than provide drawing methods, such as DrawLine and DrawRectangle. GraphicsОбъект также поддерживает состояние графики, которое можно разделить на следующие категории: A Graphics object also maintains graphics state, which can be divided into the following categories:

Параметры качества Quality settings

Область обрезки Clipping region

Параметры качества Quality Settings

GraphicsОбъект имеет несколько свойств, влияющих на качество отображаемых элементов. A Graphics object has several properties that influence the quality of the items that are drawn. Например, можно задать TextRenderingHint свойство, чтобы указать тип сглаживания (при его наличии), применяемый к тексту. For example, you can set the TextRenderingHint property to specify the type of antialiasing (if any) applied to text. Другими свойствами, влияющими на качество SmoothingMode , являются,, CompositingMode CompositingQuality и InterpolationMode . Other properties that influence quality are SmoothingMode, CompositingMode, CompositingQuality, and InterpolationMode.

В следующем примере рисуются два эллипса: один с режимом сглаживания, для которого задано значение AntiAlias , и один с режимом сглаживания HighSpeed . The following example draws two ellipses, one with the smoothing mode set to AntiAlias and one with the smoothing mode set to HighSpeed:

Преобразования Transformations

GraphicsОбъект поддерживает два преобразования («мир» и «страница»), которые применяются ко всем элементам, рисуемым этим Graphics объектом. A Graphics object maintains two transformations (world and page) that are applied to all items drawn by that Graphics object. Любое аффинное преобразование может храниться в мировом преобразовании. Any affine transformation can be stored in the world transformation. Аффинное преобразование включает масштабирование, вращение, отражение, наклон и преобразование. Affine transformations include scaling, rotating, reflecting, skewing, and translating. Преобразование «страница» можно использовать для масштабирования и для изменения единиц измерения (например, пикселей на дюймы). The page transformation can be used for scaling and for changing units (for example, pixels to inches). Дополнительные сведения см. в разделе системы координат и преобразования. For more information, see Coordinate Systems and Transformations.

В следующем примере устанавливаются преобразования мира и страницы Graphics объекта. The following example sets the world and page transformations of a Graphics object. Для универсального преобразования устанавливается поворот на 30 градусов. The world transformation is set to a 30-degree rotation. Преобразование «страница» задается таким образом, чтобы координаты, передаваемые во второй, DrawEllipse обрабатывались как миллиметры, а не пиксели. The page transformation is set so that the coordinates passed to the second DrawEllipse will be treated as millimeters instead of pixels. Код выполняет два идентичных вызова DrawEllipse метода. The code makes two identical calls to the DrawEllipse method. Преобразование «мир» применяется к первому DrawEllipse вызову, и оба преобразования (мир и страница) применяются ко второму DrawEllipse вызову. The world transformation is applied to the first DrawEllipse call, and both transformations (world and page) are applied to the second DrawEllipse call.

На следующем рисунке показаны два эллипса. The following illustration shows the two ellipses. Обратите внимание, что поворот на 30 градусов основан на происхождении системы координат (левый верхний угол клиентской области), а не на центрах эллипсов. Note that the 30-degree rotation is about the origin of the coordinate system (upper-left corner of the client area), not about the centers of the ellipses. Также обратите внимание, что ширина пера, равная 1, означает 1 пиксель для первого эллипса и 1 миллиметр для второго эллипса. Also note that the pen width of 1 means 1 pixel for the first ellipse and 1 millimeter for the second ellipse.

Область обрезки Clipping Region

GraphicsОбъект поддерживает область обрезки, которая применяется ко всем элементам, рисуемым этим Graphics объектом. A Graphics object maintains a clipping region that applies to all items drawn by that Graphics object. Можно задать отсеченную область, вызвав SetClip метод. You can set the clipping region by calling the SetClip method.

В следующем примере создается область в форме креста путем формирования объединения двух прямоугольников. The following example creates a plus-shaped region by forming the union of two rectangles. Этот регион назначается в качестве вырезанной области Graphics объекта. That region is designated as the clipping region of a Graphics object. Затем код выводит две строки, которые ограничены внутренней областью обрезки. Then the code draws two lines that are restricted to the interior of the clipping region.

На следующем рисунке показаны обрезанные строки: The following illustration shows the clipped lines:

Объекты Graphics и Drawing в Windows Forms Graphics and Drawing in Windows Forms

Среда CLR использует расширенную реализацию Windows интерфейс графических устройств (GDI) с именем GDI+. The common language runtime uses an advanced implementation of the Windows Graphics Device Interface (GDI) called GDI+. С помощью GDI+ можно создавать графики, рисовать текст и манипулировать графическими изображениями как объектами. With GDI+ you can create graphics, draw text, and manipulate graphical images as objects. Интерфейс GDI+ обеспечивает производительность и простоту использования. GDI+ is designed to offer performance and ease of use. GDI+ можно использовать для отрисовки графических изображений на Windows Forms и элементы управления. You can use GDI+ to render graphical images on Windows Forms and controls. Хотя вы не можете использовать GDI+ непосредственно в веб-формах, можно отображать графические изображения с помощью серверного веб-элемента управления Image. Although you cannot use GDI+ directly on Web Forms, you can display graphical images through the Image Web Server control.

В этом разделе вы найдете разделы, в которых представлены основные принципы программирования GDI+. In this section, you will find topics that introduce the fundamentals of GDI+ programming. Хотя он не является полным справочником, в нем содержатся сведения об объектах Graphics, Pen, Brush и Color и способах выполнения таких задач, как рисование фигур, создание текста, отображение рисунков. Although not intended to be a comprehensive reference, this section includes information about the Graphics, Pen, Brush, and Color objects, and explains how to perform such tasks as drawing shapes, drawing text, or displaying images. Дополнительные сведения см. в справочнике по GDI+. For more information, see GDI+ Reference.

Если вы хотите немедленно приступить к работе, см. статью Приступая к программированию графики. If you’d like to jump in and get started right away, see Getting Started with Graphics Programming. Она содержит разделы, посвященные использованию кода для рисования линий, фигур, текста и других элементов в формах Windows Forms. It has topics on how to use code to draw lines, shapes, text, and more on Windows forms.

в этом разделе In This Section

Общие сведения о графике Graphics Overview
Общие сведения об управляемых классах, связанных с графикой. Provides an introduction to the graphics-related managed classes.

Управляемый код GDI+ About GDI+ Managed Code
Предоставляет сведения об управляемых классах GDI+. Provides information about the managed GDI+ classes.

Использование управляемых графических классов Using Managed Graphics Classes
Демонстрирует выполнение различных задач с помощью управляемых классов GDI+. Demonstrates how to complete a variety of tasks using the GDI+ managed classes.

Справочник Reference

System.Drawing
Предоставляет доступ к основным графическим функциям GDI+. Provides access to GDI+ basic graphics functionality.

System.Drawing.Drawing2D
Расширенные функциональные возможности для создания двухмерной и векторной графики. Provides advanced two-dimensional and vector graphics functionality.

System.Drawing.Imaging
Предоставляет расширенные графические функции GDI+. Provides advanced GDI+ imaging functionality.

System.Drawing.Text
Предоставляет расширенный набор типографических функций GDI+. Provides advanced GDI+ typography functionality. Классы в этом пространстве имен позволяют создавать и использовать коллекции шрифтов. The classes in this namespace can be used to create and use collections of fonts.

System.Drawing.Printing
Функции печати. Provides printing functionality.

Связанные разделы Related Sections

Рисование и отрисовка пользовательского элемента управления Custom Control Painting and Rendering
Подробные сведения о способах написания кода для рисования элементов управления. Details how to provide code for painting controls.

Структура интерфейса Graphics Structure of the Graphics Interface

Интерфейс управляемого класса для GDI+ содержит около 60 классов, перечислений 50 и 8 структур. The managed class interface to GDI+ contains about 60 classes, 50 enumerations, and 8 structures. GraphicsКласс является основой функциональности GDI+. это класс, который фактически рисует линии, кривые, цифры, изображения и текст. The Graphics class is at the core of GDI+ functionality; it is the class that actually draws lines, curves, figures, images, and text.

Важные классы Important Classes

Многие классы работают вместе с Graphics классом. Many classes work together with the Graphics class. Например, DrawLine метод получает Pen объект, который содержит атрибуты (цвет, ширина, тип штриха и т. д.) рисуемой линии. For example, the DrawLine method receives a Pen object, which holds attributes (color, width, dash style, and the like) of the line to be drawn. FillRectangleМетод может получить указатель на LinearGradientBrush объект, который работает с Graphics объектом для заполнения прямоугольника с постепенно изменяющимся цветом. The FillRectangle method can receive a pointer to a LinearGradientBrush object, which works with the Graphics object to fill a rectangle with a gradually changing color. FontStringFormatобъекты и влияют на способ, которым Graphics объект рисует текст. Font and StringFormat objects influence the way a Graphics object draws text. MatrixОбъект хранит и манипулирует универсальным преобразованием Graphics объекта, которое используется для вращения, масштабирования и отражения изображений. A Matrix object stores and manipulates the world transformation of a Graphics object, which is used to rotate, scale, and flip images.

GDI+ предоставляет несколько структур (например,, Rectangle Point и Size ) для Организации графических данных. GDI+ provides several structures (for example, Rectangle, Point, and Size) for organizing graphics data. Кроме того, некоторые классы служат в основном как структурированные типы данных. Also, certain classes serve primarily as structured data types. Например, BitmapData класс является вспомогательным классом для Bitmap класса, а PathData класс — вспомогательным классом для GraphicsPath класса. For example, the BitmapData class is a helper for the Bitmap class, and the PathData class is a helper for the GraphicsPath class.

GDI+ определяет несколько перечислений, которые представляют собой коллекции связанных констант. GDI+ defines several enumerations, which are collections of related constants. Например, LineJoin перечисление содержит элементы, Bevel Miter и Round , которые указывают стили, которые можно использовать для объединения двух строк. For example, the LineJoin enumeration contains the elements Bevel, Miter, and Round, which specify styles that can be used to join two lines.