<HTML
><HEAD
><TITLE
>GnomeLess</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeIconSelection"
HREF="gnomeiconselection.html"><LINK
REL="NEXT"
TITLE="GnomeMDIChild"
HREF="gnomemdichild.html"></HEAD
><BODY
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TH
COLSPAN="4"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="5"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeiconselection.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomemdichild.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMELESS"
>GnomeLess</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN19574"
></A
><H2
>Name</H2
>GnomeLess&nbsp;--&nbsp;Simple file content browser widget.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN19577"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomeless.html#GNOMELESS-STRUCT"
>GnomeLess</A
>;
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeless.html#GNOME-LESS-NEW"
>gnome_less_new</A
>                  (void);
void        <A
HREF="gnomeless.html#GNOME-LESS-CLEAR"
>gnome_less_clear</A
>                (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl);
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    <A
HREF="gnomeless.html#GNOME-LESS-SHOW-FILE"
>gnome_less_show_file</A
>            (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *path);
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    <A
HREF="gnomeless.html#GNOME-LESS-SHOW-COMMAND"
>gnome_less_show_command</A
>         (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *command_line);
void        <A
HREF="gnomeless.html#GNOME-LESS-SHOW-STRING"
>gnome_less_show_string</A
>          (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *s);
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    <A
HREF="gnomeless.html#GNOME-LESS-SHOW-FILESTREAM"
>gnome_less_show_filestream</A
>      (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             <GTKDOCLINK
HREF="FILE"
>FILE</GTKDOCLINK
> *f);
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    <A
HREF="gnomeless.html#GNOME-LESS-SHOW-FD"
>gnome_less_show_fd</A
>              (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             int file_descriptor);
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    <A
HREF="gnomeless.html#GNOME-LESS-WRITE-FILE"
>gnome_less_write_file</A
>           (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *path);
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    <A
HREF="gnomeless.html#GNOME-LESS-WRITE-FD"
>gnome_less_write_fd</A
>             (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             int fd);
void        <A
HREF="gnomeless.html#GNOME-LESS-SET-FONT"
>gnome_less_set_font</A
>             (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             <GTKDOCLINK
HREF="GDKFONT"
>GdkFont</GTKDOCLINK
> *font);
void        <A
HREF="gnomeless.html#GNOME-LESS-SET-FIXED-FONT"
>gnome_less_set_fixed_font</A
>       (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> fixed);
void        <A
HREF="gnomeless.html#GNOME-LESS-RESHOW"
>gnome_less_reshow</A
>               (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl);
void        <A
HREF="gnomeless.html#GNOME-LESS-FIXED-FONT"
>gnome_less_fixed_font</A
>           (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19620"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <GTKDOCLINK
HREF="GTKOBJECT"
>GtkObject</GTKDOCLINK
>
   +----<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>
         +----<GTKDOCLINK
HREF="GTKCONTAINER"
>GtkContainer</GTKDOCLINK
>
               +----<GTKDOCLINK
HREF="GTKBOX"
>GtkBox</GTKDOCLINK
>
                     +----<GTKDOCLINK
HREF="GTKVBOX"
>GtkVBox</GTKDOCLINK
>
                           +----GnomeLess</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19628"
></A
><H2
>Description</H2
><P
>    This widget implements a graphical "more" command.  It allows the
    user to view a text file.  There are various possible ways to
    specify the contents to display: loading the data from a file (by
    providing a filename) or by loading it from an open C FILE data
    stream or from the output of a Unix command or from a Unix file
    descriptor. 
  </P
><P
>    The following is a simple example of its use. The code creates a
    GnomeLess widget, sets a custom font, and fills the widget with
    the contents of a file.
  </P
><DIV
CLASS="INFORMALEXAMPLE"
><P
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>GtkWidget *gl;
GdkFont *font;

/* create a new widget */
gl = <A
HREF="gnomeless.html#GNOME-LESS-NEW"
>gnome_less_new</A
>();

/* set our custom font */
font = gdk_font_load("-adobe-helvetica-bold-o-normal-*-*-140-*-*-p-*-iso8859-1");
<A
HREF="gnomeless.html#GNOME-LESS-SET-FONT"
>gnome_less_set_font</A
>(GNOME_LESS(gl), font);

/* display some text */
<A
HREF="gnomeless.html#GNOME-LESS-SHOW-FILE"
>gnome_less_show_file</A
>(GNOME_LESS(gl), "/home/user/file.txt");
  </PRE
></TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN19637"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN19639"
></A
><H3
><A
NAME="GNOMELESS-STRUCT"
></A
>struct GnomeLess</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeLess;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19644"
></A
><H3
><A
NAME="GNOME-LESS-NEW"
></A
>gnome_less_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_less_new                  (void);</PRE
></TD
></TR
></TABLE
><P
>Creates a new GnomeLess widget.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&amp;GtkWidget pointer to a new GNOME less widget</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19660"
></A
><H3
><A
NAME="GNOME-LESS-CLEAR"
></A
>gnome_less_clear ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_less_clear                (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl);</PRE
></TD
></TR
></TABLE
><P
>Clears all text from GnomeLess widget <TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19677"
></A
><H3
><A
NAME="GNOME-LESS-SHOW-FILE"
></A
>gnome_less_show_file ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnome_less_show_file            (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *path);</PRE
></TD
></TR
></TABLE
><P
>Displays a file in a GnomeLess widget. Replaces any text already being displayed
in the widget.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pathname of file to be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if successful, <TT
CLASS="LITERAL"
>FALSE</TT
> if not. Error stored in <TT
CLASS="LITERAL"
>errno</TT
>.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19706"
></A
><H3
><A
NAME="GNOME-LESS-SHOW-COMMAND"
></A
>gnome_less_show_command ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnome_less_show_command         (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *command_line);</PRE
></TD
></TR
></TABLE
><P
>Runs the shell command specified in <TT
CLASS="PARAMETER"
><I
>command_line</I
></TT
>, and places the output of that command
in the GnomeLess widget specified by <TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>. Replaces any text already being displayed in the
widget.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>command_line</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Command to be executed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if successful, <TT
CLASS="LITERAL"
>FALSE</TT
> if not. Error stored in <TT
CLASS="LITERAL"
>errno</TT
>.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19737"
></A
><H3
><A
NAME="GNOME-LESS-SHOW-STRING"
></A
>gnome_less_show_string ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_less_show_string          (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *s);</PRE
></TD
></TR
></TABLE
><P
>Displays a string in the GnomeLess widget <TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>. Replaces any text
already being displayed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>s</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> String to be displayed</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19759"
></A
><H3
><A
NAME="GNOME-LESS-SHOW-FILESTREAM"
></A
>gnome_less_show_filestream ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnome_less_show_filestream      (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             <GTKDOCLINK
HREF="FILE"
>FILE</GTKDOCLINK
> *f);</PRE
></TD
></TR
></TABLE
><P
>Reads all of the text from filestream <TT
CLASS="PARAMETER"
><I
>f</I
></TT
>, and places it in the GnomeLess widget <TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>. Replaces any text
already being displayed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>f</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Filestream to be displayed in the widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if successful, <TT
CLASS="LITERAL"
>FALSE</TT
> if not. Error stored in <TT
CLASS="LITERAL"
>errno</TT
>.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19790"
></A
><H3
><A
NAME="GNOME-LESS-SHOW-FD"
></A
>gnome_less_show_fd ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnome_less_show_fd              (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             int file_descriptor);</PRE
></TD
></TR
></TABLE
><P
>Reads all of the text from file descriptor <TT
CLASS="PARAMETER"
><I
>file_descriptor</I
></TT
>, and places it in the GnomeLess widget <TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>.
Replaces any text already being displayed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>file_descriptor</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Filestream to be displayed in the widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if successful, <TT
CLASS="LITERAL"
>FALSE</TT
> if not. Error stored in <TT
CLASS="LITERAL"
>errno</TT
>.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19820"
></A
><H3
><A
NAME="GNOME-LESS-WRITE-FILE"
></A
>gnome_less_write_file ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnome_less_write_file           (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *path);</PRE
></TD
></TR
></TABLE
><P
>Writes the text displayed in the GnomeLess widget <TT
CLASS="PARAMETER"
><I
>gl</I
></TT
> to the file specified by <TT
CLASS="PARAMETER"
><I
>path</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>path</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Path of file to be written</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if successful, <TT
CLASS="LITERAL"
>FALSE</TT
> if not. Error stored in <TT
CLASS="LITERAL"
>errno</TT
>.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19851"
></A
><H3
><A
NAME="GNOME-LESS-WRITE-FD"
></A
>gnome_less_write_fd ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnome_less_write_fd             (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             int fd);</PRE
></TD
></TR
></TABLE
><P
>Writes the text displayed in the GnomeLess widget <TT
CLASS="PARAMETER"
><I
>gl</I
></TT
> to file descriptor <TT
CLASS="PARAMETER"
><I
>fd</I
></TT
>.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>fd</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> File descriptor</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if successful, <TT
CLASS="LITERAL"
>FALSE</TT
> if not. Error stored in <TT
CLASS="LITERAL"
>errno</TT
>.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19881"
></A
><H3
><A
NAME="GNOME-LESS-SET-FONT"
></A
>gnome_less_set_font ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_less_set_font             (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             <GTKDOCLINK
HREF="GDKFONT"
>GdkFont</GTKDOCLINK
> *font);</PRE
></TD
></TR
></TABLE
><P
>Sets the font of the text to be displayed in the GnomeLess widget <TT
CLASS="PARAMETER"
><I
>gl</I
></TT
> to <TT
CLASS="PARAMETER"
><I
>font</I
></TT
>.</P
><P
>Note: This will not affect text already being displayed.
If you use this function after adding text to the widget, you must show it again
by using <A
HREF="gnomeless.html#GNOME-LESS-RESHOW"
>gnome_less_reshow</A
> or one of the gnome_less_show commands.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>font</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GdkFont</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19906"
></A
><H3
><A
NAME="GNOME-LESS-SET-FIXED-FONT"
></A
>gnome_less_set_fixed_font ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_less_set_fixed_font       (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl,
                                             <GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> fixed);</PRE
></TD
></TR
></TABLE
><P
>Specifies whether or not new text should be displayed using a fixed font. Pass TRUE
in <TT
CLASS="PARAMETER"
><I
>fixed</I
></TT
> to use a fixed font, or FALSE to revert to the default GtkText font.</P
><P
>Note: This will not affect text already being displayed.
If you use this function after adding text to the widget, you must show it again
by using <A
HREF="gnomeless.html#GNOME-LESS-RESHOW"
>gnome_less_reshow</A
> or one of the gnome_less_show commands.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GNOME Less widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>fixed</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Whether or not to use a fixed font</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19930"
></A
><H3
><A
NAME="GNOME-LESS-RESHOW"
></A
>gnome_less_reshow ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_less_reshow               (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl);</PRE
></TD
></TR
></TABLE
><P
>Re-displays all of the text in the GnomeLess widget <TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>. If the font has changed since
the last show/reshow of text, it will update the current text to the new font.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN19947"
></A
><H3
><A
NAME="GNOME-LESS-FIXED-FONT"
></A
>gnome_less_fixed_font ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_less_fixed_font           (<A
HREF="gnomeless.html"
>GnomeLess</A
> *gl);</PRE
></TD
></TR
></TABLE
><P
>This function is obsolete. Please use <A
HREF="gnomeless.html#GNOME-LESS-SET-FIXED-FONT"
>gnome_less_set_fixed_font</A
> instead.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gl</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to GnomeLess widget</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeiconselection.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomemdichild.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeIconSelection</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeMDIChild</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>