4D Japan
テクニカルサポートブログ-
リストボックス でデベロッパーを楽にする
私たちにとって、日を追うごとにデベロッパーを楽にすることは大事な目的です。そしてリストボックス は、この目的を叶えるための、4Dで最も使われている強力なフォームの一つです。ご存知のようにリストボックス は多くのイベントのトリガーです。4D v18 R2ではForm eventコマンドを拡張して、リストボックス がトリガーとなった場合により多くの情報が返されるようにしたのは、そのような理由です。
古いトリッキーなコードで、どの列、行、ヘッダーをクリックしたか、マウスを重ねていたかを知りたいのではないでしょうか。よりスムーズでスマートな方法をお見せしましょう。
イベントによって、追加された関連のあるプロパティがForm eventコマンドによって返されます。 いくつかサンプルをチェックしてみましょう。
On Header Clickイベント
ヘッダーオブジェクトの名称、カラムオブジェクトの名称、カラム番号はForm eventコマンドによって返されます。以下のサンプルは、On Header Clickイベントでトリガーされた時にオブジェクトを返す例です。
{"headerName":"headerLastname", // New property - Header object name "columnName":"lastname", // New property - Column object name "column":2, // New property - Column number "code":42, "description":"On Header Click", "objectName":"EmployeesLB"}例えば、カラム・オブジェクト名をデータベースの実際の属性名（例：lastname）に設定した場合、
Employeeのlastnameを表示するカラムのヘッダーをクリックした際に、lastnameとfirstname属性のカラムをソートします：
Form.event:=FORM Event
Case of
: (Form event code=On Header Click)
If (Form.event.columnName="lastname")
Form.employees:=Form.employees.orderBy(Form.event.columnName+", firstname")
End if
End caseOn Display Detailイベント
On Display Detailイベントがトリガーされる場合、追加される関連のあるプロパティ（例：isRowSelected）はForm eventコマンドによって返されます。これはリストボックス の行の外観を管理するのに役に立ちます：
以下はリストボックス のMeta info expressionプロパティのメソッド(setColor)のサンプルです：
setColorメソッド：
C_OBJECT($event;$0;$meta)
$event:=FORM Event
$meta:=New object
Case of
: ($event.code=On Display Detail)
If ($event.isRowSelected) //set color when row is selected
$meta.fill:="lightblue"
End if
End case
$0:=$metaそして行を選択した際のリストボックス の状態です：
ON MOUSE MOVEイベント
他によく使われるイベントはOn Mouse Moveイベントです。下記はForm eventコマンドによってトリガーされた時に返されるオブジェクトの例です。
マウスを置いた場所の役に立つ情報をすぐに入手できます！
マウスをヘッダーの上で停止する
Form eventコマンドが返すのは：
{"area":"header", // The mouse is on a header
"areaName":"headerLastname", // Header object name
"column":2, // Column number
"columnName":"lastname", // Colmun object name
"code":37,
"description":"On Mouse Move",
"objectName":"EmployeesLB"}
マウスをセルの上で停止する
Form eventコマンドが返すのは：
{"area":"cell", // The mouse is on a cell
"column":1, // Column number
"row":2, // Row number
"columnName":"firstname", // Colmun object name
"code":37,
"description":"On Mouse Move",
"objectName":"EmployeesLB"}とても多くのリストボックス イベントがあるので、一つのブログでは全てをカバーすることはできません。ドキュメントをチェックして、各イベントについてより詳細な情報を参照し、HDIサンプルをダウンロードして多くを学んでください！
-
RELATE MANYが使用できない場合
入力フォームでレコードを表示している間，そのテーブルは自動リレーションの対象から除外されます。これは編集中のレコードが意図に反してアンロードされることを防止するための措置であり，仕様です。たとえば，Ｎテーブルの入力フォームでダイアログを表示している場合，
RELATE MANYでＮテーブルのカレントセレクションを作成することはできません。
-
ウィンドウが無限にリサイズする
フォームのサイズが「自動」に設定されている場合，ウィンドウの最小サイズは，すべてのオブジェクトが表示できるサイズになります。そのようなウィンドウに対して
SET WINDOW RECTを使用する場合，ウィンドウの最小サイズを下回るような指定をすることがないようにしてください。コマンドで強制的に変形された「自動サイズ」のウィンドウをユーザーがマウス操作でリサイズした場合，ウィンドウの境界付近に表示された中途半端なオブジェクトが完全に表示されるよう，ウィンドウサイズの補正が試みられますが，ウィンドウの境界部はスプリッターでもあるので，同時にオブジェクトがリサイズされ，再びウィンドウサイズが不足することになります。ウィンドウとオブジェクトが互いを増幅させるため，リサイズがいつまでも終わりません。「自動サイズ」のウィンドウに対して
SET WINDOW RECTを使用する場合，ウィンドウの最小サイズに違反するような設定をしないように注意してください。
-
効かない編集メニュー
Windows版で，ウィンドウを表示する場合，編集メニュー（コピー＆ペーストなど）を誤って無効化していないか，特に注意してしてください。Macとは違い，モーダル型のウィンドウがメニューバーを
disableにするのは，仕様です。
-
ライブラリピクチャのID
ピクチャライブラリに登録された画像は，ドラッグ＆ドロップあるいはコピー＆ペースト操作でフォームに挿入し，スタティックピクチャ（ライブラリ画像）にすることができますが，ピクチャの番号（ID）が
32767よりも上だった場合，画像はエディターでもランタイムでも表示されません。これは仕様です。ピクチャライブラリのIDは，符号付き16ビットなので，32767が最大値となります。v11以降，Resourcesフォルダーが画像をライブラリ管理するための標準的な手段であり，ピクチャライブラリは，役目を終えています。廃止される予定はありませんが，今後，サポートが拡張されることもありません。そのことを踏まえ，新規の開発では，フォーム画像の管理にリソースピクチャを使用することが推奨されています。
-
PDFに埋め込めないフォント
v17r5では，4D View Proのエクスポート（
VP EXPORT DOCUMENT）が拡張され，PDF形式が指定できるようになりました。v18では，より正確なPDFドキュメントが出力できるよう，フォントの埋め込みがサポートされるようになりました。
Manage Printing and PDF export
埋め込みに対応しているのは，OpenType（
.otf.ttf）フォントです。SpreadJSが内部的に使用しているpdfkitの制限により，Unicodeマップを有するフォントだけが使用できます。システムにプリインストールされているフォントには，Unicodeマップを有さないものもあるため，エクスポートの前にフォントファイルがスキャンされ，埋め込みができるかどうか，判断されるようになっています（SpreadJSがデフォルトでサポートしているフォントはスキップします）。フォントファイルのスキャンは，下記の仕様に基づいて実行されます。Font fileは，VP EXPORT DOCUMENTが埋め込みフォントファイルを特定するため，VP EXPORT DOCUMENTが内部的に使用するコマンドとして追加されました。4D View Proドキュメント内で使用されているフォントに対応するフォントファイルがみつからない場合，SpreadJSのデフォルトフォントが使用されます。前述したように，PDFに埋め込むことができるのは
.otf.ttfファイルだけであり，フォントコレクション（.ttc）はサポートされていないことに留意してください。たとえば「Gill Sans」フォントは，フォントコレクションなので，印刷はできますが，PDFに埋め込むことはできません。これは（SpreadJSおよびpdfKitの）仕様です。回避策として，フォントコレクションを個別のフォントファイルに分割するオンラインサービスが使用できるかもしれません。
-
キリル文字のショートカット
4Dのキーボードショートカットは，モディファイアキーと
AからZ（文字）の単純な組み合わせで設定されています。ロシア語キーボードのレイアウトは，西欧レイアウトとは入力できる文字が違うため，ショートカットの設定ダイアログを表示している間，無効にされるべきですが，Macの場合，そのままキリル文字が入力できてしまいます。しかし，そのように設定したショートカットは無効です。ショートカットは，西欧レイアウトで設定するようにしてください。
-
足し算の答えが間違っている⁉︎
整数の
11に実数の1.5を加算した値は，何でしょうか。$Int:=11 $Real:=1.5 $Int:=$Int+$Real上記の演算は，32ビット版では
13（12.5を切り上げた値），64ビット版では12（12.5を切り下げた値）となります。これは仕様です。64ビット版の4Dでは，インタープリターモードとコンパイルモードの動きを揃えるため，インタープリターモードであっても，Intel CPUの「丸め」処理（最近接偶数丸め）で「丸め」処理が実行されるようになっています。一方，32ビット版は，従来どおり，「四捨五入」処理が実行されるため，演算結果に違いがあります。
-
非表示オブジェクトを移動すると増殖する
Windows版でフォームオブジェクトを同一メソッド内で非表示に設定し，移動してから非表示を解除した場合，画面上ではオブジェクトが以前の位置と新しい位置の両方に表示されます。これはAPIの特性に由来する振る舞いであり，現状では仕様です。オブジェクトの「増殖」を防止するためには，下記のようなコードを避けてくだだい。
OBJECT SET VISIBLE (*;"object";False) OBJECT SET COORDINATES*;"object";$left;$top;$right;$bottom) OBJECT SET VISIBLE (*;"object";True)
-
4D Write ProとHTML
4D Write ProのHTMLパーサーは，XHTML（XML形式のHTML）をインポートするように設計されています。正しくないXMLのインポートは失敗するかもしれません。たとえば，アンパーサンド記号（”&”）は
&のようにエスケープされている必要があります。WP Newで初期化するテキストは，標準テキストや不完全なHTMLコードの断片ではなく，XHTMLであるべきです。タグが省略された標準テキストは，まずHTMLとして整形され（この時点で
&は&になります），その後，XMLとして解析されるので，エラーになります。アンパーサンド記号（”&”）のようにエスケープが必要な文字が含まれるテキストを4D Write Proでインポートする場合，文字がエスケープされた標準テキストをWP Newに処理させようとするのではなく，文字がエスケープされていない標準テキストをWP SET TEXTで処理するようにしてください。