renamed HasFocus() to IsActive() to avoid confusion with FindFocus(); documented...

[wxWidgets.git] / docs / latex / wx / sound.tex

diff --git a/docs/latex/wx/sound.tex b/docs/latex/wx/sound.tex
index 4d6ee2e4980d530b58e16ad2d990caad92268151..fd48c22e874f7fc97f7dca31229af99ea3c78e94 100644 (file)
--- a/docs/latex/wx/sound.tex
+++ b/docs/latex/wx/sound.tex
@@ -1,8 +1,10 @@
 \section{\class{wxSound}}\label{wxsound}
 
-This class represents a short wave file, in Windows WAV format, that
+This class represents a short sound (loaded from Windows WAV file), that
 can be stored in memory and played. Currently this class is implemented
-on Windows and Linux only.
+on Windows and Unix (and uses either 
+\urlref{Open Sound System}{http://www.opensound.com/oss.html} or 
+\urlref{Simple DirectMedia Layer}{http://www.libsdl.org/}).
 
 \wxheading{Derived from}
 
@@ -10,11 +12,11 @@ on Windows and Linux only.
 
 \wxheading{Include files}
 
-<wx/wave.h>
+<wx/sound.h>
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
-\membersection{wxSound::wxSound}\label{wxsoundconstr}
+\membersection{wxSound::wxSound}\label{wxsoundctor}
 
 \func{}{wxSound}{\void}
 
@@ -29,9 +31,9 @@ determine whether this succeeded.
 
 \docparam{fileName}{The filename or Windows resource.}
 
-\docparam{isResource}{true if {\it fileName} is a resource, false if it is a filename.}
+\docparam{isResource}{\true if {\it fileName} is a resource, \false if it is a filename.}
 
-\membersection{wxSound::\destruct{wxSound}}
+\membersection{wxSound::\destruct{wxSound}}\label{wxsounddtor}
 
 \func{}{\destruct{wxSound}}{\void}
 
@@ -39,7 +41,7 @@ Destroys the wxSound object.
 
 \membersection{wxSound::Create}\label{wxsoundcreate}
 
-\func{bool}{Create}{\param{const wxString\&}{ fileName}, \param{bool}{ isResource = false}}
+\func{bool}{Create}{\param{const wxString\&}{ fileName}, \param{bool}{ isResource = \false}}
 
 Constructs a wave object from a file or resource.
 
@@ -47,22 +49,54 @@ Constructs a wave object from a file or resource.
 
 \docparam{fileName}{The filename or Windows resource.}
 
-\docparam{isResource}{true if {\it fileName} is a resource, false if it is a filename.}
+\docparam{isResource}{\true if {\it fileName} is a resource, \false if it is a filename.}
 
 \wxheading{Return value}
 
-true if the call was successful, false otherwise.
+\true if the call was successful, \false otherwise.
 
 \membersection{wxSound::IsOk}\label{wxsoundisok}
 
 \constfunc{bool}{IsOk}{\void}
 
-Returns true if the object contains a successfully loaded file or resource, false otherwise.
+Returns \true if the object contains a successfully loaded file or resource, \false otherwise.
+
+\membersection{wxSound::IsPlaying}\label{wxsoundisplaying}
+
+\constfunc{static bool}{IsPlaying}{\void}
+
+Returns \true if a sound is played at the moment.
 
 \membersection{wxSound::Play}\label{wxsoundplay}
 
-\constfunc{bool}{Play}{\param{bool}{ async = true}, \param{bool}{ looped = false}}
+\constfunc{bool}{Play}{\param{unsigned }{ flags = wxSOUND\_ASYNC}}
+
+\func{static bool}{Play}{\param{const wxString\& }{filename}, \param{unsigned}{ flags = wxSOUND\_ASYNC}}
+
+Plays the sound file. If another sound is playing, it will be interrupted.
+Returns \true on success, \false otherwise.
+
+The possible values for \arg{flags} are:
+
+\begin{twocollist}
+\twocolitem{wxSOUND\_SYNC}{{\tt Play} will block and wait until the sound is
+replayed.}
+\twocolitem{wxSOUND\_ASYNC}{Sound is played asynchronously, 
+{\tt Play} returns immediately}
+\twocolitem{wxSOUND\_ASYNC | wxSOUND\_LOOP}{Sound is played asynchronously
+and loops until another sound is played, 
+\helpref{wxSound::Stop}{wxsoundstop} is called or the program terminates.}
+\end{twocollist}
+
+The static form is shorthand for this code:
+
+\begin{verbatim}
+wxSound(filename).Play(flags);
+\end{verbatim}
+
+\membersection{wxSound::Stop}\label{wxsoundstop}
 
-Plays the wave file synchronously or asynchronously, looped or single-shot.
+\func{static void}{Stop}{\void}
 
+If a sound is played, this function stops it.