Chapter1

プログラミング入門　（桐s-2024LT：ツールバー編）

桐でプログラムを作ろうという方への道しるべになれば幸いです

Introduction

この入門講座は桐s-2024LT で作成しています

イベント（フォーム＋イベント）と一括処理について

Win桐ではイベント処理の他に、Dos桐で使われていた一括処理が利用できます。
これは Dos桐の資産を継承するために必要だからでしょう（お仕事で使われているシステムを刷新するのはとても大変です）

この入門講座はイベント処理の講座になります

※筆者も昔々イベントに移行する前、Dos桐の一括処理をWin桐の一括処理にアップグレードしたことがあります。
結構大きなシステムだったのですが必要に迫られて（今更 Dosマシンの時代でもないし、NEC98シリーズの入手も難しくなってきたし）
一括処理のままWin桐に移行した次第です（実際 Win桐で一括処理が継承されていたので助かりました）
その後イベントに移行し今に至っています（イベントを学び始めてから一括処理は全く使用していません）

ツールバー表示について

システム　→　[環境設定]　→　[リボンを使用する（再起動後に有効）] のチェックを外して【オフ】にしてください
※桐を再起動すると、従来のツールバー表示になります

Chapter1：プログラムの第1歩は　「開いて閉じる」から
	改定版／更新日：2024年8月10日

1	事前準備
	ここで使用する表とフォームを作成します。表、フォーム、そして Chapter2 以降で作成するファイルは全て同じフォルダに入れておきます。

1-1	住所録（テーブルとフォーム）の作成
1-1-1	表（テーブル）の作成 [ファイル]メニュー　→　[新規作成] → [表] または　桐ファイルパレット　[ファイルの種類：表]　→　[新規作成] ファイル名：" 住所録.tbx " → [簡易表] [表題]：住所録（設定しなくてもOK）、[項目数]：２０（既存値でOKということです） → 完了（作成後定義で開くとよいでしょう） [定義] では項目名Ａ～Ｄを次のように変更してください。

1-1-2	フォームの作成 [ファイル]メニュー　→　[新規作成] → [フォーム]
	または　桐ファイルパレット [ファイルの種類：フォーム]　→　[新規作成] ファイル名：" 住所録.wfx " →　[一覧表] を選択使用する表ファイルは "住所録.tbx" です。ファイル参照から設定しましょう項目名を設定した4項目だけを使用します。またグループ化する項目はありません。作成したファイルは、[定義] で開くとよいでしょう
	項目幅を調整します（ここでは適当に設定しています。微調整は実際にデータを入力してからでないと難しいですね）。

	※ ファイルの拡張子に大文字、小文字の区別はありません。桐は自動で ”TBX , WFX” を付加しますが、” tbx , wfx ” でOKです。

1-2	郵便番号簿（テーブルとフォーム）の作成
1-2-1	表（テーブル）の作成 [ファイル]メニュー　→　[新規作成]　→　[ファイル名]：" 郵便番号簿.tbx "　→　[簡易表]　→　[表題]：郵便番号簿（設定しなくてもOK）、[項目数]：２０（既存値でOK） →　完了
	作成後、[定義] で項目名を次のように変更します。

1-2-2	フォームの作成 [新規作成]　→　[ファイル名]：" 郵便番号簿.wfx " →　[一覧表]　→　[表ファイル名]：" 郵便番号簿.tbx " →　[使用する項目]：以下の通りです

	郵便番号簿のフォームは特に調整する設定はありません

1-3	データ作成：郵便番号データを読み込みます
1-3-1	郵便局のサイトから郵便番号データをダウンロードして展開（解凍）し、準備しておきます ※ここでは「住所の郵便番号（1レコード1行、UTF-8形式）（CSV形式）」を利用しています（ファイル "utf_ken_all.csv" を入手しました）

1-3-2	" 郵便番号簿.wfx " を開いて [ファイル]メニュー　→　[読み込み]　→　[CSV]　をクリックします ※" 郵便番号簿.tbx " からも読込めます

	読み込むCSVファイルに "utf_ken_all.csv" を指定します。[読み込み項目] は　 (全て) でOKです。

	事前準備は以上で完了です (^_^)v

2	メニューの作成

2-1	Null フォーム（表を持たないフォーム）を使って作成します。フォームの種類で [ 白紙 -> フォーム定義へ ] を選択します。 ※ ファイル名は " MainMenu.wfx " としました

2-2	コマンドボタンを２つ準備して [オブジェクトの属性] → コマンドボタンの機能名を以下のように設定します ※フォームのサイズは適当に変更してください

2-2-1

2-2-2
2-2-3	できあがったフォームは次のようになります

2-3	このまま [住所録] と [郵便番号簿] のボタンを押すと以下のように所定のフォームが開きます。 "MainMenu.wfx" は閉じられます。

ヒント	定義画面を表示するショートカットキー [ファイル]　→　ファイルを選択して [ Ctrl ＋左クリック ] 、[ Ctrl ＋ Enter ] で、定義画面を開くことができます

3	住所録と郵便番号簿に MainMenu に戻るためのボタンを設定します。 ※ これまでの設定ではフォームを閉じるには右上のを押すしかなく MainMenu には戻れません。

3-1	"住所録.wfx" と "郵便番号簿.wfx" を定義で開いてヘッダ部分を広げてコマンドボタンを設定します。

3-1-1	"住所録.wfx" にコマンドボタンを設定します
3-1-2	同様に "郵便番号簿.wfx" にコマンドボタンを設定します

3-2	"MainMenu" の [住所録]ボタン、または [郵便番号簿]ボタンでフォームを開いて、開いたフォームに設定した [MainMenu]ボタンを押すとフォームが閉じて "MainMenu" に戻ることができるようになりました。

4	住所録から郵便番号簿へまた郵便番号簿から住所録へ MainMenu に戻らずに移動できるようにコマンドボタンを追加します

4-1	"住所録.wfx" 、 "郵便番号簿.wfx" の両フォームを定義で開いて、[住所録]・[郵便番号簿]のコマンドボタンを次のように追加します。

4-1-1	"住所録.wfx"の[郵便番号簿]ボタンの属性は次のようになります
4-1-2	"郵便番号簿.wfx" の[住所録]ボタンです

4-2	不要なボタンを使えないようにします
4-2-1	コマンドボタンの機能をすべて【なし】にします "住所録"では [住所録]ボタンの機能をすべて【なし】にします。同様に "郵便番号簿"では [郵便番号簿]ボタンの機能をすべて【なし】にします
4-2-2	もしくはコマンドボタンを【使用不可表示】にします
	コマンドボタンの [オブジェクトの属性]　→　[表示]　→　[フォーカス設定可能]　で設定します

5	ここまでの設定だけではフォームの右上の (閉じる）を押すと MainMenu を開かずに、ただ単にフォームが閉じるだけになります。
	そこでフォームをで閉じる際に、自動実行するコマンドを設定します。
	フォームを定義で開いて、 [フォームの属性] で、終了時の実行コマンドにコマンドボタン [cmdMainMenu] を登録します。 "MainMenu.wfx"には設定不要ですね

5-1	ワークスペースでWクリックしたり、右クリックして　→　[オブジェクトの属性]　→　オプションタブで終了時の実行コマンドに [cmdMainMenu] を登録します。 ※コマンドボタンのリストが表示されます。
	以下はワークスペースで右クリックした時のサンプルです。

6	MainMenu 、住所録、郵便番号簿の各フォームでコマンドボタンを押してみてくださいそれぞれのフォームを自由に移動できるようになっている、はずです　(^_^)v

6-1
	最初に開くフォームは MainMenu でなくてよいことにもなります

6-2	補足：上記のサンプルでは、表示を微調整しています（表示はお好みなので、以下の設定は参考まで）
	○[コマンドボタン]はオブジェクトの属性で → 背景 → 立体色モード→ (継承) に設定 ○"MainMenu.wfx" ではツールバーから　書式 → フォーム操作バーを「なし」に設定します ○"住所録.wfx" と "郵便番号簿.wfx" では項目名のフォントの表示位置を中央にして、明細部と共に高さを調整しています

Chapter 1 終わり、お疲れ様でした　(^_^)ノ
	Special Thanks　ONnojiさん、ＡＫさん