hotkey

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

概要

hotkey [-altModifier] [-autoSave boolean] [-commandModifier] [-ctrlModifier] [-factorySettings] [-isModifier] [-keyShortcut string] [-name string] [-pressCommandRepeat boolean] [-releaseCommandRepeat boolean] [-releaseName string] [-sourceUserHotkeys]

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

戻り値

なし

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

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
-altModifier(-alt)
-ctrlModifier(-ctl)
ホットキーを取得するには、Ctrl キーを押す必要があります。 メニュー項目のアクセラレータ キーが使用されている場合（menuItem -ke/keyEquivalent）、アクセラレータ キーの設定がホットキー設定をオーバーライドすることに注意してください。
-commandModifier(-cmd)
ホットキーを取得するには、コマンド キーを押す必要があります。 これは、個別のコマンド キーを持つシステム上でのみ使用可能です。 メニュー項目のアクセラレータ キーが使用されている場合（menuItem -ke/keyEquivalent）、アクセラレータ キーの設定がホットキー設定をオーバーライドすることに注意してください。
-isModifier(-mod)
ホットキーがモディファイアになります。
-keyShortcut(-k)	string
どのキーを設定するかを指定します。キーは、単一の ASCII 文字（大文字と小文字は別の文字として設定できます）または特殊キーボード文字のキーワード文字列のいずれかである必要があります。 有効なキーワードは、 Up、Down、Right、Left、 Home、End、Page_Up、Page_Down、Insert、 Return、Space、 F1 ～ F12 です。
-name(-n)	string
キーを押したときに実行される namedCommand オブジェクトの名前です。
-releaseName(-rn)	string
キーを離したときに実行される namedCommand オブジェクトの名前です。
-autoSave(-as)	boolean
true に設定すると、終了するときに必ずホットキーが保存されます。false の場合は、「savePrefs -hotkeys」を使用しないかぎり、ホットキーは保存されません。
-factorySettings(-fs)
ホットキーを初期のデフォルトにリセットします。
-sourceUserHotkeys(-suh)
このコマンドは userHotkey ファイルを読み込みます。
-pressCommandRepeat(-pcr)	boolean
true を指定すると、コマンド repeatLast が実行されてコマンドが繰り返されます。このフラグはデフォルトでは false です。
-releaseCommandRepeat(-rcr)	boolean
true を指定すると、コマンド repeatLast が実行されてコマンドが繰り返されます。このフラグはデフォルトでは false です。

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: 1 つのコマンドで複数回使用可能なフラグ

MEL 例

// Here's an example of how to create a namedCommand
// object and then map it to a key.
//
nameCommand
    -annotation "Select Circle Tool"
    -command "setToolTo circleContext"
    circleToolNamedCommand;
hotkey -k "F5" -alt -name "circleToolNamedCommand";


// Here are more examples of how to use the hotkey command.
//
hotkey -k "d" -name "Delete_Command";
hotkey -k "d" -name "";  // unsets the above command

hotkey -k "d" -name "Delete_Command";
hotkey -k "d" -releaseName "After_Delete_Command";
hotkey -k "d" -name "";         //only unsets the key press name
hotkey -k "d" -releaseName "";  //only unsets the key release name
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.
//
hotkey -query z;

//    Likewise, for the modified variations of the "z" key.
//
hotkey -query -alt z;
hotkey -query -ctl z;
hotkey -query -alt -ctl z;

//    Determine the press command attached to the "z" key.
//
hotkey -query -name z;

//    To query the "-" hotkey use the string "Dash" instead.
//
hotkey -query Dash;