移動先: 概要 戻り値 フラグ. Python 例.

概要

hotkey([altModifier=boolean], [autoSave=boolean], [commandModifier=boolean], [ctrlModifier=boolean], [factorySettings=boolean], [isModifier=boolean], [keyShortcut=string], [name=string], [pressCommandRepeat=boolean], [releaseCommandRepeat=boolean], [releaseName=string], [sourceUserHotkeys=boolean])

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

hotkey は 「元に戻す」が可能、「照会」が可能、「編集」が不可能 です。

このコマンドは、アプリケーション全体用の単一キーのホットキーを設定します。

戻り値

なし

戻り値の型は照会モードでは照会フラグが基になります。

フラグ

altModifier, autoSave, commandModifier, ctrlModifier, factorySettings, isModifier, keyShortcut, name, pressCommandRepeat, releaseCommandRepeat, releaseName, sourceUserHotkeys
ロング ネーム（ショート ネーム） 引数型 プロパティ
altModifier(alt) boolean
ctrlModifier(ctl) boolean createquery
ホットキーを取得するには、Ctrl キーを押す必要があります。 メニュー項目のアクセラレータ キーが使用されている場合（menuItem -ke/keyEquivalent）、アクセラレータ キーの設定がホットキー設定をオーバーライドすることに注意してください。
commandModifier(cmd) boolean create
ホットキーを取得するには、コマンド キーを押す必要があります。 これは、個別のコマンド キーを持つシステム上でのみ使用可能です。 メニュー項目のアクセラレータ キーが使用されている場合（menuItem -ke/keyEquivalent）、アクセラレータ キーの設定がホットキー設定をオーバーライドすることに注意してください。
isModifier(mod) boolean create
ホットキーがモディファイアになります。
keyShortcut(k) string create
どのキーを設定するかを指定します。キーは、単一の ASCII 文字（大文字と小文字は別の文字として設定できます）または特殊キーボード文字のキーワード文字列のいずれかである必要があります。

有効なキーワードは、
Up、Down、Right、Left、
Home、End、Page_Up、Page_Down、Insert、
Return、Space、
F1 ～ F12 です。
name(n) string createquery
キーを押したときに実行される namedCommand オブジェクトの名前です。
releaseName(rn) string createquery
キーを離したときに実行される namedCommand オブジェクトの名前です。
autoSave(autoSave) boolean create
true に設定すると、終了するときに必ずホットキーが保存されます。false の場合は、「savePrefs -hotkeys」を使用しないかぎり、ホットキーは保存されません。
factorySettings(fs) boolean create
ホットキーを初期のデフォルトにリセットします。
sourceUserHotkeys(suh) boolean create
このコマンドは userHotkey ファイルを読み込みます。
pressCommandRepeat(pcr) boolean create
true を指定すると、コマンド repeatLast が実行されてコマンドが繰り返されます。このフラグはデフォルトでは false です。
releaseCommandRepeat(rcr) boolean create
true を指定すると、コマンド repeatLast が実行されてコマンドが繰り返されます。このフラグはデフォルトでは false です。
: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

import maya.cmds as cmds

# Here's an example of how to create a namedCommand
# object and then map it to a key.
#
cmds.nameCommand( 'circleToolNamedCommand', annotation='Select Circle Tool', command='setToolTo circleContext')
cmds.hotkey( k='F5', alt=True, name='circleToolNamedCommand' )


# Here are more examples of how to use the hotkey command.
#
cmds.hotkey( k='d', name='Delete_Command' )
cmds.hotkey( k='d', name='' ) # unsets the above command

cmds.hotkey( k='d', name='Delete_Command' )
cmds.hotkey( k='d', releaseName='After_Delete_Command' )
cmds.hotkey( k='d', name='' ) #only unsets the key press name
cmds.hotkey( k='d', releaseName='' ) #only unsets the key release name
cmds.hotkey( k='d', n='', rn='' ) #unsets both the key press and release name

#    Determine if a command is attached to either the press or release
#    of the "z" hotkey.
#
cmds.hotkey( 'z', query=True )

#    Likewise, for the modified variations of the "z" key.
#
cmds.hotkey( 'z', query=True, alt=True )
cmds.hotkey( 'z', query=True, ctl=True )
cmds.hotkey( 'z', query=True, alt=True, ctl=True )

#    Determine the press command attached to the "z" key.
#
cmds.hotkey( 'z', query=True, name=True )

#    To query the "-" hotkey use the string "Dash" instead.
#
cmds.hotkey( 'Dash', query=True )