mirror of https://github.com/fltk/fltk
Remove extra 3 pixel offset when the size is below a certain amount;
instead, use a constant +1 offset. Add another bit to flags_, VISIBLE_FOCUS, which provides per-widget keyboard focus control. The default is for all widgets to participate in keyboard focus navigation. Use the set_visible_focus(), clear_visible_focus(), and visible_focus() methods on Fl_Widget to control this. Clean up the Fl_Widget documentation and add missing stuff. git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@2543 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
This commit is contained in:
Michael R Sweet
parent
c22732b9e0
commit
57cef6a4bd
3
CHANGES
3
CHANGES
|
|
@ -1,5 +1,8 @@
|
|||
CHANGES IN FLTK 1.1.0rc5
|
||||
|
||||
- Added new visible focus flag bit and methods to
|
||||
Fl_Widget, so it is now possible to do both global and
|
||||
per-widget keyboard focus control.
|
||||
- Removed extra 3 pixel border around input fields.
|
||||
- No longer quote characters from 0x80 to 0x9f in input
|
||||
fields.
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
//
|
||||
// "$Id: Fl_Widget.H,v 1.6.2.4.2.14 2002/05/13 05:05:11 spitzak Exp $"
|
||||
// "$Id: Fl_Widget.H,v 1.6.2.4.2.15 2002/07/23 15:07:32 easysw Exp $"
|
||||
//
|
||||
// Widget header file for the Fast Light Tool Kit (FLTK).
|
||||
//
|
||||
|
|
@ -85,7 +85,8 @@ protected:
|
|||
int flags() const {return flags_;}
|
||||
void set_flag(int c) {flags_ |= c;}
|
||||
void clear_flag(int c) {flags_ &= ~c;}
|
||||
enum {INACTIVE=1, INVISIBLE=2, OUTPUT=4, SHORTCUT_LABEL=64, CHANGED=128};
|
||||
enum {INACTIVE=1, INVISIBLE=2, OUTPUT=4, SHORTCUT_LABEL=64,
|
||||
CHANGED=128, VISIBLE_FOCUS=512};
|
||||
|
||||
FL_EXPORT void draw_box() const;
|
||||
FL_EXPORT void draw_box(Fl_Boxtype, Fl_Color) const;
|
||||
|
|
@ -174,6 +175,10 @@ public:
|
|||
void set_changed() {flags_ |= CHANGED;}
|
||||
void clear_changed() {flags_ &= ~CHANGED;}
|
||||
FL_EXPORT int take_focus();
|
||||
void set_visible_focus() { flags_ |= VISIBLE_FOCUS; }
|
||||
void clear_visible_focus() { flags_ &= ~VISIBLE_FOCUS; }
|
||||
void visible_focus(int v) { if (v) set_visible_focus(); else clear_visible_focus(); }
|
||||
int visible_focus() { return flags_ & VISIBLE_FOCUS; }
|
||||
|
||||
FL_EXPORT static void default_callback(Fl_Widget*, void*);
|
||||
void do_callback() {callback_(this,user_data_);}
|
||||
|
|
@ -207,5 +212,5 @@ public:
|
|||
#endif
|
||||
|
||||
//
|
||||
// End of "$Id: Fl_Widget.H,v 1.6.2.4.2.14 2002/05/13 05:05:11 spitzak Exp $".
|
||||
// End of "$Id: Fl_Widget.H,v 1.6.2.4.2.15 2002/07/23 15:07:32 easysw Exp $".
|
||||
//
|
||||
|
|
|
|||
|
|
@ -43,11 +43,14 @@ to call <TT>redraw()</TT> after these. </P>
|
|||
<LI><A href=#Fl_Widget.argument>argument</A></LI>
|
||||
<LI><A href=#Fl_Widget.box>box</A></LI>
|
||||
<LI><A href=#Fl_Widget.callback>callback</A></LI>
|
||||
<LI><A href=#Fl_Widget.changed>changed</A></LI>
|
||||
<LI><A href=#Fl_Widget.clear_changed>clear_changed</A></LI>
|
||||
<LI><A href=#Fl_Widget.clear_output>clear_output</A></LI>
|
||||
<LI><A href=#Fl_Widget.clear_visible>clear_visible</A></LI>
|
||||
<LI><A href=#Fl_Widget.clear_visible_focus>clear_visible_focus</A></LI>
|
||||
</UL>
|
||||
</TD><TD align=left valign=top>
|
||||
<UL>
|
||||
<LI><A href=#Fl_Widget.changed>changed</A></LI>
|
||||
<LI><A href=#Fl_Widget.clear_changed>clear_changed</A></LI>
|
||||
<LI><A href=#Fl_Widget.color>color</A></LI>
|
||||
<LI><A href=#Fl_Widget.contains>contains</A></LI>
|
||||
<LI><A href=#Fl_Widget.damage>damage</A></LI>
|
||||
|
|
@ -56,39 +59,40 @@ to call <TT>redraw()</TT> after these. </P>
|
|||
<LI><A href=#Fl_Widget.deimage>deimage</A></LI>
|
||||
<LI><A href=#Fl_Widget.do_callback>do_callback</A></LI>
|
||||
<LI><A href=#Fl_Widget.h>h</A></LI>
|
||||
</UL>
|
||||
</TD><TD align=left valign=top>
|
||||
<UL>
|
||||
<LI><A href=#Fl_Widget.handle>handle</A></LI>
|
||||
<LI><A href=#Fl_Widget.hide>hide</A></LI>
|
||||
<LI><A href=#Fl_Widget.image>image</A></LI>
|
||||
<LI><A href=#Fl_Widget.inside>inside</A></LI>
|
||||
<LI><A href=#Fl_Widget.label>label</A></LI>
|
||||
<LI><A href=#Fl_Widget.labelcolor>labelcolor</A></LI>
|
||||
</UL>
|
||||
</TD><TD align=left valign=top>
|
||||
<UL>
|
||||
<LI><A href=#Fl_Widget.labelfont>labelfont</A></LI>
|
||||
<LI><A href=#Fl_Widget.labelsize>labelsize</A></LI>
|
||||
<LI><A href=#Fl_Widget.labeltype>labeltype</A></LI>
|
||||
<LI><A href=#Fl_Widget.output>output</A></LI>
|
||||
</UL>
|
||||
</TD><TD align=left valign=top>
|
||||
<UL>
|
||||
<LI><A href=#Fl_Widget.parent>parent</A></LI>
|
||||
<LI><A href=#Fl_Widget.position>position</A></LI>
|
||||
<LI><A href=#Fl_Widget.redraw>redraw</A></LI>
|
||||
<LI><A href=#Fl_Widget.resize>resize</A></LI>
|
||||
<LI><A href=#Fl_Widget.selection_color>selection_color</A></LI>
|
||||
<LI><A href=#Fl_Widget.set_changed>set_changed</A></LI>
|
||||
<LI><A href=#Fl_Widget.set_output>set_output</A></LI>
|
||||
<LI><A href=#Fl_Widget.set_visible>set_visible</A></LI>
|
||||
<LI><A href=#Fl_Widget.set_visible_focus>set_visible_focus</A></LI>
|
||||
<LI><A href=#Fl_Widget.show>show</A></LI>
|
||||
<LI><A href=#Fl_Widget.size>size</A></LI>
|
||||
<LI><A href=#Fl_Widget.take_focus>take_focus</A></LI>
|
||||
<LI><A href=#Fl_Widget.takesevents>takesevents</A></LI>
|
||||
</UL>
|
||||
</TD><TD align=left valign=top>
|
||||
<UL>
|
||||
<LI><A href=#Fl_Widget.size>size</A></LI>
|
||||
<LI><A href=#Fl_Widget.take_focus>take_focus</A></LI>
|
||||
<LI><A href=#Fl_Widget.takesevents>takesevents</A></LI>
|
||||
<LI><A href="#Fl_Widget.tooltip">tooltip</A></LI>
|
||||
<LI><A href=#Fl_Widget.type>type</A></LI>
|
||||
<LI><A href=#Fl_Widget.user_data>user_data</A></LI>
|
||||
<LI><A href=#Fl_Widget.visible>visible</A></LI>
|
||||
<LI><A href=#Fl_Widget.visible_visible>visible_focus</A></LI>
|
||||
<LI><A href=#Fl_Widget.visible_r>visible_r</A></LI>
|
||||
<LI><A href=#Fl_Widget.w>w</A></LI>
|
||||
<LI><A href=#Fl_Widget.when>when</A></LI>
|
||||
|
|
@ -100,6 +104,7 @@ to call <TT>redraw()</TT> after these. </P>
|
|||
</TABLE>
|
||||
</CENTER>
|
||||
|
||||
|
||||
<H4><A NAME="Fl_Widget.Fl_Widget">protected Fl_Widget::Fl_Widget(int x, int y, int w, int h, const char*
|
||||
label=0);</A></H4>
|
||||
|
||||
|
|
@ -109,6 +114,7 @@ widgets have a matching public constructor. It takes a value for
|
|||
<TT>x()</TT>, <TT>y()</TT>, <TT>w()</TT>, <TT>h()</TT>, and an
|
||||
optional value for <TT>label()</TT>.
|
||||
|
||||
|
||||
<H4><A NAME="Fl_Widget.~Fl_Widget">virtual Fl_Widget::~Fl_Widget();</A></H4>
|
||||
|
||||
<P>Destroys the widget. Destroying single widgets is not very
|
||||
|
|
@ -118,102 +124,23 @@ group <I>immediately</I> after destroying the children. You
|
|||
almost always want to destroy the parent group instead which
|
||||
will destroy all of the child widgets and groups in that group.
|
||||
|
||||
<H4><A NAME="Fl_Widget.type">uchar Fl_Widget::type() const;</A></H4>
|
||||
|
||||
<P>Returns the widget type value, which is used for Forms
|
||||
compatability and to simulate RTTI.
|
||||
<H4><A name=Fl_Widget.active>int Fl_Widget::active() const</A><BR>
|
||||
<A name=Fl_Widget.active_r>int Fl_Widget::active_r() const</A></BR>
|
||||
<A name=Fl_Widget.activate>void Fl_Widget::activate()</A></BR>
|
||||
<A name=Fl_Widget.deactivate>void Fl_Widget::deactivate()</A></H4>
|
||||
|
||||
<H4><A name=Fl_Widget.x>short Fl_Widget::x() const</A>
|
||||
<BR><A name=Fl_Widget.y>short Fl_Widget::y() const</A>
|
||||
<BR><A name=Fl_Widget.w>short Fl_Widget::w() const</A>
|
||||
<BR><A name=Fl_Widget.h>short Fl_Widget::h() const</A></H4>
|
||||
<P><TT>Fl_Widget::active()</TT> returns whether the widget is
|
||||
active. <TT>Fl_Widget::active_r()</TT> returns whether the
|
||||
widget and all of its parents are active. An inactive widget
|
||||
does not get any events, but it does get redrawn. A widget is
|
||||
only active if <TT>active()</TT> is true on it <I>and all of its
|
||||
parents</I>.
|
||||
|
||||
<P>Returns the position of the upper-left corner of the widget
|
||||
in its enclosing Fl_Window (<I>not</I> its parent if that is not
|
||||
an Fl_Window), and its width and height.
|
||||
<P>Changing this value will send <TT>FL_ACTIVATE</TT> or <TT>
|
||||
FL_DEACTIVATE</TT> to the widget if <tt>active_r()</tt> is true.
|
||||
<P>Currently you cannot deactivate <TT>Fl_Window</TT> widgets. </P>
|
||||
|
||||
<H4><A name=Fl_Widget.resize>virtual void
|
||||
Fl_Widget::resize(int x, int y, int w, int h)</A>
|
||||
<BR><A name=Fl_Widget.position>void Fl_Widget::position(short x, short y)</A>
|
||||
<BR><A name=Fl_Widget.size>void Fl_Widget::size(short w, short h)</A></H4>
|
||||
|
||||
<P>Change the size or position of the widget. This is a virtual
|
||||
function so that the widget may implement its own handling of
|
||||
resizing. The default version does <I>not</I> call the
|
||||
<TT>redraw()</TT> method, but instead relies on the parent
|
||||
widget to do so because the parent may know a faster way to
|
||||
update the display, such as scrolling from the old position.
|
||||
|
||||
<P><TT>position(x,y)</TT> is a shortcut for <TT>resize(x,y,w(),h())</TT>,
|
||||
and <TT>size(w,h)</TT> is a shortcut for <TT>resize(x(),y(),w,h)</TT>.</P>
|
||||
|
||||
<H4><A name=Fl_Widget.window>Fl_Window* Fl_Widget::window() const;</A></H4>
|
||||
|
||||
<P>Returns a pointer to the primary <A
|
||||
href=Fl_Window.html#Fl_Window><TT>Fl_Window</TT></A> widget.
|
||||
Returns <TT>NULL</TT> if no window is associated with this
|
||||
widget. Note: for an <TT>Fl_Window</TT> widget, this returns
|
||||
its <I>parent</I> window (if any), not <I>this</I> window.
|
||||
|
||||
<H4><A name=Fl_Widget.box>Fl_Boxtype Fl_Widget::box() const
|
||||
<BR> void Fl_Widget::box(Fl_Boxtype)</A></H4>
|
||||
|
||||
<P>Gets or sets the box type for the widget, which identifies a
|
||||
routine that draws the background of the widget. See <A
|
||||
href="common.html#boxtypes">Box Types</A> for the available
|
||||
types. The default depends on the widget, but is usually
|
||||
<TT>FL_NO_BOX</TT> or <TT>FL_UP_BOX</TT>.
|
||||
|
||||
<H4><A name=Fl_Widget.color>Fl_Color Fl_Widget::color() const
|
||||
<BR>void Fl_Widget::color(Fl_Color)
|
||||
<BR>void Fl_Widget::color(Fl_Color, Fl_Color)</A></H4>
|
||||
|
||||
<P>Gets or sets the background color of the widget. The color is
|
||||
passed to the box routine. The color is either an index into an
|
||||
internal table of RGB colors or an RGB color value generated
|
||||
using <TT>fl_rgb_color()</TT>. The default for most widgets is
|
||||
<TT>FL_GRAY</TT>. See the <A
|
||||
href=enumerations.html#Enumerations>enumeration list</A> for
|
||||
predefined colors. Use <A
|
||||
href="Fl.html#Fl.set_color"><TT>Fl::set_color()</TT></A> to
|
||||
redefine colors.
|
||||
|
||||
<P>The two color form sets both the background and selection
|
||||
colors. See the description of the <A
|
||||
HREF="#Fl_Widget.selection_color"><TT>selection_color()</TT></A>
|
||||
method for more information.
|
||||
|
||||
<H4><A name=Fl_Widget.selection_color>Fl_Color
|
||||
Fl_Widget::selection_color() const
|
||||
<BR>void Fl_Widget::selection_color(Fl_Color)</A></H4>
|
||||
|
||||
<P>Gets or sets the selection color, which is defined for Forms
|
||||
compatibility and is usually used to color the widget when it is
|
||||
selected, although some widgets use this color for other
|
||||
purposes. You can set both colors at once with
|
||||
<TT>color(a,b)</TT>.
|
||||
|
||||
<H4><A name=Fl_Widget.label>const char* Fl_Widget::label() const
|
||||
<BR> void Fl_Widget::label(const char*)</A></H4>
|
||||
|
||||
<P>Get or set the current label pointer. The label is shown
|
||||
somewhere on or next to the widget. The passed pointer is stored
|
||||
unchanged in the widget (the string is <I>not</I> copied), so if
|
||||
you need to set the label to a formatted value, make sure the
|
||||
buffer is <TT>static</TT>, global, or allocated.
|
||||
|
||||
<H4><A name=Fl_Widget.labeltype>void Fl_Widget::label(Fl_Labeltype,
|
||||
const char*)
|
||||
<BR> uchar Fl_Widget::labeltype() const
|
||||
<BR> void Fl_Widget::labeltype(Fl_Labeltype)</A></H4>
|
||||
|
||||
<P>Gets or sets the <A
|
||||
href="common.html#labeltypes"><TT>labeltype</TT></A> which
|
||||
identifies the function that draws the label of the widget. This
|
||||
is generally used for special effects such as embossing or for
|
||||
using the <TT>label()</TT> pointer as another form of data such
|
||||
as an icon. The value <TT>FL_NORMAL_LABEL</TT> prints the label
|
||||
as plain text.
|
||||
|
||||
<H4><A name=Fl_Widget.align>Fl_Align Fl_Widget::align() const
|
||||
<BR> void Fl_Widget::align(Fl_Align)</A></H4>
|
||||
|
|
@ -236,42 +163,6 @@ bitwise-OR'd together:
|
|||
<LI><TT>FL_ALIGN_WRAP</TT></LI>
|
||||
</UL>
|
||||
|
||||
<H4><A name=Fl_Widget.labelcolor>Fl_Color Fl_Widget::labelcolor() const
|
||||
<BR> void Fl_Widget::labelcolor(Fl_Color)</A></H4>
|
||||
|
||||
<P>Gets or sets the label color. The default color is <TT>FL_BLACK</TT>.
|
||||
|
||||
<H4><A name=Fl_Widget.labelfont>Fl_Font Fl_Widget::labelfont() const
|
||||
<BR> void Fl_Widget::labelfont(Fl_Font)</A></H4>
|
||||
|
||||
<P>Gets or sets the font to use. Fonts are identified by small
|
||||
8-bit indexes into a table. See the <A
|
||||
href=enumerations.html#Enumerations> enumeration list</A> for
|
||||
predefined typefaces. The default value uses a Helvetica
|
||||
typeface (Arial for Microsoft® Windows®). The function
|
||||
<A href="Fl.html#Fl.set_font"><TT>Fl::set_font()</TT></A> can
|
||||
define new typefaces.
|
||||
|
||||
<H4><A name=Fl_Widget.labelsize>uchar Fl_Widget::labelsize() const
|
||||
<BR>void Fl_Widget::labelsize(uchar)</A></H4>
|
||||
|
||||
<P>Gets or sets the font size in pixels. The default size is 14
|
||||
pixels.
|
||||
|
||||
<H4><A name=Fl_Widget.callback>typedef void (Fl_Callback)(Fl_Widget*, void*)
|
||||
<BR>Fl_Callback* Fl_Widget::callback() const
|
||||
<BR>void Fl_Widget::callback(Fl_Callback*, void* = 0)
|
||||
<BR>void Fl_Widget::callback(void (*)(Fl_Widget*, long), long = 0)
|
||||
<BR>void Fl_Widget::callback(void (*)(Fl_Widget*))</A></H4>
|
||||
|
||||
<P>Gets or sets the current callback function for the widget.
|
||||
Each widget has a single callback.
|
||||
|
||||
<H4><A name=Fl_Widget.user_data>void* Fl_Widget::user_data() const
|
||||
<BR>void Fl_Widget::user_data(void*)</A></H4>
|
||||
|
||||
<P>Gets or sets the current user data (<TT>void *</TT>) argument
|
||||
that is passed to the callback function.
|
||||
|
||||
<H4><A name=Fl_Widget.argument>long Fl_Widget::argument() const
|
||||
<BR> void Fl_Widget::argument(long)</A></H4>
|
||||
|
|
@ -291,16 +182,30 @@ that is passed to the callback function.
|
|||
</TR>
|
||||
</TABLE></CENTER>
|
||||
|
||||
<H4><A name=Fl_Widget.do_callback>void Fl_Widget::do_callback()
|
||||
<BR> void Fl_Widget::do_callback(Fl_Widget*, void* = 0)
|
||||
<BR> void Fl_Widget::do_callback(Fl_Widget*, long)</A></H4>
|
||||
|
||||
<P>Causes a widget to invoke its callback function, optionally
|
||||
with arbitrary arguments.
|
||||
<H4><A name=Fl_Widget.box>Fl_Boxtype Fl_Widget::box() const
|
||||
<BR> void Fl_Widget::box(Fl_Boxtype)</A></H4>
|
||||
|
||||
<P>Gets or sets the box type for the widget, which identifies a
|
||||
routine that draws the background of the widget. See <A
|
||||
href="common.html#boxtypes">Box Types</A> for the available
|
||||
types. The default depends on the widget, but is usually
|
||||
<TT>FL_NO_BOX</TT> or <TT>FL_UP_BOX</TT>.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.callback>typedef void (Fl_Callback)(Fl_Widget*, void*)
|
||||
<BR>Fl_Callback* Fl_Widget::callback() const
|
||||
<BR>void Fl_Widget::callback(Fl_Callback*, void* = 0)
|
||||
<BR>void Fl_Widget::callback(void (*)(Fl_Widget*, long), long = 0)
|
||||
<BR>void Fl_Widget::callback(void (*)(Fl_Widget*))</A></H4>
|
||||
|
||||
<P>Gets or sets the current callback function for the widget.
|
||||
Each widget has a single callback.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.changed>int Fl_Widget::changed() const</A>
|
||||
<BR><A name=Fl_Widget.set_changed>void Fl_Widget::set_changed()</A>
|
||||
<BR><A name=Fl_Widget.clear_changed>void Fl_Widget::clear_changed()</A></H4>
|
||||
<BR><A name=Fl_Widget.clear_changed>void Fl_Widget::clear_changed()</A>
|
||||
<BR><A name=Fl_Widget.set_changed>void Fl_Widget::set_changed()</A></H4>
|
||||
|
||||
<P><TT>Fl_Widget::changed()</TT> is a flag that is turned on
|
||||
when the user changes the value stored in the widget. This is
|
||||
|
|
@ -312,16 +217,53 @@ response to an "OK" button.
|
|||
<P>Most widgets turn this flag off when they do the callback, and when
|
||||
the program sets the stored value. </P>
|
||||
|
||||
<H4><A name=Fl_Widget.when>Fl_When Fl_Widget::when() const
|
||||
<BR> void Fl_Widget::when(Fl_When)</A></H4>
|
||||
|
||||
<P><TT>Fl_Widget::when()</TT> is a set of bitflags used by
|
||||
subclasses of <TT> Fl_Widget</TT> to decide when to do the
|
||||
callback. If the value is zero then the callback is never
|
||||
done. Other values are described in the individual widgets.
|
||||
This field is in the base class so that you can scan a panel and
|
||||
<TT>do_callback()</TT> on all the ones that don't do their own
|
||||
callbacks in response to an "OK" button.
|
||||
<H4><A NAME="Fl_Widget.clear_visible">void Fl_Window::clear_visible();</A></H4>
|
||||
|
||||
<P>Hides the widget; you must still redraw the parent to see a
|
||||
change in the window. Normally you want to use the <A
|
||||
HREF="#Fl_Widget.hide"><CODE>hide()</CODE> method instead.
|
||||
|
||||
|
||||
<H4><A NAME="Fl_Widget.clear_visible_focus">void Fl_Window::clear_visible_focus();</A></H4>
|
||||
|
||||
<P>Disables keyboard focus navigation with this widget;
|
||||
normally, all widgets participate in keyboard focus navigation.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.color>Fl_Color Fl_Widget::color() const
|
||||
<BR>void Fl_Widget::color(Fl_Color)
|
||||
<BR>void Fl_Widget::color(Fl_Color, Fl_Color)</A></H4>
|
||||
|
||||
<P>Gets or sets the background color of the widget. The color is
|
||||
passed to the box routine. The color is either an index into an
|
||||
internal table of RGB colors or an RGB color value generated
|
||||
using <TT>fl_rgb_color()</TT>. The default for most widgets is
|
||||
<TT>FL_GRAY</TT>. See the <A
|
||||
href=enumerations.html#Enumerations>enumeration list</A> for
|
||||
predefined colors. Use <A
|
||||
href="Fl.html#Fl.set_color"><TT>Fl::set_color()</TT></A> to
|
||||
redefine colors.
|
||||
|
||||
<P>The two color form sets both the background and selection
|
||||
colors. See the description of the <A
|
||||
HREF="#Fl_Widget.selection_color"><TT>selection_color()</TT></A>
|
||||
method for more information.
|
||||
|
||||
|
||||
<h4><a name="Fl_Widget.contains">int Fl_Widget::contains(Fl_Widget* b) const</A></H4>
|
||||
|
||||
<P>Returns 1 if <TT>b</TT> is a child of this widget, or is
|
||||
equal to this widget. Returns 0 if <TT>b</TT> is <TT>NULL</TT>.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.damage>uchar Fl_Widget::damage() const</A></H4>
|
||||
|
||||
<P>Non-zero if <A
|
||||
HREF="subclassing.html#draw"><TT>draw()</TT></A> needs to be
|
||||
called. The damage value is actually a bit field that the widget
|
||||
subclass can use to figure out what parts to draw.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.default_callback>static void
|
||||
Fl_Widget::default_callback(Fl_Widget*, void*)</A></H4>
|
||||
|
|
@ -331,6 +273,216 @@ the queue returned by <A
|
|||
href="Fl.html#Fl.readqueue"><TT>Fl::readqueue()</TT></A>. You
|
||||
may want to call this from your own callback.
|
||||
|
||||
|
||||
<H4><A name="Fl_Widget.deimage">Fl_Image* Fl_Widget::deimage()</A><BR>
|
||||
void Fl_Widget::deimage(Fl_Image* a)<BR>
|
||||
void Fl_Widget::deimage(Fl_Image& a)</H4>
|
||||
|
||||
<P>Gets or sets the image to use as part of the widget label.
|
||||
This image is used when drawing the widget in the inactive
|
||||
state.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.do_callback>void Fl_Widget::do_callback()
|
||||
<BR> void Fl_Widget::do_callback(Fl_Widget*, void* = 0)
|
||||
<BR> void Fl_Widget::do_callback(Fl_Widget*, long)</A></H4>
|
||||
|
||||
<P>Causes a widget to invoke its callback function, optionally
|
||||
with arbitrary arguments.
|
||||
|
||||
|
||||
<H4><A name="Fl_Widget.handle">virtual int Fl_Widget::handle(int event)</A></H4>
|
||||
|
||||
<P>Handles the specified event. You normally don't call this
|
||||
method directly, but instead let FLTK do it when the user
|
||||
interacts with the widget.
|
||||
|
||||
|
||||
<H4><A name="Fl_Widget.image">Fl_Image* Fl_Widget::image()</A><BR>
|
||||
void Fl_Widget::image(Fl_Image* a)<BR>
|
||||
void Fl_Widget::image(Fl_Image& a)</H4>
|
||||
|
||||
<P>Gets or sets the image to use as part of the widget label.
|
||||
This image is used when drawing the widget in the active state.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.inside>int Fl_Widget::inside(const Fl_Widget* a)
|
||||
const</A></H4>
|
||||
|
||||
<P>Returns 1 if this widget is a child of <TT>a</TT>, or is
|
||||
equal to <TT>a</TT>. Returns 0 if <TT>a</TT> is <TT>NULL</TT>.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.label>const char* Fl_Widget::label() const
|
||||
<BR> void Fl_Widget::label(const char*)</A></H4>
|
||||
|
||||
<P>Get or set the current label pointer. The label is shown
|
||||
somewhere on or next to the widget. The passed pointer is stored
|
||||
unchanged in the widget (the string is <I>not</I> copied), so if
|
||||
you need to set the label to a formatted value, make sure the
|
||||
buffer is <TT>static</TT>, global, or allocated.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.labelcolor>Fl_Color Fl_Widget::labelcolor() const
|
||||
<BR> void Fl_Widget::labelcolor(Fl_Color)</A></H4>
|
||||
|
||||
<P>Gets or sets the label color. The default color is <TT>FL_BLACK</TT>.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.labelfont>Fl_Font Fl_Widget::labelfont() const
|
||||
<BR> void Fl_Widget::labelfont(Fl_Font)</A></H4>
|
||||
|
||||
<P>Gets or sets the font to use. Fonts are identified by small
|
||||
8-bit indexes into a table. See the <A
|
||||
href=enumerations.html#Enumerations> enumeration list</A> for
|
||||
predefined typefaces. The default value uses a Helvetica
|
||||
typeface (Arial for Microsoft® Windows®). The function
|
||||
<A href="Fl.html#Fl.set_font"><TT>Fl::set_font()</TT></A> can
|
||||
define new typefaces.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.labelsize>uchar Fl_Widget::labelsize() const
|
||||
<BR>void Fl_Widget::labelsize(uchar)</A></H4>
|
||||
|
||||
<P>Gets or sets the font size in pixels. The default size is 14
|
||||
pixels.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.labeltype>void Fl_Widget::label(Fl_Labeltype,
|
||||
const char*)
|
||||
<BR> uchar Fl_Widget::labeltype() const
|
||||
<BR> void Fl_Widget::labeltype(Fl_Labeltype)</A></H4>
|
||||
|
||||
<P>Gets or sets the <A
|
||||
href="common.html#labeltypes"><TT>labeltype</TT></A> which
|
||||
identifies the function that draws the label of the widget. This
|
||||
is generally used for special effects such as embossing or for
|
||||
using the <TT>label()</TT> pointer as another form of data such
|
||||
as an icon. The value <TT>FL_NORMAL_LABEL</TT> prints the label
|
||||
as plain text.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.output>int Fl_Widget::output() const</A>
|
||||
<BR><A name=Fl_Widget.clear_output>void Fl_Widget::clear_output()</A>
|
||||
<BR><A name=Fl_Widget.set_output>void Fl_Widget::set_output()</A></H4>
|
||||
|
||||
<P><tt>output()</tt> means the same as <tt>!active()</tt> except
|
||||
it does not change how the widget is drawn. The widget will not
|
||||
receive any events. This is useful for making scrollbars or
|
||||
buttons that work as displays rather than input devices.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.parent>Fl_Group *Fl_Widget::parent() const</A></H4>
|
||||
|
||||
<P>Returns a pointer to the parent widget. Usually this is a <A
|
||||
href=Fl_Group.html#Fl_Group> <TT>Fl_Group</TT></A> or <A
|
||||
HREF="Fl_Window.html#Fl_Window"><tt>Fl_Window</tt></a>. Returns
|
||||
<tt>NULL</tt> if the widget has no parent.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.redraw>void Fl_Widget::redraw()</A></H4>
|
||||
|
||||
<P>Marks the widget as needing its <A
|
||||
HREF="subclassing.html#draw"><TT>draw()</TT></A> routine called.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.resize>virtual void
|
||||
Fl_Widget::resize(int x, int y, int w, int h)</A>
|
||||
<BR><A name=Fl_Widget.position>void Fl_Widget::position(short x, short y)</A>
|
||||
<BR><A name=Fl_Widget.size>void Fl_Widget::size(short w, short h)</A></H4>
|
||||
|
||||
<P>Change the size or position of the widget. This is a virtual
|
||||
function so that the widget may implement its own handling of
|
||||
resizing. The default version does <I>not</I> call the
|
||||
<TT>redraw()</TT> method, but instead relies on the parent
|
||||
widget to do so because the parent may know a faster way to
|
||||
update the display, such as scrolling from the old position.
|
||||
|
||||
<P><TT>position(x,y)</TT> is a shortcut for <TT>resize(x,y,w(),h())</TT>,
|
||||
and <TT>size(w,h)</TT> is a shortcut for <TT>resize(x(),y(),w,h)</TT>.</P>
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.selection_color>Fl_Color
|
||||
Fl_Widget::selection_color() const
|
||||
<BR>void Fl_Widget::selection_color(Fl_Color)</A></H4>
|
||||
|
||||
<P>Gets or sets the selection color, which is defined for Forms
|
||||
compatibility and is usually used to color the widget when it is
|
||||
selected, although some widgets use this color for other
|
||||
purposes. You can set both colors at once with
|
||||
<TT>color(a,b)</TT>.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.takesevents>int Fl_Widget::takesevents() const</A></H4>
|
||||
|
||||
<P>This is the same as <TT>(active() && !output()
|
||||
&& visible())</TT> but is faster.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.take_focus>int Fl_Widget::take_focus()</A></H4>
|
||||
Tries to make this widget be the <TT>Fl::focus()</TT> widget, by first
|
||||
sending it an <TT>FL_FOCUS</TT> event, and if it returns non-zero,
|
||||
setting <TT>Fl::focus()</TT> to this widget. You should use this
|
||||
method to assign the focus to an widget. Returns true if the widget
|
||||
accepted the focus.
|
||||
|
||||
|
||||
<H4><A name="Fl_Widget.tooltip">const char *Fl_Widget::tooltip()<BR>
|
||||
void Fl_Widget::tooltip(const char *t)</A></H4>
|
||||
|
||||
<P>Gets or sets a string of text to display in a popup tooltip
|
||||
window when the user hovers the mouse over the widget. The
|
||||
string is <I>not</I> copied, so make sure any formatted string
|
||||
is stored in a <TT>static</TT>, global, or allocated buffer.
|
||||
|
||||
|
||||
<H4><A NAME="Fl_Widget.type">uchar Fl_Widget::type() const;</A></H4>
|
||||
|
||||
<P>Returns the widget type value, which is used for Forms
|
||||
compatability and to simulate RTTI.
|
||||
|
||||
<H4><A name=Fl_Widget.x>short Fl_Widget::x() const</A>
|
||||
<BR><A name=Fl_Widget.y>short Fl_Widget::y() const</A>
|
||||
<BR><A name=Fl_Widget.w>short Fl_Widget::w() const</A>
|
||||
<BR><A name=Fl_Widget.h>short Fl_Widget::h() const</A></H4>
|
||||
|
||||
<P>Returns the position of the upper-left corner of the widget
|
||||
in its enclosing Fl_Window (<I>not</I> its parent if that is not
|
||||
an Fl_Window), and its width and height.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.user_data>void* Fl_Widget::user_data() const
|
||||
<BR>void Fl_Widget::user_data(void*)</A></H4>
|
||||
|
||||
<P>Gets or sets the current user data (<TT>void *</TT>) argument
|
||||
that is passed to the callback function.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.window>Fl_Window* Fl_Widget::window() const;</A></H4>
|
||||
|
||||
<P>Returns a pointer to the primary <A
|
||||
href=Fl_Window.html#Fl_Window><TT>Fl_Window</TT></A> widget.
|
||||
Returns <TT>NULL</TT> if no window is associated with this
|
||||
widget. Note: for an <TT>Fl_Window</TT> widget, this returns
|
||||
its <I>parent</I> window (if any), not <I>this</I> window.
|
||||
|
||||
|
||||
<H4><A NAME="Fl_Widget.set_visible">void Fl_Window::set_visible();</A></H4>
|
||||
|
||||
<P>Makes the widget visible; you must still redraw the parent
|
||||
widget to see a change in the window. Normally you want to use
|
||||
the <A HREF="#Fl_Widget.show"><CODE>show()</CODE> method
|
||||
instead.
|
||||
|
||||
|
||||
<H4><A NAME="Fl_Widget.set_visible_focus">void Fl_Window::set_visible_focus();</A></H4>
|
||||
|
||||
<P>Enables keyboard focus navigation with this widget; note,
|
||||
however, that this will not necessarily mean that the widget
|
||||
will accept focus, but for widgets that can accept focus, this
|
||||
method enables it if it has been disabled.
|
||||
|
||||
|
||||
<H4><A name=Fl_Widget.visible>int Fl_Widget::visible() const</A><BR>
|
||||
<A name=Fl_Widget.visible_r>int Fl_Widget::visible_r() const</A><BR>
|
||||
<A name=Fl_Widget.show>void Fl_Widget::show()</A><BR>
|
||||
|
|
@ -349,101 +501,23 @@ visible, as this will send false <TT>FL_SHOW</TT> or <TT>FL_HIDE</TT>
|
|||
events to the widget</I>. <TT>redraw()</TT> is called if necessary on
|
||||
this or the parent.
|
||||
|
||||
<H4><A name=Fl_Widget.active>int Fl_Widget::active() const</A><BR>
|
||||
<A name=Fl_Widget.active_r>int Fl_Widget::active_r() const</A></BR>
|
||||
<A name=Fl_Widget.activate>void Fl_Widget::activate()</A></BR>
|
||||
<A name=Fl_Widget.deactivate>void Fl_Widget::deactivate()</A></H4>
|
||||
<H4><A NAME="Fl_Widget.visible_focus">void Fl_Window::visible_focus();</A></H4>
|
||||
|
||||
<P><TT>Fl_Widget::active()</TT> returns whether the widget is
|
||||
active. <TT>Fl_Widget::active_r()</TT> returns whether the
|
||||
widget and all of its parents are active. An inactive widget
|
||||
does not get any events, but it does get redrawn. A widget is
|
||||
only active if <TT>active()</TT> is true on it <I>and all of its
|
||||
parents</I>.
|
||||
<P>Returns non-zero if this widget will participate in keyboard
|
||||
focus navigation.
|
||||
|
||||
<P>Changing this value will send <TT>FL_ACTIVATE</TT> or <TT>
|
||||
FL_DEACTIVATE</TT> to the widget if <tt>active_r()</tt> is true.
|
||||
<P>Currently you cannot deactivate <TT>Fl_Window</TT> widgets. </P>
|
||||
|
||||
<H4><A name=Fl_Widget.output>int Fl_Widget::output() const</A><BR>
|
||||
<A name=Fl_Widget.set_output>void Fl_Widget::set_output()</A></BR>
|
||||
<A name=Fl_Widget.clear_output>void Fl_Widget::clear_output()</A></H4>
|
||||
<H4><A name=Fl_Widget.when>Fl_When Fl_Widget::when() const
|
||||
<BR> void Fl_Widget::when(Fl_When)</A></H4>
|
||||
|
||||
<P><tt>output()</tt> means the same as <tt>!active()</tt> except
|
||||
it does not change how the widget is drawn. The widget will not
|
||||
receive any events. This is useful for making scrollbars or
|
||||
buttons that work as displays rather than input devices.
|
||||
<P><TT>Fl_Widget::when()</TT> is a set of bitflags used by
|
||||
subclasses of <TT> Fl_Widget</TT> to decide when to do the
|
||||
callback. If the value is zero then the callback is never
|
||||
done. Other values are described in the individual widgets.
|
||||
This field is in the base class so that you can scan a panel and
|
||||
<TT>do_callback()</TT> on all the ones that don't do their own
|
||||
callbacks in response to an "OK" button.
|
||||
|
||||
<H4><A name=Fl_Widget.takesevents>int Fl_Widget::takesevents() const</A></H4>
|
||||
|
||||
<P>This is the same as <TT>(active() && !output()
|
||||
&& visible())</TT> but is faster.
|
||||
|
||||
<H4><A name=Fl_Widget.redraw>void Fl_Widget::redraw()</A></H4>
|
||||
|
||||
<P>Marks the widget as needing its <A
|
||||
HREF="subclassing.html#draw"><TT>draw()</TT></A> routine called.
|
||||
|
||||
<H4><A name=Fl_Widget.damage>uchar Fl_Widget::damage() const</A></H4>
|
||||
|
||||
<P>Non-zero if <A
|
||||
HREF="subclassing.html#draw"><TT>draw()</TT></A> needs to be
|
||||
called. The damage value is actually a bit field that the widget
|
||||
subclass can use to figure out what parts to draw.
|
||||
|
||||
<H4><A name=Fl_Widget.parent>Fl_Group *Fl_Widget::parent() const</A></H4>
|
||||
|
||||
<P>Returns a pointer to the parent widget. Usually this is a <A
|
||||
href=Fl_Group.html#Fl_Group> <TT>Fl_Group</TT></A> or <A
|
||||
HREF="Fl_Window.html#Fl_Window"><tt>Fl_Window</tt></a>. Returns
|
||||
<tt>NULL</tt> if the widget has no parent.
|
||||
|
||||
<h4><a name="Fl_Widget.contains">int Fl_Widget::contains(Fl_Widget* b) const</A></H4>
|
||||
|
||||
<P>Returns 1 if <TT>b</TT> is a child of this widget, or is
|
||||
equal to this widget. Returns 0 if <TT>b</TT> is <TT>NULL</TT>.
|
||||
|
||||
<H4><A name=Fl_Widget.inside>int Fl_Widget::inside(const Fl_Widget* a)
|
||||
const</A></H4>
|
||||
|
||||
<P>Returns 1 if this widget is a child of <TT>a</TT>, or is
|
||||
equal to <TT>a</TT>. Returns 0 if <TT>a</TT> is <TT>NULL</TT>.
|
||||
|
||||
<H4><A name=Fl_Widget.take_focus>int Fl_Widget::take_focus()</A></H4>
|
||||
Tries to make this widget be the <TT>Fl::focus()</TT> widget, by first
|
||||
sending it an <TT>FL_FOCUS</TT> event, and if it returns non-zero,
|
||||
setting <TT>Fl::focus()</TT> to this widget. You should use this
|
||||
method to assign the focus to an widget. Returns true if the widget
|
||||
accepted the focus.
|
||||
|
||||
<H4><A name="Fl_Widget.deimage">Fl_Image* Fl_Widget::deimage()</A><BR>
|
||||
void Fl_Widget::deimage(Fl_Image* a)<BR>
|
||||
void Fl_Widget::deimage(Fl_Image& a)</H4>
|
||||
|
||||
<P>Gets or sets the image to use as part of the widget label.
|
||||
This image is used when drawing the widget in the inactive
|
||||
state.
|
||||
|
||||
<H4><A name="Fl_Widget.image">Fl_Image* Fl_Widget::image()</A><BR>
|
||||
void Fl_Widget::image(Fl_Image* a)<BR>
|
||||
void Fl_Widget::image(Fl_Image& a)</H4>
|
||||
|
||||
<P>Gets or sets the image to use as part of the widget label.
|
||||
This image is used when drawing the widget in the active state.
|
||||
|
||||
<H4><A name="Fl_Widget.tooltip">const char *Fl_Widget::tooltip()<BR>
|
||||
void Fl_Widget::tooltip(const char *t)</A></H4>
|
||||
|
||||
<P>Gets or sets a string of text to display in a popup tooltip
|
||||
window when the user hovers the mouse over the widget. The
|
||||
string is <I>not</I> copied, so make sure any formatted string
|
||||
is stored in a <TT>static</TT>, global, or allocated buffer.
|
||||
|
||||
<H4><A name="Fl_Widget.handle">virtual int Fl_Widget::handle(int event)</A></H4>
|
||||
|
||||
<P>Handles the specified event. You normally don't call this
|
||||
method directly, but instead let FLTK do it when the user
|
||||
interacts with the widget.
|
||||
|
||||
</BODY>
|
||||
</HTML>
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
//
|
||||
// "$Id: Fl.cxx,v 1.24.2.41.2.42 2002/07/11 01:10:15 matthiaswm Exp $"
|
||||
// "$Id: Fl.cxx,v 1.24.2.41.2.43 2002/07/23 15:07:33 easysw Exp $"
|
||||
//
|
||||
// Main event handling code for the Fast Light Tool Kit (FLTK).
|
||||
//
|
||||
|
|
@ -419,6 +419,7 @@ static int send_handlers(int event) {
|
|||
Fl_Widget* fl_oldfocus; // kludge for Fl_Group...
|
||||
|
||||
void Fl::focus(Fl_Widget *o) {
|
||||
if (o && !o->visible_focus()) return;
|
||||
if (grab()) return; // don't do anything while grab is on
|
||||
Fl_Widget *p = focus_;
|
||||
if (o != p) {
|
||||
|
|
@ -948,5 +949,5 @@ void Fl_Window::flush() {
|
|||
}
|
||||
|
||||
//
|
||||
// End of "$Id: Fl.cxx,v 1.24.2.41.2.42 2002/07/11 01:10:15 matthiaswm Exp $".
|
||||
// End of "$Id: Fl.cxx,v 1.24.2.41.2.43 2002/07/23 15:07:33 easysw Exp $".
|
||||
//
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
//
|
||||
// "$Id: Fl_Input_.cxx,v 1.21.2.11.2.13 2002/07/20 05:56:44 easysw Exp $"
|
||||
// "$Id: Fl_Input_.cxx,v 1.21.2.11.2.14 2002/07/23 15:07:33 easysw Exp $"
|
||||
//
|
||||
// Common input widget routines for the Fast Light Tool Kit (FLTK).
|
||||
//
|
||||
|
|
@ -233,7 +233,7 @@ void Fl_Input_::drawtext(int X, int Y, int W, int H) {
|
|||
p = value();
|
||||
// visit each line and draw it:
|
||||
int desc = height-fl_descent();
|
||||
int xpos = X-xscroll_; if (W > 12) xpos += 3;
|
||||
int xpos = X - xscroll_ + 1;
|
||||
int ypos = -yscroll_;
|
||||
for (; ypos < H;) {
|
||||
|
||||
|
|
@ -872,5 +872,5 @@ Fl_Input_::~Fl_Input_() {
|
|||
}
|
||||
|
||||
//
|
||||
// End of "$Id: Fl_Input_.cxx,v 1.21.2.11.2.13 2002/07/20 05:56:44 easysw Exp $".
|
||||
// End of "$Id: Fl_Input_.cxx,v 1.21.2.11.2.14 2002/07/23 15:07:33 easysw Exp $".
|
||||
//
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
//
|
||||
// "$Id: Fl_Widget.cxx,v 1.5.2.4.2.18 2002/06/02 17:52:36 easysw Exp $"
|
||||
// "$Id: Fl_Widget.cxx,v 1.5.2.4.2.19 2002/07/23 15:07:33 easysw Exp $"
|
||||
//
|
||||
// Base widget class for the Fast Light Tool Kit (FLTK).
|
||||
//
|
||||
|
|
@ -89,7 +89,7 @@ Fl_Widget::Fl_Widget(int X, int Y, int W, int H, const char* L) {
|
|||
callback_ = default_callback;
|
||||
user_data_ = 0;
|
||||
type_ = 0;
|
||||
flags_ = 0;
|
||||
flags_ = VISIBLE_FOCUS;
|
||||
damage_ = 0;
|
||||
box_ = FL_NO_BOX;
|
||||
color_ = FL_GRAY;
|
||||
|
|
@ -115,6 +115,7 @@ int Fl_Widget::damage_resize(int X, int Y, int W, int H) {
|
|||
|
||||
int Fl_Widget::take_focus() {
|
||||
if (!takesevents()) return 0;
|
||||
if (!visible_focus()) return 0;
|
||||
if (!handle(FL_FOCUS)) return 0; // see if it wants it
|
||||
if (contains(Fl::focus())) return 1; // it called Fl::focus for us
|
||||
Fl::focus(this);
|
||||
|
|
@ -241,5 +242,5 @@ int Fl_Widget::contains(const Fl_Widget *o) const {
|
|||
}
|
||||
|
||||
//
|
||||
// End of "$Id: Fl_Widget.cxx,v 1.5.2.4.2.18 2002/06/02 17:52:36 easysw Exp $".
|
||||
// End of "$Id: Fl_Widget.cxx,v 1.5.2.4.2.19 2002/07/23 15:07:33 easysw Exp $".
|
||||
//
|
||||
|
|
|
|||
Loading…
Reference in New Issue