起動と終了

起動は、"HELuPER.exe"を実行するだけです。起動すると、タスクトレイ（通知領域）にアイコンが登録され、“ビューア”と“情報パネル”が現れます。

終了するには、タスクトレイアイコンを右クリックしてメニューを開き、終了を選択してください。

ビューア

ビューアには、マウスカーソルが指し示す場所（これを“注目点”と呼びます）の周辺が拡大表示されます。マウスカーソルは映りません。

ビューアは、マウスカーソルが近づくと回避します。回避方法には、以下の種類があり、設定コンソールから選択できます。

タスクトレイアイコンをクリックするたびに表示/非表示が切り替わります。タスクトレイアイコンの右クリックメニューの[隠す]でも同じことができます。また、Shiftキーで一時的に透過させることもできます。
もちろん、情報パネルも同様になります。

ビューアの最大サイズは、画面の解像度によって制限されます。指定されたサイズがこの範囲内になければ、自動的に調整されます。調整されている場合は、拡大画像の周辺に薄く黄と黒の帯が表示されます。

情報パネル

ビューアに引っ付いて、注目点に関する情報を表示します。設定コンソールにて、以下の表示形式から選択できます。

情報パネルは、マウスカーソルとビューアの位置関係によって移動します。

コマンドパッド

コマンドパッドは、指呼キーを押している間だけ現れ、様々な機能を使用できます。指呼キーは、設定コンソールで割り当ての確認と変更ができます。ちなみに、基底で割り当てられている[LWin]とは、左側のWindowsキーのことです。

※コマンドパッドを表示しいる間、注目点・ビューア共に更新されません。拡大画像の縁が暗く表示されます。
※マンドパッドの動作に合わせて、マウスカーソルを移動させています。

コマンドパッドには、以下の機能が並んでいて、クリックで使用します。

〔RGB送出〕は、キーボード操作を再現してR,G,Bの各値を外部のソフトに入力します。使用方法は、次の通りです。

〔注目点調整〕は、コマンドパッドを閉じた時に反映されます。直接キーボードから、数値を入力することはできません。

ダイレクトキー

ダイレクトキーでは、キーの組み合わせで、マウスカーソルを1ドットずつ動かしたり、ビューアの拡大画像をクリップボードにコピーしたりできます。キーの割り当ては、設定コンソールで確認と変更ができます。

設定コンソール

設定は、タスクトレイアイコンを右クリックすると現れるメニューの[設定]から行います。

設定項目の説明は、タイトルバーにある？をクリックし、続けて知りたい項目をクリックすると表示されますので、参考にしてください。

変更した設定内容を適応したらどうなるかを確認できる“お試し”機能があります。お試し中は、拡大画像に黄と黒の帯が表示されます。

色書式は、.NET Frameworkの《String.Format》メソッドそのものです。詳細は、以下のサイト等を参考にしてください。ですが、プログラム経験者でなければ、かなり難解だと思います。申し訳ございません。

プロジェクトを開いて最初に行うべきこと

ソース フォルダを配布するに際して、"obj"フォルダを削除しています。
そのため、ユーザーコントロールを使用しているフォームのデザインを開くと、エラーになります。
そこで、初めてプロジェクト（ソリューション）を開いたら、“ビルド”してください。これで"obj"フォルダが、作成されます。
フォームのデザインを開いてしまった場合は、ビルド後にプロジェクトを開き直すと正常になります。

デバッグ時のエラー表示について

"bin"フォルダに設定ファイルがある状態でデバッグ実行すると、イミディエイト ウィンドウに下記のエラーが表示される場合があります。
これは、設定ファイルに記述されている色コードの形式を、エラーによって判断しているためです。気にせず無視してください。

拡大画像表示部のサイズ制限

“ビューアの拡大画像表示部の縦または横の最大値”と“マウスカーソル接近許容距離（回避行動を始める距離）の最大値”の和が、“使用する画面（作業領域）の解像度の縦横の短い方の50%以下”に収まるように制限されています。
これは、回避時にビューアが画面からはみ出してしまったり、常にビューアに隠されてしまう領域ができたりなど、支障をきたさないようにするためです。

もし、画面設定を変更したり違う解像度の画面へビューアが移動したりして、最大サイズに収まらなくなった場合は、表示可能な値に調整されます。これは、一時的な処置で設定値を変更するものではありません。再び十分な解像度になると元に戻ります。

理想の回避

とにかく“邪魔にならないルーペ”を実現したくて、マウスカーソルを回避する方法を考えました。外部から得ている情報は、“使用クライアント領域”と“マウスカーソル位置”だけです。

手始めに、画面の四隅をグルグルする〔画面四隅のすれ違い〕を作りましたが、そこにはウィンドウの操作項目やステータスバーがあったりするので、それらを隠してしまうこの方式だけでは少々難がありました。
そこで、重要度が低そうな画面中央を横断する〔画面中央の右往左往〕や、マウスに寄り添って視線移動を小さくする〔画面の中の金魚〕を追加しました。しかしながら、眼前を行ったり来たりされるのは意外と目障りでした。
これだけやってもダメならばと、通常ウィンドウと同様の〔手取り足取り〕も追加してしまいました。いやいや待て待て、これでは自動回避の理念がないがしろになっているではないか。
心を入れ替え、静と動の折衷案として、基本的には画面右端中央に居てマウスが近づけば上下に逃げる〔画面右の三角関係〕を設けてみました。

という具合に、簡単に実装できそうな機能を盛り込んできましたが、もっとデキる人ならばもっともっと格好いい回避を実現できるでしょう。妙案があれば改造してみてください。
もし、作者がデキる人であったなら、水に浮かぶ油のようにヌルンッと回り込むような感じを再現したり、軌跡が自然なカーブを描くようにしてみたいですが、絵に描いた餅です。

Setting.xml

このファイルには、設定内容が保存されます。設定コンソールの[OK]ボタンを押して確定すると、実行ファイルと同じフォルダに作成されます。

このファイルには、設定コンソールから変更できない項目が含まれています。その項目の詳細は、“○資料”⇒“《表1》”の通りです。
XML形式のテキストファイル（UTF-8）なのでテキストエディタで変更可能です。ただし、大文字と小文字を区別するので、書き換えには十分注意してください。

Resume.xml

このファイルには、〔手取り足取り〕モード時のビューアの表示位置と基点座標が保存されます。変更があれば、本作が終了するときに、実行ファイルと同じフォルダに作成されます。
初期化したいときは、このファイルを削除してください。

キーボード入力

APIの《GetAsyncKeyState》を使ってキーのON/OFF状態を監視しています。
.NETにキーの状態を取得する機能はなさそうなので（Shift,Ctrl,Altなら捕捉できるけど）、最初は《KeyDown》/《KeyUp》イベントの組み合わせで対処しようと思っていました。しかし、ルーペとは他のアプリケーションの補助的存在ゆえほぼ非アクティブ状態ですし、回避という特性上ユーザーがルーペをアクティブにするスマートな方法もありません。ルーペ自身の状況にかかわりなく操作できないと困るということで、結局APIに頼りました。（その代わり、他のアプリのショートカットキーとの重複という厄介な問題を抱えてしまうことになるのですが…）

長らくサボってきたけど、ダイレクトキーによるマウスカーソル移動操作での斜め入力をできるようにしてみたら、なかなかの曲者だった。
4方向時代のキー割り当ては、他のアプリケーションとの兼ね合いも考えて、あまり採用例を見かけないAlt+カーソルキー（方向キー）という組み合わせでした。
ところが、Alt+↑+←に反応してくれないのです（これが仕様なのか、制作環境固有の問題なのかは不明）。仕方なくCtrlキーに替えたものの、これはこれでテキストエディタ等で使用される組み合わせです。とは言え、本作をテキストエディタと共に使用するのは稀であろうし、Shiftより害が少なそうだから、「他に選択肢がない」と自分に言い聞かせて納得することにしました。（あぁ、斜め入力なんて欲を出すから…グスン、だってやりたいやん。）
どうしてもダメなら、カーソルキーを諦めてテンキーの2,4,6,8辺りにするなどしてください。

注目点調整 と マウスカーソル移動 の違い

よく似た機能に、コマンドパッドの〔注目点調整〕とダイレクトキーの〔マウスカーソル移動〕があります。これらは、使用目的が異なります。
〔注目点調整〕は、現在の注目点から決まったドット数分だけ移動させたいときに向いています。〔マウスカーソル移動〕は、ビューアを見ながら目的のピクセル（座標）にマウスカーソルを合わせるのに向いています。

拡大画像複写 と ビュー撮影 の違い

よく似た機能に、コマンドパッドの〔拡大画像複写〕とダイレクトキーの〔ビュー撮影〕があります。これらは、ビューアに表示されている拡大画像を取得する機能ですが、いくつか違いがあります。
〔拡大画像複写〕は、内部で拡大された画像そのものを取得します。よって、ビューアからはみ出している部分を含みますが、ガイド画像（背景・格子線等）は描かれていません。
〔ビュー撮影〕は、ビューアの画像を表示している部分を画像として取得します。そのため、表示部の枠やガイド画像が含まれます。

RGB送出の仕組み

〔RGB送出〕は、《SendKeys.SendWait》メソッドを使用してキーボード操作を再現する仕組みです。
標準での再現手順は、Windows標準の“色の設定”ダイアログを想定し、以下のようになっています。ちなみに、手順9は、便宜上行っているだけであって、必須の操作ではありません。

もし、目的のアプリケーションに合わないなら、設定ファイルの<送出パターン>を書き換えてください。記述方法は、MSDNの「SendKeys.Send メソッド」の説明を参照してください。

送出パターン内に埋め込まれている "|ALPHA|","|RED|","|GREEN|","|BLUE|"（必ず大文字）は、それぞれA,R,G,Bの値（10進数）に置き換えられます。

送出パターンには、色書式用の要素を利用することもできます。ただし、この場合は《String.Format》用の記述となりますので、文字以外のキーの波括弧が二重になる点に気を付けてください。
16進数で出力したいなど、もう少し柔軟に運用したいなら、こちらを試してください（とはいえ、10進数が通じない状況がどれほど存在するのか…そもそもそのような環境でこんな拙作を使うだろうか？）。それでもダメなら、コードを改良してください。

Windows標準の“色の設定”ダイアログに使途を限定するなら、手順1をAlt+R（"%r"）に書き換えてR欄へフォーカスを移すようにすると、少し便利かもしれません。また、手順4,7の“全選択”を省いても問題ありません。

コマンドパッドのオマケ機能

実行ファイルと同じフォルダに"complete.wav"という名前でWaveファイルを置いておくと、コマンドボタンを実行した後に再生されます。これは、「了解しました」とか「完了しました」っていう手応えを感じたいという作者個人の欲求から設けています。もし必要でしたら、お手数ですがお好みのWaveファイルをご用意ください。
なぜ、Waveファイルを同梱していないかと言うと、お気に入りの音の提供元が“再配布禁止”でして、リソースを含め全てを公開する当方の方針ゆえ、それは“再配布”に当たるかもと思い諦めました。と言う訳で、紹介だけしておきます。「フリー効果音素材 くらげ工匠」）さんの「システム音・電子音」に収録されている“ボタン073”をあれこれ加工（フォーマット変換, 前後の無音部を削除, 倍速再生, 音量調整）して使っています。