システム定義ボタン

[アーティクル]
12/31/2024

この記事では、システム定義ボタンについて説明します。

概要

システム定義のいくつかのボタンが、アクションウィンドウに自動的に存在します。一般に、これらのシステム定義ボタンは、エンドユーザーに適用され、使用可能な状態を保持する必要があります。ただし、まれなケースでは (たとえば、より専門的な管理が必要な場合、またはシステム定義ボタンが特定のフォームには役立たないまたは該当しない)、開発者は明確に抑制するまたはシステム定義ボタンを上書きする必要がある場合があります。たとえば、ある状況では、複数の「新規」オプションからユーザーが選択できるようにするメニューボタンは、システム定義された新規ボタンの方が望ましい場合があります。

システム定義ボタンのリスト

次のテーブルは、システム定義ボタンの完全な一覧を示しています。これらのテーブルは、条件付きまたは完全に抑制または上書きする必要がある場合に役立つ情報も提供します。

一般的なボタン

ボタン	ボタン名マクロ*	備考
輸出		このボタンを抑制しないでください。
添付	#SystemDefinedAttachButton	添付ファイル用に設定されていないフォームでは表示しないため、このボタンを抑制しないでください。
フィルターの表示	#SystemDefinedShowFiltersButton	既定では、目次フォームは表示=いいえになっています。

* システム定義のボタン名マクロは、SysSystemDefinedButtons マクロファイルにあります。

詳細フォームに固有のボタン

これらのボタンは、詳細フォームの経験の不可欠な部分です。したがって、これらのボタンを非表示にする必要はほとんどありません。

ボタン	ボタン名マクロ*	備考
ビューの変更	#SystemDefinedShowMenuButton	このボタンは、オプションアクションペインタブの下にあります。
グリッドビュー	#SystemDefinedGridViewButton
詳細ビュー	#SystemDefinedDetailsViewButton
行の詳細の表示	#SystemDefinedLineDetailsViewButton
ヘッダーの詳細ビュー	#SystemDefinedHeaderDetailsViewButton
リストを表示	#SystemDefinedShowListButton

* システム定義のボタン名マクロは、SysSystemDefinedButtons マクロファイルにあります。

システム定義ボタンのないフォームスタイル

さまざまなフォームスタイルについては、システム定義されたボタンの追加に意味がない主な理由は、これらのフォームが標準のアクションウィンドウを持っていないことです。次のフォームスタイルは、システム定義のボタンを受け取ることはありません。

ダッシュボード
ダイアログ
DropDialog
FormPart
ルックアップ
サイトマップ
ウィザード

システム定義のボタンの大部分またはすべてを非表示

フォーム上のシステム定義ボタンのほとんどまたはすべてを非表示にしている場合は、フォームのスタイル (Form.Design.Style) またはパターンを再確認し、フォームの目的を再検討する必要があります。代わりにフォームをダイアログにすべきでしょうか。 (デフォルトでは、ダイアログにはシステム定義のボタンは表示されません。) 多くの場合、このような状況でのフォームはスタイル=自動であり、ダイアログとしてはより適切です。フォームを技術的にダイアログにする必要がある場合、同時にすべてのシステム定義されたボタンを自動的に非表示にできるメタデータまたはコードは現在ありません。フォームをシステム定義のボタンを受け取らないフォームスタイルに切り替える場合を除き、各ボタンを個別に抑制/オーバーライドにする必要があります (この記事の他のセクションを参照)。このシナリオは非常に稀です。

新規システムおよびシステムの削除のボタン

新規および削除ボタンは、現在カーネルによって追加され、特殊なメタデータプロパティを使用して制御されます。これらのボタンは、常にフォーム上の最初のマスターデータソースで機能します。

これらのボタンは既定ではいつ有効になりますか

フォームには通常、システム定義された新規および削除ボタンがあります。これらのボタンは、次の条件でフォームに表示されます。

フォームには、システム定義のボタンを使用できるスタイルがあります。
フォームには 1 つ以上のデータソースがあります。

フォームの新規および削除ボタンの表示にどのように影響を与えますか。ただしキーボードのショートカットを介して標準の新規および削除タスクを起動できますか。

フォームでの新規ボタンと削除ボタンの表示/非表示を制御するには、Form.Design の ShowNewButton および ShowDeleteButton プロパティを使用します。データソースでユーザーがまだレコードを作成して削除できる場合、キーボードショートカットはシステムボタンが表示されない場合でも引き続き機能することに注意してください。

プロパティ	先頭値	説明
Form.Design.ShowNewButton	いいえ	フォーム上でシステム定義の新規ボタンを非表示にします。
Form.Design.ShowDeleteButton	いいえ	フォーム上でシステム定義の削除ボタンを非表示にします。

新規および削除ボタンの状態 (有効/無効)、およびフォームで関連するタスクの動作にどのように影響しますか。

フォーム上の新規および削除ボタンの状態と、関連するタスクの動作の両方に影響を及ぼすには、AllowCreate と AllowDelete のプロパティを指定します。また、このアプローチを使用して、新規と削除ボタンを無効にする場合、関連付けられているキーボードショートカットは無効になります。

プロパティ	先頭値	説明
Form.Datasources.<FirstMasterDatasource>.AllowCreate	いいえ	フォームはレコードの作成を許可しません。フォームに無効なシステム定義の新規ボタンがあります。
Form.Datasources.<FirstMasterDatasource>.AllowCreate	はい	このフォームはレコードの作成を可能にします。フォームには、システム定義の新規ボタンが有効になっています (表示されている場合)。
Form.Datasources.<FirstMasterDatasource>.AllowDelete	いいえ	フォームはレコードの削除を許可しません。フォームに無効なシステム定義の削除ボタンがあります。
Form.Datasources.<FirstMasterDatasource>.AllowDelete	はい	このフォームはレコードの削除を可能にします。フォームには、システム定義の削除ボタンが有効になっています (表示されている場合)。

メモ

フォームに新規レコードアクションがある場合、ボタンコントロールはシステム定義の新規ボタンの有効状態を上書きします。

新しいタスク (ボタンをクリックするまたはキーボードショートカットを使用するかのいずれか) の動作をどのように変更しますか。

新しいタスクの動作を変更するメカニズムは 3 つあります。

新しいレコードアクション プロパティを使用します。このプロパティは、現在、Form.Design でのみ使用可能であり、フォーム上で New コマンドを呼び出すすべての CommandButton (セカンダリコレクションにバインドされている CommandButtons も含まれる) に対して参照されたアクションがトリガーされます。今後、新しいレコードアクション プロパティがすべてのコンテナーコントロールに配置され、プロパティのスコープにわたるコントロールが向上します。現時点では、新しいレコードアクション プロパティもメニューボタンまたはドロップダイアログボタンとして定義できないことに注意してください。

プロパティ	先頭値	説明
Form.Design.NewRecordAction	フォームからのコントロール名	このプロパティは、指定されたアクションを実行するための新規タスクをオーバーライドします。

(推奨)イベントを使用します。特に、レコードの作成と削除の前後に実行することを意図したコードを配置できる場合、これらのアクションのプリイベントとポストイベントがあります。以下のコード例をご覧ください。

[Form]
public class Form1 extends FormRun
{
    public void init()
    {
        super();
        element.dataHelper().RecordCreating += eventhandler(this.PreRecordCreate);
        element.dataHelper().RecordCreated  += eventhandler(this.PostRecordCreate);
        // similar methods exist for deletion:
        // element.dataHelper().RecordDeleting, element.dataHelper().RecordDeleted
        //
        // explicit actions can be triggered via:
        // element.dataHelper().RecordCreate(), element.dataHelper().RecordDelete()        
    }
    public void PreRecordCreate(FormRunServiceArgs _cancellableArgs)
    {
        //  I can add my logic here that gets invoked before the global creation task
        // if I need to, I can cancel the "super" of the task by doing:
        // _cancellableArgs.cancel()
    }
    public void PostRecordCreate()
    {
        //  I can add my logic here that gets invoked after the global creation task
    }
}

対応するデータソースの、create() または delete() メソッドで上書きを作成します。

新しいボタン (ただしタスクではない) の動作をどのように変更しますか。

システム定義された新規ボタンを、複数の「新規」オプションからユーザーに選択させるメニューボタンに置き変える場合を考えてみましょう。したがって、次のタスクを実行できます。

システム定義された新規ボタンを非表示にします。
新しいアクションに対する独自のボタンをモデル化します。

ただし、この時点で、キーボードショートカットが呼び出されると、新規のシステム動作も起動します。キーボードショートカットを押したときにモデル化された新規ボタンを起動するようにするには、このボタンを Form.Design の NewRecordAction として設定する必要があります。前のセクションで触れたように、アクションは現在フォーム上の新しいタスクを呼び出すすべての CommandButtons に対して起動されます。したがって、このアプローチは、複数のデータソースを持つフォームでは使用しないでください。

編集、実行、保存、およびシステムボタンを復元

編集、実行、保存、および復元ボタンでは、ユーザーが必要に応じてフォームの編集モードを切り替えることができます。この機能は重要であるため、これらのボタンは現在抑制できません。ただし、フォームが常に編集モードまたは表示モードである必要がある場合、ViewEditMode プロパティを使用して効果を達成でき、ボタンはフォームに表示されません。ほとんどのフォームが ViewEditMode=Auto のままになることに注意してください。フォームが読み取り専用の場合、または常に編集可能になる場合を除いて、純粋に外観上の理由で ViewEditMode=View または ViewEditMode=Edit に設定しないでください。

Form.Design.ViewEditMode	フォーム動作	システム定義ボタンの動作
表示	フォームは常に表示モードです。	フレームワークが必要ではないとみなすため、これらのボタン (編集、完了、保存、および復元) のいずれも表示されません。
編集	フォームは常に編集モードです。	保存および元に戻すボタンのみが表示されるのは、ユーザーが編集モードを終了することができないからです。元に戻すボタンは、フレームワークによって指定されたオプションタブにあります。
自動	フォームは、表示モードと編集モードの間で切り替えることができます。	表示モードでは、編集ボタンはアクションウィンドウに表示されます。編集モードでは、保存ボタンはアクションウィンドウに表示されており、読み取りモードおよび元に戻すボタンはフレームワークによって指定されたオプションタブに表示されます。

条件付きで編集ボタンを隠すまたは表示できますか？

あるポイントでフォームが編集可能で、他のポイントで読み取り専用にすると、ユーザーがフォームを編集できるかどうかを判断するロジックを使用して、実行時に ViewEditMode プロパティを設定できます。フォームを読み取り専用にする必要があるときは、ViewEditMode=表示を設定します。フォームの編集または表示のいずれかができるとき、ViewEditMode=自動を設定します。

編集ボタンをクリックするときに追加コードを実行するにはどうすればよいですか。

編集ボタンをクリックしたときに追加のコードを実行させるには、イベントを使用します (この記事の前半の「新しいタスクの動作を変更する方法 (ボタンをクリックするか、キーボードショートカットを使用する) は?」セクションの例を参照してください)。具体的には、次のイベントを使用します。

現在の表示/編集モードの切替えをサブスクライブするには、次のイベントを使用します:
- element.viewEditModeHelper().EditModeSwitching
- element.viewEditModeHelper().EditModeSwitche
現在の表示/編集モードを照会するには、次のイベントを使用します:
- element.viewEditModeHelper().isInEditMode()
- element.viewEditModeHelper().IsInViewMode()
現在の表示/編集モードの切替えをトリガーするには、次のイベントを使用します:
- element.viewEditModeHelper().setViewEditMode(ViewEditMode::Edit)

[更新]、[ポップアウト]、[閉じる] システムボタン

更新、ポップアウト、および閉じる ボタンは、アクションウィンドウの右側にあるシステムボタンです。更新ボタンは、フォーム上のすべてのデータを更新するために使用されます。 ポップアウト ボタンを使用すると、現在のフォームが別のウィンドウに移動します。 閉じる ボタンは、フォームを閉じます (基本的に、このボタンはブラウザの戻るボタンをクリックします)。これらのシステムボタンは不可欠なコンポーネントであり、現時点では抑制することはできません。

他のシステム定義ボタン

残りのシステム定義のボタンは Form.Init 中に追加されます。同じ名前のコントロールが存在しない場合にのみ追加されます。

システム定義されたボタンと共に追加コードを実行する、またはボタンの動作を変更するにはどうすればよいですか。

表示切り替えボタン (たとえば、グリッドビュー、詳細ビュー、ヘッダービュー、または明細行ビューに切り替えるボタン) については、個々の TabPage で pageActivated() メソッドを上書きする必要があります。
プリイベント/ポストイベントを持つシステム定義されたボタン (たとえば、新規、削除、および編集) については、適切なイベントにサブスクライブすることができます。これらのボタンの特定のイベントについては、新規作成/削除ボタンと編集ボタンの対応するセクションを参照してください。
タスクを直接呼び出さないシステム定義のボタン (たとえば、SystemDefinedShowMenuButton および SystemDefinedShowListButton) については、registerOverrideMethod() の呼び出しを通してボタンの上書きを登録でき、システム定義ボタンをクリックしたときに追加コードが実行されるようにします。
```
public void overrideFunction(FormCommandButtonControl _command)
    {
        // Put any pre-super code here 
        // This serves as the call to super()
        _command.clicked(); 
        // Put any post-super code here
    }
```

対応するタスクを抑制することなく、フォーム上のこれらのシステム定義されたボタンのいずれかを抑制するにはどうすればよいですか。

一般に、システムボタンのいずれかを非表示にすることはお勧めしません。それらの存在は、フォーム上のアクションに一貫性をもたらします。ただし、それが役立たないある状況によっては、ボタンが現在表示されます。これらの状況の多くに対処する将来の作業項目があります。たとえば、次のタスクの作業項目があります。

添付ファイルを許可するように構成されていないフォームで添付ボタンを非表示にします。
グリッドがないフォームで エクスポート ボタンを非表示にします。
メイングリッドがないフォームで フィルターを表示する ボタンを非表示にします。

ただし、これらのボタンのいずれかを抑制する必要がある場合 (決して推奨しません)、次のコード例に示すように、コードを通してコントロールを検索し、可視性を false に設定できます。利用可能な場合、SysSystemDefinedButtons マクロを使用して、ボタン名を参照します。

FormCommandButtonControl attachButton;

    public void init()
    {
        #SysSystemDefinedButtons

        super();

        attachButton= this.control(this.controlId(#SystemDefinedAttachButton)) as FormCommandButtonControl; 
        attachButton.visible(false); 
    }

次の方法で共有

システム定義ボタン

概要

システム定義ボタンのリスト

一般的なボタン

詳細フォームに固有のボタン

システム定義ボタンのないフォームスタイル

システム定義のボタンの大部分またはすべてを非表示

新規システムおよびシステムの削除のボタン

これらのボタンは既定ではいつ有効になりますか

フォームの新規および削除ボタンの表示にどのように影響を与えますか。ただしキーボードのショートカットを介して標準の新規および削除タスクを起動できますか。

新規および削除ボタンの状態 (有効/無効)、およびフォームで関連するタスクの動作にどのように影響しますか。

新しいタスク (ボタンをクリックするまたはキーボードショートカットを使用するかのいずれか) の動作をどのように変更しますか。

新しいボタン (ただしタスクではない) の動作をどのように変更しますか。

編集、実行、保存、およびシステムボタンを復元

条件付きで編集ボタンを隠すまたは表示できますか？

編集ボタンをクリックするときに追加コードを実行するにはどうすればよいですか。

[更新]、[ポップアウト]、[閉じる] システムボタン

他のシステム定義ボタン

システム定義されたボタンと共に追加コードを実行する、またはボタンの動作を変更するにはどうすればよいですか。

対応するタスクを抑制することなく、フォーム上のこれらのシステム定義されたボタンのいずれかを抑制するにはどうすればよいですか。

フィードバック

その他のリソース

次の方法で共有

システム定義ボタン

概要

システム定義ボタンのリスト

一般的なボタン

詳細フォームに固有のボタン

システム定義ボタンのないフォーム スタイル

システム定義のボタンの大部分またはすべてを非表示

新規システムおよびシステムの削除のボタン

これらのボタンは既定ではいつ有効になりますか

フォームの新規および削除ボタンの表示にどのように影響を与えますか。ただしキーボードのショートカットを介して標準の新規および削除タスクを起動できますか。

新規および削除ボタンの状態 (有効/無効)、およびフォームで関連するタスクの動作にどのように影響しますか。

新しいタスク (ボタンをクリックするまたはキーボード ショートカットを使用するかのいずれか) の動作をどのように変更しますか。

新しいボタン (ただしタスクではない) の動作をどのように変更しますか。

編集、実行、保存、およびシステム ボタンを復元

条件付きで 編集ボタンを隠すまたは表示できますか？

編集ボタンをクリックするときに追加コードを実行するにはどうすればよいですか。

[更新]、[ポップアウト]、[閉じる] システム ボタン

他のシステム定義ボタン

システム定義されたボタンと共に追加コードを実行する、またはボタンの動作を変更するにはどうすればよいですか。

対応するタスクを抑制することなく、フォーム上のこれらのシステム定義されたボタンのいずれかを抑制するにはどうすればよいですか。

フィードバック

その他のリソース

システム定義ボタンのないフォームスタイル

新しいタスク (ボタンをクリックするまたはキーボードショートカットを使用するかのいずれか) の動作をどのように変更しますか。

編集、実行、保存、およびシステムボタンを復元

条件付きで編集ボタンを隠すまたは表示できますか？

[更新]、[ポップアウト]、[閉じる] システムボタン