Legacy Document

Inside Macintosh: Speech Recognition Manager /

Chapter 1 - Speech Recognition Manager / Speech Recognition Manager Reference

Speech Recognition Manager Routines / Managing Speech Objects

SRSetProperty

You can use the SRSetProperty function to set the value of a property of a speech object.

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

srObject

A speech object.

selector

A property selector. See "Recognition System Properties" on page 1-37, "Recognition Result Properties" on page 1-46, "Recognizer Properties" on page 1-40, and "Language Object Properties," beginning on page 1-47 for lists of the available property selectors.

property

The address of a buffer containing the value to which the specified property is to be set.

propertyLen

The length, in bytes, of the specified buffer.

DESCRIPTION

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.