TYPE_xxx [TIME_RANGE] - Item Data Type - Time/Date List/Range ----------------------------------------------------------------------------------------------------------
#include <nsfdata.h>
Description :
Time/Date List or Range fields contains two or more Time/Date values and/or zero or more ranges of Time/Date values. Time/Date List or Range fields are stored in notes as items of TYPE_TIME_RANGE.
An item of TYPE_TIME_RANGE consists of a range header, an array of TIMEDATEs, and an array of TIMEDATE_PAIRs, as follows:
RANGE range header
TIMEDATE time/date no. 0
TIMEDATE time/date no. 1
...
TIMEDATE time/date no. N
TIMEDATE_PAIR time/date range no. 0
TIMEDATE_PAIR time/date range no. 1
...
TIMEDATE_PAIR time/date range no. N
The ListEntries member of the range header contains the number of TIMEDATEs in the array of TIMEDATEs. The RangeEntries member of the range header contains the number of TIMEDATE_PAIRs in the array of TIMEDATE_PAIRs.
To create a Time/Date List or Range field using the API, initialize a RANGE structure, any number of TIMEDATE structures, and any number of TIMEDATE_PAIR structures. Initialize a memory buffer with the RANGE structure, followed by all the TIMEDATE structures, followed by all the TIMEDATE_PAIR structures. Then call NSFItemAppend to append this buffer to an open note.
The total length of a Time/Date List or Range field must not exceed 15 kilobytes.
To create a Time/Date List or Range field using the Notes user interface, compose a document using a form with a Time field that accepts multiple values. Enter two or more time/date values, separated by multi-value separators, into the field. The Time field accepts multiple values if the design of the field in the form has the Allow Multi-Value box checked in the Field Definition dialog box. The multi-value separators are also defined by the design of the field in the form. The default multi-value separators for Time fields are commas and semicolons. The multi-value separators are not stored in the field.
For Time/Date List or Range fields created using the Notes user interface, the SUMMARY flag is set by default. For Time/Date List or Range fields created using the API, specify ITEM_SUMMARY in the item_flags parameter of NSFItemAppend to set the SUMMARY flag.
Sample Usage :
NOTEHANDLE hNote;
char *szFieldName;
TIMEDATE *aTimeDates;
WORD usCount;
DWORD dwValueLen;
void far *pvoidItemValue;
RANGE *pRange;
TIMEDATE *pTimeDate;
WORD i;
STATUS error;