BufferedGraphicsContext.Allocate Метод

Определение

Пространство имен:

System.Drawing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

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

Перегрузки

Allocate(Graphics, Rectangle)	Создает графический буфер заданного размера, используя формат пикселей заданного объекта Graphics.
Allocate(IntPtr, Rectangle)	Создает графический буфер заданного размера, используя формат пикселей заданного объекта Graphics.

Allocate(Graphics, Rectangle)

Исходный код:

BufferedGraphicsContext.cs

Создает графический буфер заданного размера, используя формат пикселей заданного объекта 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 для сопоставления формата пикселей для нового буфера.

targetRectangle

Rectangle

Объект Rectangle, показывающий размер создаваемого буфера.

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

BufferedGraphics

Объект BufferedGraphics, который может использоваться для рисования буфера заданных размеров.

Примеры

В следующем примере кода показано создание графического буфера с помощью Allocate метода . Этот код является частью более крупного примера, предоставленного BufferedGraphics для класса .

// 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 объект для выделения буфера и предоставления временного контекста для буфера. Новый BufferedGraphicsContext объект отличается от BufferedGraphicsContext для домена приложения и автоматически удаляется при BufferedGraphics удалении объекта, возвращаемого методом Allocate .

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

• BufferedGraphics
• Graphics
• Rectangle
• Двойная буферизация графики

Allocate(IntPtr, Rectangle)

Исходный код:

BufferedGraphicsContext.cs

Создает графический буфер заданного размера, используя формат пикселей заданного объекта 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

nativeint

Указатель IntPtr на контекст устройства для соответствия формату пикселей нового буфера.

targetRectangle

Rectangle

Объект Rectangle, показывающий размер создаваемого буфера.

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

BufferedGraphics

Объект BufferedGraphics, который может использоваться для рисования буфера заданных размеров.

Примеры

В следующем примере кода показано создание графического буфера с помощью Allocate метода . Этот код является частью более крупного примера, предоставленного BufferedGraphics для класса .

// 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 объект для выделения буфера и предоставления временного контекста для буфера. Новый BufferedGraphicsContext объект отличается от BufferedGraphicsContext для домена приложения и автоматически удаляется при BufferedGraphics удалении объекта, возвращаемого методом Allocate .

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

• BufferedGraphics
• IntPtr
• Rectangle
• Двойная буферизация графики