|
To load BBSystemBar you simply need to add the relative path of the plugin (from your Blackbox directory) to the Blackbox configuration file plugins.rc (located in the Blackbox directory).
For example, if you installed Blackbox into c:\Blackbox, and BBSystemBar.dll is located in c:\Blackbox\plugins\BBSystemBar, you should add the line...
plugins\BBSystemBar\BBSystemBar.dll
...to plugins.rc.
|
how to use BBSystemBar...
|
Ctrl + right clicking on the BBSystemBar will bring up a menu that allows for the setting of the configuration
variables. Indicators are displayed for the currently selected configuration items. Any changes are effective
immediately, and the BBSystemBar will respond accordingly.
Ctrl + left click and dragging allows for the temporary movement of BBSystemBar. Shift + left clicking on BBSystemBar
will return it to it's original location.
BBSystemBar has the option of displaying a system tray. If the system tray is displayed, the icons respond
to standard mouse functions (i.e. left-click or right-click on the icons).
BBSystemBar also contains an optional task list. If the task list is displayed, left clicking on a task
will make the task active (including restoring it from a minimized state). Right clicking on a task will
minimize the task. Mid-clicking on a task moves it one workspace to the right. Shift mid-clicking on a
task will move the task one workspace to the left. Alt + left clicking will switch between task bar and
task icon appearance.
BBSystemBar responds to standard plugin broadcast messages (bro@ms):
@BBHidePlugins, @BBShowPlugins
Additionally, the following bro@ms can also be used:
@BBSystemBarAbout About box for BBSystemBar
@BBSystemBarPluginToggle Should BBSystemBar respond to Toggle Plugins?
@BBSystemBarToggleLinkToToolbar Toogle the linking to the toolbar
@BBSystemBarToggleSystray Toggle the systray, provided BB4win
is not running on top of Windows Explorer
@BBSystemBarToggleTasks Toggle the tasks
@BBSystemBarMinimizeAll Minimize all the tasks
@BBSystemBarRestoreAll Restore all the tasks
The following bro@ms only work if BBSystemBar is not linked to the Toolbar:
@BBSystemBarOnTop Toggle onTop setting for BBSystemBar
@BBSystemBarTopLeft Move BBSystemBar to the top left
@BBSystemBarTopCenter Move BBSystemBar to the top center
@BBSystemBarTopRight Move BBSystemBar to the top right
@BBSystemBarBottomLeft Move BBSystemBar to the bottom left
@BBSystemBarBottomCenter Move BBSystemBar to the bottom center
@BBSystemBarBottomRight Move BBSystemBar to the bottom right
I have included a default configuration file (BBSystemBar.rc) in the .zip, but if a configuration file for some reason
can not be found at startup (BBSystemBar will first search for it in the same directory as the plugin, then in the Blackbox directory),
BBSystemBar will start with default values which are specified below:
systembar.linkToToolbar: true "Link" the SystemBar to the Toolbar
(Note: overrides x, y, widthPercent and onTop settings)
systembar.widthPercent: 100 width of SystemBar with respect to screen width
systembar.placement: TopLeft BBSystemBar placement
systembar.onTop: false Always on top?
systembar.tasks.enabled: true Display tasks?
systembar.hidden: false BBSystemBar visible?
systembar.pluginToggle: true Should BBSystemBar respond to Plugin Toggle?
systembar.systray.enabled: true Display systray?
systembar.icon.saturation: 255 Amount to blend in real icon color (255 - 0)
systembar.icon.hue: 0 Degree of bar color to use on icon (0 - 255)
Note: If Blackbox for Windows is running on top Windows Explorer, no systray will be available.
|