\section{infowin.c File Reference}
\label{infowin_8c}\index{infowin.c@{infowin.c}}
A GTK+ Widget to implement a RISC OS style info window. 

{\tt \#include \char`\"{}rox-clib.h\char`\"{}}\par
{\tt \#include $<$stdio.h$>$}\par
{\tt \#include $<$stdlib.h$>$}\par
{\tt \#include $<$string.h$>$}\par
{\tt \#include $<$time.h$>$}\par
{\tt \#include $<$unistd.h$>$}\par
{\tt \#include $<$gtk/gtk.h$>$}\par
{\tt \#include \char`\"{}infowin.h\char`\"{}}\par
{\tt \#include \char`\"{}rox.h\char`\"{}}\par
{\tt \#include \char`\"{}rox\_\-debug.h\char`\"{}}\par
{\tt \#include \char`\"{}rox\_\-filer\_\-action.h\char`\"{}}\par
{\tt \#include \char`\"{}uri.h\char`\"{}}\par
{\tt \#include $<$libxml/parser.h$>$}\par
\subsection*{Functions}
\begin{CompactItemize}
\item 
GType {\bf rox\_\-info\_\-win\_\-get\_\-type} (void)
\item 
Gtk\-Widget $\ast$ {\bf rox\_\-info\_\-win\_\-new} (const gchar $\ast${\bf program}, const gchar $\ast$purpose, const gchar $\ast$version, const gchar $\ast$author, const gchar $\ast$website)
\item 
void {\bf rox\_\-info\_\-win\_\-add\_\-browser\_\-command} ({\bf ROXInfo\-Win} $\ast$iw, const gchar $\ast$cmd)
\item 
Gtk\-Widget $\ast$ {\bf rox\_\-info\_\-win\_\-new\_\-from\_\-appinfo} (const char $\ast${\bf program})
\item 
Gtk\-Widget $\ast$ {\bf rox\_\-info\_\-win\_\-get\_\-extension\_\-area} ({\bf ROXInfo\-Win} $\ast$iw)
\item 
GType {\bf info\_\-win\_\-get\_\-type} (void)
\item 
Gtk\-Widget $\ast$ {\bf info\_\-win\_\-new} (const gchar $\ast${\bf program}, const gchar $\ast$purpose, const gchar $\ast$version, const gchar $\ast$author, const gchar $\ast$website)
\item 
Gtk\-Widget $\ast$ {\bf info\_\-win\_\-new\_\-from\_\-appinfo} (const gchar $\ast${\bf program})
\item 
void {\bf info\_\-win\_\-add\_\-browser\_\-command} ({\bf ROXInfo\-Win} $\ast$iw, const gchar $\ast$cmd)
\end{CompactItemize}


\subsection{Detailed Description}
A GTK+ Widget to implement a RISC OS style info window. 



\subsection{Function Documentation}
\index{infowin.c@{infowin.c}!info_win_add_browser_command@{info\_\-win\_\-add\_\-browser\_\-command}}
\index{info_win_add_browser_command@{info\_\-win\_\-add\_\-browser\_\-command}!infowin.c@{infowin.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void info\_\-win\_\-add\_\-browser\_\-command ({\bf ROXInfo\-Win} $\ast$ {\em iw}, const gchar $\ast$ {\em cmd})}\label{infowin_8c_7a3ddce3ee2932149b13f82392f46d57}


\begin{Desc}
\item[{\bf Deprecated}]As \doxyref{rox\_\-info\_\-win\_\-add\_\-browser\_\-command()}{p.}{infowin_8c_40577c74c4e6d3bf8e133b9b953bacf8}. \end{Desc}
\index{infowin.c@{infowin.c}!info_win_get_type@{info\_\-win\_\-get\_\-type}}
\index{info_win_get_type@{info\_\-win\_\-get\_\-type}!infowin.c@{infowin.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}GType info\_\-win\_\-get\_\-type (void)}\label{infowin_8c_cf8f4470a4a57b678c24e16a422d809d}


\begin{Desc}
\item[{\bf Deprecated}]Replaced by \doxyref{rox\_\-info\_\-win\_\-get\_\-type()}{p.}{infowin_8c_5c3141f28041db75688b1865af3a8cf8} \end{Desc}
\index{infowin.c@{infowin.c}!info_win_new@{info\_\-win\_\-new}}
\index{info_win_new@{info\_\-win\_\-new}!infowin.c@{infowin.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Gtk\-Widget$\ast$ info\_\-win\_\-new (const gchar $\ast$ {\em program}, const gchar $\ast$ {\em purpose}, const gchar $\ast$ {\em version}, const gchar $\ast$ {\em author}, const gchar $\ast$ {\em website})}\label{infowin_8c_f35cd42394ac0a3ac97f8edd139d02f0}


\begin{Desc}
\item[{\bf Deprecated}]As \doxyref{rox\_\-info\_\-win\_\-new()}{p.}{infowin_8c_8da5fdb1ec1b7f2599f4e3af5b3bbfc5} except that the window's delete\_\-event signal is caught to turn closing the window into a hide \end{Desc}
\index{infowin.c@{infowin.c}!info_win_new_from_appinfo@{info\_\-win\_\-new\_\-from\_\-appinfo}}
\index{info_win_new_from_appinfo@{info\_\-win\_\-new\_\-from\_\-appinfo}!infowin.c@{infowin.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Gtk\-Widget$\ast$ info\_\-win\_\-new\_\-from\_\-appinfo (const gchar $\ast$ {\em program})}\label{infowin_8c_6f2c980e4c7398987a02476b2f64c72f}


\begin{Desc}
\item[{\bf Deprecated}]As \doxyref{rox\_\-info\_\-win\_\-new\_\-from\_\-appinfo()}{p.}{infowin_8c_e72cce77ca7fd12fb98db70c85d94e88} except that the window's delete\_\-event signal is caught to turn closing the window into a hide \end{Desc}
\index{infowin.c@{infowin.c}!rox_info_win_add_browser_command@{rox\_\-info\_\-win\_\-add\_\-browser\_\-command}}
\index{rox_info_win_add_browser_command@{rox\_\-info\_\-win\_\-add\_\-browser\_\-command}!infowin.c@{infowin.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void rox\_\-info\_\-win\_\-add\_\-browser\_\-command ({\bf ROXInfo\-Win} $\ast$ {\em iw}, const gchar $\ast$ {\em cmd})}\label{infowin_8c_40577c74c4e6d3bf8e133b9b953bacf8}


Add a possible command for viewing a web page.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[\mbox{$\leftrightarrow$} {\em iw}]a valid info window \item[\mbox{$\leftarrow$} {\em cmd}]command to add. It will be called with a single argument which is the URL to view\end{description}
\end{Desc}
\begin{Desc}
\item[{\bf Deprecated}]Web sites are now viewed using \doxyref{rox\_\-uri\_\-launch()}{p.}{uri_8c_600d9d74224900548e10188f1e4cd384} and commands added by this function are ignored. \end{Desc}
\index{infowin.c@{infowin.c}!rox_info_win_get_extension_area@{rox\_\-info\_\-win\_\-get\_\-extension\_\-area}}
\index{rox_info_win_get_extension_area@{rox\_\-info\_\-win\_\-get\_\-extension\_\-area}!infowin.c@{infowin.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Gtk\-Widget$\ast$ rox\_\-info\_\-win\_\-get\_\-extension\_\-area ({\bf ROXInfo\-Win} $\ast$ {\em iw})}\label{infowin_8c_4645175ce185c2f5fa8b7d1797fa8f81}


Get pointer to a Gtk\-VBox between the default contents and the dialog area with the close button. Arbitrary content may be added here.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[\mbox{$\leftrightarrow$} {\em iw}]a valid info window \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]pointer to a Gtk\-VBox \end{Desc}
\index{infowin.c@{infowin.c}!rox_info_win_get_type@{rox\_\-info\_\-win\_\-get\_\-type}}
\index{rox_info_win_get_type@{rox\_\-info\_\-win\_\-get\_\-type}!infowin.c@{infowin.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}GType rox\_\-info\_\-win\_\-get\_\-type (void)}\label{infowin_8c_5c3141f28041db75688b1865af3a8cf8}


Type code for an Info\-Win \index{infowin.c@{infowin.c}!rox_info_win_new@{rox\_\-info\_\-win\_\-new}}
\index{rox_info_win_new@{rox\_\-info\_\-win\_\-new}!infowin.c@{infowin.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Gtk\-Widget$\ast$ rox\_\-info\_\-win\_\-new (const gchar $\ast$ {\em program}, const gchar $\ast$ {\em purpose}, const gchar $\ast$ {\em version}, const gchar $\ast$ {\em author}, const gchar $\ast$ {\em website})}\label{infowin_8c_8da5fdb1ec1b7f2599f4e3af5b3bbfc5}


Construct an information window for the program.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[\mbox{$\leftarrow$} {\em program}]name of program \item[\mbox{$\leftarrow$} {\em purpose}]short description of program's function \item[\mbox{$\leftarrow$} {\em version}]string describing current version \item[\mbox{$\leftarrow$} {\em author}]name of author(s) \item[\mbox{$\leftarrow$} {\em website}]URL where to find more information or get new versions\end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]pointer to a \doxyref{ROXInfo\-Win}{p.}{structROXInfoWin} object\end{Desc}
\begin{Desc}
\item[{\bf Deprecated}]Use \doxyref{rox\_\-info\_\-win\_\-new\_\-from\_\-appinfo()}{p.}{infowin_8c_e72cce77ca7fd12fb98db70c85d94e88} instead. \end{Desc}
\index{infowin.c@{infowin.c}!rox_info_win_new_from_appinfo@{rox\_\-info\_\-win\_\-new\_\-from\_\-appinfo}}
\index{rox_info_win_new_from_appinfo@{rox\_\-info\_\-win\_\-new\_\-from\_\-appinfo}!infowin.c@{infowin.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Gtk\-Widget$\ast$ rox\_\-info\_\-win\_\-new\_\-from\_\-appinfo (const char $\ast$ {\em program})}\label{infowin_8c_e72cce77ca7fd12fb98db70c85d94e88}


Construct an information window for the program. The data is taken from the file {\tt \$APP\_\-DIR/App\-Info.xml}.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[\mbox{$\leftarrow$} {\em program}]name of program\end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]pointer to a \doxyref{ROXInfo\-Win}{p.}{structROXInfoWin} object \end{Desc}
