Add documentation for readonly() and input_type().
Fix "make distclean" so that it removes all of the library files. git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@2204 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
This commit is contained in:
Michael R Sweet
parent
84bccaf8e7
commit
c56bb65a97
@ -1,10 +1,15 @@
|
||||
<HTML><BODY>
|
||||
<HTML>
|
||||
<BODY>
|
||||
|
||||
<!-- NEW PAGE -->
|
||||
|
||||
<H2><A name=Fl_Input>class Fl_Input</A></H2>
|
||||
|
||||
<HR>
|
||||
|
||||
<H3>Class Hierarchy</H3>
|
||||
<UL>
|
||||
<PRE>
|
||||
|
||||
<UL><PRE>
|
||||
<A href=Fl_Input_.html#Fl_Input_>Fl_Input_</A>
|
||||
|
|
||||
+----<B>Fl_Input</B>
|
||||
@ -12,22 +17,23 @@
|
||||
+----<A href="Fl_File_Input.html">Fl_File_Input</A>, <A href=Fl_Float_Input.html#Fl_Float_Input>Fl_Float_Input</A>,
|
||||
<A href=Fl_Int_Input.html#Fl_Int_Input>Fl_Int_Input</A>, <A href=Fl_Multiline_Input.html#Fl_Multiline_Input>Fl_Multiline_Input</A>,
|
||||
<A href=Fl_Output.html#Fl_Output>Fl_Output</A>, <A href=Fl_Secret_Input.html#Fl_Secret_Input>Fl_Secret_Input</A>
|
||||
</PRE>
|
||||
</UL>
|
||||
</PRE></UL>
|
||||
|
||||
<H3>Include Files</H3>
|
||||
<UL>
|
||||
<PRE>
|
||||
|
||||
<UL><PRE>
|
||||
#include <FL/Fl_Input.H>
|
||||
</PRE>
|
||||
</UL>
|
||||
</PRE></UL>
|
||||
|
||||
<H3>Description</H3>
|
||||
<P>This is the FLTK text input widget. It displays a single line of text
|
||||
and lets the user edit it. Normally it is drawn with an inset box and
|
||||
a white background. The text may contain any characters (even 0), and
|
||||
will correctly display anything, using ^X notation for unprintable
|
||||
control characters and \nnn notation for unprintable characters with
|
||||
the high bit set. It assumes the font can draw any characters in the
|
||||
ISO-8859-1 character set.
|
||||
|
||||
<P>This is the FLTK text input widget. It displays a single line
|
||||
of text and lets the user edit it. Normally it is drawn with an
|
||||
inset box and a white background. The text may contain any
|
||||
characters (even 0), and will correctly display anything, using
|
||||
^X notation for unprintable control characters and \nnn notation
|
||||
for unprintable characters with the high bit set. It assumes the
|
||||
font can draw any characters in the ISO-8859-1 character set.
|
||||
|
||||
<CENTER><TABLE border=1 WIDTH=90% summary="Fl_Input keyboard and mouse bindings.">
|
||||
|
||||
@ -240,6 +246,7 @@ inserted.
|
||||
</TD><TD align=left valign=top>
|
||||
<UL>
|
||||
<LI><A href=#Fl_Input.index>index</A></LI>
|
||||
<LI><A href=#Fl_Input.readonly>readonly</A></LI>
|
||||
<LI><A href=#Fl_Input.size>size</A></LI>
|
||||
</UL>
|
||||
</TD><TD align=left valign=top>
|
||||
@ -260,78 +267,115 @@ inserted.
|
||||
</TD></TR>
|
||||
</TABLE>
|
||||
</CENTER>
|
||||
<H4><A name=Fl_Input.Fl_Input>Fl_Input::Fl_Input(int x, int y, int w,
|
||||
int h, const char *label = 0)</A></H4>
|
||||
Creates a new <TT>Fl_Input</TT> widget using the given position, size,
|
||||
and label string. The default boxtype is <TT>FL_DOWN_BOX</TT>.
|
||||
<H4><A name=Fl_Input.~Fl_Input>virtual Fl_Input::~Fl_Input()</A></H4>
|
||||
Destroys the widget and any value associated with it.
|
||||
<H4><A name=Fl_Input.value>const char *Fl_Input::value() const
|
||||
<BR> int Fl_Input::value(const char*)
|
||||
<BR> int Fl_Input::value(const char*, int)</A></H4>
|
||||
The first form returns the current value, which is a pointer to the
|
||||
internal buffer and is valid only until the next event is handled.
|
||||
<P>The second two forms change the text and set the mark and the point
|
||||
to the end of it. The string is copied to the internal buffer. Passing <TT>
|
||||
NULL</TT> is the same as "". This returns non-zero if the new value is
|
||||
different than the current one. You can use the second version to
|
||||
directly set the length if you know it already or want to put nul's in
|
||||
the text. </P>
|
||||
<H4><A name=Fl_Input.static_value>int Fl_Input::static_value(const
|
||||
char*)
|
||||
<BR> int Fl_Input::static_value(const char*, int)</A></H4>
|
||||
Change the text and set the mark and the point to the end of it. The
|
||||
string is <I>not</I> copied. If the user edits the string it is copied
|
||||
to the internal buffer then. This can save a great deal of time and
|
||||
memory if your program is rapidly changing the values of text fields,
|
||||
but this will only work if the passed string remains unchanged until
|
||||
either the <TT>Fl_Input</TT> is destroyed or <TT>value()</TT> is called
|
||||
again.
|
||||
<H4><A name=Fl_Input.size>int Fl_Input::size() const</A></H4>
|
||||
Returns the number of characters in <TT>value()</TT>. This may be
|
||||
greater than <TT>strlen(value())</TT> if there are nul characters in
|
||||
it.
|
||||
<H4><A name=Fl_Input.index>char Fl_Input::index(int) const</A></H4>
|
||||
Same as <TT>value()[n]</TT>, but may be faster in plausible
|
||||
implementations. No bounds checking is done.
|
||||
<H4><A name=Fl_Input.when>Fl_When Fl_Widget::when() const
|
||||
<BR> void Fl_Widget::when(Fl_When)</A></H4>
|
||||
Controls when callbacks are done. The following values are useful,
|
||||
the default value is <TT>FL_WHEN_RELEASE</TT>:
|
||||
<UL>
|
||||
<LI><TT>0</TT>: The callback is not done, but <TT>changed()</TT> is
|
||||
turned on. </LI>
|
||||
<LI><TT>FL_WHEN_CHANGED</TT>: The callback is done each time the text
|
||||
is changed by the user. </LI>
|
||||
<LI><TT>FL_WHEN_RELEASE</TT>: The callback will be done when this
|
||||
widget loses the focus, including when the window is unmapped. This
|
||||
is a useful value for text fields in a panel where doing the callback
|
||||
on every change is wasteful. However the callback will also happen if
|
||||
the mouse is moved out of the window, which means it should not do
|
||||
anything visible (like pop up an error message). You might do better
|
||||
setting this to zero, and scanning all the items for <TT>changed()</TT>
|
||||
when the OK button on a panel is pressed. </LI>
|
||||
<LI><TT>FL_WHEN_ENTER_KEY</TT>: If the user types the Enter key, the
|
||||
entire text is selected, and the callback is done if the text has
|
||||
changed. Normally the Enter key will navigate to the next field (or
|
||||
insert a newline for a <TT>Fl_Mulitline_Input</TT>), this changes the
|
||||
behavior. </LI>
|
||||
<LI><TT>FL_WHEN_ENTER_KEY|FL_WHEN_NOT_CHANGED</TT>: The Enter key will
|
||||
do the callback even if the text has not changed. Useful for command
|
||||
fields. </LI>
|
||||
</UL>
|
||||
<H4><A name=Fl_Input.textcolor>Fl_Color Fl_Input::textcolor() const
|
||||
<BR> void Fl_Input::textcolor(Fl_Color)</A></H4>
|
||||
Gets or sets the color of the text in the input field.
|
||||
<H4><A name=Fl_Input.textfont>Fl_Font Fl_Input::textfont() const
|
||||
<BR> void Fl_Input::textfont(Fl_Font)</A></H4>
|
||||
Gets or sets the font of the text in the input field.
|
||||
<H4><A name=Fl_Input.textsize>uchar Fl_Input::textsize() const
|
||||
<BR> void Fl_Input::textsize(uchar)</A></H4>
|
||||
Gets or sets the size of the text in the input field.
|
||||
<H4><A name=Fl_Input.cursor_color>Fl_Color Fl_Input::cursor_color()
|
||||
const
|
||||
<BR> void Fl_Input::cursor_color(Fl_Color)</A></H4>
|
||||
Get or set the color of the cursor. This is black by default.
|
||||
|
||||
</BODY></HTML>
|
||||
<H4><A name="Fl_Input.Fl_Input">Fl_Input::Fl_Input(int x, int y, int w,
|
||||
int h, const char *label = 0)</A></H4>
|
||||
|
||||
<P>Creates a new <TT>Fl_Input</TT> widget using the given position, size,
|
||||
and label string. The default boxtype is <TT>FL_DOWN_BOX</TT>.
|
||||
|
||||
<H4><A name="Fl_Input.~Fl_Input">virtual Fl_Input::~Fl_Input()</A></H4>
|
||||
|
||||
<P>Destroys the widget and any value associated with it.
|
||||
|
||||
<H4><A name="Fl_Input.value">const char *Fl_Input::value() const
|
||||
<BR>int Fl_Input::value(const char*)
|
||||
<BR>int Fl_Input::value(const char*, int)</A></H4>
|
||||
|
||||
<P>The first form returns the current value, which is a pointer
|
||||
to the internal buffer and is valid only until the next event is
|
||||
handled.
|
||||
|
||||
<P>The second two forms change the text and set the mark and the
|
||||
point to the end of it. The string is copied to the internal
|
||||
buffer. Passing <TT>NULL</TT> is the same as "".
|
||||
This returns non-zero if the new value is different than the
|
||||
current one. You can use the second version to directly set the
|
||||
length if you know it already or want to put nul's in the
|
||||
text.</P>
|
||||
|
||||
<H4><A name="Fl_Input.static_value">int Fl_Input::static_value(const
|
||||
char*)
|
||||
<BR>int Fl_Input::static_value(const char*, int)</A></H4>
|
||||
|
||||
<P>Change the text and set the mark and the point to the end of
|
||||
it. The string is <I>not</I> copied. If the user edits the
|
||||
string it is copied to the internal buffer then. This can save a
|
||||
great deal of time and memory if your program is rapidly
|
||||
changing the values of text fields, but this will only work if
|
||||
the passed string remains unchanged until either the
|
||||
<TT>Fl_Input</TT> is destroyed or <TT>value()</TT> is called
|
||||
again.
|
||||
|
||||
<H4><A name="Fl_Input.size">int Fl_Input::size() const</A></H4>
|
||||
|
||||
<P>Returns the number of characters in <TT>value()</TT>. This
|
||||
may be greater than <TT>strlen(value())</TT> if there are nul
|
||||
characters in it.
|
||||
|
||||
<H4><A name="Fl_Input.index">char Fl_Input::index(int) const</A></H4>
|
||||
|
||||
<P>Same as <TT>value()[n]</TT>, but may be faster in plausible
|
||||
implementations. No bounds checking is done.
|
||||
|
||||
<H4><A name="Fl_Input.when">Fl_When Fl_Widget::when() const
|
||||
<BR>void Fl_Widget::when(Fl_When)</A></H4>
|
||||
|
||||
<P>Controls when callbacks are done. The following values are useful,
|
||||
the default value is <TT>FL_WHEN_RELEASE</TT>:
|
||||
|
||||
<UL>
|
||||
|
||||
<LI><TT>0</TT>: The callback is not done, but
|
||||
<TT>changed()</TT> is turned on.</LI>
|
||||
|
||||
<LI><TT>FL_WHEN_CHANGED</TT>: The callback is done each
|
||||
time the text is changed by the user.</LI>
|
||||
|
||||
<LI><TT>FL_WHEN_RELEASE</TT>: The callback will be done
|
||||
when this widget loses the focus, including when the
|
||||
window is unmapped. This is a useful value for text
|
||||
fields in a panel where doing the callback on every
|
||||
change is wasteful. However the callback will also
|
||||
happen if the mouse is moved out of the window, which
|
||||
means it should not do anything visible (like pop up an
|
||||
error message). You might do better setting this to
|
||||
zero, and scanning all the items for <TT>changed()</TT>
|
||||
when the OK button on a panel is pressed.</LI>
|
||||
|
||||
<LI><TT>FL_WHEN_ENTER_KEY</TT>: If the user types the
|
||||
Enter key, the entire text is selected, and the callback
|
||||
is done if the text has changed. Normally the Enter key
|
||||
will navigate to the next field (or insert a newline for
|
||||
a <TT>Fl_Mulitline_Input</TT>), this changes the
|
||||
behavior.</LI>
|
||||
|
||||
<LI><TT>FL_WHEN_ENTER_KEY|FL_WHEN_NOT_CHANGED</TT>: The
|
||||
Enter key will do the callback even if the text has not
|
||||
changed. Useful for command fields.</LI>
|
||||
|
||||
</UL>
|
||||
|
||||
<H4><A name="Fl_Input.textcolor">Fl_Color Fl_Input::textcolor() const
|
||||
<BR>void Fl_Input::textcolor(Fl_Color)</A></H4>
|
||||
|
||||
<P>Gets or sets the color of the text in the input field.
|
||||
|
||||
<H4><A name="Fl_Input.textfont">Fl_Font Fl_Input::textfont() const
|
||||
<BR>void Fl_Input::textfont(Fl_Font)</A></H4>
|
||||
|
||||
<P>Gets or sets the font of the text in the input field.
|
||||
|
||||
<H4><A name="Fl_Input.textsize">uchar Fl_Input::textsize() const
|
||||
<BR>void Fl_Input::textsize(uchar)</A></H4>
|
||||
|
||||
<P>Gets or sets the size of the text in the input field.
|
||||
|
||||
<H4><A name="Fl_Input.cursor_color">Fl_Color Fl_Input::cursor_color()
|
||||
const
|
||||
<BR>void Fl_Input::cursor_color(Fl_Color)</A></H4>
|
||||
|
||||
<P>Get or set the color of the cursor. This is black by default.
|
||||
|
||||
</BODY>
|
||||
</HTML>
|
||||
|
||||
@ -1,176 +1,247 @@
|
||||
<HTML><BODY>
|
||||
<HTML>
|
||||
<BODY>
|
||||
|
||||
<!-- NEW PAGE -->
|
||||
|
||||
<H2><A name="Fl_Input_">class Fl_Input_</A></H2>
|
||||
|
||||
<HR>
|
||||
|
||||
<H3>Class Hierarchy</H3>
|
||||
<UL>
|
||||
<PRE>
|
||||
|
||||
<UL><PRE>
|
||||
<A href=Fl_Widget.html#Fl_Widget>Fl_Widget</A>
|
||||
|
|
||||
+----<B>Fl_Input_</B>
|
||||
|
|
||||
+----<A href=Fl_Input.html#Fl_Input>Fl_Input</A>
|
||||
</PRE>
|
||||
</UL>
|
||||
</PRE></UL>
|
||||
|
||||
<H3>Include Files</H3>
|
||||
<UL>
|
||||
<PRE>
|
||||
|
||||
<UL><PRE>
|
||||
#include <FL/Fl_Input_.H>
|
||||
</PRE>
|
||||
</UL>
|
||||
</PRE></UL>
|
||||
|
||||
<H3>Description</H3>
|
||||
This is a virtual base class below <A href=Fl_Input.html#Fl_Input><TT>
|
||||
Fl_Input</TT></A>. It has all the same interfaces, but lacks the <TT>
|
||||
handle()</TT> and <TT>draw()</TT> method. You may want to subclass it
|
||||
if you are one of those people who likes to change how the editing keys
|
||||
|
||||
<P>This is a virtual base class below <A
|
||||
href="Fl_Input.html#Fl_Input"><TT>Fl_Input</TT></A>. It has all
|
||||
the same interfaces, but lacks the <TT>handle()</TT> and
|
||||
<TT>draw()</TT> method. You may want to subclass it if you are
|
||||
one of those people who likes to change how the editing keys
|
||||
work.
|
||||
<P>This can act like any of the subclasses of Fl_Input, by setting <TT>
|
||||
type()</TT> to one of the following values: </P>
|
||||
<UL>
|
||||
<PRE>
|
||||
|
||||
<P>This can act like any of the subclasses of Fl_Input, by
|
||||
setting <TT>type()</TT> to one of the following values:</P>
|
||||
|
||||
<UL><PRE>
|
||||
#define FL_NORMAL_INPUT 0
|
||||
#define FL_FLOAT_INPUT 1
|
||||
#define FL_INT_INPUT 2
|
||||
#define FL_MULTILINE_INPUT 4
|
||||
#define FL_SECRET_INPUT 5
|
||||
</PRE>
|
||||
</UL>
|
||||
</PRE></UL>
|
||||
|
||||
<H3>Methods</H3>
|
||||
|
||||
<CENTER>
|
||||
<TABLE width=90% summary="Fl_Input_ methods.">
|
||||
<TR><TD align=left valign=top>
|
||||
<TABLE width="90%" summary="Fl_Input_ methods.">
|
||||
<TR><TD align="left" valign="top">
|
||||
<UL>
|
||||
<LI><A href=#Fl_Input_.Fl_Input_>Fl_Input_</A></LI>
|
||||
<LI><A href=#Fl_Input_.~Fl_Input_>~Fl_Input_</A></LI>
|
||||
<LI><A href=#Fl_Input_.copy>copy</A></LI>
|
||||
<LI><A href=#Fl_Input_.copy_cuts>copy_cuts</A></LI>
|
||||
<LI><A href="#Fl_Input_.Fl_Input_">Fl_Input_</A></LI>
|
||||
<LI><A href="#Fl_Input_.~Fl_Input_">~Fl_Input_</A></LI>
|
||||
<LI><A href="#Fl_Input_.copy">copy</A></LI>
|
||||
<LI><A href="#Fl_Input_.copy_cuts">copy_cuts</A></LI>
|
||||
</UL>
|
||||
</TD><TD align=left valign=top>
|
||||
</TD><TD align="left" valign="top">
|
||||
<UL>
|
||||
<LI><A href=#Fl_Input_.cut>cut</A></LI>
|
||||
<LI><A href=#Fl_Input_.drawtext>drawtext</A></LI>
|
||||
<LI><A href=#Fl_Input_.handletext>handletext</A></LI>
|
||||
<LI><A href=#Fl_Input_.insert>insert</A></LI>
|
||||
<LI><A href="#Fl_Input_.cut">cut</A></LI>
|
||||
<LI><A href="#Fl_Input_.drawtext">drawtext</A></LI>
|
||||
<LI><A href="#Fl_Input_.handletext">handletext</A></LI>
|
||||
<LI><A href="#Fl_Input_.input_type">input_type</A></LI>
|
||||
</UL>
|
||||
</TD><TD align=left valign=top>
|
||||
</TD><TD align="left" valign="top">
|
||||
<UL>
|
||||
<LI><A href=#Fl_Input_.lineboundary>lineboundary</A></LI>
|
||||
<LI><A href=#Fl_Input_.mark>mark</A></LI>
|
||||
<LI><A href=#Fl_Input_.maybe_do_callback>maybe_do_callback</A></LI>
|
||||
<LI><A href="#Fl_Input_.insert">insert</A></LI>
|
||||
<LI><A href="#Fl_Input_.lineboundary">lineboundary</A></LI>
|
||||
<LI><A href="#Fl_Input_.mark">mark</A></LI>
|
||||
<LI><A href="#Fl_Input_.maybe_do_callback">maybe_do_callback</A></LI>
|
||||
</UL>
|
||||
</TD><TD align=left valign=top>
|
||||
</TD><TD align="left" valign="top">
|
||||
<UL>
|
||||
<LI><A href=#Fl_Input_.maximum_size>maximum_size</A></LI>
|
||||
<LI><A href=#Fl_Input_.position>position</A></LI>
|
||||
<LI><A href=#Fl_Input_.replace>replace</A></LI>
|
||||
<LI><A href="#Fl_Input_.maximum_size">maximum_size</A></LI>
|
||||
<LI><A href="#Fl_Input_.position">position</A></LI>
|
||||
<LI><A href="#Fl_Input_.readonly">readonly</A></LI>
|
||||
<LI><A href="#Fl_Input_.replace">replace</A></LI>
|
||||
</UL>
|
||||
</TD><TD align=left valign=top>
|
||||
</TD><TD align="left" valign="top">
|
||||
<UL>
|
||||
<LI><A href=#Fl_Input_.undo>undo</A></LI>
|
||||
<LI><A href=#Fl_Input_.up_down_position>up_down_position</A></LI>
|
||||
<LI><A href=#Fl_Input_.wordboundary>wordboundary</A></LI>
|
||||
<LI><A href="#Fl_Input_.undo">undo</A></LI>
|
||||
<LI><A href="#Fl_Input_.up_down_position">up_down_position</A></LI>
|
||||
<LI><A href="#Fl_Input_.wordboundary">wordboundary</A></LI>
|
||||
</UL>
|
||||
</TD></TR>
|
||||
</TABLE>
|
||||
</CENTER>
|
||||
<H4><A name=Fl_Input_.Fl_Input_>Fl_Input_::Fl_Input_(int x, int y, int
|
||||
|
||||
<H4><A name="Fl_Input_.Fl_Input_">Fl_Input_::Fl_Input_(int x, int y, int
|
||||
w, int h, const char *label = 0)</A></H4>
|
||||
Creates a new <TT>Fl_Input_</TT> widget using the given position,
|
||||
size, and label string. The default boxtype is <TT>FL_DOWN_BOX</TT>.
|
||||
<H4><A name=Fl_Input_.~Fl_Input_>virtual Fl_Input_::~Fl_Input_()</A></H4>
|
||||
The destructor removes the widget and any value associated with it.
|
||||
<H4><A name=Fl_Input_.wordboundary>int Fl_Input_::wordboundary(int i)
|
||||
|
||||
<P>Creates a new <TT>Fl_Input_</TT> widget using the given
|
||||
position, size, and label string. The default boxtype is
|
||||
<TT>FL_DOWN_BOX</TT>.
|
||||
|
||||
<H4><A name="Fl_Input_.~Fl_Input_">virtual Fl_Input_::~Fl_Input_()</A></H4>
|
||||
|
||||
<P>The destructor removes the widget and any value associated with it.
|
||||
|
||||
<H4><A name="Fl_Input_.wordboundary">int Fl_Input_::wordboundary(int i)
|
||||
const</A></H4>
|
||||
Returns true if position <TT>i</TT> is at the start or end of a word.
|
||||
<H4><A name=Fl_Input_.lineboundary>int Fl_Input_::lineboundary(int i)
|
||||
|
||||
<P>Returns true if position <TT>i</TT> is at the start or end of a word.
|
||||
|
||||
<H4><A name="Fl_Input_.lineboundary">int Fl_Input_::lineboundary(int i)
|
||||
const</A></H4>
|
||||
Returns true if position <TT>i</TT> is at the start or end of a line.
|
||||
<H4><A name=Fl_Input_.drawtext>void Fl_Input_::drawtext(int,int,int,int)</A>
|
||||
</H4>
|
||||
Draw the text in the passed bounding box. If <TT>damage()
|
||||
FL_DAMAGE_ALL</TT> is true, this assumes the area has already been
|
||||
erased to <TT>color()</TT>. Otherwise it does minimal update and
|
||||
erases the area itself.
|
||||
<H4><A name=Fl_Input_.handletext>void Fl_Input_::handletext(int
|
||||
|
||||
<P>Returns true if position <TT>i</TT> is at the start or end of a line.
|
||||
|
||||
<H4><A name="Fl_Input_.drawtext">void Fl_Input_::drawtext(int,int,int,int)</A></H4>
|
||||
|
||||
<P>Draw the text in the passed bounding box. If <TT>damage()
|
||||
& FL_DAMAGE_ALL</TT> is true, this assumes the area has
|
||||
already been erased to <TT>color()</TT>. Otherwise it does
|
||||
minimal update and erases the area itself.
|
||||
|
||||
<H4><A name="Fl_Input_.handletext">void Fl_Input_::handletext(int
|
||||
e,int,int,int,int)</A></H4>
|
||||
Default handler for all event types. Your <TT>handle()</TT> method
|
||||
should call this for all events that it does not handle completely.
|
||||
You must pass it the same bounding box as passed to <TT>draw()</TT>.
|
||||
Handles <TT>FL_PUSH</TT>, <TT>FL_DRAG</TT>, <TT>FL_RELEASE</TT> to
|
||||
select text, handles <TT>FL_FOCUS</TT> and <TT>FL_UNFOCUS</TT> to show
|
||||
and hide the cursor.
|
||||
<H4><A name=Fl_Input_.up_down_position>int
|
||||
|
||||
<P>Default handler for all event types. Your <TT>handle()</TT>
|
||||
method should call this for all events that it does not handle
|
||||
completely. You must pass it the same bounding box as passed to
|
||||
<TT>draw()</TT>. Handles <TT>FL_PUSH</TT>, <TT>FL_DRAG</TT>,
|
||||
<TT>FL_RELEASE</TT> to select text, handles <TT>FL_FOCUS</TT>
|
||||
and <TT>FL_UNFOCUS</TT> to show and hide the cursor.
|
||||
|
||||
<H4><A name="Fl_Input_.up_down_position">int
|
||||
Fl_Input_::up_down_position(int i, int keepmark=0)</A></H4>
|
||||
Do the correct thing for arrow keys. Sets the position (and mark if <I>
|
||||
keepmark</I> is zero) to somewhere in the same line as <I>i</I>, such
|
||||
that pressing the arrows repeatedly will cause the point to move up and
|
||||
down.
|
||||
<H4><A name=Fl_Input_.maybe_do_callback>void
|
||||
|
||||
<P>Do the correct thing for arrow keys. Sets the position (and
|
||||
mark if <I>keepmark</I> is zero) to somewhere in the same line
|
||||
as <I>i</I>, such that pressing the arrows repeatedly will cause
|
||||
the point to move up and down.
|
||||
|
||||
<H4><A name="Fl_Input_.maybe_do_callback">void
|
||||
Fl_Input_::maybe_do_callback()</A></H4>
|
||||
Does the callback if <TT>changed()</TT> is true or if <TT>when()
|
||||
FL_WHEN_NOT_CHANGED</TT> is non-zero. You should call this at any
|
||||
point you think you should generate a callback.
|
||||
|
||||
<P>Does the callback if <TT>changed()</TT> is true or if
|
||||
<TT>when() & FL_WHEN_NOT_CHANGED</TT> is non-zero. You
|
||||
should call this at any point you think you should generate a
|
||||
callback.
|
||||
|
||||
<H4><A name="Fl_Input_.maximum_size">void Fl_Input_::maximum_size(int m)<BR>
|
||||
int Fl_Input_::maximum_size() const</A></H4>
|
||||
|
||||
<P>Sets or returns the maximum length of the input field.
|
||||
<H4><A name=Fl_Input_.position>int Fl_Input_::position() const
|
||||
<BR> int Fl_Input_::position(int new_position, int new_mark)
|
||||
<BR> int Fl_Input_::position(int new_position_and_new_mark)</A></H4>
|
||||
The input widget maintains two pointers into the string. The
|
||||
"position" is where the cursor is. The "mark" is the other end of the
|
||||
selected text. If they are equal then there is no selection. Changing
|
||||
this does not affect the clipboard (use <TT>copy()</TT> to do that).
|
||||
<P>Changing these values causes a <TT>redraw()</TT>. The new values
|
||||
are bounds checked. The return value is non-zero if the new position
|
||||
is different than the old one. <TT>position(n)</TT> is the same as <TT>
|
||||
position(n,n)</TT>. <TT>mark(n)</TT> is the same as <TT>
|
||||
position(position(),n)</TT>. </P>
|
||||
<H4><A name=Fl_Input_.mark>int Fl_Input_::mark() const
|
||||
|
||||
<H4><A name="Fl_Input_.position">int Fl_Input_::position() const
|
||||
<BR>int Fl_Input_::position(int new_position, int new_mark)
|
||||
<BR>int Fl_Input_::position(int new_position_and_new_mark)</A></H4>
|
||||
|
||||
<P>The input widget maintains two pointers into the string. The
|
||||
"position" is where the cursor is. The
|
||||
"mark" is the other end of the selected text. If they
|
||||
are equal then there is no selection. Changing this does not
|
||||
affect the clipboard (use <TT>copy()</TT> to do that).
|
||||
|
||||
<P>Changing these values causes a <TT>redraw()</TT>. The new
|
||||
values are bounds checked. The return value is non-zero if the
|
||||
new position is different than the old one. <TT>position(n)</TT>
|
||||
is the same as <TT>position(n,n)</TT>. <TT>mark(n)</TT> is the
|
||||
same as <TT>position(position(),n)</TT>.</P>
|
||||
|
||||
<H4><A name="Fl_Input_.mark">int Fl_Input_::mark() const
|
||||
<BR> int Fl_Input_::mark(int new_mark)</A></H4>
|
||||
Gets or sets the current selection mark. <TT>mark(n)</TT> is the same
|
||||
as <TT>position(position(),n)</TT>.
|
||||
<H4><A name=Fl_Input_.replace>int Fl_Input_::replace(int a, int b,
|
||||
|
||||
<P>Gets or sets the current selection mark. <TT>mark(n)</TT> is
|
||||
the same as <TT>position(position(),n)</TT>.
|
||||
|
||||
<H4><A name="Fl_Input_.replace">int Fl_Input_::replace(int a, int b,
|
||||
const char *insert, int length=0)</A></H4>
|
||||
This call does all editing of the text. It deletes the region between <TT>
|
||||
a</TT> and <TT>b</TT> (either one may be less or equal to the other),
|
||||
and then inserts the string <TT>insert</TT> at that point and leaves
|
||||
the <TT>mark()</TT> and <TT>position()</TT> after the insertion. Does
|
||||
the callback if <TT>when() FL_WHEN_CHANGED</TT> and there is a change.
|
||||
<P>Set <TT>start</TT> and <TT>end</TT> equal to not delete anything.
|
||||
Set <TT>insert</TT> to <TT>NULL</TT> to not insert anything. </P>
|
||||
<P><TT>length</TT> must be zero or <TT>strlen(insert)</TT>, this saves
|
||||
a tiny bit of time if you happen to already know the length of the
|
||||
insertion, or can be used to insert a portion of a string or a string
|
||||
containing nul's. </P>
|
||||
<P><TT>a</TT> and <TT>b</TT> are clamped to the 0..<TT>size()</TT>
|
||||
range, so it is safe to pass any values. </P>
|
||||
<P><TT>cut()</TT> and <TT>insert()</TT> are just inline functions that
|
||||
call <TT>replace()</TT>. </P>
|
||||
<H4><A name=Fl_Input_.cut>int Fl_Input_::cut()
|
||||
|
||||
<P>This call does all editing of the text. It deletes the region
|
||||
between <TT>a</TT> and <TT>b</TT> (either one may be less or
|
||||
equal to the other), and then inserts the string <TT>insert</TT>
|
||||
at that point and leaves the <TT>mark()</TT> and
|
||||
<TT>position()</TT> after the insertion. Does the callback if
|
||||
<TT>when() & FL_WHEN_CHANGED</TT> and there is a change.
|
||||
|
||||
<P>Set <TT>start</TT> and <TT>end</TT> equal to not delete
|
||||
anything. Set <TT>insert</TT> to <TT>NULL</TT> to not insert
|
||||
anything.</P>
|
||||
|
||||
<P><TT>length</TT> must be zero or <TT>strlen(insert)</TT>, this
|
||||
saves a tiny bit of time if you happen to already know the
|
||||
length of the insertion, or can be used to insert a portion of a
|
||||
string or a string containing nul's.</P>
|
||||
|
||||
<P><TT>a</TT> and <TT>b</TT> are clamped to the
|
||||
0..<TT>size()</TT> range, so it is safe to pass any values.</P>
|
||||
|
||||
<P><TT>cut()</TT> and <TT>insert()</TT> are just inline
|
||||
functions that call <TT>replace()</TT>.</P>
|
||||
|
||||
<H4><A name="Fl_Input_.cut">int Fl_Input_::cut()
|
||||
<BR> int Fl_Input_::cut(int n)
|
||||
<BR> int Fl_Input_::cut(int a, int b);</A></H4>
|
||||
<TT>Fl_Input_::cut()</TT> deletes the current selection. <TT>cut(n)</TT>
|
||||
deletes <TT>n</TT> characters after the <TT>position()</TT>. <TT>
|
||||
cut(-n)</TT> deletes <TT>n</TT> characters before the <TT>position()</TT>
|
||||
. <TT>cut(a,b)</TT> deletes the characters between offsets <TT>a</TT>
|
||||
and <TT>b</TT>. <TT>A</TT>, <TT>b</TT>, and <TT>n</TT> are all clamped
|
||||
to the size of the string. The mark and point are left where the
|
||||
deleted text was.
|
||||
<P>If you want the data to go into the clipboard, do <TT>
|
||||
Fl_Input_::copy()</TT> before calling <TT>Fl_Input_::cut()</TT>, or do <TT>
|
||||
Fl_Input_::copy_cuts()</TT> afterwards. </P>
|
||||
<H4><A name=Fl_Input_.insert>int Fl_Input_::insert(const char *t,int
|
||||
|
||||
<P><TT>Fl_Input_::cut()</TT> deletes the current selection.
|
||||
<TT>cut(n)</TT> deletes <TT>n</TT> characters after the
|
||||
<TT>position()</TT>. <TT>cut(-n)</TT> deletes <TT>n</TT>
|
||||
characters before the <TT>position()</TT>. <TT>cut(a,b)</TT>
|
||||
deletes the characters between offsets <TT>a</TT> and
|
||||
<TT>b</TT>. <TT>A</TT>, <TT>b</TT>, and <TT>n</TT> are all
|
||||
clamped to the size of the string. The mark and point are left
|
||||
where the deleted text was.
|
||||
|
||||
<P>If you want the data to go into the clipboard, do
|
||||
<TT>Fl_Input_::copy()</TT> before calling
|
||||
<TT>Fl_Input_::cut()</TT>, or do <TT>Fl_Input_::copy_cuts()</TT>
|
||||
afterwards.</P>
|
||||
|
||||
<H4><A name="Fl_Input_.insert">int Fl_Input_::insert(const char *t,int
|
||||
l=0)</A></H4>
|
||||
Insert the string <TT>t</TT> at the current position, and leave the
|
||||
mark and position after it. If <TT>l</TT> is not zero then it is
|
||||
assumed to be <TT>strlen(t)</TT>.
|
||||
<H4><A name=Fl_Input_.copy>int Fl_Input_::copy()</A></H4>
|
||||
Put the current selection between <TT>mark()</TT> and <TT>position()</TT>
|
||||
into the clipboard. Does not replace the old clipboard contents if <TT>
|
||||
position()</TT> and <TT>mark()</TT> are equal.
|
||||
<H4><A name=Fl_Input_.undo>int Fl_Input_::undo()</A></H4>
|
||||
Does undo of several previous calls to <TT>replace()</TT>. Returns
|
||||
non-zero if any change was made.
|
||||
<H4><A name=Fl_Input_.copy_cuts>int Fl_Input_::copy_cuts()</A></H4>
|
||||
Copy all the previous contiguous cuts from the undo information to the
|
||||
clipboard. This is used to make ^K work. </BODY></HTML>
|
||||
|
||||
<P>Insert the string <TT>t</TT> at the current position, and
|
||||
leave the mark and position after it. If <TT>l</TT> is not zero
|
||||
then it is assumed to be <TT>strlen(t)</TT>.
|
||||
|
||||
<H4><A name="Fl_Input_.copy">int Fl_Input_::copy()</A></H4>
|
||||
|
||||
<P>Put the current selection between <TT>mark()</TT> and
|
||||
<TT>position()</TT> into the clipboard. Does not replace the
|
||||
old clipboard contents if <TT>position()</TT> and
|
||||
<TT>mark()</TT> are equal.
|
||||
|
||||
<H4><A name="Fl_Input_.undo">int Fl_Input_::undo()</A></H4>
|
||||
|
||||
<P>Does undo of several previous calls to <TT>replace()</TT>.
|
||||
Returns non-zero if any change was made.
|
||||
|
||||
<H4><A name="Fl_Input_.copy_cuts">int Fl_Input_::copy_cuts()</A></H4>
|
||||
|
||||
<P>Copy all the previous contiguous cuts from the undo
|
||||
information to the clipboard. This is used to make ^K work.
|
||||
|
||||
<H4><A name="Fl_Input.input_type">int Fl_Input::input_type() const
|
||||
<BR>void Fl_Input::input_type(int)</A></H4>
|
||||
|
||||
<P>Gets or sets the input field type.
|
||||
|
||||
<H4><A name="Fl_Input.readonly">int Fl_Input::readonly() const
|
||||
<BR>void Fl_Input::readonly(int)</A></H4>
|
||||
|
||||
<P>Gets or sets the read-only state of the input field.
|
||||
|
||||
</BODY>
|
||||
</HTML>
|
||||
|
||||
10
src/Makefile
10
src/Makefile
@ -1,5 +1,5 @@
|
||||
#
|
||||
# "$Id: Makefile,v 1.18.2.14.2.41 2002/04/30 21:50:16 easysw Exp $"
|
||||
# "$Id: Makefile,v 1.18.2.14.2.42 2002/05/08 12:44:52 easysw Exp $"
|
||||
#
|
||||
# Library makefile for the Fast Light Tool Kit (FLTK).
|
||||
#
|
||||
@ -239,7 +239,11 @@ libfltk_gl_s.a: $(GLOBJECTS)
|
||||
chmod +x libfltk_gl_s.a
|
||||
|
||||
clean :
|
||||
-@ rm -f *.o $(DSONAME) $(GLDSONAME) $(LIBRARY) $(CLEAN) libfltk.so libfltk_gl.so
|
||||
-@ rm -f *.o $(DSONAME) $(FLDSONAME) $(GLDSONAME) \
|
||||
../lib/$(LIBNAME) ../lib/$(FLLIBNAME) ../lib/$(GLLIBNAME) \
|
||||
libfltk.so libfltk_forms.so libfltk_gl.so \
|
||||
libfltk.sl libfltk_forms.sl libfltk_gl.sl \
|
||||
$(CLEAN)
|
||||
|
||||
depend: $(CPPFILES) $(FLCPPFILES) $(GLCPPFILES) $(CFILES)
|
||||
makedepend -Y -I.. -f makedepend $(CPPFILES) $(GLCPPFILES) $(CFILES)
|
||||
@ -429,5 +433,5 @@ uninstall:
|
||||
|
||||
|
||||
#
|
||||
# End of "$Id: Makefile,v 1.18.2.14.2.41 2002/04/30 21:50:16 easysw Exp $".
|
||||
# End of "$Id: Makefile,v 1.18.2.14.2.42 2002/05/08 12:44:52 easysw Exp $".
|
||||
#
|
||||
|
||||
Loading…
Reference in New Issue
Block a user