============
BBTaskSwitch
============


Abstract
========

BBTaskSwitch is a plugin for Blackbox for Windows,
which replaces the Alt-Tab (task-switching) window by *box-styled one.




Files
=====

BBTaskSwitch.dll
	The plugin.

BBTaskSwitch.rc
	Configuration file for BBTaskSwitch.

ts.dll
mod_nix.dll
	Libraries for this plugin.
	Don't add these into your plugins.rc.




Operations
==========

Alt-Tab
	Select the next task.

Shift-Alt-Tab
	Select the previous task.

U-Alt (Releasing Alt)
	Switch the selected task.

Alt-NonTab (Pressing non-Tab while holding Alt)
	Cancel selecting task.




Configurations
==============

BBTaskSwitch reads its settings from the file named `BBTaskSwitch.rc'
which is in the same folder as `BBTaskSwitch.dll'.
It contains bro@ms one-per-line.
BBTaskSwitch just sends that bro@ms.




Bro@ms
======

@BBTaskSwitch Activate
	Activate BBTaskSwitch.

@BBTaskSwitch Inactivate
	Inactivate BBTaskSwitch.

@BBTaskSwitch ChangeEngine <type>
	Change the engine to check key operations such as Alt-Tab.
	<type> can be one of the following values:

	None
		Don't check any key operation by BBTaskSwitch.
		This may be useful to use external key customizing appliction
		such as MADO TSUKAI NO YUUTSU <http://mayu.sf.net/>.

	Simple
		Normal engine to check key operations.

	Hook
		Alternative engine to check key operations.
		Use this if you feel that
		BBTaskSwitch often misses U-Alt/Alt-NonTab.
		This engine is available on Windows NT 4.0 SP3 or later.

@BBTaskSwitch ChangeHotKey <key>
	Change the key to select task.
	<key> is a virtual-key code [*].
	The default value means the Tab key.

	For example, if <key> is 0x70 (F1 key),
	the hot keys (Alt-Tab/Shift-Alt-Tab) to select task
	will be changed for Alt-F1/Shift-Alt-F1.

	If you use Windows 9x, you have to change this.
	Because BBTaskSwitch can't override Alt-Tab.

	[*] http://msdn.microsoft.com/library/en-us/winui/WinUI
	    /WindowsUserInterface/UserInput/VirtualKeyCodes.asp

@BBTaskSwitch Next
@BBTaskSwitch Prev
@BBTaskSwitch Switch
@BBTaskSwitch Cancel
	Control BBTaskSwitch (from application other than BBTaskSwitch).
	To use these bro@ms,
	the engine must be None (@BBTaskSwitch ChangeEngine None).

@BBTaskSwitch mod_nix BasePadding <top> [<right> [<bottom> [<left]]]
	Change the amount of paddings of the entire Alt-Tab window in pixels.

@BBTaskSwitch mod_nix BaseStyle <style>
	Change the gradient style of the entire Alt-Tab window.

	<style> can be one of the following values:

	menu.title
	menu.frame
	menu.hilite,
	toolbar
	toolbar.label
	toolbar.windowlabel
	toolbar.clock

@BBTaskSwitch mod_nix BaseBorder <bool>
	Specify whether to draw the border of the entire Alt-Tab window.

@BBTaskSwitch mod_nix TaskPadding <top> [<right> [<bottom> [<left]]]
@BBTaskSwitch mod_nix TaskStyle <style>
@BBTaskSwitch mod_nix TaskBorder <bool>
	Same as `@BBTaskSwitch BasePadding' and others,
	but for the selected task line.




Known issues
============

- BBTaskSwitch rarely misses U-Alt and Alt-NonTab.
  Especially, BBTaskSwitch often misses them while CPU usage is high.




Q & A
=====

Why don't you add icons for BBTaskSwitch?

	I'll never add icons or other things,
	because I made this plugin to reproduce
	the one of original blackbox on *nix.




ChangeLog
=========

0.1.1	2005-03-02
	- Added the following bro@ms:

	  @BBTaskSwitch Next
	  @BBTaskSwitch Prev
	  @BBTaskSwitch Switch
	  @BBTaskSwitch Cancel

	- Renamed some bro@ms.

	- Fixed minor issues.

0.1.0	2005-02-24/25
	- Rewritten.

	- Modified for multi monitor environments
	  to pop up the Alt-Tab window on the monitor
	  where the active window is.
	  (Thanks, NC-17)

0.0.3	2004-08-18
	- Added the option `bbtaskswitch.hot_key'.

	- Modified to work on Windows 9x,
	  though you have to change `bbtaskswitch.hot_key'.

0.0.2	2004-08-15
	- Improved the normal method to recognize key-strokes.
	  The normal method maybe works as well as the alternative method.

	- Modified to cansel selecting task
	  by pressing a key which is not tab, alt or shift.
	  In short, pressing ctrl or win while selecting task
	  will cansel selecting task like the default one of Windows.

	- Added the option `bbtaskswitch.screening_method'.

0.0.1	2004-08-09
	- Modified to switch automatically when there is only one task
	  as well as the default one of Windows.

	- Improved the algorithm to enumerate tasks.
	  Now BBTaskSwitch will show tasks
	  as well as the default one of Windows.

	- Removed `use_pid_checking' option and `exclusion' function.
	  They are disused by the above improvement.

0.0.0	2004-08-01/02
	- Added the option `use_pid_checking' to exclude some applications
	  which are showed in the task list redundantly.

	- Added `exclusion' function to exclude some applications
	  which are not expected to be showed in the task list.

0.0.0c	2004-07-31
	- Appearance of the Alt-Tab window is configurable
	  (drawing border and so forth).

	- Added alternative method to check U-Alt and Alt-NonTab.
	  See the description about configurations.

0.0.0b	2004-07-29/30
	- Fixed to switch to the right workspace
	  when switching a task which is not in the current workspace,
	  even if `blackbox.tasks.followActive' (in extensions.rc) is false.
	  (Thanks, NC-17)

	- Fix the bug that BBTaskSwitch freezes blackbox
	  by pressing Alt-Tab or Shift-Alt-Tab
	  when there is no task except blackbox.
	  (Thanks, Arc Angel)

	- Modified not to show the task list
	  when there is one task except blackbox.
	  This will be like the default of Windows more.

0.0.0a	2004-07-28
	- Test release.




Misc.
=====

BBTaskSwitch is released under the terms of GNU General Public License
either version 2 or (at your option) any later version.

Latest information: http://nicht.s8.xrea.com/2004/07/28/BBTaskSwitch

Copyright (C) 2004-2005 kana <nicht AT s8 DOT xrea DOT con>




__END__
