Carbon


SRSetIndexedItem

Header: SpeechRecognition.h Carbon status: Supported

Replaces a subitem in a container object with some other object.

OSErr SRSetIndexedItem (
    SRSpeechObject container, 
    SRSpeechObject item, 
    SInt32 index
);
Parameter descriptions
container

A speech object.

item

A speech object.

index

An integer ranging from 0 to one less than the number of subitems in the specified speech object.

function result

A result code.

DISCUSSION

The SRSetIndexedItem function replaces the subitem having the index specified by the index parameter in the container object specified by the container parameter with the speech object specified by the item parameter. A reference to the replacement item is maintained separately by the container; as a result, you can release any reference to that item if you no longer need it. The reference to the replaced item is removed from the container; if that reference was the last remaining reference to the object, the object is released.

VERSION NOTES

In Speech Recognition Manager version 1.5, this function is useful only for operating on language objects (of type SRLanguageObject), although it is defined for all speech objects.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 7/10/2000)