BufferedGraphicsContext.Allocate Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Erstellt einen Grafikpuffer.

Überlädt

Allocate(Graphics, Rectangle)	Erstellt mithilfe des Pixelformats des angegebenen Graphics einen Grafikpuffer von der angegebenen Größe.
Allocate(IntPtr, Rectangle)	Erstellt mithilfe des Pixelformats des angegebenen Graphics einen Grafikpuffer von der angegebenen Größe.

Allocate(Graphics, Rectangle)

Quelle:

BufferedGraphicsContext.cs

Erstellt mithilfe des Pixelformats des angegebenen Graphics einen Grafikpuffer von der angegebenen Größe.

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

Parameter

targetGraphics

Graphics

Das Graphics, dem das Pixelformat des neuen Puffers entsprechen soll.

targetRectangle

Rectangle

Ein Rectangle, das die Größe des zu erstellenden Puffers angibt.

Gibt zurück

BufferedGraphics

Ein BufferedGraphics, das zum Zeichnen in einen Puffer mit den angegebenen Abmessungen verwendet werden kann.

Beispiele

Im folgenden Codebeispiel wird das Erstellen eines Grafikpuffers mithilfe der Allocate -Methode veranschaulicht. Dieser Code ist Teil eines größeren Beispiels für die BufferedGraphics -Klasse.

// 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))

Hinweise

Wenn Sie die Allocate -Methode mit einem Rechteck aufrufen, dessen Größe den Wert der MaximumBuffer Eigenschaft überschreitet, wird ein temporärer BufferedGraphicsContext erstellt, um den Puffer zuzuordnen und einen temporären Kontext für den Puffer bereitzustellen. Das neue BufferedGraphicsContext unterscheidet sich von der BufferedGraphicsContext für die Anwendungsdomäne und wird automatisch verworfen, wenn das BufferedGraphics von der Allocate -Methode zurückgegebene freigegeben wird.

Weitere Informationen

• BufferedGraphics
• Graphics
• Rectangle
• Doppelt gepufferte Grafiken

Allocate(IntPtr, Rectangle)

Quelle:

BufferedGraphicsContext.cs

Erstellt mithilfe des Pixelformats des angegebenen Graphics einen Grafikpuffer von der angegebenen Größe.

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

Parameter

targetDC

IntPtr

nativeint

Ein IntPtr für einen Gerätekontext, dem das Pixelformat des neuen Puffers entsprechen soll.

targetRectangle

Rectangle

Ein Rectangle, das die Größe des zu erstellenden Puffers angibt.

Gibt zurück

BufferedGraphics

Ein BufferedGraphics, das zum Zeichnen in einen Puffer mit den angegebenen Abmessungen verwendet werden kann.

Beispiele

Im folgenden Codebeispiel wird das Erstellen eines Grafikpuffers mithilfe der Allocate -Methode veranschaulicht. Dieser Code ist Teil eines größeren Beispiels für die BufferedGraphics -Klasse.

// 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))

Hinweise

Wenn Sie die Allocate -Methode mit einem Rechteck aufrufen, dessen Größe den Wert der MaximumBuffer Eigenschaft überschreitet, wird ein temporärer BufferedGraphicsContext erstellt, um den Puffer zuzuordnen und einen temporären Kontext für den Puffer bereitzustellen. Das neue BufferedGraphicsContext unterscheidet sich von der BufferedGraphicsContext für die Anwendungsdomäne und wird automatisch verworfen, wenn das BufferedGraphics von der Allocate -Methode zurückgegebene freigegeben wird.

Weitere Informationen

• BufferedGraphics
• IntPtr
• Rectangle
• Doppelt gepufferte Grafiken