Export (0) Print
Expand All

BufferedGraphicsContext Class

Provides methods for creating graphics buffers that can be used for double buffering.

System.Object
  System.Drawing.BufferedGraphicsContext

Namespace:  System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public sealed class BufferedGraphicsContext : IDisposable

The BufferedGraphicsContext type exposes the following members.

  NameDescription
Public methodBufferedGraphicsContextInitializes a new instance of the BufferedGraphicsContext class.
Top

  NameDescription
Public propertyMaximumBufferGets or sets the maximum size of the buffer to use.
Top

  NameDescription
Public methodAllocate(Graphics, Rectangle)Creates a graphics buffer of the specified size using the pixel format of the specified Graphics.
Public methodAllocate(IntPtr, Rectangle)Creates a graphics buffer of the specified size using the pixel format of the specified Graphics.
Public methodDisposeReleases all resources used by the BufferedGraphicsContext.
Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodInvalidateDisposes of the current graphics buffer, if a buffer has been allocated and has not yet been disposed.
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

The BufferedGraphicsContext class allows you to implement custom double buffering for your graphics. Graphics that use double buffering can reduce or eliminate flicker that is caused by redrawing a display surface.

NoteNote

The simplest way to use double buffering is to set the OptimizedDoubleBuffer control style flag on a control using the SetStyle method. Setting the OptimizedDoubleBuffer control styles flag for a control redirects all painting for the control through a default graphics buffer, without requiring any additional code. This flag is set to true by default.

The BufferedGraphicsContext class provides methods for creating and configuring a graphics buffer. The Allocate method creates a BufferedGraphics, which is a wrapper for a graphics buffer that also provides methods you can use to write to the buffer and render its contents to an output device.

You can retrieve the BufferedGraphicsContext for the current application domain from the static BufferedGraphicsManager.Current property. For graphically intensive applications such as animation, you can create a dedicated BufferedGraphicsContext using the constructor, but for most applications the BufferedGraphicsManager.Current property will be sufficient.

For more information on drawing buffered graphics and custom buffering implementations, see Double Buffered Graphics and How to: Manually Manage Buffered Graphics.

The following code example demonstrates how to acquire the BufferedGraphicsContext for the current application domain. This code is part of a larger example provided for the BufferedGraphics class.


// Retrieves the BufferedGraphicsContext for the 
// current application domain.
BufferedGraphicsContext appDomainGraphicsContext = 
     BufferedGraphicsManager.Current;


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Community Additions

ADD
Show:
© 2014 Microsoft