Hi Roger,
Roger said:
Yes, the tools are indeed confusing when you first try to use them. The
only way to figure out what the different options do is to tinker around
with the options, and check to see what has changed.
Trying to reply to myself. Probably for all formats. (?)
No, "tool_utl.dll" is not for all formats. Let me explain a bit, in
tutorial format, for the benefit of all
There are 2 types of plugin DLLs that can be used with CLCL, Format
plugins, and Tool plugins.
-Format Plugins-
Format plugins enable CLCL to capture and store additional clipboard
formats. Examples are "fmt_metafile.dll" and "fmt_rtf.dll", which allow
for Metafile and RTF clipboard support, respectively.
These format plugin DLLs can be configured as follows:
1) Download the additional Format plugins that you wish to use, from
http://nakka.com/soft/clcl/index_eng.html . These are listed right at
the bottom of the page. Currently 3 plugins to support Unicode
(fmt_unicode.dll), RTF (fmt_rtf.dll), and Metafiles (fmt_metafile.dll)
are available.
2) Left-click once on the CLCL system tray icon.
3) This will open the CLCL "Viewer" window. Click "View" on the menu
bar, and select "Options".
4) The "CLCL - Options" dialog opens. Click to activate the "Format" tab.
5) Click the "Add..." button.
6) The "Edit of Clipboard Format" dialog box opens. Click the
"Browse..." button.
7) Browse to the path containing the DLLs that you downloaded in Step 1.
Select the plugin DLL (e.g fmt_metafile.dll), and click "Open".
8) The "Select function header" dialog box opens. Click OK.
9) Click "OK" to close the "CLCL - Options" dialog box.
Your selected format plugin is now configured, and this format will be
picked up and stored whenever it is available on the clipboard.
Note that you can only select 1 plugin DLL in step 7 from the Open
dialog box. So, steps 5 to 8 need to be repeated for each format plugin
DLL that you wish to add.
-Tool Plugins-
The second category of CLCL plugins can be thought of as a set of tiny
utilities, called "tools" that perform one or more functions. A single
Tool plugin DLL can contain one or more tools, and each tool performs
one specific task, such as "Clear Clipboard" or "Clear History". The
steps to configure tool plugins, and a description of what the different
tools do is given below.
1) Download the Tool plugins that you wish to use, from
http://nakka.com/soft/clcl/index_eng.html . These are listed right at
the bottom of the page. Currently 2 plugins DLLs containing text
manipulation functions (tool_text.dll), and utilitity tools
(tool_utl.dll) are available.
2) Left-click once on the CLCL system tray icon.
3) This will open the CLCL "Viewer" window. Click "View" on the menu
bar, and select "Options".
4) The "CLCL - Options" dialog opens. Click to activate the "Tool" tab.
Note that Tool plugins are configured on the "Tool" tab, while Format
plugins are configured on the "Format" tab.
5) Click the "Add..." button.
6) The "Edit of Tool" dialog is displayed. Click the "Browse..." button.
7) Browse to the path containing the DLLs that you downloaded in Step 1.
Select the plugin DLL (e.g tool_text.dll), and click "Open".
8) The "Select Tool" dialog opens up. This dialog displays all the tools
contained in the selected DLL. Select a tool and click OK. Note that you
cannot select multiple tools in this dialog.
9) Click OK to close the "Edit of Tool" dialog.
10) Repeat steps 5 to 9 to add more tools.
Unfortunately, you can select only a single tool in Step 8, so you will
have to repeat steps 5 to 8 to configure multiple tools even if they are
all contained in the same DLL.
Many of these tools operate on the currently selected History item (or
items) in the Viewer. This means that when you select Tools -> ToolName,
you must make sure that the appropriate History item is first selected,
since the tool will perform its action on the currently selected item(s).
Here is a small explanation of what each tool does.
-Tools in "tool_text.dll"-
1) To &Lower – Converts the text in the selected item(s) to lowercase.
2) To &Upper - Converts the text in the selected item(s) to uppercase.
3) &Quotation – Brings up a dialog where you can enter a quotation
character (default character is >). When you enter the character and
click OK, each line of text in the selected item(s) will be prefixed by
the quotation character. For example, if the quotation character entered
is >> , the text :
This is just
an example
will turn into
4) U&n Quotation - Brings up a dialog where you can enter a quotation
character (default character is >). When you enter the character and
click OK, the quotation character at the beginning of each line of text
in the selected item(s) will be removed (if it exists). For example, if
the quotation character entered is >> , the text :
will turn into
This is just
an example
This feature is especially useful to strip the quotation characters from
the text in forwarded emails / quoted newsgroup posts.
5)<&TAG></TAG> - Brings up a dialog where you can enter a start and end
tag to wrap the text in the selected item(s) with. For example, if you
enter <B> for the "Start character" and </B> for the "End character",
the text
Turn Bold today
will turn into
<B>Turn Bold today</B>
6) Delete C&RLF - Removes any line breaks from the text in the selected
item(s). For example, the text
This sentence
has too
many line breaks
will turn into
This sentence has too many line breaks
7) C&onnection of text - This tool concatenates (or "connects", hence
the name of the tool) the text in all selected items, and copies them to
the clipboard. For example, if the following 3 History items are selected :
i) United
ii) we
iii) stand
running this tool will copy the following text to the clipboard :
United we stand
8) &Word Wrap - This tool brings up a dialog where you can enter a
number that is the column width (number of characters) to wrap the text
in the selected items into.
-Tools in "tool_utl.dll"-
1) Clear &History - This tool will delete all History items.
2) Clear &Clipboard - This tool will empty the clipboard of its
current contents.
3) Save of &more items - This tool will save the text in each selected
item into its own text file. You can choose the folder where these files
will be saved, and also specify the naming convention of the saved files.
4) Always on &Top - This will set the CLCL Viewer window to "Always on
top", which means that the Viewer window will remain in front of all
other windows even when some other window is active.
5) &Un Top - This will remove the "Always on top" attribute of the
Viewer window, if it was previously set using the "Always on &Top" tool.
6) &Play Sound - This tool will play a wav file of your choice when a
user-specified event occurs. To configure the wav file, select
View->Options in the Viewer. Click on the "Tool" tab. Select "&Play
Sound" from the list of tools, and click the "Properties..." button. The
"Open" dialog pops up, and you can select the desired wav file and click
OK. To configure the event when this wav sound is played, select "&Play
Sound" from the list of tools, and click the "Edit..." button. The "Edit
of tool" dialog opens up, and you can select the event in the "Call
Type" section. For example, checking "When data is added to h&istory"
will play the wav sound, whenever a new item is added to CLCL's list of
History items.
Hope this helps !
Regards,
Mario