FindFreeTimeDialogEx (NotesUIDocument - LotusScript®)

Brings up a "Free Time" dialog box based on the current document.

Note: This method is new with Release 5.

Defined in

NotesUIDocument

Syntax

flag = notesUIDocument .FindFreeTimeDialogEx( reqPeopleItems$ , optPeopleItems$ , reqRoomsItems$ , optRoomsItems$ , reqResourcesItems$ , optResourcesItems$ , removedPeopleItems$ , startDateItem$ , endDateItem$ )

Parameters

reqPeopleItems$

Array of type String. Names of one or more multi-value Text fields in the current document that contain the names of people required at the meeting.

optPeopleItems$

Array of type String. Names of one or more multi-value Text fields in the current document that contain the names of people whose attendance is optional.

reqRoomsItems$

Array of type String. Names of one or more multi-value Text fields in the current document that contain the names of rooms required for the meeting.

optRoomsItems$

Array of type String. Names of one or more multi-value Text fields in the current document that contain the names of optional rooms.

reqResourcesItems$

Array of type String. Names of one or more multi-value Text fields in the current document that contain the names of resources required for the meeting.

optResourcesItems$

Array of type String. Names of one or more multi-value Text fields in the current document that contain the names of optional resources.

removedPeopleItems$

Array of type String. Names of one or more multi-value Text fields in the current document that contain the names of people to remove from the attendance list.

startDateItem$

String. Name of a Date/Time field (item) in the current document that contains the start time for the meeting. You must specify the StartDateTime.

endDateItem$

String. Name of a Date/Time field (item) in the current document that contains the end time for the meeting. You must specify the EndDateTime. The EndDateTime must be later than the StartDateTime.

Return value

flag

Boolean. Returns True if the user selects OK, False if the user selects Cancel.

Usage

This method is valid only when the document is in Edit mode.

If you don't need a parameter, specify it as an empty string.

The meeting time should not span midnight.

This method causes the following sequence:

  • The "Free Time" dialog box appears using the current values in the specified fields in the document (except removedPeopleItems$).
  • The user can adjust values in the dialog box.
  • If the user selects OK, the values in the dialog box are written back to the specified fields the document (including removedPeopleItems$).

This method is the same as the FindFreeTimeDialog method, except that theparameters that point to Text fields are arrays, and the method has a return value.

Example