CityDesk 2.0-Documentation
Running External Programs from the CityDesk Tools menuIf the built in features aren't enough for your site, you can program CityDesk to run an external program or batch file of your choice from the main CityDesk window.
For example, you can launch Larkware CopyBoy from within CityDesk to work with your CityDesk file. CopyBoy is an assistant application that adds some features for advanced users of CityDesk. For more information, visit theLarkware Web site.
These tools will be listed under the Tools menu in the CityDesk main window. If there are no tools installed, this menu will not appear.
In order to add items to the Tools menu you will need to be somewhat comfortable with editing the registry.
Items in the Tools menu are stored under the CityDesk key (HKEY_CURRENT_USER\Software\Fog Creek Software\CityDesk) in a folder called Tools. Each tool has two string values associated with it.
1. Tools1 (Tools2, Tools3, etc up to Tools9): The value of this key is the command that will be executed when you choose this menu item.
When you are providing an external application to run, you may use %1 in the command line. This will be replaced with the full path to the CityDesk file you are currently editing. For example, consider the following command line:
"CopyBoy.exe" "%1"
This will launch CopyBoy allowing you to edit your existing .cty file.
Also notice in our example the use of quotes. That is because the %1 will be replaced with a path to a folder which might include a space or two. This may confuse CopyBoy into thinking you are trying to open two files. To be safe always put quotes around the program name and each of the arguments you pass it.
For those familiar with the internal design of the CityDesk .cty file, %2 will also be replaced by the ixStructure of the currently selected node in the CityDeskmain window.
2. Title1 (Title2, Title3, etc up to Title9): This string is displayed in the Tools menu on the main window in CityDesk.
The first three items in the menu (Title1, Title2, Title3) can be executed with the keyboard shortcut Ctrl+F1, Ctrl+F2, Ctrl+F3 respectively.
©Copyright 2001-2003 Fog Creek Software, Inc. All Rights Reserved.