hotkey

ジャンプ先: 概要. 戻り値. 関連. フラグ. MEL 例.

概要

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

hotkey は、取り消し可能、照会可能、および編集不可能です。

戻り値

なし

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-altModifier(-alt)
-autoSave(-as)	boolean
true に設定すると、終了するときに必ずホットキーが保存されます。false の場合は、「savePrefs -hotkeys」を使用しないかぎり、ホットキーは保存されません。
-commandModifier(-cmd)
ホットキーを取得するには、コマンド キーを押す必要があります。これは、個別のコマンド キーを持つシステム上でのみ使用可能です。メニュー項目のアクセラレータ キーが使用されている場合(menuItem -ke/keyEquivalent)、アクセラレータ キーの設定がホットキー設定をオーバーライドすることに注意してください。
-ctrlModifier(-ctl)
ホットキーを取得するには、Ctrl キーを押す必要があります。メニュー項目のアクセラレータ キーが使用されている場合(menuItem -ke/keyEquivalent)、アクセラレータ キーの設定がホットキー設定をオーバーライドすることに注意してください。
-ctxClient(-cc)	string
ホットキーのコンテキストを指定します。他のフラグと一緒に使用すると、特定のホットキー コンテキストでホットキーを変更したり、照会することができます。このフラグを指定しない場合は、グローバル ホットキーコンテキストが考慮されます。ホットキー コンテキストでのホットキーの動作を確認するには、hotkeyCtx コマンドを調べてください。
-dragPress(-dp)	boolean
ｔrue を指定すると、マニピュレータのドラッグ中にコマンドを実行できます。ただし、ツール コンテキストでこの操作が許可されている場合に限ります。このフラグは既定では false です。
-factorySettings(-fs)
ホットキーを初期の既定にリセットします。
-isModifier(-mod)
このフラグは廃止されているので、使用しないでください。
-keyShortcut(-k)	string
どのキーを設定するかを指定します。キーは、単一の ASCII 文字(大文字と小文字は別の文字として設定できます)または特殊キーボード文字のキーワード文字列のいずれかである必要があります。 有効なキーワードは、 Up、Down、Right、Left、 Home、End、Page_Up、Page_Down、Insert、 Return、Space、 F1 ～ F12、 Tab(モディファイヤが指定されている場合のみ機能します)、 Delete、Backspace(モディファイヤが指定されている場合のみ機能します)です。
-name(-n)	string
キーを押したときに実行される namedCommand オブジェクトの名前です。
-pressCommandRepeat(-pcr)	boolean
true を指定すると、コマンド repeatLast が実行されてコマンドが繰り返されます。このフラグは既定では false です。
-releaseCommandRepeat(-rcr)	boolean
true を指定すると、コマンド repeatLast が実行されてコマンドが繰り返されます。このフラグは既定では false です。
-releaseName(-rn)	string
キーを離したときに実行される namedCommand オブジェクトの名前です。
-shiftModifier(-sht)
ホットキーを取得するには、Shift キーを押す必要があります。
-sourceUserHotkeys(-suh)
このフラグは現在サポートしていません。ユーザ ホットキーを読み込むには、hotkeySet コマンドで import フラグを使用してください。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	コマンド内でフラグを複数回使用できます。

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;

//    Here's an example of how to create runtimeCommand with  a certain hotkey context,
//    and map it to a key.
//

//    Create a command with "paintEffects" hotkey context.
//
runTimeCommand
	-annotation "Modify the Brush Size for the Paint Effects Tool"
	-category "Paint Effects"
	-commandLanguage "mel"
	-command ("dynWireCtx -e -dbs \"width\" `currentCtx`;")
	-hotkeyCtx ("paintEffects")
	ModifyBrushSize;

nameCommand
	-annotation "ModifyBrushSizeNameCommand"
	-sourceType "mel"
	-command ("ModifyBrushSize")
	ModifyBrushSizeNameCommand;

//    Assign the paintEffects as a hotkey context client.
//
hotkeyCtx -type "Tool" -addClient "paintEffects";

//    Map a key to the newly created command.
//    When the Paint Effects Tool is activated, the b key will work within this tool and
//    override editor and application-wide contexts.
hotkey -keyShortcut "b" -name "ModifyBrushSizeNameCommand";

//    Determine the press command attached to the "b" key within the tool's context.
//
hotkey -query -ctxClient "paintEffects" -name b;

//    Unset the key press name within the tool's context
//
hotkey -k "b" -name "" -ctxClient "paintEffects";