EditPro - the Professional Editor for Windows

TOOLSINI.TXT
------------
TOOLSINI.TXT is the third of three text files that contain 
information about the EditPro .INI files.

The files include:

	EPINI.TXT 	describes the EP.INI file, which 
			contains general settings for 
			EditPro.

	MENUSINI.TXT	describes the MENUS.INI file, 
			which controls the EditPro menu bar.

	TOOLSINI.TXT	describes the TOOLS.INI file, which
			controls the assignment of icons to
			the Icon ToolBar, Icon ToolBox, and
			Icon ToolCube.

TOOLS.INI
---------
The TOOLS.INI file contains parameters that EditPro uses to
define the Icon ToolBar, ToolBox, and ToolCube, and the 
commands and images associated with the items in the 
buttons.

You can manually edit, add, and delete the images associated
with buttons, customize the command associations, or use the
Icon Palette Designer dialog box to automatically change the
values of the parameters.


Format
------
As a general rule, all of the .INI files follow the same 
format:

	[Section Name]
	keyname=value

Hint: use the Show Sections command in the File menu to 
move around in large .INI files.  This will show a list
of all [Section Name] sections for that .INI file.


Default TOOLS.INI
-----------------
The following sections appear in the default TOOLS.INI file:

	[ToolBox]	Entries describe the options, buttons, 
			commands, and image associations for the 
			Icon ToolBox.
	
	[ToolBar]	Entries describe the options, buttons, 
			commands, and image associations for the 
			Icon ToolBar.

	[ToolCube]	Entry describes the options for the 
			Icon ToolCube.

	[ToolCube1]	Entries describe the buttons, commands, 
			and image associations for side 1 of the 
			Icon ToolCube.

	[ToolCube2]	Entries describe the buttons, commands, 
			and image associations for side 2 of the 
			Icon ToolCube.

	[ToolCube3]	Entries describe the buttons, commands, 
			and image associations for side 3 of the 
			Icon ToolCube.

	[ToolCube4]	Entries describe the buttons, commands, 
			and image associations for side 4 of the 
			Icon ToolCube.

[ToolBox]
---------
Setting the defaults for the Icon ToolBox - The following is 
the general format for the Icon ToolBox options:

	Options=#rows #cols width height style


Where:

	#rows		indicates the number of rows of 
			buttons displayed in the Icon 
			ToolBox.

	#cols		indicates the number of columns of 
			buttons displayed in the Icon ToolBox.

	width		indicates the width of each button in 
			pixels.
	
	height		indicates the height of each button in
			pixels.

	style		indicates scrolling method, horizontal
			scroll bars, vertical scroll bars, or 
			scroll buttons.  Refer to the TBX_style
			entries in the \MACROS\EDITPRO.H macro
			header file.

For example:

	[ToolBox]
	Options=6 2 37 30 12288		[default options]


Setting the button, command, and image associations - the 
following is the general format for the [ToolBox] section:

	button_number=command_id image_name


Where:	

	button_number	is the number of the button in the
			Icon Toolbox.  Buttons are numbered 
			sequentially.

	command_id	is the id number of the command 
			executed when the button is chosen.

	image_name	is the filename, with extension, of 
			the image associated and displayed on
			button_number.  The images are in the 
			\BUTTONS subdirectory.

For example:

	[ToolBox]
	Options=6 2 37 30 12288		[default options]
	1=101 fopen.bmp
	2=102 fclose.bmp
		.
		.
		.

[ToolBar] 
---------
Setting the defaults for the Icon ToolBar - the following
is the general format for the Icon ToolBar options:

	Options=position #rows #cols width height style

Where:	

	position	indicates the location of the ToolBar.
			Possible locations are TOP, BOTTOM, 
			LEFT, and RIGHT.

	#rows		indicates the number of rows of buttons 	
			displayed in the Icon ToolBar.

	#cols		indicates the number of columns of 
			buttons displayed in the Icon ToolBar.

	width		indicates the width of each button in 
			pixels.
	
	height		indicates the height of each button in
			pixels.

	style		indicates scrolling method, horizontal 
			scroll bars, vertical scroll bars, or 
			scroll buttons.


For example:

	[ToolBar]
	Options=0 1 1 37 30 0		[default options]


Setting the button, command, and image associations - the
following is the general format for the [ToolBar] section:

	button_number=command_id image_name

	
Where:	

	button_number	is the number of the button in the
			Icon Toolbar.  Buttons are numbered
			sequentially left to right.

	command_id	is the id number of the command 
			executed when the button is chosen.

	image_name	is the filename, with extension, of 
			the image associated and displayed 
			on button_number.  The images are in
			the \BUTTONS subdirectory.

For example:

	[ToolBar]
	Options=0 1 1 37 30 0		[default options]
	1=101 fopen.bmp
	2=102 fclose.bmp
		.
		.
		.


[ToolCube]
----------
Setting the defaults for the Icon ToolCube - the following
is the general format for the Icon ToolCube options:

	Options=#sides #cols width height style


Where:	

	#sides		indicates the number of sides of
			buttons displayed in the Icon 
			ToolCube.  2 or 4 sides only.

	#cols		indicates the number of columns of 
			buttons displayed in the Icon ToolCube.

	width		indicates the width of each button in 
			pixels.
	
	height		indicates the height of each button in 
			pixels.

	style		indicates scroll buttons.


For example:

	[ToolCube]
	Options=4 3 37 30 0	[default options]


[ToolCubeN]
-----------
Setting the button, command, and image associations - the
following is the general format for the [ToolCubeN] 
section:

	button_number=command_id image_name


Where:	

	button_number	is the number of the button in the
			Icon ToolCube side n.  Buttons are 
			numbered sequentially.

	command_id	is the id number of the command 
			executed when the button is chosen.

	image_name	is the filename, with extension, of
			the image associated and displayed 
			on button_number.  The images are 
			in the \BUTTONS subdirectory.


For example:

	[ToolCube1]
	1=101 fopen.bmp
	2=102 fclose.bmp
		.
		.
		.

