Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

The following table shows the graphics display interface (GDI) functions.

Programming element Description

AlphaBlend

This function displays bitmaps that have transparent or semitransparent pixels.

BeginPaint

This function prepares the specified window for painting and fills a PAINTSTRUCTstructure with information about the painting.

BitBlt

This function transfers pixels from a specified source rectangle to a specified destination rectangle, altering the pixels according to the selected raster operation (ROP) code.

ChangeDisplaySettingsEx

This function changes the settings of the specified display device to the specified graphics mode.

ClientToScreen

This function converts the client coordinates of a specified point to screen coordinates.

CombineRgn

This function combines two regions and stores the result in a third region. The two regions are combined according to the specified mode.

CopyRect

This function copies the coordinates of one rectangle to another.

CreateBitmap

This function creates a bitmap with the specified width, height, and bit depth.

CreateCompatibleBitmap

This function creates a bitmap compatible with the device associated with the specified device context.

CreateCompatibleDC

This function creates a memory device context (DC) compatible with the specified device.

CreateDC

This function creates a DC for a device.

CreateDIBPatternBrushPt

This function creates a logical brush that has the pattern specified by the device-independent bitmap (DIB).

CreateDIBSection

This function creates a DIB that applications can write to directly.

CreatePalette

This function creates a logical color palette.

CreatePatternBrush

This function creates a logical brush with the specified bitmap pattern.

CreatePen

This function creates a logical pen that has the specified style, width, and color.

CreatePenIndirect

This function creates a logical cosmetic pen that has the style, width, and color specified in the LOGPENstructure.

CreateRectRgn

This function creates a rectangular region.

CreateRectRgnIndirect

This function creates a rectangular region.

CreateSolidBrush

This function creates a logical brush that has the specified solid color.

DeleteDC

This function deletes the specified DC.

DeleteObject

This function deletes a logical pen, brush, font, bitmap, region, or palette, freeing all system resources associated with the object.

DrawEdge

This function draws one or more edges of a rectangle.

DrawFocusRect

This function draws a rectangle in the style used to indicate that the rectangle has the focus.

DrawFrameControl

This function draws a frame control of the specified type and style.

Ellipse

This function draws an ellipse. The center of the ellipse is the center of the specified bounding rectangle.

EndPaint

This function marks the end of painting in the specified window.

EnumDisplayDevices

This function obtains information about the display devices in a system.

EnumDisplaySettings

This function retrieves information about one of the graphics modes for a display device.

EqualRect

This function determines whether the two specified rectangles are equal by comparing the coordinates of their upper-left and lower-right corners.

EqualRgn

This function checks the two specified regions to determine whether they are identical.

ExcludeClipRect

This function creates a new clipping region that consists of the existing clipping region minus the specified rectangle.

ExtCreateRegion

This function creates a region from the specified region data.

ExtEscape

This function allows applications to access capabilities of a particular device that are not available through the GDI.

FillRect

This function fills a rectangle using the specified brush.

FillRgn

This function fills a region using the specified brush.

GetBkColor

This function returns the current background color for the specified device context.

GetBkMode

This function returns the current background mix mode for a specified device context.

GetBValue

This macro retrieves an intensity value for the blue component of a 32-bit RGB value.

GetClipBox

This function retrieves the dimensions of the tightest bounding rectangle that can be drawn around the current visible area on the device.

GetClipRgn

This function retrieves a handle identifying the current application-defined clipping region for the specified device context.

GetCurrentObject

This function returns the currently selected object of the specified type.

GetCurrentPositionEx

This function retrieves the current position in logical coordinates.

GetDC

This function retrieves a handle to a display device context for the client area of the specified window.

GetDCEx

This function retrieves a handle to a display device context for the client area of a specified window or for the entire screen.

GetDeviceCaps

This function retrieves information about the capabilities of a specified device.

GetDIBColorTable

This function retrieves red, green, and blue color values from a range of entries in the color table of the DIB that is currently selected into a specified device context.

GetGValue

This macro retrieves an intensity value for the green component of a 32-bit RGB value.

GetLayout

This function returns the layout of a device context.

GetNearestColor

This function returns the system palette color that will be displayed when the specified color value is used.

GetNearestPaletteIndex

This function retrieves the index for the entry in the specified logical palette that most closely matches a specified color value.

GetObject

This function obtains information about a specified graphics object.

GetObjectType

This function returns the type of the specified object.

GetPaletteEntries

This function retrieves a specified range of palette entries from the specified logical palette.

GetPixel

This function retrieves the RGB color value of the pixel at the specified coordinates.

GetRegionData

This function fills the specified buffer with data describing a region.

GetRgnBox

This function retrieves the bounding rectangle of the specified region.

GetROP2

This function retrieves the foreground mix mode of the specified device context.

GetRValue

This macro retrieves an intensity value for the red component of a 32-bit RGB value.

GetStockObject

This function retrieves a handle to one of the predefined stock pens, brushes or fonts.

GetStretchBltMode

This function retrieves the current stretching mode.

GetSysColorBrush

This function retrieves a handle identifying a logical brush that corresponds to the specified color index.

GetSystemPaletteEntries

This function retrieves a range of palette entries from the system palette associated with the specified device context.

GetOutlineTextMetrics

This function retrieves text metrics for TrueType fonts.

GetUpdateRect

This function retrieves the coordinates of the smallest rectangle that completely encloses the update region of the specified window in client coordinates.

GetUpdateRgn

This function retrieves the update region of a window by copying it into the specified region.

GetViewportExtEx

This function retrieves the x-extent and y-extent of the current viewport for the specified device context.

GetViewportOrgEx

This function retrieves the x-coordinates and y-coordinates of the viewport origin for the specified device context.

GetWindowDC

This function retrieves the DC for the entire window, including title bar, menus, and scroll bars.

GetWindowExtEx

This function retrieves the x-extent and y-extent of the window for the specified device context.

GetWindowOrgEx

This function retrieves the x-coordinates and y-coordinates of the window origin for the specified device context.

GetWindowRgn

This function obtains a copy of the window region of a window.

GradientFill

This function fills rectangular regions with a background color that is interpolated from color values specified at the vertices.

InflateRect

This function increases or decreases the width and height of the specified rectangle.

IntersectClipRect

This function creates a new clipping region from the intersection of the current clipping region and the specified rectangle.

IntersectRect

This function calculates the intersection of two source rectangles and places the coordinates of the intersection rectangle into the destination rectangle.

InvalidateRect

This function adds a rectangle to the specified window's update region.

InvalidateRgn

This function invalidates the client area within the specified region by adding the area to the current update region of a window.

InvertRect

This function inverts a rectangle in a window by performing a logical NOT operation on the color values for each pixel in the rectangle's interior.

IsRectEmpty

This function determines whether the specified rectangle is empty.

LineTo

This function draws a line from the current position up to, but not including, the specified point.

LoadBitmap

This function loads the specified bitmap resource from the executable file for a module.

MapWindowPoints

This function converts, or maps, a set of points from a coordinate space relative to one window to a coordinate space relative to another window.

MaskBlt

This function combines the color data for the source and destination bitmaps using the specified mask and raster operation.

MoveToEx

This function updates the current position to the specified point and optionally retrieves the previous position.

OffsetRect

This function moves the specified rectangle by the specified offsets.

OffsetRgn

This function moves a region by the specified offsets.

OffsetViewportOrgEx

This function modifies the viewport origin for a device context using the specified horizontal and vertical offsets.

PatBlt

This function paints the given rectangle using the brush that is currently selected into the specified device context.

Polygon

This function draws a polygon consisting of two or more vertices connected by straight lines.

Polyline

This function draws a series of line segments by connecting the points in the specified array.

PtInRect

This function determines whether the specified point lies within the specified rectangle.

PtInRegion

This function determines whether the specified point is inside the specified region.

RealizePalette

This function maps palette entries from the current logical palette to the system palette.

Rectangle

This function draws a rectangle.

RectInRegion

This function determines whether any part of the specified rectangle is within the boundaries of a region.

RectVisible

This function determines whether any part of the specified rectangle lies within the clipping region of the specified device context.

RedrawWindow

This function updates the specified rectangle or region in the client area of a window.

ReleaseDC

This function releases a DC, freeing it for use by other applications.

RestoreDC

This function restores a DC to the specified state.

RoundRect

This function draws a rectangle with rounded corners.

SaveDC

This function saves the current state of the specified device context by copying data describing selected objects and graphic modes (such as the bitmap, brush, palette, font, pen, region, and drawing mode) to a context stack.

ScreenToClient

This function converts the screen coordinates of a specified point on the screen to client coordinates.

SelectClipRgn

This function selects a region as the current clipping region for the specified device context.

SelectObject

This function selects an object into a specified device context.

SelectPalette

This function selects the specified logical palette into a device context.

SetBitmapBits

This function sets the bits of color data for a bitmap to the specified values.

SetBkColor

This function sets the current background color to the specified color.

SetBkMode

This function sets the background mix mode of the specified device context.

SetBrushOrgEx

This function is called by an application to set the brush origin of the next brush selected into the specified device context.

SetDIBColorTable

This function sets red, green, and blue color values in a range of entries in the color table of the DIB that is currently selected into a specified device context.

SetDIBitsToDevice

This function sets the pixels in the specified rectangle on the device that is associated with the destination device context using color data from a DIB.

SetLayout

This function changes the layout of a device context.

SetPaletteEntries

This function sets RGB color values and flags in a range of entries in a logical palette.

SetPixel

This function sets the pixel at the specified coordinates to the specified color.

SetRect

This function sets the coordinates of the specified rectangle.

SetRectEmpty

This function creates an empty rectangle in which all coordinates are set to zero.

SetRectRgn

This function changes a region into a rectangular region with the specified coordinates.

SetROP2

This function sets the current foreground mix mode. GDI uses the foreground mix mode to combine pens and interiors of filled objects with the colors already on the screen.

SetStretchBltMode

This function sets the bitmap stretching mode in a specified device context.

SetViewportOrgEx

This function sets the viewpoint origin of a device context to the specified coordinates.

SetWindowOrgEx

This function specifies which window point maps to the viewport origin (0,0).

SetWindowRgn

This function sets the window region of a window.

StretchBlt

This function copies a bitmap from a source rectangle into a destination rectangle, stretching or compressing the bitmap to fit the dimensions of the destination rectangle, if necessary.

StretchDIBits

This function copies the color data for a rectangle of pixels in a DIB to the specified destination rectangle.

SubtractRect

This function obtains the coordinates of a rectangle determined by subtracting one rectangle from another.

TransparentBlt

This function performs a bit-block transfer of the color data corresponding to a rectangle of pixels from the specified source device context into a destination device context.

TransparentImage

This function transfers a bitmap, omitting the portions drawn in a specified color.

UnionRect

This function creates the union of two rectangles.

UpdateWindow

This function updates the client area of the specified window by sending a WM_PAINTmessage to the window if the window's update region is not empty.

ValidateRect

This function validates the client area within a rectangle by removing the rectangle from the update region of the specified window.

ValidateRgn

This function validates the client area within a region by removing the region from the current update region of the specified window.

See Also

Reference

GDI Reference