add ant stuff
[debian/freetts] / javadoc / com / sun / speech / engine / SpeechEventUtilities.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">\r
2 <!--NewPage-->\r
3 <HTML>\r
4 <HEAD>\r
5 <!-- Generated by javadoc (build 1.4.2_16) on Mon Mar 09 18:20:29 CET 2009 -->\r
6 <TITLE>\r
7 SpeechEventUtilities (FreeTTS 1.2)\r
8 </TITLE>\r
9 \r
10 <META NAME="keywords" CONTENT="com.sun.speech.engine.SpeechEventUtilities class">\r
11 \r
12 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">\r
13 \r
14 <SCRIPT type="text/javascript">\r
15 function windowTitle()\r
16 {\r
17     parent.document.title="SpeechEventUtilities (FreeTTS 1.2)";\r
18 }\r
19 </SCRIPT>\r
20 \r
21 </HEAD>\r
22 \r
23 <BODY BGCOLOR="white" onload="windowTitle();">\r
24 \r
25
26 <!-- ========= START OF TOP NAVBAR ======= -->\r
27 <A NAME="navbar_top"><!-- --></A>
28 <A HREF="#skip-navbar_top" title="Skip navigation links"></A>
29 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">\r
30 <TR>\r
31 <TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">\r
32 <A NAME="navbar_top_firstrow"><!-- --></A>
33 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">\r
34   <TR ALIGN="center" VALIGN="top">\r
35   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>\r
36   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>\r
37   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>\r
38   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>\r
39   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>\r
40   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>\r
41   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>\r
42   </TR>\r
43 </TABLE>\r
44 </TD>\r
45 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>\r
46 </EM>\r
47 </TD>\r
48 </TR>\r
49 \r
50 <TR>\r
51 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">\r
52 &nbsp;<A HREF="../../../../com/sun/speech/engine/EngineMonitor.EngineMonitorEngineListener.html" title="class in com.sun.speech.engine"><B>PREV CLASS</B></A>&nbsp;\r
53 &nbsp;<A HREF="../../../../com/sun/speech/engine/SpeechEventUtilities.SpeechAWTEvent.html" title="class in com.sun.speech.engine"><B>NEXT CLASS</B></A></FONT></TD>\r
54 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">\r
55   <A HREF="../../../../index.html" target="_top"><B>FRAMES</B></A>  &nbsp;\r
56 &nbsp;<A HREF="SpeechEventUtilities.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;\r
57 &nbsp;<SCRIPT type="text/javascript">\r
58   <!--\r
59   if(window==top) {\r
60     document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');\r
61   }\r
62   //-->\r
63 </SCRIPT>\r
64 <NOSCRIPT>\r
65   <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>\r
66 </NOSCRIPT>
67 \r
68 </FONT></TD>\r
69 </TR>\r
70 <TR>\r
71 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">\r
72   SUMMARY:&nbsp;<A HREF="#nested_class_summary">NESTED</A>&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>\r
73 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">\r
74 DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>\r
75 </TR>\r
76 </TABLE>\r
77 <A NAME="skip-navbar_top"></A>
78 <!-- ========= END OF TOP NAVBAR ========= -->\r
79 \r
80 <HR>\r
81 <!-- ======== START OF CLASS DATA ======== -->\r
82 <H2>\r
83 <FONT SIZE="-1">\r
84 com.sun.speech.engine</FONT>\r
85 <BR>\r
86 Class SpeechEventUtilities</H2>\r
87 <PRE>\r
88 java.lang.Object\r
89   <IMG SRC="../../../../resources/inherit.gif" ALT="extended by"><B>com.sun.speech.engine.SpeechEventUtilities</B>\r
90 </PRE>\r
91 <HR>\r
92 <DL>\r
93 <DT>public class <B>SpeechEventUtilities</B><DT>extends java.lang.Object</DL>\r
94 \r
95 <P>\r
96 Utilities to help with dispatch JSAPI 1.0 events on the event
97  dispatching thread of AWT/Swing.  This is needed to help
98  applications conform with the Swing Event Thread model.  If these
99  utilities were not used, then a GUI application would have to
100  implement Runnables to handle JSAPI events that result in updates
101  to the GUI.\r
102 <P>\r
103 \r
104 <P>\r
105 <HR>\r
106 \r
107 <P>\r
108 <!-- ======== NESTED CLASS SUMMARY ======== -->\r
109 \r
110 <A NAME="nested_class_summary"><!-- --></A>
111 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">\r
112 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">\r
113 <TD COLSPAN=2><FONT SIZE="+2">\r
114 <B>Nested Class Summary</B></FONT></TD>\r
115 </TR>\r
116 <TR BGCOLOR="white" CLASS="TableRowColor">\r
117 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
118 <CODE>protected static&nbsp;class</CODE></FONT></TD>\r
119 <TD><CODE><B><A HREF="../../../../com/sun/speech/engine/SpeechEventUtilities.SpeechAWTEvent.html" title="class in com.sun.speech.engine">SpeechEventUtilities.SpeechAWTEvent</A></B></CODE>\r
120 \r
121 <BR>\r
122 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Inner class that defines SpeechAWTEvents.  </TD>\r
123 </TR>\r
124 <TR BGCOLOR="white" CLASS="TableRowColor">\r
125 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
126 <CODE>protected static&nbsp;class</CODE></FONT></TD>\r
127 <TD><CODE><B><A HREF="../../../../com/sun/speech/engine/SpeechEventUtilities.SpeechAWTEventTarget.html" title="class in com.sun.speech.engine">SpeechEventUtilities.SpeechAWTEventTarget</A></B></CODE>\r
128 \r
129 <BR>\r
130 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Inner class used to handle events as they are dispatched from the
131  AWT event queue.</TD>\r
132 </TR>\r
133 </TABLE>\r
134 &nbsp;\r
135 <!-- =========== FIELD SUMMARY =========== -->\r
136 \r
137 <A NAME="field_summary"><!-- --></A>
138 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">\r
139 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">\r
140 <TD COLSPAN=2><FONT SIZE="+2">\r
141 <B>Field Summary</B></FONT></TD>\r
142 </TR>\r
143 <TR BGCOLOR="white" CLASS="TableRowColor">\r
144 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
145 <CODE>protected static&nbsp;boolean</CODE></FONT></TD>\r
146 <TD><CODE><B><A HREF="../../../../com/sun/speech/engine/SpeechEventUtilities.html#awtRunning">awtRunning</A></B></CODE>\r
147 \r
148 <BR>\r
149 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If true, the AWT EventQueue has been set up in the VM.  </TD>\r
150 </TR>\r
151 <TR BGCOLOR="white" CLASS="TableRowColor">\r
152 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
153 <CODE>protected static&nbsp;<A HREF="../../../../com/sun/speech/engine/SpeechEventUtilities.SpeechAWTEventTarget.html" title="class in com.sun.speech.engine">SpeechEventUtilities.SpeechAWTEventTarget</A></CODE></FONT></TD>\r
154 <TD><CODE><B><A HREF="../../../../com/sun/speech/engine/SpeechEventUtilities.html#speechAWTEventTarget">speechAWTEventTarget</A></B></CODE>\r
155 \r
156 <BR>\r
157 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;A target used to process speechAWTEvent objects.  </TD>\r
158 </TR>\r
159 <TR BGCOLOR="white" CLASS="TableRowColor">\r
160 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
161 <CODE>protected static&nbsp;java.awt.EventQueue</CODE></FONT></TD>\r
162 <TD><CODE><B><A HREF="../../../../com/sun/speech/engine/SpeechEventUtilities.html#systemEventQueue">systemEventQueue</A></B></CODE>\r
163 \r
164 <BR>\r
165 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The AWT EventQueue.  </TD>\r
166 </TR>\r
167 <TR BGCOLOR="white" CLASS="TableRowColor">\r
168 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
169 <CODE>static&nbsp;boolean</CODE></FONT></TD>\r
170 <TD><CODE><B><A HREF="../../../../com/sun/speech/engine/SpeechEventUtilities.html#waitUntilDispatched">waitUntilDispatched</A></B></CODE>\r
171 \r
172 <BR>\r
173 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If true, wait until an event has been dispatched before returning
174  from the post method.  </TD>\r
175 </TR>\r
176 </TABLE>\r
177 &nbsp;\r
178 <!-- ======== CONSTRUCTOR SUMMARY ======== -->\r
179 \r
180 <A NAME="constructor_summary"><!-- --></A>
181 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">\r
182 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">\r
183 <TD COLSPAN=2><FONT SIZE="+2">\r
184 <B>Constructor Summary</B></FONT></TD>\r
185 </TR>\r
186 <TR BGCOLOR="white" CLASS="TableRowColor">\r
187 <TD><CODE><B><A HREF="../../../../com/sun/speech/engine/SpeechEventUtilities.html#SpeechEventUtilities()">SpeechEventUtilities</A></B>()</CODE>\r
188 \r
189 <BR>\r
190 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>\r
191 </TR>\r
192 </TABLE>\r
193 &nbsp;\r
194 <!-- ========== METHOD SUMMARY =========== -->\r
195 \r
196 <A NAME="method_summary"><!-- --></A>
197 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">\r
198 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">\r
199 <TD COLSPAN=2><FONT SIZE="+2">\r
200 <B>Method Summary</B></FONT></TD>\r
201 </TR>\r
202 <TR BGCOLOR="white" CLASS="TableRowColor">\r
203 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
204 <CODE>protected static&nbsp;boolean</CODE></FONT></TD>\r
205 <TD><CODE><B><A HREF="../../../../com/sun/speech/engine/SpeechEventUtilities.html#isAWTRunning()">isAWTRunning</A></B>()</CODE>\r
206 \r
207 <BR>\r
208 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Determine if the AWT event queue is running.  </TD>\r
209 </TR>\r
210 <TR BGCOLOR="white" CLASS="TableRowColor">\r
211 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
212 <CODE>static&nbsp;void</CODE></FONT></TD>\r
213 <TD><CODE><B><A HREF="../../../../com/sun/speech/engine/SpeechEventUtilities.html#postSpeechEvent(com.sun.speech.engine.SpeechEventDispatcher, javax.speech.SpeechEvent)">postSpeechEvent</A></B>(<A HREF="../../../../com/sun/speech/engine/SpeechEventDispatcher.html" title="interface in com.sun.speech.engine">SpeechEventDispatcher</A>&nbsp;dispatcher,
214                 javax.speech.SpeechEvent&nbsp;event)</CODE>\r
215 \r
216 <BR>\r
217 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Post a JSAPI SpeechEvent.  </TD>\r
218 </TR>\r
219 <TR BGCOLOR="white" CLASS="TableRowColor">\r
220 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
221 <CODE>static&nbsp;void</CODE></FONT></TD>\r
222 <TD><CODE><B><A HREF="../../../../com/sun/speech/engine/SpeechEventUtilities.html#postSpeechEvent(com.sun.speech.engine.SpeechEventDispatcher, javax.speech.SpeechEvent, boolean)">postSpeechEvent</A></B>(<A HREF="../../../../com/sun/speech/engine/SpeechEventDispatcher.html" title="interface in com.sun.speech.engine">SpeechEventDispatcher</A>&nbsp;dispatcher,
223                 javax.speech.SpeechEvent&nbsp;event,
224                 boolean&nbsp;waitUntilDispatched)</CODE>\r
225 \r
226 <BR>\r
227 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Post a JSAPI SpeechEvent.  </TD>\r
228 </TR>\r
229 </TABLE>\r
230 &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
231 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">\r
232 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">\r
233 <TD><B>Methods inherited from class java.lang.Object</B></TD>\r
234 </TR>\r
235 <TR BGCOLOR="white" CLASS="TableRowColor">\r
236 <TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>\r
237 </TR>\r
238 </TABLE>\r
239 &nbsp;\r
240 <P>\r
241 \r
242 <!-- ============ FIELD DETAIL =========== -->\r
243 \r
244 <A NAME="field_detail"><!-- --></A>
245 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">\r
246 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">\r
247 <TD COLSPAN=1><FONT SIZE="+2">\r
248 <B>Field Detail</B></FONT></TD>\r
249 </TR>\r
250 </TABLE>\r
251 \r
252 <A NAME="awtRunning"><!-- --></A><H3>\r
253 awtRunning</H3>\r
254 <PRE>\r
255 protected static boolean <B>awtRunning</B></PRE>\r
256 <DL>\r
257 <DD>If true, the AWT EventQueue has been set up in the VM.  This flag
258  is used to determine whether we should use the AWT EventQueue for
259  synchronizing SpeechEvents with the AWT EventQueue or not.\r
260 <P>\r
261 <DL>\r
262 </DL>\r
263 </DL>\r
264 <HR>\r
265 \r
266 <A NAME="systemEventQueue"><!-- --></A><H3>\r
267 systemEventQueue</H3>\r
268 <PRE>\r
269 protected static java.awt.EventQueue <B>systemEventQueue</B></PRE>\r
270 <DL>\r
271 <DD>The AWT EventQueue.  This is lazily created in postSpeechEvent to
272  delay the need to initialize the Toolkit until it is necessary.\r
273 <P>\r
274 <DL>\r
275 <DT><B>See Also:</B><DD><A HREF="../../../../com/sun/speech/engine/SpeechEventUtilities.html#postSpeechEvent(com.sun.speech.engine.SpeechEventDispatcher, javax.speech.SpeechEvent)"><CODE>postSpeechEvent(com.sun.speech.engine.SpeechEventDispatcher, javax.speech.SpeechEvent)</CODE></A></DL>\r
276 </DL>\r
277 <HR>\r
278 \r
279 <A NAME="speechAWTEventTarget"><!-- --></A><H3>\r
280 speechAWTEventTarget</H3>\r
281 <PRE>\r
282 protected static <A HREF="../../../../com/sun/speech/engine/SpeechEventUtilities.SpeechAWTEventTarget.html" title="class in com.sun.speech.engine">SpeechEventUtilities.SpeechAWTEventTarget</A> <B>speechAWTEventTarget</B></PRE>\r
283 <DL>\r
284 <DD>A target used to process speechAWTEvent objects.  This target
285  is a component that expresses interest in SpeechAWTEvents.  It
286  is lazily created along with systemEventQueue in postSpeechEvent.\r
287 <P>\r
288 <DL>\r
289 <DT><B>See Also:</B><DD><A HREF="../../../../com/sun/speech/engine/SpeechEventUtilities.html#postSpeechEvent(com.sun.speech.engine.SpeechEventDispatcher, javax.speech.SpeechEvent)"><CODE>postSpeechEvent(com.sun.speech.engine.SpeechEventDispatcher, javax.speech.SpeechEvent)</CODE></A></DL>\r
290 </DL>\r
291 <HR>\r
292 \r
293 <A NAME="waitUntilDispatched"><!-- --></A><H3>\r
294 waitUntilDispatched</H3>\r
295 <PRE>\r
296 public static boolean <B>waitUntilDispatched</B></PRE>\r
297 <DL>\r
298 <DD>If true, wait until an event has been dispatched before returning
299  from the post method.  This is meant to be a global debugging flag.
300  If a class calling postSpeechEvent wants to wait until the
301  SpeechEvent has been dispatched, it should call the postSpeechEvent
302  method that has the waitUntilDispatched parameter.\r
303 <P>\r
304 <DL>\r
305 <DT><B>See Also:</B><DD><A HREF="../../../../com/sun/speech/engine/SpeechEventUtilities.html#postSpeechEvent(com.sun.speech.engine.SpeechEventDispatcher, javax.speech.SpeechEvent)"><CODE>postSpeechEvent(com.sun.speech.engine.SpeechEventDispatcher, javax.speech.SpeechEvent)</CODE></A></DL>\r
306 </DL>\r
307 \r
308 <!-- ========= CONSTRUCTOR DETAIL ======== -->\r
309 \r
310 <A NAME="constructor_detail"><!-- --></A>
311 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">\r
312 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">\r
313 <TD COLSPAN=1><FONT SIZE="+2">\r
314 <B>Constructor Detail</B></FONT></TD>\r
315 </TR>\r
316 </TABLE>\r
317 \r
318 <A NAME="SpeechEventUtilities()"><!-- --></A><H3>\r
319 SpeechEventUtilities</H3>\r
320 <PRE>\r
321 public <B>SpeechEventUtilities</B>()</PRE>\r
322 <DL>\r
323 </DL>\r
324 \r
325 <!-- ============ METHOD DETAIL ========== -->\r
326 \r
327 <A NAME="method_detail"><!-- --></A>
328 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">\r
329 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">\r
330 <TD COLSPAN=1><FONT SIZE="+2">\r
331 <B>Method Detail</B></FONT></TD>\r
332 </TR>\r
333 </TABLE>\r
334 \r
335 <A NAME="isAWTRunning()"><!-- --></A><H3>\r
336 isAWTRunning</H3>\r
337 <PRE>\r
338 protected static boolean <B>isAWTRunning</B>()</PRE>\r
339 <DL>\r
340 <DD>Determine if the AWT event queue is running.  This method is one big
341  hack, and we will be entering a bug against AWT to provide us with
342  a real method for determining if AWT is active or not.  The problem
343  with asking AWT if it is active right now is that it will activate
344  it if it isn't already active.\r
345 <P>\r
346 <DD><DL>\r
347 </DL>\r
348 </DD>\r
349 </DL>\r
350 <HR>\r
351 \r
352 <A NAME="postSpeechEvent(com.sun.speech.engine.SpeechEventDispatcher, javax.speech.SpeechEvent)"><!-- --></A><H3>\r
353 postSpeechEvent</H3>\r
354 <PRE>\r
355 public static void <B>postSpeechEvent</B>(<A HREF="../../../../com/sun/speech/engine/SpeechEventDispatcher.html" title="interface in com.sun.speech.engine">SpeechEventDispatcher</A>&nbsp;dispatcher,
356                                    javax.speech.SpeechEvent&nbsp;event)</PRE>\r
357 <DL>\r
358 <DD>Post a JSAPI SpeechEvent.  This is to be used by multiple processes
359  to synchronize SpeechEvents.  It currently uses the AWT EventQueue
360  as a means for doing this, which has the added benefit of causing
361  all SpeechEvent notification to be done from the event dispatch
362  thread.  This is important because the Swing Thread Model requires
363  all interaction with Swing components to be done from the event
364  dispatch thread.
365
366  This method will immediately return once the event has been
367  posted if the global waitUntilDispatched flag is set to false.
368  Otherwise, it will wait until the event has been dispatched
369  before returning.\r
370 <P>\r
371 <DD><DL>\r
372 <DT><B>Parameters:</B><DD><CODE>dispatcher</CODE> - the dispatcher that will dispatch the event<DD><CODE>event</CODE> - the SpeechEvent to post</DL>\r
373 </DD>\r
374 </DL>\r
375 <HR>\r
376 \r
377 <A NAME="postSpeechEvent(com.sun.speech.engine.SpeechEventDispatcher, javax.speech.SpeechEvent, boolean)"><!-- --></A><H3>\r
378 postSpeechEvent</H3>\r
379 <PRE>\r
380 public static void <B>postSpeechEvent</B>(<A HREF="../../../../com/sun/speech/engine/SpeechEventDispatcher.html" title="interface in com.sun.speech.engine">SpeechEventDispatcher</A>&nbsp;dispatcher,
381                                    javax.speech.SpeechEvent&nbsp;event,
382                                    boolean&nbsp;waitUntilDispatched)</PRE>\r
383 <DL>\r
384 <DD>Post a JSAPI SpeechEvent.  This is to be used by multiple processes
385  to synchronize SpeechEvents.  It currently uses the AWT EventQueue
386  as a means for doing this, which has the added benefit of causing
387  all SpeechEvent notification to be done from the event dispatch
388  thread.  This is important because the Swing Thread Model requires
389  all interaction with Swing components to be done from the event
390  dispatch thread.
391
392  This method will immediately return once the event has been
393  posted if the waitUntilDispatched parameter is set to false.
394  Otherwise, it will wait until the event has been dispatched
395  before returning.\r
396 <P>\r
397 <DD><DL>\r
398 <DT><B>Parameters:</B><DD><CODE>dispatcher</CODE> - the dispatcher that will dispatch the event<DD><CODE>event</CODE> - the SpeechEvent to post<DD><CODE>waitUntilDispatched</CODE> - if true, do not return until the
399  event have been dispatched</DL>\r
400 </DD>\r
401 </DL>\r
402 <!-- ========= END OF CLASS DATA ========= -->\r
403 <HR>\r
404 \r
405
406 <!-- ======= START OF BOTTOM NAVBAR ====== -->\r
407 <A NAME="navbar_bottom"><!-- --></A>
408 <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
409 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">\r
410 <TR>\r
411 <TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">\r
412 <A NAME="navbar_bottom_firstrow"><!-- --></A>
413 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">\r
414   <TR ALIGN="center" VALIGN="top">\r
415   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>\r
416   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>\r
417   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>\r
418   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>\r
419   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>\r
420   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>\r
421   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>\r
422   </TR>\r
423 </TABLE>\r
424 </TD>\r
425 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>\r
426 </EM>\r
427 </TD>\r
428 </TR>\r
429 \r
430 <TR>\r
431 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">\r
432 &nbsp;<A HREF="../../../../com/sun/speech/engine/EngineMonitor.EngineMonitorEngineListener.html" title="class in com.sun.speech.engine"><B>PREV CLASS</B></A>&nbsp;\r
433 &nbsp;<A HREF="../../../../com/sun/speech/engine/SpeechEventUtilities.SpeechAWTEvent.html" title="class in com.sun.speech.engine"><B>NEXT CLASS</B></A></FONT></TD>\r
434 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">\r
435   <A HREF="../../../../index.html" target="_top"><B>FRAMES</B></A>  &nbsp;\r
436 &nbsp;<A HREF="SpeechEventUtilities.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;\r
437 &nbsp;<SCRIPT type="text/javascript">\r
438   <!--\r
439   if(window==top) {\r
440     document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');\r
441   }\r
442   //-->\r
443 </SCRIPT>\r
444 <NOSCRIPT>\r
445   <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>\r
446 </NOSCRIPT>
447 \r
448 </FONT></TD>\r
449 </TR>\r
450 <TR>\r
451 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">\r
452   SUMMARY:&nbsp;<A HREF="#nested_class_summary">NESTED</A>&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>\r
453 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">\r
454 DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>\r
455 </TR>\r
456 </TABLE>\r
457 <A NAME="skip-navbar_bottom"></A>
458 <!-- ======== END OF BOTTOM NAVBAR ======= -->\r
459 \r
460 <HR>\r
461 \r
462 </BODY>\r
463 </HTML>\r