ch17.htm

MAPI__SAPI__TAPI

    <td WIDTH="335">An instruction to the user, such as Insert the disk. </td>
  </tr>
  <tr>
    <td WIDTH="195"><tt><font FACE="Courier">Vtxtst_WARNING</font></tt> </td>
    <td WIDTH="60">8</td>
    <td WIDTH="335">A warning, such as Your printer is out of paper. </td>
  </tr>
  <tr>
    <td WIDTH="195"><tt><font FACE="Courier">Vtxtst_READING</font></tt> </td>
    <td WIDTH="60">16</td>
    <td WIDTH="335">Text that is being read from a document, such as an e-mail message. </td>
  </tr>
  <tr>
    <td WIDTH="195"><tt><font FACE="Courier">Vtxtst_NUMBERS</font></tt> </td>
    <td WIDTH="60">32</td>
    <td WIDTH="335">Text that is numeric and that should be read in numeric style. </td>
  </tr>
  <tr>
    <td WIDTH="195"><tt><font FACE="Courier">Vtxtst_SPREADSHEET</font></tt> </td>
    <td WIDTH="60">64</td>
    <td WIDTH="335">Text that is being read from a spreadsheet, such as columns of numbers. </td>
  </tr>
</table>
</center></div><div align="center"><center>

<table BORDERCOLOR="#000000" BORDER="1" WIDTH="80%">
  <tr>
    <td WIDTH="550"><b>Warning</b></td>
  </tr>
  <tr>
    <td WIDTH="550"><blockquote>
      <p>The flag parameter of the <tt><font FACE="Courier">Speak</font></tt> method is <i>not</i> 
      optional, but how the value is used depends on the installed TTS engine. It is possible 
      that setting this flag to various values will <i>not</i> result in different inflections 
      of voice during playback. </p>
    </blockquote>
    </td>
  </tr>
</table>
</center></div>

<p>The TTS engine is responsible for playing back messages sent in from all speech-enabled 
applications on your pc. Each message sent to the TTS engine is played back in the order 
in which it was received. You can use the flag parameter to control the priority level of 
the text message you send to the TTS engine. There are three priority levels for a 
message. The OLE library has a set of pre-defined constants to match the priority values. 
Table 17.2 shows each of the priority levels, their values, and a short description. <br>
</p>

<p align="center"><b>Table 17.2. Priority values used by the SAPI TTS engine.</b> </p>
<div align="center"><center>

<table BORDERCOLOR="#000000" BORDER="1" WIDTH="80%">
  <tr>
    <td><i>Pre-Defined Constant</i></td>
    <td WIDTH="60"><i>Value</i> </td>
    <td WIDTH="364"><i>Description</i></td>
  </tr>
  <tr>
    <td WIDTH="166"><tt><font FACE="Courier">Vtxtsp_VERYHIGH</font></tt> </td>
    <td WIDTH="60">128</td>
    <td WIDTH="364">Play the text immediately, interrupting text that is currently being 
    spoken, if any. The interrupted text resumes playing as soon as the very high-priority 
    text is finished, although the interrupted text may not be correctly synchronized. </td>
  </tr>
  <tr>
    <td WIDTH="166"><tt><font FACE="Courier">Vtxtsp_HIGH</font></tt> </td>
    <td WIDTH="60">256</td>
    <td WIDTH="364">Play the text as soon as possible, after text that is currently being 
    spoken but before any other text in the queue. </td>
  </tr>
  <tr>
    <td WIDTH="166"><tt><font FACE="Courier">Vtxtsp_NORMAL</font></tt> </td>
    <td WIDTH="60">512</td>
    <td WIDTH="364">Add the text to the end of the queue. This is the default priority. </td>
  </tr>
</table>
</center></div>

<p>To test the <tt><font FACE="Courier">Speak</font></tt> method, you need to add a 
command button to the form along with a text box and several option buttons with two frame 
controls. Refer to Figure 17.3 and Table 17.3 as you arrange the controls on the form. </p>

<p><a HREF="f17-3.gif"><b>Figure 17.3 : </b><i>Laying out the controls for adding the 
Speak method to the project.</i></a> <br>
</p>

<p align="center"><b>Table 17.3. Control table for the Voice Text Demo form.</b> </p>
<div align="center"><center>

<table BORDERCOLOR="#000000" BORDER="1" WIDTH="80%">
  <tr>
    <td><i>Control</i></td>
    <td WIDTH="118"><i>Property</i> </td>
    <td WIDTH="143"><i>Setting</i></td>
  </tr>
  <tr>
    <td WIDTH="176"><tt><font FACE="Courier">VB.Frame</font></tt> </td>
    <td WIDTH="118"><tt><font FACE="Courier">Name</font></tt></td>
    <td WIDTH="143">fraPriority</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Caption</font></tt> </td>
    <td WIDTH="143">&quot;Priority&quot;</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Height</font></tt> </td>
    <td WIDTH="143">615</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Left</font></tt> </td>
    <td WIDTH="143">3120</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">TabIndex</font></tt> </td>
    <td WIDTH="143">13</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Top</font></tt> </td>
    <td WIDTH="143">3120</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Width</font></tt> </td>
    <td WIDTH="143">3975</td>
  </tr>
  <tr>
    <td WIDTH="176"><tt><font FACE="Courier">VB.OptionButton</font></tt> </td>
    <td WIDTH="118"><tt><font FACE="Courier">Name</font></tt></td>
    <td WIDTH="143">OptPriority</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Caption</font></tt> </td>
    <td WIDTH="143">&quot;&amp;Very High&quot;</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Height</font></tt> </td>
    <td WIDTH="143">255</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Index</font></tt> </td>
    <td WIDTH="143">2</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Left</font></tt> </td>
    <td WIDTH="143">2760</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">TabIndex</font></tt> </td>
    <td WIDTH="143">16</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Top</font></tt> </td>
    <td WIDTH="143">240</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Width</font></tt> </td>
    <td WIDTH="143">1095</td>
  </tr>
  <tr>
    <td WIDTH="176"><tt><font FACE="Courier">VB.OptionButton</font></tt> </td>
    <td WIDTH="118"><tt><font FACE="Courier">Name</font></tt></td>
    <td WIDTH="143">OptPriority</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Caption</font></tt> </td>
    <td WIDTH="143">&quot;&amp;High&quot;</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Height</font></tt> </td>
    <td WIDTH="143">255</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Index</font></tt> </td>
    <td WIDTH="143">1</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Left</font></tt> </td>
    <td WIDTH="143">1440</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">TabIndex</font></tt> </td>
    <td WIDTH="143">15</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Top</font></tt> </td>
    <td WIDTH="143">240</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Width</font></tt> </td>
    <td WIDTH="143">1215</td>
  </tr>
  <tr>
    <td WIDTH="176"><tt><font FACE="Courier">VB.OptionButton</font></tt> </td>
    <td WIDTH="118"><tt><font FACE="Courier">Name</font></tt></td>
    <td WIDTH="143">OptPriority</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Caption</font></tt> </td>
    <td WIDTH="143">&quot;&amp;Normal&quot;</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Height</font></tt> </td>
    <td WIDTH="143">255</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Index</font></tt> </td>
    <td WIDTH="143">0</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Left</font></tt> </td>
    <td WIDTH="143">240</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">TabIndex</font></tt> </td>
    <td WIDTH="143">14</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Top</font></tt> </td>
    <td WIDTH="143">240</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Value</font></tt> </td>
    <td WIDTH="143">-1 'True</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Width</font></tt> </td>
    <td WIDTH="143">1215</td>
  </tr>
  <tr>
    <td WIDTH="176"><tt><font FACE="Courier">VB.Frame</font></tt> </td>
    <td WIDTH="118"><tt><font FACE="Courier">Name</font></tt></td>
    <td WIDTH="143">fraType</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Caption</font></tt> </td>
    <td WIDTH="143">&quot;Statement Types&quot;</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Height</font></tt> </td>
    <td WIDTH="143">1095</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Left</font></tt> </td>
    <td WIDTH="143">3120</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">TabIndex</font></tt> </td>
    <td WIDTH="143">5</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Top</font></tt> </td>
    <td WIDTH="143">1920</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Width</font></tt> </td>
    <td WIDTH="143">3975</td>
  </tr>
  <tr>
    <td WIDTH="176"><tt><font FACE="Courier">VB.OptionButton</font></tt> </td>
    <td WIDTH="118"><tt><font FACE="Courier">Name</font></tt></td>
    <td WIDTH="143">optType</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Caption</font></tt> </td>
    <td WIDTH="143">&quot;Warning&quot;</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Height</font></tt> </td>
    <td WIDTH="143">255</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Index</font></tt> </td>
    <td WIDTH="143">6</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Left</font></tt> </td>
    <td WIDTH="143">2760</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">TabIndex</font></tt> </td>
    <td WIDTH="143">12</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Top</font></tt> </td>
    <td WIDTH="143">240</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Width</font></tt> </td>
    <td WIDTH="143">975</td>
  </tr>
  <tr>
    <td WIDTH="176"><tt><font FACE="Courier">VB.OptionButton</font></tt> </td>
    <td WIDTH="118"><tt><font FACE="Courier">Name</font></tt></td>
    <td WIDTH="143">optType</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Caption</font></tt> </td>
    <td WIDTH="143">&quot;Statement&quot;</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Height</font></tt> </td>
    <td WIDTH="143">255</td>
  </tr>
  <tr>
    <td WIDTH="176">　</td>
    <td WIDTH="118"><tt><font FACE="Courier">Index</font></tt> </td>
    <td WIDTH="143">5</td>
  </tr>