InViewEdit (NotesUIView - LotusScript®)

1. 照会: ユーザーが編集可能なビュー列エントリを入力したとき。
2. 検証: ユーザーが編集可能なビュー列エントリを終了したとき。
3. 保存: 既存文書の 1 つ以上のビューの列エントリを検証した後。
4. 新規エントリ: 新規文書の 1 つ以上のビューの列エントリを検証した後。

定義位置

NotesUIView

構文

InViewEdit(Source As NotesUIView, RequestType As Integer, ColProgName As Variant, ColumnValue As Variant, Continue As Variant)

パラメータ

Source

NotesUIView 型。読み込み専用。 現在のビューです。

RequestType

整数。読み込み専用。 現在のイベント要求:

• 1 は、照会要求です。
  注: Release 6.0 では、要求 1 が予約されています。これは使用しないでください。
• 2 は、検証要求です。
• 3 は、保存要求です。
• 4 は、新規エントリの要求です。

ColProgName

String 型の配列。読み込み専用。

• 照会と検証の要求の場合: 要素 0 の現在の列のプログラム名。
• 保存と新規エントリの要求の場合: 処理される列のプログラム名。要素 0 から始まります。

ColumnValue

Variant 型の配列。この配列の要素は ColProgName の配列の要素に対応します。

• 照会と検証の要求の場合: 要素 0 の現在の列エントリのテキスト。
• 保存と新規エントリの要求の場合: 処理される列エントリのテキスト。要素 0 から始まります。

Continue

Boolean 型。読み書き可能。照会または検証の要求を処理するかどうかを示します。初期設定は True です。処理を停止してエラーメッセージを生成するには、このパラメータを False に設定します。このパラメータは、保存と新規エントリの要求には反映されません。

使用法

このイベントは、編集可能な列でのみ発生します。編集可能な列の設計方法は、「ユーザーがビューから文書を編集または作成できるようにする」を参照してください。

現在のビューの列エントリに表示されているアイテムを含む文書の文書 ID を取り出すには、CaretNoteID を使用します。ユーザーが文書を新規作成しているときは、このプロパティの照会要求に「0」が設定されます。

列のプログラム名をその列に関連付けられたアイテム名と同一にすると、処理が速くなります。この名前を ColProgName 配列で使用すると、アイテムの値を取得および設定できます。

編集可能な列を編集するには、クリックするか、[Tab] キーを押します。既存値が入力されたボックスが表示されたら、値を変更します。終了したら、クリックするか、[Tab] キーを押します。

既存文書内の編集可能な列エントリを処理するには:

• 検証要求で ColumnValue(0) を検査し、値が不適切な場合は [Continue] を False に設定します。
• 保存要求で、ColumnValue のすべての値を関連するアイテムに書き込みます。

新規文書内の編集可能な列エントリを処理するには:

• CaretNoteID の値に「0」が設定されている場合は終了します。
• 検証要求で ColumnValue(0) を検査し、値が不適切な場合は [Continue] を False に設定します。
• 新規エントリの要求で、ColumnValue のすべての値を関連するアイテムに書き込みます。

照会と検証の要求は、列エントリの 1 つに対して行われます。効率を上げるために、保存と新規エントリの要求は累積した複数の列エントリに対して実行されます。

ただし、アイテムをアイコンとして表している列に対する要求は例外です。アイコンを変更するには、保存要求で、ビューの列エントリで表されているアイテムに書き込みます。列エントリをクリックするたびに、保存コードが実行されます。

Notes は、このイベントに対応するスクリプトの作成時に、ユーザーに代わってイベントの構文 (パラメータも含む) を作成します。ユーザーが入力する必要はありません。

例