Freigeben über


BufferedGraphicsContext.Allocate Methode

Definition

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
Quelle:
BufferedGraphicsContext.cs
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

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

Gilt für:

Allocate(IntPtr, Rectangle)

Quelle:
BufferedGraphicsContext.cs
Quelle:
BufferedGraphicsContext.cs
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

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

Gilt für: