Dieses Steuerelement implementiert eine Zeichenfläche, auf die von der Anwendung gezeichnet werden kann. Es hat zwei Zeichen-Modi, Standard und Cached, die durch die Cached-Eigenschaft definiert werden.

Im Standard-Modus löst das DrawingArea das Draw-Ereignis jedes Mal aus, wenn es aktualisiert werden muss. Im Cached-Modus wird das Zeichnen einmal ausgeführt. Die aktuelle Zeichnung wird in einem internen Bild gespeichert, das von der DrawingArea verwendet wird, um sich selbst zu aktualisieren. Anders formuliert: Im gecacheten Modus kann man sie als Paint-Device benutzen, das heißt man kann direkt auf ihr zeichnen, wann immer es benötigt wird – so wie in diesem Beispiel:

Public Sub DrawingAreaCanvas_Draw()
 
    Paint.Begin(DrawingAreaCanvas)
      DrawBarChart()
    Paint.End()
 
End

Im nicht-gecacheten Modus dagegen entscheiden andere interne Instanzen, wann eine DrawingArea neu gezeichnet werden muss. Das ist zum Beispiel der Fall, wenn sie durch ein Fenster überdeckt war. Dann muss sie neu gezeichnet werden, sobald sie wieder sichtbar ist. In solchem Fall wird das Draw-Event der DrawingArea aufgerufen. Ein Quelltext wie der o.a. würde zu einem Fehler führen.

So erzeugen Sie ein neues DrawingArea-Steuerelement:

Dim hDrawingArea As DrawingArea
hDrawingArea = New DrawingArea ( Parent As Container ) [ As "EventName" ]

Die Klasse DrawingArea verfügt über die folgenden relevanten Eigenschaften:

Tabelle 18.11.0.1.1 : Eigenschaften der Klasse DrawingArea

Hinweise

• In der Arrange-Klasse existiert eine Liste der Konstanten, die mit dem Attribut Arrangement verwendet werden können → https://gambas-buch.de/doku.php?id=k20:k20.7:start.
• Wenn die Eigenschaft 'Cached' gesetzt ist, wird der Inhalt der DrawingArea nicht gelöscht, wenn sie von einem anderen Fenster verdeckt wird. Sie wird nur durch die explizite Verwendung der Clear()-Methode geleert.
• Die Existenz der Eigenschaft 'Focus' ist ein Grund, warum die DrawingArea gern für Steuerelemente verwendet wird.
• Wenn die Eigenschaft NoMouse gesetzt ist, dann deaktiviert diese Eigenschaft die Weiterleitung von Mausereignissen an das Steuerelement und seine untergeordneten Steuerelemente. Mausereignisse werden an andere Steuerelemente weitergeleitet, als ob das Steuerelement und seine untergeordneten Steuerelemente nicht in der Hierarchie der Steuerelemente vorhanden wären. Mausklicks und andere Ereignisse werden nicht beachtet.

Die Klasse DrawingArea verfügt nur über zwei relevante Methoden:

Tabelle 18.11.0.2.1 : Methode der Klasse DrawingArea

Die Klasse DrawingArea besitzt diese Ereignisse:

Tabelle 18.11.0.3.1 : Ereignisse der Klasse DrawingArea

• Generell gilt: Außerhalb des Draw()-Ereignisses kann nicht in eine DrawingArea gezeichnet werden und das Draw()-Ereignis sollte nur Paint-Zeichenanweisungen ausführen.
• Gut zu wissen, dass innerhalb des Draw()-Ereignisses keine Anweisungen ausgeführt werden, welche die DrawingArea als Steuerelement modifizieren. Alles, was zu einer Modifikation der DrawingArea führt, sollten Sie mit anderen Methoden festlegen.
• Das Font()-Ereignis ist besonders dann nützlich, wenn Sie ein benutzerdefiniertes Steuerelement implementieren, da dieses Ereignis auch ausgelöst wird, wenn die Standardschriftart des Desktops global geändert wird. Es ermöglicht Ihnen, Ihr Steuerelement entsprechend der neuen Schriftart neu zu entwerfen.

In den folgenden Kapiteln werden Projekte beschrieben, die auf unterschiedliche Art die DrawingArea als Zeichenfläche nutzen.