Mig-infocom MiG Calendar JavaBeans Guide User Manual

MiG InfoCom ABMiG Calendar™ JavaBeans Guide______________________________________________________________Release 6MiG Calendar JavaBeans Guide Page 1

MiG InfoCom ABJBuilder XWorks flawlessly. Error handling is not as good as for those above.MiG Calendar JavaBeans Guide Page 10 / 45Illustration 2: Ne

MiG InfoCom ABJBuilder 2005Due to a JBuilder 2005 bug (Report # 9476) that prevents custom components to work in many situations MiG Calendar componen

MiG InfoCom ABVisual Editor works with MiG Calendar. It should be noted though that VE doesn't have the possibility to have custom beans on its J

MiG InfoCom ABtheme though, this has to be set manually if the default look doesn’t fulfills the requirements. It is easy to tweak and build in functi

MiG InfoCom ABapproach is chosen. See more about this as the “Mixing core-level …” below.Installing the JavaBean ComponentsTo use the MiG Calendar com

MiG InfoCom ABsense without being connected to an instance of this class. It represents the date area and holds references to some other beans.DateHea

MiG InfoCom ABthe framework. It contains a few properties to tweak how the data should be generated, including the possibility to add the generated ac

MiG InfoCom ABfor information about the properties.DateSpinnerBeanThis is a very customizable spinner component that holds a date/time or a part there

MiG InfoCom ABmonth(s) and year(s) views are all implemented by this bean; it is only configured in different ways. This means that the structure has

MiG InfoCom ABmake all date calculations for the graphical mapping of date/time to pixels. Cells can be of different sizes, in both dimensions, to mak

MiG InfoCom ABMiG InfoCom ABS:t Olofsgatan 28a753 32 UppsalaSwedenwww.miginfocom.comwww.migcomponents.comCOPYRIGHT © MiG InfoCom AB.All rights reserve

MiG InfoCom ABThis bean divides normal rows, for the sake of layout, into regular and compressed. (in the core of the component you can create any num

MiG InfoCom ABSub rows are given the row number the same way as a JTree get its row number. This means that folder rows will always be before its chil

MiG InfoCom ABYou create the DateHeaderBean as you would any other non-visual bean, normally by dragging it to the GUI workspace. Then you set the hea

MiG InfoCom ABEvery row in the date header is specified by an element in the property headerRows. For every row there are properties to specify how th

MiG InfoCom ABLabel Repetition – If selected this row will only draw the labels that are specified. Can for instance be used to draw only ever second

MiG InfoCom ABthe DateAreaBean. Since the category header will always decorate the secondary dimension the position is a function of the primaryDimens

MiG InfoCom ABThe text drawn in the labels is defined with a template text. Default is “$gridRowName$” which will be expanded with the name of the sub

MiG InfoCom ABIt is important to understand how this works in order to create anything but a very basic category header. If you understand the concept

MiG InfoCom ABalso filtered on sub row type. There are five types of filter:• All – Applies to all types of rows• All Folders – Apples to all types of

MiG InfoCom ABExample 3DefaultSubRowLevel 0 – Applies to All Folders. Applies to row 0-1.DefaultSubRowLevel 1 – Applies to All Folders. Applies to row

MiG InfoCom ABTable of ContentsMiG Calendar Tutorial...6Preface...

MiG InfoCom ABlabel.Label Repetition – If selected it constrains this element (SubRowLevel) to certain rows. How this works can be read in the Technic

MiG InfoCom ABdocumented in the API JavaDoc for the class.All properties are in two different versions, one for Folders and one for a Leafs (a leaf is

MiG InfoCom ABDate Spinners/Combos and Date GroupsThere are two kinds of date spinners. One is a normal JComboBox and can't be configured much re

MiG InfoCom ABthis. It will create random activities for a selected date/time range and optionally create a category tree. Many aspects of this creati

MiG InfoCom ABThe rest of the properties for DemoDataBean are pretty straight forward and will not be reiterated here. For more info on these properti

MiG InfoCom ABthese types of properties works. Basically they define a rectangle relative to another rectangle in a very flexible way. For instance do

MiG InfoCom ABThe look of the combo part (not popup) is automatically configured to look like the current Look&Feel. Since it is only possible to

MiG InfoCom ABMinimumPopupSize, PreferredPopupSize and MaximumPopupSize together with the preferred size of the DateAreaBean itself if they are are nu

MiG InfoCom ABhandles the optional scroll bars.Since the DateAreaBean is a DateAreaContainer you will normally always have an instance of this class d

MiG InfoCom ABmethod CategoryDepository.getRoot(). Use this root to handle the tree much like how you would with a normal JTree. The Category nodes in

MiG InfoCom ABDateHeaderBean... 15CategoryHeaderBean...

MiG InfoCom ABare sub classes of AbstractActivity. The changed Activity is set at the source in the generated event.• Add a PropertyChangeListener to

MiG InfoCom ABAnother way that can be used if there are different looks (e.g. colors) depending on the Category the activities belongs to (an activity

MiG InfoCom ABpublic static final String DEFAULT_SHADOW_SHAPE_NAMEYet another way is to provide different AShapes (or rather RootAShapes) for differen

MiG InfoCom ABrepaint them selves accordingly. This is a very powerful design that makes fast and resource effective user interactions possible with a

MiG InfoCom AB}public void gridChanged(PropertyChangeEvent e) {} // Not interestedpublic void dispose() {} // Nothing to dispose of};dateArea.addDeco

MiG InfoCom ABIf you will work with the beans documented in this guide but still want some of the functionality from the more advanced core; that is e

MiG InfoCom ABAdding a Date Picker Component... 35Advanced Topics... 37

MiG InfoCom ABMiG Calendar TutorialPrefaceThis document aims at providing enough information to get started using the MiG Calendar JavaBeans component

MiG InfoCom AB www.migcalendar.com Bug ReportsPlease submit a support ticket.MiG Calendar JavaBeans Guide Page 7 / 45

MiG InfoCom ABIntroductionMiG Calendar's Visual JavaBean(s) makes the component very easy to use and configure, especially in combination with a

MiG InfoCom ABThe support for handling advanced beans visually in a designer is somewhat different for every IDE (Integrated Development Environments)