次のいずれかをモーダルウィンドウに表示します。

• 指定されたビュー。ユーザーはこのビューで文書を複数選択できます。@PickList は、選択された文書の列の値を返します。
• 使用可能なすべての Domino ディレクトリに存在する情報が表示されるダイアログボックス。ユーザーはユーザー、グループ、サーバー、会議室、リソースなどの名前をいくつでも選択でき、@PickList は選択された名前を返します。

@PickList( [CUSTOM] :[SINGLE] ; server :file ; view ; title ; prompt ; column ; categoryname )

@PickList( [NAME] :[SINGLE] [; selectedoptions])

@PickList( [ROOM] )

@PickList( [RESOURCE] )

@PickList( [FOLDERS] :[SINGLE] ; server:database )

@PickList( [FOLDERS] :[SHARED] ; server:database )

@PickList( [FOLDERS] :[PRIVATE] ; server:database )

@PickList( [FOLDERS] :[NODESKTOP] ; server:database )

パラメータ

[CUSTOM]

キーワード。ダイアログボックスにビューを表示することを示します。

キーワード。1 つ以上の名前を選択できるダイアログボックスを開きます。

[SINGLE]

キーワード。省略可能。文書を 1 つしか選択できないよう制限します。

キーワード。会議室を選択するダイアログボックスを開きます。

キーワード。リソースを選択するダイアログボックスを開きます。

キーワード。データベース内およびデスクトップにあるすべてのフォルダ名の文字列リスト (複数の選択可能) を返します。以下のキーワードを [Folders] と組み合わせることができます。

[SINGLE]

キーワード。省略可能。フォルダを 1 つしか選択できないよう制限します。

[SHARED]

キーワード。省略可能。共有フォルダ以外は選択できないよう制限します。

[PRIVATE]

キーワード。省略可能。個人フォルダ (データベース内およびデスクトップ上にあるもの) 以外は選択できないよう制限します。

[SHARED]:[PRIVATE]

キーワード。省略可能。すべての共有フォルダと個人フォルダから選択できます。

[NODESKTOP]

キーワード。省略可能。デスクトップにあるフォルダは選択から除外します。

リスト。事前選択オプションです。

文字列リスト。server はデータベースがあるサーバーの名前です。file は開くデータベースのパスとファイル名です。データベースの名前と保存場所は、オペレーティングシステムの適切な形式で指定します。

[custom] キーワードの場合は、その後に続くパラメータとして、サーバーおよびファイル名の代わりにレプリカ ID を使用できます。レプリカ ID は文字列でなければなりません。また、2 組の 8 桁の 16 進数の間にコロン (:) が必要です。たとえば、

@PickList([CUSTOM]; "852564A0:006B7872"; "By Category"; "Testing replica ID"; "Test prompt"; 3)

現在開いているデータベースを指定するには、"" を使用します。

文字列。データベース内の開くビューの名前です。

文字列。ダイアログボックスのウィンドウタイトルを指定します。

文字列。ダイアログボックス内に表示するプロンプトです。文字列の 1 行目のみが表示されます。それ以上長い文字列は切り捨てられます。

数値。この関数からどの列の値を返すかを示す数値です。最初の列の場合は 1、2 番目の列の場合は 2 というように指定します。@DbColumn や @DbLookup とは異なり、列に含まれる式の種類にかかわらず、すべての列が数えられます。

メモ このパラメータは R5 で新しく追加されました。

文字列。省略可能。ビューの指定されたカテゴリを表示します。このパラメータを使用するには、ビューはカテゴリ別でなければなりません。

columnValue

文字列リスト。ユーザーが選択した文書の、指定された列 の値。

この関数は、ボタン式、手動エージェント式、貼り付けエージェント式、フォームアクション式、ビューアクション式で使用すると便利です。列式、選択式、メールエージェント式、スケジュール設定されたエージェント式、非表示切り替え式、ウィンドウタイトル式、フォーム式では使用できません。

@PickList([CUSTOM]) は、@DbColumn や @DbLookup と同様に動作しますが、@PickList のほうが次の点で優れています。

• データをより多く保存できる
• 検索をより速く実行できる
• 最初の数文字を入力するだけで、希望する文書がすぐに見つかる

カレンダービューでは、@PickList によって当日と翌日の 2 日間が時刻のスロットなしで表示されます。カレンダーの表示形式を切り替えるボタンをクリックすると、他の日付に移動できます。

この関数は、Web アプリケーションでは使用できません。

@PickList 関数は 64 KB を超えるデータを返すことはできません。次の公式を使用して、@PickList で返されるデータ量を求めます。

文字列を返す検索の場合

2 + (2 * 返されるエントリ数) + 全エントリの合計文字列サイズ

数値または日付を返す検索の場合

(10 * 返されるエントリ数) + 6

@PickList では、サイズに関係なくビューにアクセスできます。表示できる選択肢の数に制限はありません。サイズが制限されるのは戻り値のみです。

クロスリファレンス

LotusScript NotesUIWorkspace クラスの PickListStrings メソッド

例
関連項目

@DbColumn (Lotus Domino データソース)
@DbColumn (ODBC データソース)
@DbLookup (Lotus Domino データソース)
@DbLookup (ODBC データソース)
@DialogBox
@Prompt と @PickList でユーザー入力を取得する
@Prompt

用語集