IASControl::Speak

This method provides speech feedback.

Syntax

HRESULT Speak( DWORD dwSpeechContext, DWORD dwMode, DWORD dwReserved );

dwSpeechContext

Specifies a DWORD that contains the speech context.

dwMode

Specifies a DWORD that contains the speech feedback mode. It is one of the following values.

ASFC_SPEAK_CAPTION

Speech feedback includes the caption text.

ASFC_SPEAK_FOCUSITEM

Speech feedback includes the text of the item that has the focus.

ASFC_SPEAK_ALLITEMS

Speech feedback includes all items.

ASFC_SPEAK_ASFORMFOCUS

Used when a form calls this method on the control that has the focus.

ASFC_SPEAK_ITEMBYID

Speech feedback includes the text of the item that has the item identifier specified in dwReserved.

ASFC_SPEAK_ITEMATINDEX

Speech feedback includes the text of the item that has the item index specified in dwReserved.

dwReserved

Reserved.

Return Values

NOERROR indicates success. If an error occurs, the appropriate HRESULT value is returned.