Carbon


SRSetProperty

Header: SpeechRecognition.h Carbon status: Supported

Sets the value of a property of a speech object.

OSErr SRSetProperty (
    SRSpeechObject srObject, 
    OSType selector, 
    const void *property, 
    Size propertyLen
);
Parameter descriptions
srObject

A speech object.

selector

A property selector. See See “Recognizer Properties”, “Recognizer Listen Key Properties”, “Language Object Properties”, and “Recognition System Properties” for lists of the available property selectors.

property

A pointer to a buffer containing the value to which the specified property is to be set.

propertyLen

The length, in bytes, of the specified buffer.

function result

A result code.

DISCUSSION

The SRSetProperty function sets the value of the property of the speech object specified by the srObject parameter to the value specified through the property parameter. The selector parameter specifies which property is to be set and the propertyLen parameter specifies it size, in bytes.

Not all properties can be set. If you attempt to set a property that cannot be set, SRSetProperty returns the result code kSRCantSetProperty or kSRBadSelector as its function result.

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)