タイトルバーとアイコンの概要
たとえばソースファイルが "hellowin.src" なら「hellowin」がタイトルバーに表示されます。
■アプリケーションが起動したときのアイコン
＜＜エクスプローラでファイル一覧を表示し.exeファイルに付くもの＞＞
アプリケーションの.exeファイルについて説明します。アプリケーションをコンパイルした時、自動的に次のようなファイル複製が行われています。
bin\mindexw.exe → <MYAPP>.exe （）
- 方法１：
-
・初回コンパイルのあと、生成された <MYAPP>.exe のアイコンをアイコン作成ツールなどを使って変更してください
・そのまま再コンパイルすると、mindexw.exe が再度複製され、元に戻ってしまうので、再コンパイルでは -x オプションを指示して mindexw.exe の複製を抑制してください
- 方法２：（こちらを推奨）
-
・あらかじめ、手動にて mindexw.exe の複製をとり、そのアプリケーション専用として保存し、それに対してツールでアイコンを設定してください。（仮に、MYmindexw.exe とします）
・コンパイル時に、 -e:MYmindexw.exe というコンパイルオプションを指定します。指定したファイルをキック用プログラムとするものです。これを mindexw.exe の代わりに使うことになり、アプリケーション専用アイコンが付与されます。
＜＜タイトルバー左端にあるアイコン＞＞
一方でアイコンはメインウィンドウのアイコンと同じになります。こちらもプログラムで設定できます。
ダイアログについてはダイアログの解説をお読みください。
ウィンドウＩＤ
主ウィンドウ、そこから派生する子ウィンドウもウィジェットの一種であり、ＩＤが割り当てられます。これを「ウィンドウＩＤ」と呼びます。
／￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣＼
↓主ウィンドウのＩＤ
○○を メインウィンドウに ・・・する
メインウィンドウを ・・・する
＼＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿／
／￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣￣＼
子ウィンドウ１は ＩＤ
＼＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿＿／
メインウィンドウの有効化
一般的にウィンドウを開くにはウィンドウＩＤの取得と有効化が必要です。
しかしメインウィンドウは例外的に「メインとは」の実行に入った段階でウィンドウＩＤは自動取得され、有効化までおこなわれています。つまり、「メイン」に入ったとき既にメインウィンドウは開いています。
したがって、背景色の設定やウィンドウ位置やサイズの設定などウィンドウに関する属性指定は有効化後の手続きとなるため、メインウィンドウについては属性設定のあと「変更を反映」を必ず行う必要があります。
ウィンドウの背景色
ウィジェットの解説で「背景色を設定」というものがありましたが、ウィンドウＩＤにも適用できます。
構文＝
＜色指定＞を ＜ウィンドウＩＤ＞に 背景色を設定 → ・
薄い灰色を メインウィンドウに 背景色を設定し
ウィンドウタイトルとアイコン
構文＝
＜文字列＞を ＜ウィンドウＩＤ＞に ウィンドウタイトルを変更 → ・ 注：ウィンドウが開いた状態でのみ使えます
「新しいタイトル」を メインウィンドウに ウィンドウタイトルを変更する
■タイトルバーに表示されるアイコンの変更
構文＝
＜アイコンファイル名＞を ＜ウィンドウＩＤ＞に ウィンドウアイコンを変更 → ・ 注：ウィンドウが開いた状態でのみ使えます
"image\AppRun.ico"を メインウィンドウに ウィンドウアイコンを変更する
- 注：
- 本機能によってアイコンを変更したとしても、エクスプローラでファイル一覧を表示した際の .exe ファイルアイコンは変わりません。
他のアプリケーションの .exeファイルを指定した場合は、当該ファイル先頭に埋め込まれているアイコン情報が抽出されて使用されます。（本GUIライブラリ自身も、これを利用してアプリのアイコンを自動設定しています）
ウィンドウのサイズと位置
サンプル "padding-for-pack.src" がおこなっている方法です。配置ＩＤに対して「パディングを設定」、「パディングの幅を設定」、「パディングの高さを設定」 を指定することで、ウィジェットの外側に余裕ができ、結果的にウィンドウが大きくなります。
次に解説しますが、小さすぎるサイズを指定しないよう注意が必要です。
■ウィンドウサイズを設定
構文＝
＜幅＞と ＜高さ＞を ＜ウィンドウＩＤ＞に ウィンドウサイズを設定 → ・ ＜幅＞と ＜高さ＞を ＜ウィンドウＩＤ＞に 親からの相対でウィンドウサイズを設定 → ・ 注：ウィンドウが開いた状態でのみ使えます。 本単語を実行したあと「変更を反映」が 必要です。 注：位置は絶対値以外に、ディスプレイサイズに対す る比率も使えます。0.0超〜1.0までの小数形式を 使ってください。小数形式であれば自動的に比率 指定と判断されます。たとえば 0.5 0.5 を指定し た場合は、ウィンドウサイズの幅と高さはディスプ レイサイズの２分の１の値となります。 注：「親からの相対で・・」のタイプは比率（小数） のみ指定可能です。絶対値は指定できません。
↓絶対サイズ ２００，３００を メインウィンドウに ウィンドウサイズを設定 ↓画面サイズ比率で指定 0.5，0.5を メインウィンドウに ウィンドウサイズを設定 ↓親サイズとの比率で指定 0.5，0.5を 子ウィンドウに 親からの相対でウィンドウサイズを設定 注：サンプルプログラム： window-size-setting.src window-size-setting-bad.src も併せてご覧ください。
さらには、確実にサイズ変更が行われたあとに後続のウィジェット描画をおこないたいのなら、
すべてのイベントを処理し
サイズとして 1.0, 1.0 を指定した場合、子ウィンドウは親ウィンドウと同じサイズになります。 サイズとして 0.5, 0.5 を指定すれば子ウィンドウのサイズは親ウィンドウの縦横半分のサイズとなります。
■ウィンドウ位置について
■ウィンドウ位置を設定
構文＝
＜Ｘ位置＞と ＜Ｙ位置＞を ＜ウィンドウＩＤ＞に ウィンドウ位置を設定 → ・ ＜Ｘ位置＞と ＜Ｙ位置＞を ＜ウィンドウＩＤ＞に ウィンドウ中央位置を設定 → ・ ＜Ｘ位置＞と ＜Ｙ位置＞を ＜ウィンドウＩＤ＞に 親からの相対でウィンドウ位置を設定 → ・ ＜Ｘ位置＞と ＜Ｙ位置＞を ＜ウィンドウＩＤ＞に 親からの相対でウィンドウ中央位置を設定 → ・ 注：「ウィンドウ位置を設定」はウィンドウ有効化の前でも後でも使 えますが、他は有効化の後(ウィンドウ開いた後)でのみ使えます。 有効化の後で使う場合は本単語を実行したあと「変更を反映」に より反映させる必要があります。 注：位置は絶対値以外に、ディスプレイサイズに対する比率も使えま す。0.0超〜1.0までの小数形式を使ってください（比率指定であ るかの判断は小数形式かどうかで見ています） たとえば、0.5、0.5 を指定するとディスプレイ中央の座標を指 定したことになります。
本処理単語を実行したあとは必ず、
●GUIエンジン特有の注意点
●「ウィンドウ中央位置を設定」の場合
●「親からの相対でウィンドウ(中央)位置を設定」 の場合
また、0.5, 0.5 を指定すれば子ウィンドウを親ウィンドウの真ん中に開くことができます。
構文＝
＜ウィンドウＩＤ＞を リサイズ禁止 → ・ ＜ウィンドウＩＤ＞を 横リサイズ禁止 → ・ ＜ウィンドウＩＤ＞を 縦リサイズ禁止 → ・ ＜ウィンドウＩＤ＞を リサイズ許可 → ・
フォーカス、最前面
■フォーカスを当てる
構文＝
＜ウィンドウＩＤ＞に フォーカスを当てる → ・ ＜ウィジェットＩＤ＞に フォーカスを当てる → ・
子ウィンドウ１に フォーカスを当てる ボタン１に フォーカスを当てる
この機能は対ウィンドウに限らず、ウィジェット一般に使えます。
たとえばボタンウィジェットに適用することで、特定のボタンにフォーカスを当てることができます。ウィジェットへフォーカスを当てる例として、「バインドとイベント名」−「バインドの概念」 を参照してください。
■ウィンドウを最前面に表示
構文＝
＜ウィンドウＩＤ＞を ウィンドウを最前面に表示 → ・
子ウィンドウ１を ウィンドウを最前面に表示する
■フォーカスロック
構文＝
＜ウィンドウＩＤ＞を フォーカスロック → ・ ＜ウィンドウＩＤ＞を フォーカスロック解除 → ・
子ウィンドウ１を フォーカスロックする 子ウィンドウ１を フォーカスロック解除する
「フォーカスを当てる」がその瞬間だけのフォーカス移動であるのに対して、この単語はずっとフォーカス状態を維持する点が異なります。たとえばダイアログで使います。（ダイアログ以外の部分を操作されると困るので）
■フォーカスと最前面表示の利用例
子ウィンドウがメインウィンドウの一部にかぶさり、
メインウィンドウが全部見えない”
逆に、子ウィンドウにフォーカスが当たって欲しいのであれば、子ウィンドウに対して「フォーカスを当て」すれば解決します。
(子)ウィンドウを開く、閉じる
構文＝
＜親ウィンドウＩＤ＞で ウィンドウのＩＤを取得 → ウィンドウＩＤ 〜〜（必要ならここで属性設定） 〜〜 ＜ウィンドウＩＤ＞を 有効化する
○○とは ウィンドウＩＤは ＩＤ メインウィンドウで ウィンドウのＩＤを取得し ウィンドウＩＤに 入れ ウィンドウＩＤを 有効化する
■子ウィンドウのネスト
さらなる子ウィンドウを”兄弟”にするか”孫”にするかはアプリケーション次第ですが、上位ウィンドウが閉じたときに子ウィンドウも自動的に閉じたいときは親子関係にすると良いです。
■ウィンドウを閉じる
構文＝
＜ウィンドウＩＤ＞を ウィンドウを閉じる → ・ 記：「ウィンドウを閉じる」は「ウィジェットを削除」と 等価な単語です
子ウィンドウのＩＤ記憶を ウィンドウを閉じる
ウィンドウが閉じるとき、以下のことが自動的におこなわれます。
（１）指定したウィンドウが持つウィジェット群は自動的に削除されます
（２）指定したウィンドウで登録したイベントや、メニューなどのショート
カットも抹消されます
（３）指定したウィンドウがさらに子ウィンドウを持つ場合、それらのウィ
ンドゥも閉じます。登録されたイベントやショートカットも抹消され
ます
（４）メインウィンドウを閉じると自動的にプログラムが終了します
（「実行終り」を実行したのと同じ）
カットも抹消されます
ンドゥも閉じます。登録されたイベントやショートカットも抹消され
ます
（「実行終り」を実行したのと同じ）
ウィンドウその他の操作
構文＝
＜ウィンドウＩＤ＞を ウィンドウが閉じるのを待つ → ・
子ウィンドウ１が ウィンドウが閉じるのを待つ
ダイアログ系ウィジェットでもこれを使っています。
- 注
- 本単語を実行すると、ソースコード上での次のステップへは行きませんが、その間であってもイベント処理は発生して所要の単語は起動されます。（GUIがフリーズするようなことはありません）
■ウィンドウをアイコン化・隠す
構文＝
＜ウィンドウＩＤ＞を ウィンドウをアイコン化 → ・ ＜ウィンドウＩＤ＞を ウィンドウをアイコン化解除 → ・ ＜ウィンドウＩＤ＞を ウィンドウを隠す → ・ ＜ウィンドウＩＤ＞を ウィンドウを見せる → ・ 注：「ウィンドウを見せる」は「ウィンドウをアイコン化解除」 と等価語です。
アイコン化すると、ウィンドウは見た目は消えますがそのアンコンだけがタスクバー内に表示され、まだ生きています。
「ウィンドウを隠す」 は 「ウィンドウをアイコン化」 と良く似ています。違うのは、前者はいきなり消え、後者はタスクバーに飛んで行くアニメーションを伴なう点です。
■メインウィンドウが閉じる時の制御
構文＝
メインウィンドウクローズ処理とは 本定義 （・ → ・） ・・何らかの処理・・ ・・何らかの処理・・。
メインウィンドウクローズ処理とは 本定義 （・ → ・） 「終っていいですか？」と ボタン・Yes／Noで メッセージとボタンをダイアログで表示し １に 等しい ならば 実行終り つぎに。
"window-ask-when-closemain.src" を参照ください
- 注１
- 本処理単語を本定義したのにもかかわらず、処理単語内で「実行終り」を実行しない場合、かつ、メインウィンドウ内に「閉じる」ボタンが無い場合、そのアプリケーションは通常の方法では終了できなくなり、タスクマネージャから停止するしかなくなります。
- 注２
- たとえば「終了」ボタンを設置し、それが押下され、イベント処理内で「実行終り」を実行するなどして、明にプログラム終了する場合は本処理単語は呼び出されません。
そのような明なプログラム終了であっても終了確認をしたい場合には、確認処理を独立語として定義しておき、それぞれのイベント処理内で（実行終りをする前に）確認処理を呼び出すようにしてください。
■子ウィンドウが閉じる時の制御
構文＝
（ステップ１）：イベントの登録 ＜実行情報＞と ＜引数＞を ＜子ウィンドウＩＤ＞に ウィンドウ消滅をイベント登録 → ・ （ステップ２）：イベント発生時に渡されるパラメータ ↓登録時の引数が空列のときは１つの引数のみ渡される スタック→ 子ウィンドウＩＤ列、 １(引数個数) ↓登録時の引数が非空列のとき スタック→ 子ウィンドウＩＤ列、 引数１，・・、 ｎ(引数個数) ↑ ユーザ引数が1個ならｎ=２
（イベント処理） ユーザ定義のウィンドウ消滅時処理とは （子ウィンドウID列、１ → ・） ＩＤ１は ＩＤ （引数個数が） １と 異なる ならば 「ウィンドウ消滅時処理のパラメータ異常」で 重大エラー つぎに ↓IDを表す文字列を数値化 （子ウィンドウID列を） ＩＤ列を数値化し ＩＤ１に 入れ 〜閉じる前の何らかの処理〜 ＩＤ１を ウィンドウを閉じること。 ←子ウィンドウを明に閉じる （イベントの登録） ○○とは 〜略〜 ユーザ定義のウィンドウ消滅時処理の 実行情報と 空列を ←引数不要なら「空列」を指定 子ウィンドウのＩＤ記憶に ウィンドウ消滅をイベント登録し 〜略〜。
子ウィンドウのＩＤはアプリケーションが承知しているから不要と思われるかも知れませんが、イベント処理の呼び出し時に子ウィンドウＩＤが渡されれば、子ウィンドウが複数ある場合であってもイベント処理定義は１つで済みます。
- 注１
- 本機構を利用してイベントが発生した場合、最終的に子ウィンドウを閉じるには明に「ウィンドウを閉じる」を実行する必要があります。
もし同イベント処理内で「ウィンドウを閉じる」を実行しない場合、子ウィンドウのタイトルバー右端の「×」を押すなどのOS標準の方法では閉じられなくなります。
- 注２
- たとえば子ウィンドウ内に「閉じる」ボタンを設置し、そのイベント処理内で「ウィンドウを閉じる」を実行するなどして明に閉じる場合は本処理単語は呼び出されません。
そのようなケース（閉じるボタン押下など）でも終了確認をしたい場合には、閉じることの確認あるいは閉じる前の後片付けなどの処理を独立語として定義しておき、それぞれのイベント処理内で確認処理を呼び出してください。
■ＩＤ列を数値化
構文＝
＜ＩＤを表す文字列＞を ＩＤ列を数値化 → ＩＤ（整数）
ウィンドウ状態を参照
構文＝
画面サイズを得る → Ｘ、Ｙ 注：サイズはピクセル単位です
物理的なディスプレイサイズとは異なることがあります。Windwsの拡大・縮小を反映した後の有効サイズを得ます。（このサイズまで描画できます）
Windows OS が把握しているサイズと（特に高さがタスクバー高さとの関係で）わずかに異なることがありますがGUIエンジンの特性であり、バグではありません。
■ウィンドウの位置やサイズを得る
構文＝
＜ウィンドウＩＤ＞で ウィンドウの位置とサイズを得る → Ｘ位置、Ｙ位置、Ｘサイズ、Ｙサイズ ＜ウィンドウＩＤ＞で ウィンドウの位置を得る → Ｘ位置、Ｙ位置 ＜ウィンドウＩＤ＞で ウィンドウのサイズを得る → Ｘサイズ、Ｙサイズ 注：サイズや位置はピクセル単位です
サンプル "window-geometry-immediate.exe" を起動するとメインウィンドウの位置とサイズを知ることができます。
メインウィンドウが開いた直後とボタンを押した後では位置は同じでもサイズが違うことが確認できます。メインウィンドウが開いた直後ではまだメインウィンドウの描画が完了していないことが原因です（後者の値が正しいものです）。
もし「メイン」の実行中に正しいウィンドウサイズを知りたければ、本処理単語を呼ぶ前に 「すべてのイベントを処理」 を実行してください。
■ウィンドウ存在？
構文＝
＜ウィンドウＩＤ＞が ウィンドウ存在？ → 真偽
子ウィンドウのＩＤ記憶が ウィンドウ存在？を 有りに 入れ
ウィンドウが 「ウィンドウを隠す」 または 「ウィンドウをアイコン化」 によってアイコン化されている場合も開いているのと同じ扱いで真を返します。
ウィンドウに関するサンプルプログラム
以下のプログラムを実際に起動して確認してみてください。
- window-ask-when-closemain.src/.exe
- ウィンドウが閉じるときイベント発生（閉じて良いか尋ねる）
- window-change-title-and-icon.src/.exe
- タイトルバーとアイコンを設定
- window-size-setting.src/.exe
- メインウィンドウのサイズを設定
- window-size-setting-bad.src/.exe
- メインウィンドウに”小さなサイズ”を設定（すべて表示できず）
- window-rootwin-setpos-absolute.src/.exe
- メインウィンドウの位置とサイズを設定（絶対座標を指定）
- window-rootwin-setpos-ratio.src/.exe
- メインウィンドウの位置とサイズを設定（画面比率で指定）
- window-rootwin-setpos-ratio-center.src/.exe
- メインウィンドウの中央位置を画面中央に設定（画面比率で指定）
- window-open-child.src/.exe
- 子ウィンドウを開く（サイズ／位置指定無し）
- window-open-nest.src/.exe
- 子ウィンドウを開き、さらに孫ウィンドウを開く
- window-open-complex.src/.exe
- さまざまな位置でウィンドウを開く
- window-geometry-immediate.src/.exe
- メインウィンドウの位置とサイズをモニタ表示します。
（ラベル内にモニタ表示します） - window-geometry-debug.src/.exe
- メインウィンドウの位置とサイズをモニタ表示します。
（デバッグ用のコンソールが開きそこへ表示します） - window-withdraw-and-iconify.src/.exe
- ウィンドウをタイトルバーにアイコン化または隠す
- window-is-exist.src/.exe
- 指定したウィンドウが開いているか調べる
- window-destroy.src/.exe
- ウィンドウを消す
