コンソールアプリケーションでは「メインとは」の処理が最後まで到達するとプログラムは自動的に終了しました。
　しかし、GUIアプリケーションでは「メインとは」の処理が最後まで行っても終了せず、ウィンドウは開いたままです。一般的には、このあと何らかのマウス操作やキー入力などのイベントで引き続き処理が行われることになります。次のような感じです。

　実は「メインとは」の処理もまた、イベントとして実行されています。アプリケーションが起動した後、最初のイベントは”メインを実行する”ことです。

注

上記で

　　　メインが起動　→　初期画面を描画する

とありますが、メインの末尾まで到達すると初期画面の描画が完了するわけではありません。
ユーザプログラムで何らかの描画をおこなった場合、すべて内蔵のGUIエンジンへのリクエストとして保留され、ほんのわずかな時間を置いて実際に描画されます。
多くの場合「メインとは」の最後まで来た段階ではまだほとんど実際の描画は行われていませんが、この時間差はわずかであるため見た目としては直ちに描画されているように見えます。イベント処理での描画についても同様です。

　GUIアプリケーションは以下のいずれかで終了します。



　「ウィジェット」は「ラベル」や「ボタン」など、ウィンドウ内に置く部品です。小さな部品だけでなく「テキストウィジェット」や「キャンバス」といった大規模なものもあります。ウィンドウ自体も１つのウィジェットです。
　サンプルプログラムの一つ、hellowin.exe を起動してみてください。
　hellowin はラベルを一つだけ描画するごく小さなGUIプログラムです。
　次にソースファイル、hellowin.src をご覧ください。
　　　　　　hellowin.src

メインとは
　　　　　　　　ラベル１は　　　　ＩＤ
　　　　メインウィンドウで　ラベルのＩＤを取得し　ラベル１に　入れ
　　　　「こんにちは。」を　ラベル１に　テキストを設定し
　　　　ラベル１を　有効化して配置する。

　まず、「ラベルのＩＤを取得」でラベルウィジェットを生成する準備に入ります。
　次の行で「テキストを設定」によってそのラベルに文字（列）を設定しています。
　次の、
にて、ラベル１をここで確定・生成し、さらに「配置」までおこなっています。
　ウィジェットは生成するだけではまだ画面に現れません。画面内にどのように配置するかの指示であるところの「配置」をもってようやく画面に表示されます。

注

上記で

　　　「配置」をもってようやく画面に表示されます

と書いていますが、厳密には「配置」を実行すると直ちに描画がおこなわけではありません。
「配置」に限らずユーザプログラムでの描画操作はすべて内蔵のGUIエンジンへのリクエストとして保留され、ほんのわずかな時間を置いて実際に描画されます。多くの場合「配置する」の直後ではまだ、実際の描画は行われていません。しかしこの時間差はわずかであるため見た目としては直ちに描画されているように見えます。
ウィジェットを画面に表示するには最後の手続きとして「配置する」と書くことが欠かせない・・という意味であるとご理解ください。

　ラベル、ボタンなど単純なウィジェットの生成準備をおこないます。

       単純なウィジェットの種類：

ラベル	文字を表すためのウィジェットで短いテキストに使います 　（ウィジェット幅より長い文字列は末尾が表示されません） 　（ビットマップやイメージも表示できます）
ボタン	名前の通り 　ボタンを押したときにイベントを発生させることができます
メッセージ	ラベルと似ているが長いテキストを表示するのに使われます 　（長い文字列を折り返すことで確実に全長を表示します） 　（ビットマップやイメージも表示できます）
エントリー	キーボードから文字列入力をおこなうためのウィジェット

       プログラム例：（ＩＤ取得のみ）
       プログラム例：（描画までの全体）

　＜親ウィジェット＞はこのラベル／ボタンの親となるウィジェットを指します。簡単なアプリでメイン画面内に直接設置する場合の親は「メインウィンドウ」になります。つまり、
　　　　メインウィンドウで　ラベルのＩＤを取得 のように書くことが多いです。「メインウィンドウ」とはそのアプリケーションのメインウィンドウのことです。

■ＩＤについて
　これらの処理単語はＩＤと呼ぶ整数値をスタックに返します。これに限らず「ＩＤ」と名が付くものはすべて整数で、変数に格納して後続処理のために使います。（大域変数でも局所変数でも構いません）
　ＩＤを記憶するための変数の宣言は、 　　　　○○は　ＩＤ
にて行ってください。「ＩＤ」は「変数」の等価語であるため、「○○は　変数」でも同じなのですが、ＩＤを格納する意図がはっきりします。

記： 「キャンバス」の章で解説しますが ”図形ＩＤ”と呼ぶものは例外的に倍精度整数の変数を使うことから、「○○は　図形ＩＤ」で宣言することになります。

■ラベルを表示するサンプルプログラム

注

「ウィジェットの属性指定」−「テキストを設定」 にて詳しく解説するのでここでは簡単に済ませます。

       プログラム例：
　指定する文字列を、ＩＤで指定するウィジェットに設定します。
　ラベル、ボタンに限らず、中に文字を表示できる多くのウィジェットに適用できます。

注

ダイアログの中でエントリーを扱う方法もあります。
「ダイアログ」−「文字列入力を伴うダイアログ」 の項目を参照してください

　キーボードから１行の文字列を入力するウィジェットです。既に ウィジェットのＩＤを取得 の項に登場していますが、改めてＩＤの取得から含めた手順を示します。

       プログラム例：
　上の例で解説します。
　まず「メイン」の中で「エントリーのＩＤを取得」を使い、エントリーウィジェットの設置を始めます。指定する桁数は入力できる桁数ではなく、ウィジェットの表示幅の意味になることに注意してください。（表示幅以上に入力できます）
　上の例ではエントリーＩＤを記憶する局所変数「エントリー」から、「エントリー記憶」という大域変数にコピーしています。これはイベント処理でＩＤを参照できるようにするためです。（局所変数「エントリー」はメイン外から参照できないため）
　入力域のデフォルトの背景色は白ですが、「背景色を設定」によって指定することもできます。
　この先で述べますが、初期値の設定や伏字の設定もできます。
　最後に有効化と配置によってウィジェットが見えるようにします（他のウィジェットと同様です）。
　エントリーウィジェット自体には”入力を完了した”ことを検知する仕組みは無いので、通常は近くにボタンを配置し、それを押してもらうことでタイミングを得ることになります。
　上記例ではボタンが押されるとイベント処理に入って来るので、「入力文字列を参照」を使い、入力された文字列を読んでいます。
　文字の入力中は、カーソル移動キー、BSキー、Delキー、などによって入力文字を編集できます。他にも編集関係のキー操作がありますが，詳細は 「テキストウィジェット」−「人による編集機能」 の項目をご覧ください。（テキストウィジェットと違い、カーソルは左右しか動けないのでこのすべては使えません）

■サンプルプログラム

■入力域の初期値
　エントリーウィジェットが表示された時、既に入力域に文字列が入っている状態を作ることができます。
       プログラム例：
　上記プログラムを実行すると、エントリウィジェットが表示されたとき既に、先頭に「03-」が入力済みとなります。

■伏字 　エントリウィジェットへの文字列入力中、入力した文字をエコーバックせずに伏字（記号 *）とする機能があります。パスワードのような、他人に見せたくない文字列の入力に使います。
       プログラム例：


◇◇同一種のウィジェットを複数取得
　たとえば、
       例１a：
　上記は似たようなことの繰り返しで煩雑です。これは、
       例１ｂ：
と書けば簡略化することができます。

◇◇異なるウィジェットの組み合わせで取得
　上記は読んで字のごとくの機能です。ボタンとラベルを各１つだけ、あるいはラベルとボタンを各１つだけ、という簡単なプログラムはよくあるため、このような処理単語群を用意しています。
       プログラム例：



　たとえば、３個のボタンを持つアプリケーションがあったとします。ＩＤの取得についてはたとえば、
       例２ａ：
のように一括取得できますが、得られたＩＤ群を変数に代入するのは上記のように個々の変数への代入を書く必要があります。将来ボタンが増えた場合は、「３個」の個所を「４個」にするだけでは済まず、
       例２ｂ：
のように変更することになり、変数への代入が煩雑になります。このような多くのウィジェットのＩＤを操作するのを容易にする仕組みを以下に解説します。

■複数のＩＤを配列に格納
       プログラム例：
　長いソースコードですが、多くのボタンを持つアプリケーションで典型的なスタイルとなります。（ボタンでなくラベルでも同様に書けます）
　まず、
により、ボタンに表示するテキスト群をまとめて文字列定数配列として定義しています。文字列定数配列にしたことのメリットは集中管理できることのほかに、ボタンの数をコンパイラが把握できる点にあります。
　先のプログラム例ではさらに、
とすることで、配列「ボタン群」の要素数を定数「ボタン数」としてコンパイラに計算させています。このケースではボタンは４個ですが、ソースのどこにも「４」とは書いていません。これにより将来的にボタンが増えたとしても、どこかの数字を変更する必要がありません。

　次に、
として、複数取得したボタンＩＤ群をまとめて配列に格納しています。

　次に、ボタン群への属性設定ですが、上記のような配列状であれば「回数指定」の構文を使うことで次のように簡便に書けます。
       プログラム例：
　上のようにすれば、属性設定は１つのボタン分だけ書けば、結果的に多くのボタンに設定を行えるためプログラムが簡単になります。
　上記「・・・・」の部分はアプリケーションによってさまざまなのでここには書いていませんが、たとえばサンプルプログラム samplew\dialog-lowlevel-manypos.src の「メインとは」の中の繰り返し構文を参考にしてください。

■配列から複数のＩＤを取り出し
　上記のように、配列を指定して多数のＩＤを一気にスタックに積むことができます。これを使えば、たとえば、
       プログラム例：
のようにして、まとめて有効化や配置をおこなうことができます。

■多くのウィジェットをまとめて扱うサンプルプログラム

注

ウィジェットの属性指定 で詳しく説明するため、ここでの解説は簡単にします。

　以前に下記のようなソースコードを示しました。
　上記ではテキストの設定のみをおこなっていますが、一般的には、
上のように多くの属性を設定することがあります。パディングを指定したり、色を指定する、形状を指定するなどです。
　それらについて、ウィジェットの属性指定 でさらに詳しく解説します。



■有効化
　ウィジェットへのパラメータ設定をおこなった段階ではまだウィジェットは生成されていません。「有効化」という処理単語を呼ぶことで実際にウィジェットの内部生成が行われます。

　先のプログラムを「有効化」まで書くとすれば次のようになります。
　ここまで実行するとようやく内部的にウィジェットが作成されます。
　　　　　　　　　　（注：しかし、この段階ではまだ画面には表示されません）

■これらを有効化
　複数のウィジェットを同時に有効化します。
       プログラム例：

注

配置については 配置の詳しい解説 にて改めて解説します。併せてお読みください。

　有効化の段階ではまだウィジェットはウィンドウに現れません。引き続き「配置」をおこなう必要があります。ウィンドウに対してウィジェットをどのように表示するかの指示です。

■並べ配置について
　ウィジェットをウィンドウに配置するのに３つの機構が使えますが、ここでは簡単でよく使われる「並べ配置」を解説します。
　並べ配置は、ウィジェットを 上から下へ 、あるいは 左から右へ と順に詰めて配置する手法です。ウィジェットの位置を具体的に（たとえば座標で）指定する必要はなく、GUIライブラリが自動的かつ適切に配置します。
　いわばお任せで良いのでプログラムとしては楽ですが、より凝った配置にするに他の配置機構のほうが向くこともあります。
　まず並べ順ですが、デフォルトは「上から下」です。
　たとえば２つのラベルを単に「配置」すると以下のようになります。これがデフォルトの並び順です。

　・−−−−−−・
　｜・−−−−・｜
　｜｜ラベル１｜｜
　｜・−−−−・｜
　｜・−−−−・｜
　｜｜ラベル２｜｜
　｜・−−−−・｜
　・−−−−−−・

　一方、配置ＩＤに対して、
のように並べ順をオプション指定すると以下のように左から右になります。

　・−−−−−−−−−−−−・
　｜・−−−−・・−−−−・｜
　｜｜ラベル１｜｜ラベル２｜｜
　｜・−−−−・・−−−−・｜
　・−−−−−−−−−−−−・

　指示が「右から左」なら次のような配置になります。

　・−−−−−−−−−−−−・
　｜・−−−−・・−−−−・｜
　｜｜ラベル２｜｜ラベル１｜｜
　｜・−−−−・・−−−−・｜
　・−−−−−−−−−−−−・

■並べ配置のＩＤを取得 （単一ウィジェットを配置）
       プログラム例：
　まず「並べ配置のＩＤを取得」により配置をおこなう準備に入ります。この処理単語に与えるものは配置対象となるウィジェットのＩＤ、つまり、”配置の子となるウィジェット”です。
　「並べ配置のＩＤを取得」は配置ＩＤと呼ぶＩＤを返してきます。
　配置ＩＤは局所変数に格納して使うこともありますが、配置ＩＤに対してオプションを設定することが無ければ、下記のように変数に入れず、直ちに「配置する」に渡してしまっても構いません。
       プログラム例：


■配置
　上の「配置」によって、ようやくウィジェットが画面に描画されます。
       プログラム例１：
　配置系の"ＩＤ取得"とその"配置"とで手続きが分かれているのは、パディングの指定や拡張など、配置に対して各種パラメータ指定ができるようにするためです。もし、配置ＩＤに対するパラメータ設定が不要なのであれば、下記のように取得した配置ＩＤを変数に格納せず、直ちに「配置する」としたほうが簡単になります。
       プログラム例２： （こちらのほうが簡単）
　改めて、ラベルのＩＤ取得から配置までの全体を示すと以下のようになります。
       プログラム例３： （全体像）            　（この先で解説する「有効化と配置のコンビネーション」を使うとさらに簡単になります）

■有効化と配置のコンビネーション

（単一ウィジェットを配置）

（複数ウィジェットを配置）

　「有効化して配置」は、
を一気におこなう上位語です。この定型文は利用頻度が高いためコンビネーションを用意したもので、配置に対するオプション指定が無ければこれが最も簡単な表記となります。
　「これらを有効化し・・」系の処理単語はそれの複数ウィジェット対応版です。
       プログラム例４： （全体像- 「有効化して配置」を使う）
■有効化して配置のサンプル
　hellowin.src にそっくりなサンプル、hellowin2.src があります。まったく同じ処理をしますがソースコードが少し違います。配置に関して前者は簡単に済ませていますが後者は律儀な手続きになっています。前者の「有効化して配置」が内部的にはどのようなものなのかが分かります。

       プログラム： hellowin.src　（簡単な記述）
       プログラム： hellowin2.src　（律儀な記述）



■ウィジェットを削除
　指定したウィジェットを削除します。
　表示すべきものが一つ消えるため、ウィンドウサイズを明示していない場合はその分だけウィンドウが縮小します。
　また、ウィジェットがウィンドウの場合はウィンドウが消え、さらにはそれがメインウィンドウの場合はアプリケーションが終了します。

記： ウィンドウを削除するのが目的であれば、等価語としての「ウィンドウを閉じる」のほうが意図が明確なのでそちらを勧めます。

■ウィジェット存在？
　指定したウィジェットが存在しているかを（＝削除されていないかを）確認します。
　たとえば、一旦表示したラベルやボタンを削除したい場合、プログラムが複雑な場合はそのタイミングで既に削除されていることもあり、存在することに確信が持てない場合には本単語を使って事前チェックをすることを勧めます。存在しないウィジェットを削除しようとするとGUIエンジンレベルでのエラーが発生し、強制的にアプリケーションが終了してしまうからです。
　「ウィジェット存在？」の利用例としては、サンプルプログラム "after.src" が参考になります。ボタンを押すと所定の時間経過後にボタンを削除するものですが、ボタンを２度押しされることもあり、誤って既に消えたボタンを削除することを防ぐために使っています。

• 
• 　　　　　　　　　　　　　　　　
• 　　

---