Bar Commands
--------------------------------------------------------------------------------

 // jhs

 Creating a Button Bar    DEFINE BUTTONBAR [ <oBar> ] ;
 from source code            [ BUTTONSIZE | SIZEBUTTON <nWidth>, <nHeight> ] ;
                             [ OF | WINDOW | DIALOG <oWnd> ]

                    DEFINE BUTTON [<oBtn>] ;
                       [ OF <oBar> ] ;
                       [ FILE | FILENAME | DISK <cBmpFile1> [,<cBmpFile2> ] ] ;
                       [ RESOURCE | RESNAME | NAME <cResName1> [,<cResName2> ] ] ;
                       [ ACTION <uAction> ] ;
                       [ MESSAGE <cMsg> ] ;
                       [ ADJUST ]

 <oBar>          A reference to the Bar Object.

 <nWidth>        The width and height of the buttons of the bar.
 <nHeight>       By default is 28x28 pixels.

 <oWnd>          A reference to the container Window of the bar.


 <oBtn>          A reference to the BitmapButton Object.

 <cBmpFile1>     The name of the Bitmap to display. Optionally
 <cBmpFile2>     you may specify a second bitmap for animation.

 <cResName1>     The resource name of the Bitmap to display. Optionally
 <cResName2>     you may specify a second bitmap for animation.

 <uAction>       The action to be performed when clicking the Button.

 <cMsg>          The message to display on the message bar of the
                     container Window of the Bar Object which contains
                     the BitmapButton.

 CLAUSES

 ADJUST          To automatically resizes the bitmap to the whole
                 area of the BitmapButton.


 Examples: See \examples\TestBar.prg for a ButtonBar demonstration.