mirror of https://github.com/fltk/fltk
498 lines
18 KiB
C++
498 lines
18 KiB
C++
//
|
|
// "$Id$"
|
|
//
|
|
// Window header file for the Fast Light Tool Kit (FLTK).
|
|
//
|
|
// Copyright 1998-2012 by Bill Spitzak and others.
|
|
//
|
|
// This library is free software. Distribution and use rights are outlined in
|
|
// the file "COPYING" which should have been included with this file. If this
|
|
// file is missing or damaged, see the license at:
|
|
//
|
|
// http://www.fltk.org/COPYING.php
|
|
//
|
|
// Please report all bugs and problems on the following page:
|
|
//
|
|
// http://www.fltk.org/str.php
|
|
//
|
|
|
|
/* \file
|
|
Fl_Window widget . */
|
|
|
|
#ifndef Fl_Window_H
|
|
#define Fl_Window_H
|
|
|
|
#include "Fl_Group.H"
|
|
|
|
#define FL_WINDOW 0xF0 ///< window type id all subclasses have type() >= this
|
|
#define FL_DOUBLE_WINDOW 0xF1 ///< double window type id
|
|
|
|
class Fl_X;
|
|
|
|
/**
|
|
This widget produces an actual window. This can either be a main
|
|
window, with a border and title and all the window management controls,
|
|
or a "subwindow" inside a window. This is controlled by whether or not
|
|
the window has a parent().
|
|
|
|
Once you create a window, you usually add children Fl_Widget
|
|
's to it by using window->add(child) for each new widget.
|
|
See Fl_Group for more information on how to add and remove children.
|
|
|
|
There are several subclasses of Fl_Window that provide
|
|
double-buffering, overlay, menu, and OpenGL support.
|
|
|
|
The window's callback is done if the user tries to close a window
|
|
using the window manager and Fl::modal() is zero or equal to the
|
|
window. Fl_Window has a default callback that calls Fl_Window::hide().
|
|
*/
|
|
class FL_EXPORT Fl_Window : public Fl_Group {
|
|
|
|
static char *default_xclass_;
|
|
// Note: we must use separate statements for each of the following 4 variables,
|
|
// with the static attribute, otherwise MS VC++ 2008/2010 complains :-(
|
|
// AlbrechtS 04/2012
|
|
#if FLTK_ABI_VERSION < 10301
|
|
static // when these members are static, ABI compatibility with 1.3.0 is respected
|
|
#endif
|
|
int no_fullscreen_x;
|
|
#if FLTK_ABI_VERSION < 10301
|
|
static // when these members are static, ABI compatibility with 1.3.0 is respected
|
|
#endif
|
|
int no_fullscreen_y;
|
|
#if FLTK_ABI_VERSION < 10301
|
|
static // when these members are static, ABI compatibility with 1.3.0 is respected
|
|
#endif
|
|
int no_fullscreen_w;
|
|
#if FLTK_ABI_VERSION < 10301
|
|
static // when these members are static, ABI compatibility with 1.3.0 is respected
|
|
#endif
|
|
int no_fullscreen_h;
|
|
|
|
friend class Fl_X;
|
|
Fl_X *i; // points at the system-specific stuff
|
|
|
|
const char* iconlabel_;
|
|
char* xclass_;
|
|
const void* icon_;
|
|
// size_range stuff:
|
|
int minw, minh, maxw, maxh;
|
|
int dw, dh, aspect;
|
|
uchar size_range_set;
|
|
// cursor stuff
|
|
Fl_Cursor cursor_default;
|
|
Fl_Color cursor_fg, cursor_bg;
|
|
void size_range_();
|
|
void _Fl_Window(); // constructor innards
|
|
void fullscreen_x(); // platform-specific part of sending a window to full screen
|
|
void fullscreen_off_x(int X, int Y, int W, int H);// platform-specific part of leaving full screen
|
|
|
|
// unimplemented copy ctor and assignment operator
|
|
Fl_Window(const Fl_Window&);
|
|
Fl_Window& operator=(const Fl_Window&);
|
|
|
|
protected:
|
|
|
|
/** Stores the last window that was made current. See current() const */
|
|
static Fl_Window *current_;
|
|
virtual void draw();
|
|
/** Forces the window to be drawn, this window is also made current and calls draw(). */
|
|
virtual void flush();
|
|
|
|
/**
|
|
Sets an internal flag that tells FLTK and the window manager to
|
|
honor position requests.
|
|
|
|
This is used internally and should not be needed by user code.
|
|
|
|
\param[in] force 1 to set the FORCE_POSITION flag, 0 to clear it
|
|
*/
|
|
void force_position(int force) {
|
|
if (force) set_flag(FORCE_POSITION);
|
|
else clear_flag(FORCE_POSITION);
|
|
}
|
|
/**
|
|
Returns the internal state of the window's FORCE_POSITION flag.
|
|
|
|
\retval 1 if flag is set
|
|
\retval 0 otherwise
|
|
|
|
\see force_position(int)
|
|
*/
|
|
int force_position() const { return ((flags() & FORCE_POSITION)?1:0); }
|
|
|
|
public:
|
|
|
|
/**
|
|
Creates a window from the given size and title.
|
|
If Fl_Group::current() is not NULL, the window is created as a
|
|
subwindow of the parent window.
|
|
|
|
The (w,h) form of the constructor creates a top-level window
|
|
and asks the window manager to position the window. The (x,y,w,h)
|
|
form of the constructor either creates a subwindow or a
|
|
top-level window at the specified location (x,y) , subject to window
|
|
manager configuration. If you do not specify the position of the
|
|
window, the window manager will pick a place to show the window
|
|
or allow the user to pick a location. Use position(x,y)
|
|
or hotspot() before calling show() to request a
|
|
position on the screen. See Fl_Window::resize()
|
|
for some more details on positioning windows.
|
|
|
|
Top-level windows initially have visible() set to 0
|
|
and parent() set to NULL. Subwindows initially
|
|
have visible() set to 1 and parent() set to
|
|
the parent window pointer.
|
|
|
|
Fl_Widget::box() defaults to FL_FLAT_BOX. If you plan to
|
|
completely fill the window with children widgets you should
|
|
change this to FL_NO_BOX. If you turn the window border off
|
|
you may want to change this to FL_UP_BOX.
|
|
|
|
\see Fl_Window(int x, int y, int w, int h, const char* title)
|
|
*/
|
|
Fl_Window(int w, int h, const char* title= 0);
|
|
/** Creates a window from the given position, size and title.
|
|
|
|
\see Fl_Window(int w, int h, const char *title)
|
|
*/
|
|
Fl_Window(int x, int y, int w, int h, const char* title = 0);
|
|
/**
|
|
The destructor <I>also deletes all the children</I>. This allows a
|
|
whole tree to be deleted at once, without having to keep a pointer to
|
|
all the children in the user code. A kludge has been done so the
|
|
Fl_Window and all of its children can be automatic (local)
|
|
variables, but you must declare the Fl_Window <I>first</I> so
|
|
that it is destroyed last.
|
|
*/
|
|
virtual ~Fl_Window();
|
|
|
|
virtual int handle(int);
|
|
|
|
/**
|
|
Changes the size and position of the window. If shown() is true,
|
|
these changes are communicated to the window server (which may
|
|
refuse that size and cause a further resize). If shown() is
|
|
false, the size and position are used when show() is called.
|
|
See Fl_Group for the effect of resizing on the child widgets.
|
|
|
|
You can also call the Fl_Widget methods size(x,y) and position(w,h),
|
|
which are inline wrappers for this virtual function.
|
|
|
|
A top-level window can not force, but merely suggest a position and
|
|
size to the operating system. The window manager may not be willing or
|
|
able to display a window at the desired position or with the given
|
|
dimensions. It is up to the application developer to verify window
|
|
parameters after the resize request.
|
|
*/
|
|
virtual void resize(int X,int Y,int W,int H);
|
|
/**
|
|
Sets whether or not the window manager border is around the
|
|
window. The default value is true. void border(int) can be
|
|
used to turn the border on and off. <I>Under most X window
|
|
managers this does not work after show() has been called,
|
|
although SGI's 4DWM does work.</I>
|
|
*/
|
|
void border(int b);
|
|
/**
|
|
Fast inline function to turn the window manager border
|
|
off. It only works before show() is called.
|
|
*/
|
|
void clear_border() {set_flag(NOBORDER);}
|
|
/** See void Fl_Window::border(int) */
|
|
unsigned int border() const {return !(flags() & NOBORDER);}
|
|
/** Activates the flags NOBORDER|FL_OVERRIDE */
|
|
void set_override() {set_flag(NOBORDER|OVERRIDE);}
|
|
/** Returns non zero if FL_OVERRIDE flag is set, 0 otherwise. */
|
|
unsigned int override() const { return flags()&OVERRIDE; }
|
|
/**
|
|
A "modal" window, when shown(), will prevent any events from
|
|
being delivered to other windows in the same program, and will also
|
|
remain on top of the other windows (if the X window manager supports
|
|
the "transient for" property). Several modal windows may be shown at
|
|
once, in which case only the last one shown gets events. You can see
|
|
which window (if any) is modal by calling Fl::modal().
|
|
*/
|
|
void set_modal() {set_flag(MODAL);}
|
|
/** Returns true if this window is modal. */
|
|
unsigned int modal() const {return flags() & MODAL;}
|
|
/**
|
|
A "non-modal" window (terminology borrowed from Microsoft Windows)
|
|
acts like a modal() one in that it remains on top, but it has
|
|
no effect on event delivery. There are <I>three</I> states for a
|
|
window: modal, non-modal, and normal.
|
|
*/
|
|
void set_non_modal() {set_flag(NON_MODAL);}
|
|
/** Returns true if this window is modal or non-modal. */
|
|
unsigned int non_modal() const {return flags() & (NON_MODAL|MODAL);}
|
|
|
|
/**
|
|
Marks the window as a menu window.
|
|
|
|
This is intended for internal use, but it can also be used if you
|
|
write your own menu handling. However, this is not recommended.
|
|
|
|
This flag is used for correct "parenting" of windows in communication
|
|
with the windowing system. Modern X window managers can use different
|
|
flags to distinguish menu and tooltip windows from normal windows.
|
|
|
|
This must be called before the window is shown and cannot be changed
|
|
later.
|
|
*/
|
|
void set_menu_window() {set_flag(MENU_WINDOW);}
|
|
|
|
/** Returns true if this window is a menu window. */
|
|
unsigned int menu_window() const {return flags() & MENU_WINDOW;}
|
|
|
|
/**
|
|
Marks the window as a tooltip window.
|
|
|
|
This is intended for internal use, but it can also be used if you
|
|
write your own tooltip handling. However, this is not recommended.
|
|
|
|
This flag is used for correct "parenting" of windows in communication
|
|
with the windowing system. Modern X window managers can use different
|
|
flags to distinguish menu and tooltip windows from normal windows.
|
|
|
|
This must be called before the window is shown and cannot be changed
|
|
later.
|
|
|
|
\note Since Fl_Tooltip_Window is derived from Fl_Menu_Window, this
|
|
also \b clears the menu_window() state.
|
|
*/
|
|
void set_tooltip_window() { set_flag(TOOLTIP_WINDOW);
|
|
clear_flag(MENU_WINDOW); }
|
|
/** Returns true if this window is a tooltip window. */
|
|
unsigned int tooltip_window() const {return flags() & TOOLTIP_WINDOW;}
|
|
|
|
/**
|
|
Positions the window so that the mouse is pointing at the given
|
|
position, or at the center of the given widget, which may be the
|
|
window itself. If the optional offscreen parameter is
|
|
non-zero, then the window is allowed to extend off the screen (this
|
|
does not work with some X window managers). \see position()
|
|
*/
|
|
void hotspot(int x, int y, int offscreen = 0);
|
|
/** See void Fl_Window::hotspot(int x, int y, int offscreen = 0) */
|
|
void hotspot(const Fl_Widget*, int offscreen = 0);
|
|
/** See void Fl_Window::hotspot(int x, int y, int offscreen = 0) */
|
|
void hotspot(const Fl_Widget& p, int offscreen = 0) {hotspot(&p,offscreen);}
|
|
|
|
/**
|
|
Undoes the effect of a previous resize() or show() so that the next time
|
|
show() is called the window manager is free to position the window.
|
|
|
|
This is for Forms compatibility only.
|
|
|
|
\deprecated please use force_position(0) instead
|
|
*/
|
|
void free_position() {clear_flag(FORCE_POSITION);}
|
|
/**
|
|
Sets the allowable range the user can resize this window to.
|
|
This only works for top-level windows.
|
|
<UL>
|
|
<LI>\p minw and \p minh are the smallest the window can be.
|
|
Either value must be greater than 0.</LI>
|
|
<LI>\p maxw and \p maxh are the largest the window can be. If either is
|
|
<I>equal</I> to the minimum then you cannot resize in that direction.
|
|
If either is zero then FLTK picks a maximum size in that direction
|
|
such that the window will fill the screen.</LI>
|
|
<LI>\p dw and \p dh are size increments. The window will be constrained
|
|
to widths of minw + N * dw, where N is any non-negative integer.
|
|
If these are less or equal to 1 they are ignored (this is ignored
|
|
on WIN32).</LI>
|
|
<LI>\p aspect is a flag that indicates that the window should preserve its
|
|
aspect ratio. This only works if both the maximum and minimum have
|
|
the same aspect ratio (ignored on WIN32 and by many X window managers).
|
|
</LI>
|
|
</UL>
|
|
|
|
If this function is not called, FLTK tries to figure out the range
|
|
from the setting of resizable():
|
|
<UL>
|
|
<LI>If resizable() is NULL (this is the default) then the window cannot
|
|
be resized and the resize border and max-size control will not be
|
|
displayed for the window.</LI>
|
|
<LI>If either dimension of resizable() is less than 100, then that is
|
|
considered the minimum size. Otherwise the resizable() has a minimum
|
|
size of 100.</LI>
|
|
<LI>If either dimension of resizable() is zero, then that is also the
|
|
maximum size (so the window cannot resize in that direction).</LI>
|
|
</UL>
|
|
|
|
It is undefined what happens if the current size does not fit in the
|
|
constraints passed to size_range().
|
|
*/
|
|
void size_range(int minw, int minh, int maxw=0, int maxh=0, int dw=0, int dh=0, int aspect=0) {
|
|
this->minw = minw;
|
|
this->minh = minh;
|
|
this->maxw = maxw;
|
|
this->maxh = maxh;
|
|
this->dw = dw;
|
|
this->dh = dh;
|
|
this->aspect = aspect;
|
|
size_range_();
|
|
}
|
|
|
|
/** See void Fl_Window::label(const char*) */
|
|
const char* label() const {return Fl_Widget::label();}
|
|
/** See void Fl_Window::iconlabel(const char*) */
|
|
const char* iconlabel() const {return iconlabel_;}
|
|
/** Sets the window title bar label. */
|
|
void label(const char*);
|
|
/** Sets the icon label. */
|
|
void iconlabel(const char*);
|
|
/** Sets the icon label. */
|
|
void label(const char* label, const char* iconlabel); // platform dependent
|
|
void copy_label(const char* a);
|
|
|
|
static void default_xclass(const char*);
|
|
static const char *default_xclass();
|
|
const char* xclass() const;
|
|
void xclass(const char* c);
|
|
const void* icon() const;
|
|
void icon(const void * ic);
|
|
|
|
/**
|
|
Returns non-zero if show() has been called (but not hide()
|
|
). You can tell if a window is iconified with (w->shown()
|
|
&& !w->visible()).
|
|
*/
|
|
int shown() {return i != 0;}
|
|
/**
|
|
Puts the window on the screen. Usually (on X) this has the side
|
|
effect of opening the display.
|
|
|
|
If the window is already shown then it is restored and raised to the
|
|
top. This is really convenient because your program can call show()
|
|
at any time, even if the window is already up. It also means that
|
|
show() serves the purpose of raise() in other toolkits.
|
|
|
|
Fl_Window::show(int argc, char **argv) is used for top-level
|
|
windows and allows standard arguments to be parsed from the
|
|
command-line.
|
|
|
|
\see Fl_Window::show(int argc, char **argv)
|
|
*/
|
|
virtual void show();
|
|
/**
|
|
Removes the window from the screen. If the window is already hidden or
|
|
has not been shown then this does nothing and is harmless.
|
|
*/
|
|
virtual void hide();
|
|
/**
|
|
Puts the window on the screen and parses command-line arguments.
|
|
|
|
Usually (on X) this has the side effect of opening the display.
|
|
|
|
This form should be used for top-level windows, at least for the
|
|
first (main) window. It allows standard arguments to be parsed
|
|
from the command-line. You can use \p argc and \p argv from
|
|
main(int argc, char **argv) for this call.
|
|
|
|
The first call also sets up some system-specific internal
|
|
variables like the system colors.
|
|
|
|
\todo explain which system parameters are set up.
|
|
|
|
\param argc command-line argument count, usually from main()
|
|
\param argv command-line argument vector, usually from main()
|
|
|
|
\see virtual void Fl_Window::show()
|
|
*/
|
|
void show(int argc, char **argv);
|
|
/**
|
|
Makes the window completely fill the screen, without any window
|
|
manager border visible. You must use fullscreen_off() to undo
|
|
this.
|
|
|
|
\note On some platforms, this can result in the keyboard being
|
|
grabbed. The window may also be recreated, meaning hide() and
|
|
show() will be called.
|
|
*/
|
|
void fullscreen();
|
|
/**
|
|
Turns off any side effects of fullscreen()
|
|
*/
|
|
void fullscreen_off();
|
|
/**
|
|
Turns off any side effects of fullscreen() and does
|
|
resize(x,y,w,h).
|
|
*/
|
|
void fullscreen_off(int X,int Y,int W,int H);
|
|
/**
|
|
Returns non zero if FULLSCREEN flag is set, 0 otherwise.
|
|
*/
|
|
unsigned int fullscreen_active() const { return flags() & FULLSCREEN; }
|
|
/**
|
|
Iconifies the window. If you call this when shown() is false
|
|
it will show() it as an icon. If the window is already
|
|
iconified this does nothing.
|
|
|
|
Call show() to restore the window.
|
|
|
|
When a window is iconified/restored (either by these calls or by the
|
|
user) the handle() method is called with FL_HIDE and
|
|
FL_SHOW events and visible() is turned on and off.
|
|
|
|
There is no way to control what is drawn in the icon except with the
|
|
string passed to Fl_Window::xclass(). You should not rely on
|
|
window managers displaying the icons.
|
|
*/
|
|
void iconize();
|
|
|
|
int x_root() const ;
|
|
int y_root() const ;
|
|
|
|
static Fl_Window *current();
|
|
/**
|
|
Sets things up so that the drawing functions in <FL/fl_draw.H> will go
|
|
into this window. This is useful for incremental update of windows, such
|
|
as in an idle callback, which will make your program behave much better
|
|
if it draws a slow graphic. <B>Danger: incremental update is very hard to
|
|
debug and maintain!</B>
|
|
|
|
This method only works for the Fl_Window and Fl_Gl_Window derived classes.
|
|
*/
|
|
void make_current();
|
|
|
|
// Note: Doxygen docs in Fl_Widget.H to avoid redundancy.
|
|
virtual Fl_Window* as_window() { return this; }
|
|
|
|
/**
|
|
Changes the cursor for this window. This always calls the system, if
|
|
you are changing the cursor a lot you may want to keep track of how
|
|
you set it in a static variable and call this only if the new cursor
|
|
is different.
|
|
|
|
The type Fl_Cursor is an enumeration defined in <FL/Enumerations.H>.
|
|
(Under X you can get any XC_cursor value by passing
|
|
Fl_Cursor((XC_foo/2)+1)). The colors only work on X, they are
|
|
not implemented on WIN32.
|
|
|
|
For back compatibility only.
|
|
*/
|
|
void cursor(Fl_Cursor, Fl_Color=FL_BLACK, Fl_Color=FL_WHITE); // platform dependent
|
|
void default_cursor(Fl_Cursor, Fl_Color=FL_BLACK, Fl_Color=FL_WHITE);
|
|
static void default_callback(Fl_Window*, void* v);
|
|
|
|
/** Returns the window width including any frame added by the window manager.
|
|
|
|
Same as w() if applied to a subwindow.
|
|
*/
|
|
int decorated_w();
|
|
/** Returns the window height including any window title bar and any frame
|
|
added by the window manager.
|
|
|
|
Same as h() if applied to a subwindow.
|
|
*/
|
|
int decorated_h();
|
|
|
|
};
|
|
|
|
#endif
|
|
|
|
//
|
|
// End of "$Id$".
|
|
//
|