fltk/documentation/Fl_Help_View.html
Michael R Sweet 68fb9f7910 Don't allow extra boxtypes to override user-defined boxtypes.
Change the help link function to get both the widget and pathname.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@1659 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2001-10-27 03:29:25 +00:00

126 lines
3.8 KiB
HTML

<HTML>
<!-- NEW PAGE -->
<H2>class Fl_Help_View</H2>
<HR>
<H3>Class Hierarchy</H3>
<UL><PRE>
Fl_Group
|
+----<B>Fl_Help_View</B>
</PRE></UL>
<H3>Include Files</H3>
<UL><PRE>
#include "Fl_Help_View.h"
</PRE></UL>
<H3>Description</H3>
<P>The <CODE>Fl_Help_View</CODE> widget displays HTML text. Most HTML 2.0
elements are supported, as well as a primitive implementation of tables.
GIF, JPEG, and PNG images are displayed inline.
<H3>Methods</H3>
<UL>
<LI><A HREF="#Fl_Help_View.Fl_Help_View">Fl_Help_View</A>
<LI><A HREF="#Fl_Help_View.~Fl_Help_View">~Fl_Help_View</A>
<LI><A HREF="#Fl_Help_View.directory">directory</A>
<LI><A HREF="#Fl_Help_View.filename">filename</A>
<LI><A HREF="#Fl_Help_View.link">link</A>
<LI><A HREF="#Fl_Help_View.load">load</A>
<LI><A HREF="#Fl_Help_View.size">size</A>
<LI><A HREF="#Fl_Help_View.textcolor">textcolor</A>
<LI><A HREF="#Fl_Help_View.textfont">textfont</A>
<LI><A HREF="#Fl_Help_View.textsize">textsize</A>
<LI><A HREF="#Fl_Help_View.title">title</A>
<LI><A HREF="#Fl_Help_View.topline">topline</A>
<LI><A HREF="#Fl_Help_View.value">value</A>
</UL>
<H4><A NAME="Fl_Help_View.Fl_Help_View">Fl_Help_View(int xx, int yy, int ww, int hh, const char *l = 0)</A></H4>
<P>The constructor creates the <CODE>Fl_Help_View</CODE> widget at the specified
position and size.
<H4><A NAME="Fl_Help_View.~Fl_Help_View">~Fl_Help_View()</A></H4>
<P>The destructor destroys the widget and frees all memory that has been
allocated for the current file.
<H4><A NAME="Fl_Help_View.directory">const char *directory() const</A></H4>
<P>This method returns the current directory (base) path for the file
in the buffer.
<H4><A NAME="Fl_Help_View.filename">const char *filename() const</A></H4>
<P>This method returns the current filename for the text in the buffer.
<H4><A NAME="Fl_Help_View.link">void link(Fl_Help_Func *fn)</A></H4>
<P>This method assigns a callback function to use when a link is
followed or a file is loaded (via
<CODE>Fl_Help_View::load()</CODE>) that requires a different
file or path. The callback function receives a pointer to the
<CODE>Fl_Help_View</CODE> widget and the full pathname for the
file in question and must return a pathname that can be opened
as a local file. This can also be used to retrieve remote or
virtual documents, returning the temporary file that contains
the actual data.</P>
<H4><A NAME="Fl_Help_View.load">int load(const char *f)</A></H4>
<P>This method loads the specified file or URL.
<H4><A NAME="Fl_Help_View.size">int size() const</A></H4>
<P>This method returns the length of the buffer text in pixels.
<H4><A NAME="Fl_Help_View.textcolor">void textcolor(Fl_Color c)<BR>
Fl_Color textcolor() const</A></H4>
<P>The first form sets the default text color. The second returns
the current default text color.
<H4><A NAME="Fl_Help_View.textfont">void textfont(uchar f)<BR>
uchar textfont() const</A></H4>
<P>The first form sets the default text font. The second returns
the current default text font.
<H4><A NAME="Fl_Help_View.textsize">void textsize(uchar s)<BR>
uchar textsize() const</A></H4>
<P>The first form sets the default text size. The second returns
the current default text size.
<H4><A NAME="Fl_Help_View.title">const char *title()</A></H4>
<P>This method returns the current document title, or NULL if there
is no title.
<H4><A NAME="Fl_Help_View.topline">void topline(const char *n)<BR>
void topline(int)<BR>
int topline() const</A></H4>
<P>The first two forms scroll the text to the indicated position, either
with a named destination or by pixel line.
<P>The second form returns the current top line in pixels.
<H4><A NAME="Fl_Help_View.value">void value(const char *v)<BR>
const char *value() const</A></H4>
<P>The first form sets the current buffer to the string provided and
reformats the text. The second form returns the current buffer contents.
</BODY>
</HTML>