バージョン: 20 R10 BETA

動作

ドラッグ有効

ユーザーによるオブジェクトのドラッグを制御します。デフォルトでは、ドラッグ操作は禁止されています。

二つのドラッグモードが提供されています:

カスタム: このモードでは、オブジェクトに対しておこなわれたドラッグ操作は、当該オブジェクトのコンテキストにおいて On Begin Drag フォームイベントを発生させます。これを利用して、開発者はメソッドを用いてドラッグアクションを管理しなければなりません。
つまり、カスタムモードにおいては、ドラッグ＆ドロップ操作のすべてが開発者により管理されます。このモードでは、ドラッグ＆ドロップに基づいたあらゆるインターフェースを実装することができます。これにはデータの転送を必ずしも伴わないものも含まれ、ファイルを開くや計算をトリガーするなどの任意のアクションを実行することができます。このモードは専用のプロパティ、イベント、ペーストボード テーマのコマンド等の組み合わせに基づいています。
自動: このモードでは、ドラッグ元のフォームオブジェクトからテキストやピクチャーが 4D によって コピー されます。このコピーは、同じ 4Dエリア内、2つの 4Dエリア間、4D と他のアプリケーション間で使用できます。たとえば、自動ドラッグ (＆ドロップ) を使用して、プログラムを使用せず、2つのフィールド間で値をコピーできます:

このモードでは、On Begin Drag フォームイベントは生成されません。自動ドラッグが有効のときに標準のドラッグを "強制" したい場合、アクションの間 Alt (Windows) または Option (macOS) キーを押しながら操作します。このオプションはピクチャーでは利用できません。

詳細については 4Dランゲージリファレンス マニュアルのドラッグ＆ドロップを参照してください。

JSON 文法

名称	データタイプ	とりうる値
dragging	text	"none" (デフォルト), "custom", "automatic" (リストボックスを除く)

ユーザーがドラッグ＆ドロップしたデータをオブジェクトが受け取ることができるかどうかを制御します。

二つのドロップモードが提供されています:

カスタム: このモードでは、オブジェクトに対しておこなわれたドロップ操作は、当該オブジェクトのコンテキストにおいて On Drag Over と On Drop フォームイベントを発生させます。これを利用して、開発者はメソッドを用いてドロップアクションを管理しなければなりません。
つまり、カスタムモードにおいては、ドラッグ＆ドロップ操作のすべてが開発者により管理されます。このモードでは、ドラッグ＆ドロップに基づいたあらゆるインターフェースを実装することができます。これにはデータの転送を必ずしも伴わないものも含まれ、ファイルを開くや計算をトリガーするなどの任意のアクションを実行することができます。このモードは専用のプロパティ、イベント、ペーストボード テーマのコマンド等の組み合わせに基づいています。
自動: このモードでは、4D は可能な限り自動で、オブジェクトにドロップされたテキストやピクチャー型データの挿入を管理します (データはオブジェクトにペーストされます)。このモードでは、On Drag Over と On Drop フォームイベントは生成されません。他方、ドロップ中の On After Edit とオブジェクトがフォーカスを失った時の On Data Change イベントは生成されます。

詳細については 4Dランゲージリファレンス マニュアルのドラッグ＆ドロップを参照してください。

JSON 文法

名称	データタイプ	とりうる値
dropping	text	"none" (デフォルト), "custom", "automatic" (リストボックスを除く)

対象オブジェクト

4D Write Pro area - Button - Combo Box - Input - Hierarchical List - List Box - Picture button - Plug-in Area

コマンド

OBJECT GET DRAG AND DROP OPTIONS - OBJECT SET DRAG AND DROP OPTIONS

参照

ドラッグ有効

オブジェクトメソッド実行

このオプションを選択した場合、ユーザーがインジケーターの値を変更すると 同時に On Data Change イベントが生成され、オブジェクトメソッドが実行されます。デフォルトでは、変更後に メソッドが実行されます。

JSON 文法

名称	データタイプ	とりうる値
continuousExecution	boolean	true, false

対象オブジェクト

進捗インジケーター - ルーラー - ステッパー

メソッド

オブジェクトに関連づけられたメソッドへの参照。オブジェクトメソッドは通常、フォームが表示または印刷されている間、オブジェクトを "管理" します。オブジェクトメソッドは呼び出す必要がありません。オブジェクトメソッドが関連づけられているオブジェクトに関わるイベントが発生した場合、4D は自動的にオブジェクトメソッドを呼び出します。

メソッド参照にはいくつかのタイプが利用可能です:

標準のオブジェクトメソッドファイルパス:
ObjectMethods/objectName.4dm
(objectName には実際のオブジェクト名が入ります)。このタイプの参照は、当該メソッドファイルがデフォルトの場所 ("sources/forms/formName/ObjectMethods/") にあることを示します。この場合、エディター上でフォームオブジェクトに対して操作 (名称変更、複製、コピー/ペーストなど) がおこなわれると、4D はこれらの変更を自動的にオブジェクトメソッドに反映させます。
拡張子を省いた既存のプロジェクトメソッド名: myMethod。この場合、フォームオブジェクトに対して操作がおこなわれても、4D はそれらの変更を自動で反映しません。
.4dm 拡張子を含むカスタムのメソッドファイルパス:
../../CustomMethods/myMethod.4dm。ファイルシステムも使用できます:
/RESOURCES/Buttons/bOK.4dm。この場合、フォームオブジェクトに対して操作がおこなわれても、4D はそれらの変更を自動反映しません。

JSON 文法

名称	データタイプ	とりうる値
method	text	オブジェクトメソッドの標準またはカスタムのファイルパス、またはプロジェクトメソッド名

対象オブジェクト

4D View Pro エリア - 4D Write Pro エリア - ボタン - ボタングリッド - チェックボックス - コンボボックス - ドロップダウンリスト - フォーム - 階層リスト - 入力 - リストボックス - リストボックス列 - ピクチャーボタン - ピクチャーポップアップメニュー - プラグインエリア - 進捗インジケーター - ラジオボタン - ルーラー - スピナー - スプリッター - ステッパー - サブフォーム - タブコントロール - Web エリア

行の移動可

配列型リストボックス

ランタイムにおける行の移動を許可します。このオプションはデフォルトで選択されています。セレクション型のリストボックスおよび階層リストボックスでは、このオプションは提供されていません。

JSON 文法

名称	データタイプ	とりうる値
movableRows	boolean	true, false

対象オブジェクト

リストボックス

コマンド

LISTBOX Get property - LISTBOX SET PROPERTY

複数選択可

階層リストにおいて、複数項目の選択を許可します。

JSON 文法

名称	データタイプ	とりうる値
selectionMode	text	"multiple", "single", "none"

対象オブジェクト

階層リスト

コマンド

GET LIST PROPERTIES - SET LIST PROPERTIES

ソート可

リストボックスヘッダーのクリックによる列データの並べ替えを有効にします。このオプションはデフォルトで選択されています。ピクチャー型配列 (列) はこのメカニズムではソートできません。

レコードセレクションに基づくリストボックスの場合、標準のソート機能は以下の場合のみ有効です:

データソースが カレントセレクション であり、
その列にフィールドが割り当てられていること (文字、数値、日付、時間、およびブール型)。

他の場合 (命名セレクションに基づくリストボックスや、式が割り当てられた列)、標準のソート機能は動作しません。標準のリストボックスソートは、データベースのカレントセレクションの順番を変更します。しかし、ハイライトされたレコードとカレントレコードは変更されません。標準の並び替えは、リストボックスのすべての列 (式が割り当てられた列も含む) を同期します。

JSON 文法

名称	データタイプ	とりうる値
sortable	boolean	true, false

対象オブジェクト

リストボックス

コマンド

LISTBOX Get property - LISTBOX SET PROPERTY

標準アクション

アクティブオブジェクトにより実行される典型的な処理 (例: レコードの入力・取り消し・削除、レコード間の移動、マルチページフォームでのページ間の移動、など) は、4D より標準アクションとして提供されています。詳細な情報に関しては、デザインリファレンス の標準アクションの章を参照ください。

フォームオブジェクトには、標準アクションとメソッドの両方を割り当てることができます。この場合、標準アクションは通常、メソッドの後に実行されます。また、4D はこのアクションを使用して、カレントコンテキストに応じてオブジェクトを有効化/無効化します。フォームオブジェクトが無効化されていた場合、関連づけられたメソッドは実行されません。

JSON 文法

名称	データタイプ	とりうる値
action	string	有効な標準アクション

対象オブジェクト

ボタン - ボタングリッド - チェックボックス - ドロップダウンリスト - リストボックス - ピクチャーボタン - ピクチャーポップアップメニュー - タブコントロール

コマンド

OBJECT Get action - OBJECT SET ACTION

ドラッグ有効​

JSON 文法​

対象オブジェクト​

コマンド​

参照​

ドロップ有効​

JSON 文法​

対象オブジェクト​

コマンド​

参照​

オブジェクトメソッド実行​

JSON 文法​

対象オブジェクト​

メソッド​

JSON 文法​

対象オブジェクト​

行の移動可​

JSON 文法​

対象オブジェクト​

コマンド​

複数選択可​

JSON 文法​

対象オブジェクト​

コマンド​

ソート可​

JSON 文法​

対象オブジェクト​

コマンド​

標準アクション​

JSON 文法​

対象オブジェクト​

コマンド​

ドラッグ有効

JSON 文法

対象オブジェクト

コマンド

参照

ドロップ有効

JSON 文法

対象オブジェクト

コマンド

参照

オブジェクトメソッド実行

JSON 文法

対象オブジェクト

メソッド

JSON 文法

対象オブジェクト

行の移動可

JSON 文法

対象オブジェクト

コマンド

複数選択可

JSON 文法

対象オブジェクト

コマンド

ソート可

JSON 文法

対象オブジェクト

コマンド

標準アクション

JSON 文法

対象オブジェクト

コマンド