ECMTuning - wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

<h1>ECMLink V3 Key Bindings</h1> <div class="level1"> <p> It's possible to change the key bindings (accelerator keys, hot keys, whatever you want to call them) used by ECMLink. For example, if F12 is not a good hot key for you to use to start a new log, you can change that to be Ctrl-L or maybe even just the S key by itself! </p> <p> An outline of the basic process is provided below with more details to follow. </p> <ol> <li class="level1"> Locate the installed default property files</li> <li class="level1"> Copy these into your local home directory</li> <li class="level1"> Edit local copy</li> </ol> <p> <b>NOTE:</b> Make sure you have installed at least version 3.24.70 off our <a href="http://www.ecmtuning.com/downloads.php" class="urlextern" title="http://www.ecmtuning.com/downloads.php" rel="nofollow">downloads page</a> <u>first</u> before you proceed. </p> </div> <h2>Default files</h2> <div class="level2"> <p> Default files will be installed with each new version of ECMLink. You should not edit these directly because they will be blindly replaced by future releases. But you do need to start with a copy of these because they define all the editable stuff. </p> <p> The location of these files will be in your ECMLink application install directory. Under Windows, this will typically be one of these two places. </p> <p> 32-bit Windows: </p> <pre class="code">C:\Program Files\ECMLink\ </pre><p> </p> <p> 64-bit Windows: </p> <pre class="code">C:\Program Files (x86)\ECMLink\ </pre><p> </p> <p> In that directory, you'll find the following two directories. </p> <pre class="code">resources\com\ecmtuning\ecmlink\view\ecmlink\ resources\com\ecmtuning\ecmlink\view\main\ </pre><p> </p> <p> These two directories each contain a file named <b>Action.properties</b>. You're going to copy (and rename) these two <b>Action.properties</b> files as your new starting files in your local home directory. </p> </div> <h2>Local home directory</h2> <div class="level2"> <p> Locate your user home directory for ECMLink data files. Under Windows, this will be: </p> <p> Windows XP: </p> <pre class="code">C:\Documents and Settings\&lt;username>\ecmlink\ </pre><p> </p> <p> Windows Vista/7: </p> <pre class="code">C:\Users\&lt;username>\ecmlink\ </pre><p> </p> <p> Locate the same directories under here as you found under the program files. </p> <pre class="code">resources\com\ecmtuning\ecmlink\view\ecmlink\ resources\com\ecmtuning\ecmlink\view\main\ </pre><p> </p> <p> Now copy each <b>Action.properties</b> from your ECMLink install directory into the corresponding directory in your user home directory. </p> <p> Once you've done that, rename each <b>Action.properties</b> file that you just copied into your user home directory to be <b>Action_en.properties</b> instead. This will let you edit your local home copy and remove everything you don't care about while picking up default values from the original <b>Action.properties</b> file in your install directory. </p> <p> <b>LANGUAGES NOTE:</b> If you have your base Windows language local set to something other than US English, you may need to name that _ckgedit_QUOT<u>en" part differently. To know, open up the ECMLink application and go into the Help→About dialog then click on the System tab and scroll down to user.language. If that says something other than "en", use that value instead of "en" in the <b>Action_en.properties</b> filename. Common alternatives are <b>Action_fr.properties</b> (french), <b>Action_es.properties</b> (spanish), etc. ===== Edit the local files ===== Now that you have a localized copy in your home directory that won't get blown away when you upgrade ECMLink, you can edit this file at will. Open it up in Wordpad (don't use Notepad as it doesn't like the file format!) and change whatever you want. For example, if you open the <b>Action_en.properties</b> file in the view\ecmlink directory, you'll see the following line. ecmlinkConnect.accelerator = F2 That defines the quick-key for "connect" to be F2. If you want to use Ctrl-C instead, just change that to be: ecmlinkConnect.accelerator = ctrl C The exact syntax for these accelerators is given below (if you're really brave). &lt;modifiers>* (&lt;typedID> | &lt;pressedReleasedID>) modifiers := shift | control | ctrl | meta | alt | button1 | button2 | button3 typedID := typed &lt;typedKey> typedKey := string of length 1 giving Unicode character. pressedReleasedID := (pressed | released) key key := KeyEvent key code name, i.e. the name following "VK</u>ckgedit_QUOT_. </p> <p> Examples are in the <b>Action.properties</b> files. Stuff like "ctrl L" works and "END" or "PAGE_UP" or "PAGE_DOWN", etc. Refer to this page for more examples. </p> <p> <a href="http://docs.oracle.com/javase/1.4.2/docs/api/java/awt/event/KeyEvent.html" class="urlextern" title="http://docs.oracle.com/javase/1.4.2/docs/api/java/awt/event/KeyEvent.html" rel="nofollow">http://docs.oracle.com/javase/1.4.2/docs/api/java/awt/event/KeyEvent.html</a> </p> <p> When you see something like "VK_PASTE", you can use the "PASTE" portion as your accelerator name. Just drop the VK_ prefix. </p> </div>