BufferedGraphicsContext.Allocate Метод

Определение

Создает графический буфер.Creates a graphics buffer.

Перегрузки

Allocate(Graphics, Rectangle)

Создает графический буфер заданного размера, используя формат пикселей заданного объекта Graphics.Creates a graphics buffer of the specified size using the pixel format of the specified Graphics.

Allocate(IntPtr, Rectangle)

Создает графический буфер заданного размера, используя формат пикселей заданного объекта Graphics.Creates a graphics buffer of the specified size using the pixel format of the specified Graphics.

Allocate(Graphics, Rectangle)

Создает графический буфер заданного размера, используя формат пикселей заданного объекта Graphics.Creates a graphics buffer of the specified size using the pixel format of the specified Graphics.

public:
 System::Drawing::BufferedGraphics ^ Allocate(System::Drawing::Graphics ^ targetGraphics, System::Drawing::Rectangle targetRectangle);
public System.Drawing.BufferedGraphics Allocate (System.Drawing.Graphics targetGraphics, System.Drawing.Rectangle targetRectangle);
member this.Allocate : System.Drawing.Graphics * System.Drawing.Rectangle -> System.Drawing.BufferedGraphics
Public Function Allocate (targetGraphics As Graphics, targetRectangle As Rectangle) As BufferedGraphics

Параметры

targetGraphics
Graphics

Объект Graphics для сопоставления формата пикселей для нового буфера.The Graphics to match the pixel format for the new buffer to.

targetRectangle
Rectangle

Объект Rectangle, показывающий размер создаваемого буфера.A Rectangle indicating the size of the buffer to create.

Возвращаемое значение

BufferedGraphics

Объект BufferedGraphics, который может использоваться для рисования буфера заданных размеров.A BufferedGraphics that can be used to draw to a buffer of the specified dimensions.

Примеры

В следующем примере кода показано создание графического буфера с помощью Allocate метода.The following code example demonstrates creating a graphics buffer using the Allocate method. Этот код является частью большого примера, приведенного для BufferedGraphics класса.This code is part of a larger example provided for the BufferedGraphics class.

// Allocates a graphics buffer using the pixel format 
// of the specified Graphics object.
grafx = appDomainBufferedGraphicsContext->Allocate( this->CreateGraphics(),
   Rectangle( 0, 0, 400, 400 ) );
// Allocates a graphics buffer using the pixel format
// of the specified Graphics object.
grafx = appDomainBufferedGraphicsContext.Allocate(this.CreateGraphics(),
     new Rectangle( 0, 0, 400, 400 ));
' Allocates a graphics buffer using the pixel format 
' of the specified Graphics object.
grafx = appDomainBufferedGraphicsContext.Allocate(Me.CreateGraphics(), New Rectangle(0, 0, 400, 400))

Комментарии

При вызове Allocate метода с прямоугольником, размер которого превышает значение MaximumBuffer свойства, создается временный объект, BufferedGraphicsContext который выделяет буфер и предоставляет временный контекст для буфера.When you call the Allocate method with a rectangle whose size exceeds the value of the MaximumBuffer property, a temporary BufferedGraphicsContext is created to allocate the buffer and provide a temporary context for the buffer. Новый параметр отличается BufferedGraphicsContext от BufferedGraphicsContext для домена приложения и удаляется автоматически при BufferedGraphics удалении метода, возвращаемого Allocate методом.The new BufferedGraphicsContext is distinct from the BufferedGraphicsContext for the application domain and it is disposed automatically when the BufferedGraphics returned by the Allocate method is disposed.

См. также раздел

Применяется к

Allocate(IntPtr, Rectangle)

Создает графический буфер заданного размера, используя формат пикселей заданного объекта Graphics.Creates a graphics buffer of the specified size using the pixel format of the specified Graphics.

public:
 System::Drawing::BufferedGraphics ^ Allocate(IntPtr targetDC, System::Drawing::Rectangle targetRectangle);
public System.Drawing.BufferedGraphics Allocate (IntPtr targetDC, System.Drawing.Rectangle targetRectangle);
member this.Allocate : nativeint * System.Drawing.Rectangle -> System.Drawing.BufferedGraphics
Public Function Allocate (targetDC As IntPtr, targetRectangle As Rectangle) As BufferedGraphics

Параметры

targetDC
IntPtr

Указатель IntPtr на контекст устройства для соответствия формату пикселей нового буфера.An IntPtr to a device context to match the pixel format of the new buffer to.

targetRectangle
Rectangle

Объект Rectangle, показывающий размер создаваемого буфера.A Rectangle indicating the size of the buffer to create.

Возвращаемое значение

BufferedGraphics

Объект BufferedGraphics, который может использоваться для рисования буфера заданных размеров.A BufferedGraphics that can be used to draw to a buffer of the specified dimensions.

Примеры

В следующем примере кода показано создание графического буфера с помощью Allocate метода.The following code example demonstrates creating a graphics buffer using the Allocate method. Этот код является частью большого примера, приведенного для BufferedGraphics класса.This code is part of a larger example provided for the BufferedGraphics class.

// Allocates a graphics buffer using the pixel format 
// of the specified handle to a device context.
grafx = appDomainBufferedGraphicsContext->Allocate( this->Handle,
   Rectangle( 0, 0, 400, 400 ) );
// Allocates a graphics buffer using the pixel format
// of the specified handle to a device context.
grafx = appDomainBufferedGraphicsContext.Allocate(this.Handle,
     new Rectangle( 0, 0, 400, 400 ));
' Allocates a graphics buffer using the pixel format 
' of the specified handle to device context.
grafx = appDomainBufferedGraphicsContext.Allocate(Me.Handle, New Rectangle(0, 0, 400, 400))

Комментарии

При вызове Allocate метода с прямоугольником, размер которого превышает значение MaximumBuffer свойства, создается временный объект, BufferedGraphicsContext который выделяет буфер и предоставляет временный контекст для буфера.When you call the Allocate method with a rectangle whose size exceeds the value of the MaximumBuffer property, a temporary BufferedGraphicsContext is created to allocate the buffer and provide a temporary context for the buffer. Новый параметр отличается BufferedGraphicsContext от BufferedGraphicsContext для домена приложения и удаляется автоматически при BufferedGraphics удалении метода, возвращаемого Allocate методом.The new BufferedGraphicsContext is distinct from the BufferedGraphicsContext for the application domain and it is disposed automatically when the BufferedGraphics returned by the Allocate method is disposed.

См. также раздел

Применяется к