プッシュボタンボックスの項目と設定できる値を次の表に示します。

表8-26　プッシュボタンボックスの項目と設定できる値

項目			動的変更		設定できる値
			プッシュボタン	プッシュボタンボックス	プッシュボタン	プッシュボタンボックス
枠付き（ボックスに枠を付ける）			−	−	−	チェックあり／チェックなし
ボタンを横に並べる			−	−	−	チェックあり／チェックなし
フォーカス対象外（フォーカス遷移の対象としない）			−	−	−	チェックあり／チェックなし
ボックス名称			−	−	−	プッシュボタンボックスの名前を指定します。 この名前は，APから初期フォーカスをこのボックスに設定する場合に，APが指定する名前になります。
背景色			−	−	−	白，赤，緑，青，ライトレッド，ライトブルー，黄，グレー，黒，ダークグレー，ライトグレー，ダークグリーン，ライトグリーン，ライトイエロー，ダークブルー，透明
ボタン高			−	−	−	4.5ます，3.5ます，2.5ます，2ます
ラベル	文字サイズ		−	−	−	大，標準，小
	文字の書体		−	−	−	標準，明朝，ゴシック
	文字の強調		−	−	−	標準，太字，斜体，太字＆斜体
ラベルの種類			−	−	テキスト，ビットマップ，左ビットマップ+テキスト，右ビットマップ+テキスト，下ビットマップ+テキスト，上ビットマップ+テキスト，中央ビットマップ+テキスト	−
文字色			−	−	白，赤，緑，青，紫，空，黄，黒，ダークレッド，ダークブルー，ダークグリーン，ダークイエロー	−
初期テキスト	テキスト		○	−	表示するラベル文字列を指定します。ボタンの長さはラベルの長さに応じて更新されます。	−
	テキスト揃え		−	−	中央，左，右，均等	−
ビットマップ	活性用	標準	−	−	「2.2.1(5)　ボタンに使うビットマップのサイズと画面の解像度との関係」を参照	−
		交代1	−	−		−
		交代2	−	−		−
		交代3	−	−		−
	不活性用	標準	−	−	「2.2.1(5)　ボタンに使うビットマップのサイズと画面の解像度との関係」を参照	−
		交代1	−	−		−
		交代2	−	−		−
		交代3	−	−		−
	全体プレビュー		−	−	チェックあり／チェックなし	−
	設定		−	−	一覧で選んでいる位置にビットマップを指定	−
	削除		−	−	一覧で選んでいるビットマップの指定の解除	−
選択時の動作	選択時の動作		−	−	APへ通知する，ポップアップ表示	−
	通知コード		−	−	ファンクションキー，送信キー，割り込みキー，スクリーンキーと共用：標準値では順にPF01〜PF24，ENTR，BREK，SCRN，PA1，PA2，PA3，A001〜A060 メニューバーのメニュー項目とプッシュボタンとで共用：標準値ではA061〜A071	−
	表示方法		○	−	標準表示：オブジェクトや文字を見える状態で表示する 全体非表示：文字を含むオブジェクト全体を表示しない 文字だけ非表示：オブジェクトの外観は表示するが，文字は表示しない グレーアウト表示：オブジェクトや文字を不活性状態のグレーで表示する パスワード表示：文字を「＊」に替えて表示する	−
	フォーカス設定（初期フォーカスを本ボタンに設定する）		○	−	チェックあり／チェックなし	−
	不活性（選択できない状態にする）		○	−	チェックあり／チェックなし	−
	二次ウィンドウを閉じる		−	−	チェックあり／チェックなし	−
	アクセスキーを使用する		−	−	チェックあり／チェックなし	−
	アクセスキー		−	−	1文字の半角の英大文字(A〜Z)または数字(0〜9)	−
APが渡す項目	動的変更		−	−	「8.6　APが受け取る項目およびAPが渡す項目」を参照	−
	APからテキストを変更する		−	−
	データ名		−	−

（凡例）

○：動的変更できる。

−：動的変更できない，または，該当しない。

プッシュボタンが選択されるとイベントが発生します。APに通知するイベントの場合，APでは定義時に指定したイベント通知コードが入力論理マップに格納されます。

イベント通知コードとしては「送信」「スクリーン」「割込」「ファンクションキー（PF1〜PF84）」「PA1〜PA3」および「ボタンイベント（A061〜A071）」が使用できます。

動的変更によって，ボタンの「活性／不活性」やラベルテキストを変更できます。

ユーザAPでラベルテキスト項目名に変更内容を指定した場合は，ドローのプッシュボタンダイアログで指定した「テキスト揃え」は適用されません。実行時には，ユーザAPで指定したボタンのラベルテキストは左寄せ固定となります。また，ユーザAPでラベルテキスト出力項目名に，ビットマップおよびビットマップファイル名を指定できません。

プッシュボタンダイアログの「ラベルの種類」から「ビットマップ」または「ビットマップとテキスト」の組み合わせを選択し，ビットマップの［設定］ボタンをクリックすると，プッシュボタンのラベルとして固定グラフィックや固定グラフィックとテキストの組み合わせを表示できます。使用する固定グラフィックは，あらかじめユーザが用意しておきます。なお，グラフィックのサイズが大きい場合や，テキストが長い場合には，グラフィックとテキストが重なり合うことがあるので，必要に応じてボタンのサイズを大きくしてください。

なお，プッシュボタンに表示するグラフィックは，画面の解像度に応じて交代で表示できます。最もよく使用する解像度のグラフィックを「標準用」として指定し，必要に応じて「交代用」を指定します。

次に示す表は，XMAP3が提供する標準の文字サイズに対する値です。

表8-27　 640×480または800×600の解像度（2D）

文字	ボタン高
	4.5	3.5	2.5	2
大	48×48	36×36	24×24	22×22
標準	32×32	24×24	16×16	14×14
小	24×24	18×18	12×12	10×10

表8-28　 640×480または800×600の解像度（3D）

文字	ボタン高
	4.5	3.5	2.5	2
大	44×44	32×32	22×22	20×20
標準	28×28	20×20	14×14	12×12
小	24×24	18×18	12×12	10×10

表8-29　 1,024×768または1,280×1,024の解像度（2D）

文字	ボタン高
	4.5	3.5	2.5	2
大	64×64	48×48	32×32	30×30
標準	48×48	36×36	24×24	22×22
小	32×32	24×24	16×16	14×14

表8-30　1,024×768または1,280×1,024の解像度（3D）

文字	ボタン高
	4.5	3.5	2.5	2
大	44×44	32×32	22×22	20×20
標準	28×28	20×20	14×14	12×12
小	24×24	18×18	12×12	10×10

フォーカス遷移で選択できないようにボタンを設定します。誤入力などを防ぐのに有効です。プッシュボタンボックスダイアログの「フォーカス遷移の対象としない」を指定すると，そのボタンボックス中のプッシュボタンへは，フォーカスが遷移しなくなります。

マウスだけでなく，文字キーでもプッシュボタンを選択できるように設定します。プッシュボタンダイアログの「アクセスキーを使用する」を指定すると，アクセスキーが対応するキーを選択することで，プッシュボタンを押せます。このアクセスキーに「0〜9」の数字キーを指定すると，テンキーでも操作できるようになります。

なお，アクセスキーが有効なのは，フォーカスがプッシュボタンボックスに位置づいているときです。

プッシュボタンの活性／不活性や表示属性を実行時に変更できます。表示属性の動的変更については「8.2.4　表示属性の動的変更」を参照してください。

(a)　ラベルテキストを動的変更するときの注意

●テキスト揃え

ラベルテキストを動的変更する場合，ラベルテキストの中央寄せなどの桁揃えは，論理項目の設定値で調整します。

●プッシュボタンのサイズ変更

プッシュボタンのサイズを変更した場合，変更した値がすべてのプッシュボタンのボタンサイズ，およびラベルテキストの論理項目の桁に設定されます。このため，「APからテキストを変更する」を指定しているボタンが含まれるプッシュボタンボックスで，ボタンのサイズを変更したときは，APを再コンパイルしてください。

●テキストのデータ長の変更

ターゲットによって，データ長をユーザ任意の値に設定できるようになります。「テキストのデータ長を変更する」を指定した場合，ラベルテキストの論理項目の桁が固定になります。このため，同じボックス内のすべてのボタンで，ボタンサイズの変更，およびラベルテキストの論理項目の桁の変更ができなくなります。

●プッシュボタンの貼り付け

「APからテキストを変更する」を指定しているプッシュボタンを貼り付ける場合，貼付け先のプッシュボタンボックスのボタン長に合わせて桁が変更されます。テキストのデータ長の変更は解除されます。