combit List & Label 29 - .NET Help
combit.Reporting Namespace / DesignerObject Class
Properties Methods Events

In This Topic
    DesignerObject Class Members
    In This Topic

    The following tables list the members exposed by DesignerObject.

    Public Constructors
     NameDescription
    Public Constructor  
    Top
    Public Properties
     NameDescription
    Public PropertyDescribes if the Designer object can trigger page breaks or not. The default setting is 'false'. When 'true' the Designer object can trigger page breaks. See the events GetFieldHeightInformation and DrawDesignerObject to implement your own page break logic.  
    Public Property

    The description is displayed in the designer. It may contain space characters, which should, however, not be more than 30 characters in length.

     
    Public PropertyContains a collection of DesignerProperty descendants. These properties are displayed in the Designer and serialized to the project file.  
    Public Property  
    Public PropertyThe object's default font.  
    Public Property

    The object icon that is displayed in the toolbar and menu in the designer. It should contain a 16x16 Pixel size Icon with 16 colors.

     
    Public PropertyLarge ribbon image for the designer object (PNG with alpha, 32x32 pixels).  
    Public Property

    The name of the object. This is used internally as an ID, which is, however, not shown to the user.

     
    Public Property  
    Public PropertySmall ribbon image for the designer object (PNG with alpha, 16x16 pixels).  
    Public PropertyGets or sets if a contents dialog is supported by the DesignerObject.  
    Public PropertyGets or sets the Ribbon tooltip description.  
    Top
    Public Methods
    Public Events
     NameDescription
    Public Event

    This event CreateDesignerObject is triggered when the user creates a new object. If desired, you can show the initial dialog to the user. This can, for instance, be an assistant that makes it simple for the user to configure the new object. If you don.t want to offer this, simply forego processing of the event. The following example show the display of a MessageBox as soon as the new object is placed in the workspace for the first time. You gain access to the designer window through the event argument. The passed class supports the IWin32Window interface and can, as a result, be used for a MessageBox or another window as a parent.

     
    Public Event

    After the user has edited the object, you are asked by List & Label to draw the object. The event DrawDesignerObject is triggered for this purpose. A Graphics object and the rectangle of the object are passed through EventArguments. Now, you can draw in the work area with the known GDI + methods. While doing so, access to the underlying object properties is naturally possible and useful. The sample listing shows the presentation of graphic file selected above.

     
    Public Event

    This event is triggered, when the user double clicks on the newly added object or selects the item "Properties" from the context menu. Here as well, you can gain access to the designer window through event arguments, and a separate dialog can be displayed. In the example, you see the display of a file selection dialog. Here, you can choose a graphic to be displayed in the designer. The dialog is displayed by double-clicking on the object.

     
    Public EventThis event is only called if the Designer object is located inside a report container and is used for adjusting the height of the Designer object to print to fit the actual available height (see properties AvailableSpace and IdealHeight). The actual print of the Designer object is done in the DrawDesignerObject Event.  
    Public Event  
    Public EventIs called by List & Label to reset a possible data source which the Designer object is linking to. This happens e.g. if you call the real data preview in the Designer if you where in the Layout mode before.  
    Top
    See Also