combit List & Label - Programmierer-Referenz - combit GmbH

Arbeiten mit den Komponenten
System.Boolean Bool Boolean LL_BOOL
System.DateTime DateTime Date LL_DATE
System.Object Object Object - Je nach Inhalt -
Die Überladung für den obersten Datentyp System.Object implementiert eine verschachtelte
Typenkonvertierung. Hier wird versucht, das übergebene Objekt dynamisch
in einen der bekannten Datentypen zu konvertieren. Ist dies nicht möglich, wird eine
Textvariable angemeldet, deren Inhalt sich aus der Anwendung der Methode ToString
auf das Objekt ergibt.
Die folgenden Zeilen zeigen die Anmeldung einer Zeichenkette, eines numerischen Wertes
sowie eines Datums. In jedem Fall werden automatisch die korrespondierenden List
& Label Variablentypen angewandt und im Designer zur Verfügung gestellt.
LL.Variables.Add("meintext", "hallo welt"); // -> Zeichenkette
LL.Variables.Add("meinezahl", 51515); // -> Numerischer Wert
LL.Variables.Add("meindatum", DateTime.Now); // -> Datum
Neben den aufgelisteten Standarddatentypen existieren auch Überladungen für folgende
Klassen:
• StringBuilder
• Bitmap
• Icon
• Metafile
Intern wird vor jeder Anmeldung von Variablen und Feldern zur Druckzeit geprüft, ob
diese im Drucklayout überhaupt verwendet werden. Um die Anzahl der Aufrufe zu reduzieren,
wird überdies ein Cache von verwendeten Feldern und Variablen aufgebaut.
Sie brauchen sich um die Prüfung mittels LlPrintIsFieldUsed() bzw. den Pendants für
Variablen und Chartfelder also nicht zu kümmern.
7.1.4.1. Bilder
Die Übergabe von Grafiken erfolgt mittels der gezeigten Überladungen für Bitmap, Metafile
und Icon. Um beispielsweise die Grafik c:\meinbild.jpg in List & Label darzustellen,
verwenden Sie folgenden Aufruf:
LL.Variables.Add("meinbild", new Bitmap("c:\\meinbild.jpg"));
7.1.4.2. Barcodes
Die Übergabe von Barcodes ist bei der .NET Komponente stark vereinfacht worden. Ein
Barcode wird über die Klasse LlBarcode repräsentiert. Dem Konstruktor wird der Inhalt
des Barcodes sowie das gewünschte Format übergeben. Eine eventuell notwendige
82