Examples of BBFormBuilder

• com.salas.bb.utils.uif.BBFormBuilder
  Enhanced builder of forms. This class helps build JGoodies forms incrementally. You need to understand JGoodies Forms to use this class. Note that this is not a general users guide for this class just practical notes. If you want to add more information as you learn to use this, feel free! Some key ideas to help you get going: When constructed, a a JGoodies "columns definition" string is supplied which establishes the number of columns, and the constraints on the widths of the columns From that point, a series of "append" methods are called, each supplying one or more components, and indicating whether the components should span more than one column. When you use this class you need to keep track of where you are, what column and what row, because by default this 'cursor' will wrap from the end of one row to the beginning of the next one, automatically. If you want to override this, you can for example call one of the nextColumn() and/or nextLine() related methods. What does nextline() do? nextLine() moves the cursor down several lines. It doesn't create rows. If you have just filled some row the cursor at the end of this row and there are no rows below it. If you continue with append(someComponent) it will see that cursor points to the column after the last defined. Consequentially, it will move cursor one line down and to the very left. If there's a row present, it will use this row to add component. If there's no row it will: a. create gap row b. move cursor one more line down c. create content row (with preferred height) d. add your component Now what happens when you do nextline() after filling the row. You tell that you wish to move cursor one line down. It is actually what the engine does implicitly and the only case when you need to use it explicitly is when you don't wish to fill the row to the end. You have more columns to the right, but you wish to break to the next line, so you tell nextLine(). What happens when you tell nextLine(2). You jump two rows down. In other words, you jump over one row. This row doesn't exist and engine fails to create the second row after that missing... that's an exception. Having all this in mind, if you want to create a big gap, dont do nextLine(2). Instead: appendUnrelatedComponentsRow() -- it's a big fixed-height gap. go to the next line and go to the next line again, or you will end up with components placed on this gap row. The shorter recording of this (thanks to my builder) is appendUnrelatedComponentsRow(2).

Examples of com.salas.bb.utils.uif.BBFormBuilder