Gets the target documents for a source document in order that a user next picks the only one of them. Differs from the function DEpickC4D that only one document can be picked.

Syntax

DEpickD4D( D4Dname$, trgCond$, srcDoc, showEmpty, prompt$, trgDoc )

Arguments

D4Dname$ - string, input. The name of a DocExt\DocForDoc config's item by which the target documents should be got in order that a user next picks the only one of them. Read more about this name in the help topic - DocExt\DocForDoc config. To use several configs items at the same time you should type their names through a space.

trgCond$ - string, input. An additional condition in Formula Language to select the target documents from got ones using the DocExt\DocForDoc config's item.

srcDoc - NotesDocument, input. A source document which the targets documents should be got for.

showEmpty - boolean, input. The value True (-1) means that if targets documents have not been got, the view with no documents for picking will not be displayed.

prompt$ - string, input. A text that should be displayed at the document picking. For example - describe why the picking is being done.

trgDoc - NotesDocument, modified. If a target document has been picked by a user, it will be set for the variable. Otherwise the variable will remain with no changes.

Return

Boolean. The value True (-1) means that the target documents were got and a user has picked the only one of them, and False (0) that at least one of this has not occurred.

Configs used

DocExt\DocForDoc.


Topic links:

DocExt\DocForDoc config

Function DEpickC4D

See also:

Functions of the library DocExtLib