combit List & Label - Programmierer-Referenz - combit GmbH

Arbeiten mit den Komponenten
Eigenschaft Datentyp Beschreibung
Objectname String Der eindeutige Name des Objekts. Dieser wird
intern als ID verwendet, dem Benutzer jedoch
nicht angezeigt.
Description String Diese Beschreibung wird im Designer angezeigt.
Sie darf Leerzeichen enthalten, sollte jedoch
nicht länger als 30 Zeichen lang sein.
Icon Icon Das Icon des Objekts, das im Designer in der
Symbolleiste und im Menü angezeigt wird. Es
sollte sich um ein 16x16 Pixel großes Icon mit 16
Farben handeln.
Die Komponente bietet Ihnen drei Ereignisse an. Zunächst wird bei der Anlage eines
neuen Objekts durch den Benutzer das Ereignis CreateDesignerObject ausgelöst. Falls
gewünscht können Sie dem Benutzer hier einen Einstiegsdialog anzeigen. Dies kann
beispielsweise ein Assistent sein, der dem Benutzer die Konfiguration des neuen Objekts
vereinfacht. Bietet sich die Verwendung im konkreten Fall nicht an, verzichten Sie
einfach auf die Behandlung des Ereignisses.
Die folgenden Zeilen zeigen die Anzeige einer MessageBox sobald das neue Objekt
erstmals auf dem Arbeitsbereich platziert wird. Über das Ereignisargument erhalten Sie
Zugriff auf das Fenster des Designers. Die übergebene Klasse unterstützt die Schnittstelle
IWin32Window und kann somit als Parent für eine MessageBox oder ein anderes
Fenster verwendet werden.
private void designerObject1_CreateDesignerObject(object sender,
CreateDesignerObjectEventArgs e)
{
MessageBox.Show(e.DesignerWindow, "Das neue Objekt wird nun angelegt.");
}
Das Ereignis EditDesignerObject wird ausgelöst, wenn der Benutzer doppelt auf das neu
eingefügte Objekt klickt oder aber den Eintrag "Eigenschaften" aus dem Kontextmenü
wählt. Sie erhalten auch hier über die Ereignisargumente Zugriff auf das Designerfenster
und können "über" diesem einen eigenen Dialog anzeigen.
Im Listing sehen Sie die Anzeige eines Dateiauswahl-Dialoges. Hier kann eine Grafik
ausgesucht werden, die im Designer im Rahmen des neuen Objekttyps angezeigt werden
soll. Ein Doppelklick auf das Objekt zeigt den Dialog an.
private void designerObject1_EditDesignerObject(object sender,
EditDesignerObjectEventArgs e)
{
DesignerObject desobj = (DesignerObject) sender;
96