CreateRangeDescriptor(_:_:_:_:)
Creates a range descriptor that specifies a series of consecutive elements in the same container.
Declaration
func CreateRangeDescriptor(_ rangeStart: UnsafeMutablePointer<AEDesc>!, _ rangeStop: UnsafeMutablePointer<AEDesc>!, _ disposeInputs: Bool, _ theDescriptor: UnsafeMutablePointer<AEDesc>!) -> OSErrParameters
- rangeStart:
A pointer to an object specifier that identifies the first Apple event object in the range. See Aedesc.
- rangeStop:
A pointer to an object specifier that identifies the last Apple event object in the range. See Aedesc.
- disposeInputs:
A Boolean value. Pass (
TRUE) if the function should dispose of the descriptors for therangeStartandrangeStopparameters and set them to the null descriptor or (FALSE) if your application will. A value ofFALSEmay be more efficient for some applications because it allows them to reuse descriptors. - theDescriptor:
A pointer to a descriptor. On successful return, the range descriptor created by
CreateRangeDescriptor. Your application must dispose of this descriptor after it has finished using it. See Aedesc.
Return Value
A result code. See Result Codes.
Discussion
Although the rangeStart and rangeStop parameters can be any object specifiers—including object specifiers that specify more than one Apple event object—most applications expect these parameters to specify single Apple event objects.