CanvasGraphic
CanvasGraphic
Grafikobjekt zur Darstellung in einem Canvas -Objekt
Details
- Siehe: Liste , Eigenschaften , CodeLibrary-Beispiel "Canvas"
Grafikobjekte stellen den Inhalt eines Canvas -Objektes dar. Sie können mit dem Befehl WinCreate(_WinTypeCanvasGraphic, ...) angelegt werden.
Über die Eigenschaft FormType wird die Form des Grafikobjektes definiert. Die Position und Größe wird mit der Eigenschaft Area in logischen Einheiten definiert. Für die Umrechnung von Einheiten (z. B. Millimeter, Zentimeter) in logische Einheiten kann der Befehl PrtUnitLog () verwendet werden.
Farbgebung
Die Eigenschaft ColBkg definiert die Füllfarbe des Grafikobjektes. Eine transparente Darstellung kann über WinColorOpacitySet () erreicht werden. Die Grafikobjekte können mit einem Rahmen versehen werden. Die Stärke des Rahmens in logischen Einheiten, wird über die Eigenschaft BorderWidth definiert. Die Füllfarbe des Rahmens wird über die Eigenschaft BorderColFg definiert. Auch hier ist die Angabe einer teiltransparenten Farbe durch WinColorOpacitySet () möglich.
Die Füll- ( ColBkg ) und Rahmenfarbe ( BorderColFg ) werden beim FormType _WinFormTypeLine ignoriert. Text- und Linien-Farbe werden über die Eigenschaft ColFg definiert. Hierbei werden teiltransparente Farben nicht berücksichtigt.
Inhalt
Als Inhalt können sowohl Texte als auch Grafiken dargestellt werden.
Der anzuzeigende Text wird über die Eigenschaft Caption definiert. Dieser kann mehrzeilig sein. Wortumbrüche können über die Eigenschaft WordBreak aktiviert werden. Die Eigenschaft Vertical gibt an, ob der Text vertikal oder horizontal (default) angezeigt wird. Die Textausrichtung geschieht über die Eigenschaften Justify und JustifyVert.
Ein Bild kann über die Eigenschaft PictureName gesetzt werden. Ein Stern ('*') als Präfix kennzeichnet ein extern vorliegendes Bild. Die Anzeige des Bildes erfolgt über die Eigenschaft PictureMode. Die Eigenschaft Vertical definiert, ob das Bild gekippt dargestellt wird oder nicht.
Besonderheiten je nach FormType
_WinFormTypeRectangle / _WinFormTypeSquare:
Bei der Ausgabe des rechteckigen Bereiches (_WinFormTypeRectangle, _WinFormTypeSquare) können abgerundete Ecken über die Eigenschaft Justify und Radius gesetzt werden. Die Eigenschaft definiert den Radius der abgerundeten Ecken in logischen Einheiten.
Bei der Linie werden Füll- (ColBkg) und Rahmenfarbe (BorderColFg) ignoriert. Die Farbe der Linie wird über die Eigenschaft ColFg gesetzt. Die Linienstärke in logischen Einheiten definiert die Eigenschaft LineWidth. Die Linie kann mit einem Pfeiltyp für den Start- bzw. Endpunkt versehen werden. Hierfür existiert die Eigenschaften LineCapStart und LineCapEnd.
Die Ausrichtung der Linie kann horizontal (Vertical=false) oder vertikal (Vertical=true) sein. Die Ausrichtung der Linie (links, zentriert, mittig) geschieht über die Eigenschaft LineJustify. Bild und Text werden in Abhängigkeit von der Ausrichtung links / über bzw. rechts / unter der Linie angezeigt.