This is a read-only mirror of pymolwiki.org
Difference between revisions of "Check Key"
Jump to navigation
Jump to search
(Created page with '===DESCRIPTION=== A simple script used to check if a given key is valid for for the set_key command. This is useful when the user would like to use a keyboard key as short…') |
|||
Line 1: | Line 1: | ||
===DESCRIPTION=== | ===DESCRIPTION=== | ||
− | A simple script used to check if a given key is valid for for the [[ | + | A simple script used to check if a given key is valid for for the [[Set Key]] command. This is useful when the user would like to use a keyboard key as shortcut/hotkey in their script but need to check if the key is a valid one. |
===USAGE=== | ===USAGE=== | ||
Line 11: | Line 11: | ||
</source> | </source> | ||
− | If the key specified is a valid one as defined in [[ | + | If the key specified is a valid one as defined in [[Set Key]] then it returns the value of the keystroke. Otherwise, it returns None. |
− | For an example that calls this script, see [[ | + | For an example that calls this script, see [[Jump]]. |
===PyMOL API=== | ===PyMOL API=== |
Revision as of 03:50, 25 May 2010
DESCRIPTION
A simple script used to check if a given key is valid for for the Set Key command. This is useful when the user would like to use a keyboard key as shortcut/hotkey in their script but need to check if the key is a valid one.
USAGE
load the script using the run command
check_key (keystroke)
If the key specified is a valid one as defined in Set Key then it returns the value of the keystroke. Otherwise, it returns None.
For an example that calls this script, see Jump.
PyMOL API
from pymol import cmd
import re
allowed_keys=re.compile('(F1|F2|left|right|pgup|pgdn|home|insert|(CTRL-[A-Z])|ALT-[A-Z0-9])')
def check_key (keystroke):
keystroke=keystroke.strip('\"\'')
out=allowed_keys.search(keystroke)
if (out != None):
return keystroke
else:
print "Error: Invalid key \""+keystroke+"\""
print "Valid Keys: F1, F2, left, right, pdup, pgdn, home, insert"
print " CTRL-A to CTRL-Z"
print " ALT-0 to ALT-9, ALT-A to ALT-Z"
return
cmd.extend("check_key", check_key)