combit List & Label - Programmierer-Referenz - combit GmbH

Arbeiten mit den Komponenten
müssen. In diesem Zusammenhang sind insbesondere LL_RTF und LL_HTML zu nennen.
Die bisher vorgestellten Methode erlauben mittels Überladung immer auch die explizite
Angabe des zu verwendenden List & Label Datentyps. So können Sie beispielsweise die
Methode AddFromStream verwenden, um eine RTF-Datei anzumelden.
FileStream myFileStream = File.OpenRead("c:\\test.rtf");
LL.Variables.AddFromStream("RTF-Text", myFileStream, LlFieldType.RTF);
Auch die anderen Add…-Methoden verfügen über eine derartige Überladung. Der gewünschte
Datentyp entspringt dabei der Enumeration LlFieldType.
7.1.4.7. Handles
Die API-Funktion LlDefineVariableExtHandle wird mithilfe der Methode AddFromHandle
abgebildet. Hier können Sie ein Handle in Form eines IntPtr übergeben. Auch die Angabe
des gewünschten Datentyps ist möglich. Normalerweise ist dies LlFieldType. Drawing_hBitmap.
Hinweis: Diese Methode sollte nur in Sonderfällen zur Anbindung an die Win32 API
genutzt werden, beispielsweise wenn eine Komponente mit unmanaged code ein derartiges
Handle liefert. In anderen Fällen können Sie direkt das jeweilige Bitmap anmelden.
Die abstrakte Basisklasse Image unterstützt indes auch eine statische Methode
FromHbitmap, mithilfe derer sich eine Instanz der Klasse Bitmap auf Basis eines Handles
anlegen lässt.
7.1.4.8. Beliebige andere Datentypen
Die List & Label Komponente erlaubt die Übergabe von beliebigen Daten. Hierzu steht
die Methode AddFromObject zur Verfügung. Die Methode nutzt Reflections um die
öffentlichen Felder und Eigenschaften des übergebenen Objekts abzufragen und als
Variablen bei List & Label anzumelden. Als Name wird der Name des entsprechenden
Klassenmitglieds verwendet, wobei mittels Überladung auch die Übergabe eines Namenpräfix
möglich ist.
Die folgende Zeile zeigt die Übergabe eines Cookies innerhalb eines Webreporting-
Projekts:
LL.Variables.AddFromObject("MeinCookie", Request.Cookies["test"]);
Folgende Variablen wurden durch diesen Aufruf automatisch angemeldet:
• MeinCookie.Domain
• MeinCookie.Expires (LL_DATE)
84