Control.DrawToBitmap(Bitmap, Rectangle) Methode

Definition

Unterstützt das Rendering für die angegebene Bitmap.Supports rendering to the specified bitmap.

public:
 void DrawToBitmap(System::Drawing::Bitmap ^ bitmap, System::Drawing::Rectangle targetBounds);
public void DrawToBitmap (System.Drawing.Bitmap bitmap, System.Drawing.Rectangle targetBounds);
member this.DrawToBitmap : System.Drawing.Bitmap * System.Drawing.Rectangle -> unit

Parameter

bitmap
Bitmap

Die Bitmap, in die gezeichnet werden soll.The bitmap to be drawn to.

targetBounds
Rectangle

Die Begrenzungen, innerhalb derer das Steuerelement gerendert wird.The bounds within which the control is rendered.

Hinweise

Die DrawToBitmap-Methode wird für ActiveX-Steuerelemente nicht unterstützt.The DrawToBitmap method is not supported for ActiveX controls. Sie können das OnPrint-Ereignis überschreiben und ggf. eine benutzerdefinierte Druck Logik bereitstellen.You can override the OnPrint event and provide custom printing logic if required.

Die DrawToBitmap-Methode weist die folgenden Einschränkungen auf:The DrawToBitmap method has the following limitations:

  • Für große Bitmaps kann eine ArgumentException ausgelöst werden.An ArgumentException might be thrown for large bitmaps. Die maximal zulässige Größe variiert je nach Computer.The maximum allowable size varies by machine.

  • die Ink-Steuerelemente für das Betriebssystem Windows XP Tablet PC Edition 2005 werden von DrawToBitmap nicht unterstützt.DrawToBitmap does not support the Ink controls for the Windows XP Tablet PC Edition 2005 operating system.

  • DrawToBitmap zeichnet keinen untergeordneten TextBox, wenn die Visible-Eigenschaft des TextBox auf false festgelegt ist.DrawToBitmap does not draw a child TextBox if the Visible property of the TextBox is set to false.

  • Steuerelemente in Containern werden in umgekehrter Reihenfolge gerendert.Controls inside containers are rendered in reverse order.

  • DrawToBitmap ist für die RichTextBox nicht voll funktionsfähig. nur der Rahmen einer Bitmap wird gezeichnet.DrawToBitmap is not fully functional for the RichTextBox; only the border of a bitmap is drawn.

Gilt für:

Siehe auch