combit List & Label - Programmierer-Referenz - combit GmbH

11.2. User-Objekte
User-Objekte
Da List & Label nicht alle möglichen Objekte berücksichtigen kann - seien es Spline-
Objekte, Statistik-Graphen, Charts oder Zeichnungen mit unbekanntem Grafikformat -
wurden in List & Label die sog. User-Objekte eingebaut, da auch Metafile-Variablen nicht
alle Bereiche sinnvoll abdecken können.
Wenn Sie diese mit der .NET Komponente verwenden wollen, beachten Sie bitte die
Hinweise im Kapitel "7.1. Arbeiten mit der .NET Komponente".
Wenn Sie in Ihrem Programm eine Variable über
LlDefineVariableExt(hJob, , , LL_DRAWING_USEROBJ, NULL);
definiert haben, kann der Benutzer im Designer ein Objekt definieren, das mit dieser
Variablen zusammenhängt. Dies geschieht analog zu normalen LL_DRAWING-Variablen.
Wenn List & Label dieses Objekt im Preview oder beim Druck ausgeben soll, ruft es über
den Callback LL_CMND_DRAW_USEROBJ Ihr Programm auf, um diese Aufgabe an Ihr
Programm weiterzugeben.
Dasselbe können Sie auch für Tabellenfelder durchführen, damit der Benutzer die Möglichkeit
hat, sich ein User-Objekt in die Tabelle einzubauen:
LlDefineFieldExt(hJob, , , LL_DRAWING_USEROBJ, NULL);
Für Variablen, besteht zusätzlich die Möglichkeit, User-Objekte zu definieren, deren
Parameter der Benutzer im Designer ändern kann. Die Objekte werden mit dem LL_-
DRAWING_USEROBJ_DLG-Typ definiert:
LlDefineVariableExt(hJob, , , LL_DRAWING_USEROBJ_DLG, NULL);
Bearbeitbare User-Objekte können nicht in Tabellen eingefügt werden.
Wenn der Benutzer nun den 'Bearbeiten'-Button im Zeichnungs-Dialog drückt, werden
Sie über den LL_EDIT_USEROBJ-Callback aufgefordert, einen dazugehörigen Dialog
aufzubauen, in dem die Parameter, die zu dem Objekt gehören, geändert werden können.
Diese Parameter werden mit den anderen Objekt-Informationen automatisch in der
Projektdefinitionsdatei gespeichert und zur Auswertung beim LL_DRAW_USEROBJ-
Callback übergeben, so dass Ihr Programm sich nicht weiter um die Speicherung der
Parameter kümmern muss.
Bitte beachten Sie die Hinweise des Artikels 99109
(http://support.microsoft.com/kb/99109) in der Microsoft Developer Network Knowledge
Base, wenn Sie in Callback-Objekten DDBs (device dependent bitmaps) drucken wollen:
Wandeln Sie die DDB erst in eine DIB (device independent bitmap), wenn sie nicht kompatibel
mit dem Drucker-DC ist, ansonsten ist ein irreguläres Verhalten des Druckertreibers
vorprogrammiert.
133