コントロール (クライアント API 参照)
コントロールは、フォームに表示される HTML 要素を表します。 コントロールには特定の列にバインドされるものもありますが、IFRAME、Web リソース、またはフォームに追加されたサブグリッドなど、バインドされないコントロールを表すものもあります。
コントロールオブジェクトには、コントロールの表示や動作を変更して、対応する列を指定する方法が用意されています。 以下のコレクションのいずれかを使用してコントロールにアクセスします:
- formContext.ui.controls
- formContext.ui Section.controls
- formContext.data.entityAttribute.controls
formContext.getControl メソッドは、 formContext.ui.controls.get にアクセスするためのショートカット メソッドです。
コントロールは、種類によって分類されます。 getControlType メソッドを使用すると、コントロールの種類を判別できます。 特定のコントロールのメソッドは、特定の種類のコントロールでのみ利用できます。
この記事では、コントロール タイプごとに使用できるメソッドについて説明します。
標準コントロール タイプ
これらは標準コントロールで使用可能なメソッドです。
標準コントロールの次のメソッドは、このリリースの 廃止済 にあります: addOnKeyPress
、fireOnKeyPress
および removeOnKeyPress
。
IFRAME コントロールタイプ
これらのメソッドは、IFRAME コントロールで使用可能です。
kbsearch (サポート情報検索) コントロール タイプ
これらのメソッドはサポート情報検索コントロールに使用可能です。
ヒント
サポート情報の検索コントロールがソーシャル ウィンドウに追加されると、そのコントロール名前は searchwidgetcontrol_notescontrol
となります。 この名前は変更できません。
検索コントロール タイプ
これらのメソッドは、検索コントロールで使用可能です。
選択および選択コントロールの種類
選択 (複数) と選択コントロールの両方で、同じ方法のセットを使用できます。
Quickform コントロール タイプ
このコントロールタイプでサポートされているメソッドの情報については、「 formContext.ui.quickForms 」を参照してください。
サブグリッド コントロール タイプ
このコントロールタイプでサポートされているメソッドの情報については、 グリッドおよびサブグリッド を参照してください。
Timelinewall コントロール タイプ
タイムライン コントロールは、統合ビューで投稿、活動、メモを表します。 これらのメソッドは、このコントロール タイプに使用可能です。
タイマー コントロール タイプ
これらのメソッドは、タイマー コントロールに使用可能です。
Web リソースのコントロール タイプ
Webリソース コントロールには、IFRAMEコントロールでも利用可能な同じメソッド セットがあります。 See IFRAME コントロールの種類を参照してください
Sliverlight Web リソースには、これらの追加メソッドがあります。
チップ
フォームの列にバインドされているすべてのコントロールを変更する場合は、列タイプ内のコントロール コレクションを使用します。 たとえば、name
列にバインドされた各コントロールに通知を追加するには、次のようにします :
const notification = { messages: ['Sample Notification on Name Controls'], notificationLevel: 'RECOMMENDATION', uniqueId: 'my_unique_id'};
formContext.getAttribute("name").controls.forEach(control => control.addNotification(notification));
Form Component コントロール タイプ
Form Component コントロール タイプは、メインフォームの formContext と同じメソッド セットを利用できます。 フォーム コンポーネントの動作 > クライアント API を参照ください