NkHotKey README

NkHotKeyはWindows用のホットキーユーティリティです。

インストール

nkhotkey.exeを適当なディレクトリにコピーしてください。

アンインストール

nkhotkey.exeを削除してください。レジストリには一切書き込みません。

使い方

keymapファイルを作成し、nkhotkey.exeを実行してください。タスクトレイのアイコンをクリックするとメニューが表示されます。

ファイル

ファイルは以下の場所に置いてください。

環境変数 NKTOOLSPROF が設定されていない場合	nkhotkey.exeと同じディレクトリ
環境変数 NKTOOLSPROF が設定されている場合	%NKTOOLSPROF%\nkhotkey

keymap

キーカスタマイズ設定。$環境変数名で環境変数を参照できます。また、以下の変数が定義されています。

$_foregroundwindow	フォアグラウンドウィンドウのハンドルの値
$_workareawidth	ワークエリアの幅
$_workareaheight	ワークエリアの高さ

ワークエリアとは、プライマリディスプレイの画面全体からタスクバーを除いた部分です。

設定例はkeymap-defaultを参照してください。

コマンド

exec [-d directory] filename [arg ...]

filenameを実行

filenameに実行ファイル以外を指定すると、そのファイルをOSの設定に従って開きます。-dオプションで作業ディレクトリを指定できます。

例:

ctrl+alt+cでnkcal.exeを実行

ca-c exec nkcal

ctrl+alt+hで環境変数HOMEに設定されているディレクトリを開く

ca-h exec $HOME

menu filename

メニューを表示

メニューファイル filenameに定義されたメニューを表示します。メニューファイルはkeymapと同じディレクトリから探します。

メニューファイルは1行1項目で以下の書式で定義します。エンコーディングはUTF-8です(バージョン0.3より)。

label command [arg ...]

label: メニューに表示する文字列。文字列内の"&"は、その次の文字をアクセスキーにします。
command [arg ...]: 実行するコマンドと引数。keymapと同じコマンドが使えます。

例:

メモ帳を起動

Notepad exec notepad.exe

Windowsのホームフォルダを開く

"Home Folder" exec $HOMEDRIVE$HOMEPATH

suspend

全てのキー割り当ての有効、無効の切り替え

このコマンドを割り当てたキーを除く、全てのキー割り当てを一時的に無効にします。もう一度実行すると元に戻します。

window command [options]

ウィンドウの操作

commands:

foreground [classname]: クラス名がclassnameのウィンドウをフォアグラウンドにします。現在のフォアグラウンドウィンドウのクラス名がclassnameと同じ場合は、同じクラス名の他のウィンドウをフォアグラウンドにします。
info: フォアグラウンドウィンドウのハンドル、キャプション、クラス名、位置を表示
minimize: フォアグラウンドウィンドウを最小化
minimizeall: 全てのウィンドウを最小化
pos [-c] [-l left] [-t top] [-r right] [-b bottom] [-w width] [-h height]: フォアグラウンドウィンドウの位置の設定。 -l, -t, -r, -bはそれぞれワークエリアの端からウィンドウの端までのピクセル数です。-tと-b、-lと-rを同時に指定した場合は後の指定が有効になります。-cはワークエリアの中央に設定します(センタリング)。-cを指定した場合、-l, -t, -r, -bの指定は無視します。
togglemaximize: フォアグラウンドウィンドウの最大化と通常表示の切り替え

例:

ctrl+alt+vでgvimをフォアグラウンドにする

ca-v window foreground Vim

ctrl+alt+shift+wでフォアグラウンドウィンドウの幅を1024にする

cas-w window pos -w 1024

ctrl+alt+6でフォアグラウンドウィンドウを画面右下隅に移動

ca-6 window pos -r 0 -b 0

問題の報告

bug-XXXX@nk2.org (XXXXはnkhotkeyに置き換えてください)に送ってください。

著作権表示

本ソフトウェアは「現状のまま」で、明示であるか暗黙であるかを問わず、何らの保証もなく提供されます。本ソフトウェアの使用によって生じるいかなる損害についても、作者は一切の責任を負わないものとします。

以下の制限に従う限り、商用アプリケーションを含めて、本ソフトウェアを任意の目的に使用し、自由に改変して再頒布することをすべての人に許可します。

本ソフトウェアの出自について虚偽の表示をしてはなりません。あなたがオリジナルのソフトウェアを作成したと主張してはなりません。あなたが本ソフトウェアを製品内で使用する場合、製品の文書に謝辞を入れていただければ幸いですが、必須ではありません。
ソースを変更した場合は、そのことを明示しなければなりません。オリジナルのソフトウェアであるという虚偽の表示をしてはなりません。
ソースの頒布物から、この表示を削除したり、表示の内容を変更したりしてはなりません。

This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.

Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:

The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.
Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
This notice may not be removed or altered from any source distribution.