AddInksetInterval 

2.0     

Merges an interval into an inkset.

BOOL AddInksetInterval( HINKSET hinkset, LPINTERVAL lpiNew )

Parameters

hinkset

Handle to an inkset.

lpiNew

Address of an INTERVAL232HBHD structure.

Return Value

Returns TRUE if successful; otherwise FALSE.

Comments

The inkset is reallocated to a larger size by this function. The interval merges with any existing intervals, changing the interval only when required. For example, if the new interval is a subset of an existing one, there will be no change. Similarly, if the new interval overlaps an existing one, the union is formed. The maximum number of intervals allowed is defined to be (65536 - sizeof(INKSET)) / sizeof(INTERVAL), which evaluates to 5460.

The ending time of the new interval must be greater than or equal to the beginning time. If the interval has a duration of 0, AddInksetInterval does nothing, but returns TRUE.

An inkset formed using this function is guaranteed to have the intervals in ascending chronological order.

See Also

GetInksetInterval, INTERVAL