broambox - a plugin for BB4Win
Copyright (c) 2003 Brian Hartvigsen
All rights reserved.

-- begin license --
Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:

    * Redistributions of source code must retain the above copyright notice,
      this list of conditions and the following disclaimer.
    * Redistributions in binary form must reproduce the above copyright notice,
      this list of conditions and the following disclaimer in the documentation
      and/or other materials provided with the distribution.
    * The name of the author nor the names of any contributors may be used to
      endorse or promote products derived from this software without specific
      prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
--  end license  --

Change Log:
 0.01.1
 * Fixed Slit suppot..
 ? Odd behavior in slit with transparencies to be expected.  Reason Unknown.
 0.01.0
 - Intial Release

What is broambox?
  Broambox is a simple dialog box that gives you an easy way to execute any
command in BB4Win, be it a bro@m, or shell command.  Broambox helps give you
full control over BB4Win with easy access to broams that could previously only
be accessed through a menu or hotkey.


Sample broambox.rc (or broamboxrc):
  broambox.x: 0
  broambox.y: 0
  broambox.width: 100
  broambox.inslit: false

What commands does broambox support?
  Broambox will attempt to process anything you enter as a command.
  Anything entered that begins with an "@" is posted as a bro@m to BB4Win.
  Anything the is encapsulated in "[" and "]" is processed as an internal
command (see next question).
  Everything else is processed as a shell command (ie, executing a program)

What internal commands does broambox support?
  The syntax of the internal commands is (nearly) identical to the syntax used
in menus.

  [exit]            Quit BB4Win 
  [quit]            Quit BB4Win
  [shutdown]        Shutdown Computer
  [reboot]          Reboot computer
  [logoff]          Logoff Computer
  [hibernate]       Hibernate
  [suspend]         Suspend
  [lock]            Lock Workstation
  [run]             Show run dialog
  [reconfig]        Reconfigue BB4Win
  [restart]         Restart BB4Win
  [editstyle]       Edit current style
  [editmenu]        Edit menu.rc
  [editplugins]     Edit plugins.rc
  [editextensions]  Edit extensions.rc

Why can't I set the height?
   Height of broambox is determined by the style.  It uses the style file
directive of "toolbar.fontHeight:" with a default height of 12.

What style direcetives does broambox use?
  Broambox uses "toolbar:" and "toolbar.label:".  It also correctly applies
parentRelative.

Can I change the style that broambox uses?
  No.  And I have enough of a rant in the next question that I'm not going to
put on here too.

Why can't I hide just broambox?
  Cause I think that shouldn't be allowed.  Sorry.  The hide plugin option
was first introduced with BBSlit and I whish I never had, but it's too late
now..  Anyway, broambox reponds to the @BBHidePlugins/@BBShowPlugins broams
just like all other plugins are suppose to.

Anything special I need to know?
  Why yes, yes there is.  broambox uses some "interesting" logic/trickery to
make sure that if it has focus when it is in the slit, that the slit doesn't
autohide.  Now this hasn't caused any problems in testing, but just be warned.
If you slit isn't autohiding, it could be because broambox has focus.

Special Stuff:
  I want to thank NC-17 and ironhead for being the awesome devs they are.  You
people who use BB4Win should really be greatful that they care about you.  I
also want to say that this will be the last release I make of a BB4Win plugin
for the forseeable future.  I have officially left the BB4Win development team
and will no longer be working on BB4Win or anything BB4Win related.  I'm sorry
to everyone who was waiting for BBIconsEx, but it's not going to happen.  Some
one else will have to pick up where I left off.  I have my reasons, but I
honestly don't feel like discussing them here.  I wish the BB4Win team the best
of luck, and I wish all you BB4Win'ers well..  It's been a great run and it was
fun while it lasted.  BTW, if you run into the easter eggs in broambox, congrats
