Base class for windows and menus. More...

#include <uwin.hpp>

Inheritance diagram for ubit::UWin:

Classes
struct	Modes

Public Member Functions
	UWin (UArgs nodelist=UArgs::none)
	creates a new Window; More...

virtual UWin *	toWin ()
	dynamic cast: returns this object if it derives from UWin and null otherwise.

virtual const UWin *	toWin () const
	dynamic cast: returns this object if it derives from UWin and null otherwise.

virtual int	getDisplayType () const

virtual UWin &	setTitle (const UStr &title)
	changes the title of the window.

virtual UStr	getTitle () const
	returns the title of the window.

virtual void	setPos (UMouseEvent &, float x=0, float y=0)
	moves the upper left corner of the window to the event location. More...

virtual void	setPos (const UWin &win, const UPoint &, UDisp *=null)
	moves the upper left corner of the window relatively to this position in 'win'.

virtual void	setPos (const UView &view, const UPoint &)
	moves the upper left corner of the window relatively to this position in 'view'.

virtual void	setPos (const UView &view, const UWinPlacement &)
	moves the window according to this UWinPlacement and relatively to 'view' .

virtual void	setScreenPos (const UPoint &, UDisp *=null)
	moves the upper left corner of the window to this position on the screen.

virtual void	centerOnScreen (UDisp *=null)

virtual UPoint	getPos (const UWin &win, UDisp *=null) const
	returns the position of the upper left corner of the window relatively to 'win'.

virtual UPoint	getPos (const UView &view) const
	returns the position of the upper left corner of the window relatively to 'view'.

virtual UPoint	getScreenPos (UDisp *=null) const
	returns the position of the upper left corner of the window on the screen.

virtual float	getWidth (UDisp *=null) const
	returns the window width.

virtual float	getHeight (UDisp *=null) const
	returns the window height.

virtual UDimension	getSize (UDisp *=null) const
	returns the window size on this display.

virtual void	setSize (const UDimension &, UDisp *=null)
	changes the window size on this display.

virtual void	adjustSize ()
	adjusts the size of the window according to its content. More...

void	pack ()
	synonym for adjustSize().

virtual void	setFullScreen (bool state, UDisp *=null)
	set full screen mode on or off.

virtual void	toBack (UDisp *=null)
	sends this window to the back on this display.

virtual void	toFront (UDisp *=null)
	brings this window to the front on this display.

virtual bool	isShown () const
	is the window currently shown?

virtual bool	isShown (UDisp *) const
	is the window currently shown on this display?

virtual bool	isModal () const
	is this dialog modal?.

virtual void	setModal (bool=true)
	sets this dialog in modal or non modal mode.

virtual void	show (bool state=true)
	shows/hides the window. More...

virtual void	show (bool state, UDisp *)
	shows/hides the window on this display; More...

virtual int	showModal (UDisp *=null)
	opens a window and locks the interaction with other widgets until this window is closed. More...

virtual void	close (int status=0)
	closes the window. More...

void	repaint ()

void	update ()
	updates object graphics.

virtual void	update (const UUpdate &update_options, UDisp *=null)
	indicates that the layout and/or the paint of this window will be updated. More...

virtual void	doUpdate (const UUpdate &, UDisp *=null)
	updates the layout and/or the paint of this object right now. More...

bool	isHardwin () const
	returns true if this is a "hard" window. More...

bool	isSoftwin () const
	returns true if this is a "soft" window. More...

virtual UWin &	setSoftwin (bool state=true)
	sets the "soft window" mode if arg is true. More...

UWin &	setSoftWin (bool state=true)
	setSoftwin() synonym.

UWin &	softwin (bool state=true)
	setSoftwin() synonym.

bool	isMapped () const

void	setMapped (bool s)

virtual bool	realize ()
	[impl] initializes the window and its children. More...

UView *	getWinView (UDisp *=null) const
	[impl] returns the corresponding view.

UHardwinImpl *	getHardwin (UDisp *=null) const
	[impl] returns the related hard window. More...

UHardwinImpl *	hardImpl () const

USoftwinImpl *	softImpl () const

virtual void	highlight (bool state)

void	addWinView (UView *)

virtual void	initView (UView *parent_view)

virtual UView *	initViewImpl (UView parent_view, UDisp )

virtual void	deleteViewsInside (const std::vector< UView *> &parent_views)

Public Member Functions inherited from ubit::UBox
	UBox (UArgs args=UArgs::none)
	creates a new UBox; The argument can either be a single object pointer or reference, or a list of object pointers or references separated by + operators, example: More...

virtual	~UBox ()
	recursive destructor. More...

virtual UBox *	toBox ()
	dynamic cast: returns this object if it derives from UBox and null otherwise.

virtual const UBox *	toBox () const
	dynamic cast: returns this object if it derives from UBox and null otherwise.

void	repaint ()

virtual int	getViewCount () const
	returns the number of views of this box.

virtual int	getViews (std::vector< UView *> &) const
	returns the views of this box (see DETAILS). More...

virtual UView *	getView (int n=0) const
	returns the Nth view of this box (see DETAILS). More...

virtual UView *	getView (const UInputEvent &) const
	returns the view of this box that contains the event location.

virtual UView *	getView (UWin &, const UPoint &pos_in_win, UDisp *=null) const
	returns the view of this box that contains this point in this window.

virtual UView *	getViewContaining (const UView &child_view) const
	returns the view of this box that contains 'child_view'. More...

virtual UView *	getFirstViewInside (const UView &parent_view) const
	returns the first box view that is contained in 'parent_view'. More...

virtual int	retrieveRelatedViews (std::vector< UView *> &collating_vector) const

virtual UView *	getViewInImpl (UView *parent_view)

virtual UView *	getViewInImpl (UView *parent_view, UDimension &)

void	setViewModes (int view_modes, bool)

Public Member Functions inherited from ubit::UElem
	UElem (UArgs node_arglist=UArgs::none)
	creates a new UElem; The argument can either be a single object pointer or reference, or a list of object pointers or references separated by + operators, example: More...

virtual	~UElem ()
	destructor, note that children are recursively destroyed except if pointed elsewhere ( More...

virtual void	destructs ()
	unlinks the object from its parents and destroys its children.

virtual UElem *	toElem ()
	dynamic cast: returns this object if it derives from UElem and null otherwise.

virtual const UElem *	toElem () const
	dynamic cast: returns this object if it derives from UElem and null otherwise.

const UStyle &	getStyle (UUpdateContext *) const
	virtual function that returns the style of this object. More...

virtual int	getNodeType () const
	returns the XML node type.

virtual const UStr &	getNodeName () const
	return the XML node name (which is the class name).

virtual void	initNode (UDoc *context)
	initialises the XML context of this node.

UElem &	setAttr (UNode &attribute)
	adds or replaces this attribute in the ATTRIBUTE list. More...

UElem &	addAttr (const UArgs &attributes)
	adds one or several attributes (deriving from UAttr) to the ATTRIBUTE list. More...

UElem &	removeAttr (UNode &attribute, bool auto_delete=true)
	removes/deletes an attribute (and its descendants) from the ATTRIBUTE list. More...

UElem &	removeAllAttrs (bool auto_delete=true)
	removes/deletes all attributes (and their descendants) in the ATTRIBUTE list. More...

bool	getAttrValue (UStr &value, const UStr &attr_name) const
	retrieves the value of the attribute which class name is 'attr_name'. More...

UAttr *	getAttr (const UStr &attr_name) const
	returns the attribute node which class name is 'attr_name'. More...

template<class ATTR >
ATTR *	getAttr () const
	retrieves the attribute node that derives from the "ATTR" C++ class. More...

template<class ATTR >
ATTR &	obtainAttr ()
	retrieves or creates the element's attribute that derives from the "ATTR" C++ class. More...

virtual bool	isParentOf (const UNode &possible_child) const
	returns true if this object a direct or indirect parent of 'child'.

UElem &	add (const UArgs &children)
	adds one or several objects to the end of the CHILD list of this element. More...

UElem &	add (const UArgs &children, int position)
	adds one or several objects in the CHILD list before this position. More...

UElem &	add (const UArgs &children, UChildIter iterator)
	adds one or several objects in the CHILD list before this iterator. More...

virtual UElem &	addImpl (const UArgs &nodes, UChildIter pos, UChildren &in_list)

virtual bool	addImpl1 (const UChild &node, UChildIter pos, UChildren &in_list)

UElem &	remove (UNode &child, bool auto_delete=true)
	removes/deletes a child (and its descendants) from the CHILD list. More...

UElem &	remove (int pos, bool auto_delete=true)
	removes/deletes a child (and its descendants) at this position in the CHILD list. More...

UElem &	remove (UChildIter pos, bool auto_delete=true)
	removes/deletes a child (and its descendants) at this position in the CHILD list. More...

UElem &	removeAll (bool auto_delete=true)
	removes/deletes all children (and their descendants) in the CHILD list. More...

virtual UElem &	removeImpl (UChildIter begin, int N, bool autodel, UChildren &in_list)

virtual bool	removeImpl1 (UChildIter pos, int auto_delete, UChildren &in_list)

UChildren &	getChildren () const

int	getChildCount () const

UChildIter	child (int pos) const

UNode *	getChild (int pos) const
	returns an iterator pointing to the child at this position. More...

UChildIter	cbegin () const
	returns the child at this position. More...

UChildIter	cend () const
	returns a forward iterator pointing to the end of the child list ( More...

UChildReverseIter	crbegin () const
	returns a reverse iterator pointing to the beginning of the child list ( More...

UChildReverseIter	crend () const
	returns a reverse iterator pionting to the end of the child list ( More...

virtual UStr	retrieveText (bool recursive=true) const
	collates and returns the text that is enclosed in this object. More...

virtual void	retrieveText (UStr &string, bool recursive=true) const
	collates and returns the text that is enclosed in this object. More...

bool	isShowable () const
	returns true if this object can be shown. More...

void	setShowable (bool s) const
	synonym for show(bool).

void	repaint ()
	indicates that this object will be repainted (when the main loop becomes idle).

void	doUpdate ()

UElem &	ignoreEvents (bool state=true)
	if arg is true, this element and (its children) ignore events. More...

UElem &	catchEvents (const UChild &condition_callback_expr)
	catches certain events before they reach the object's children. More...

UElem &	observeChildrenEvents (const UChild &condition_callback_expr)
	observe events that occur in children. More...

bool	isIgnoringEvents () const
	returns true if events are ignored by this object;

bool	hasCallback (long callback_id) const
	true if thie object has such a callback.

virtual bool	fire (UEvent &) const
	fires callback functions that match this event.

UElem &	enable (bool state=true)
	shortcut for setEnabled(bool state = true).

virtual UElem &	setEnabled (bool state=true, bool call_callbacks=true)
	specifies whether this object is enabled. More...

bool	isEnabled () const
	returns true if this object is currently enabled; More...

virtual UElem &	setSelected (bool state=true, bool call_callbacks=true)
	specifies whether this object is selected. More...

bool	isSelected () const

bool	isSelectable () const

UElem &	setSelectable (bool state=true)

bool	isArmed () const

bool	isArmable () const
	specifies whether this object can be armed. More...

UElem &	setArmable (bool state=true)

UElem &	setAutoRepeat (bool state=true)

bool	isAutoRepeat () const

bool	isCrossable () const

UElem &	setCrossable (bool state=true)

UElem &	setBrowsable (bool=true)

bool	isBrowsable () const

bool	isDragged () const

bool	isDraggable () const

UElem &	setDraggable (bool=true)

bool	isDroppable () const

UElem &	setDroppable (bool=true)

bool	isTextEditable () const

bool	isFloating () const

bool	isVertical () const

bool	isWidthResizable () const

bool	isHeightResizable () const

virtual bool	isSubWin () const

void	disableMenuClosing (bool s=true)
	this object and its children wont close menus when clicked if argument is true.

bool	isMenuClosingDisabled () const
	true if this object and its children do not close menus when clicked.

bool	isBrowsingGroup ()

virtual UChildren &	children () const

virtual UChildren &	attributes () const

UChildIter	abegin () const

UChildIter	aend () const

UObject::State	getInterState () const

void	setInterState (UObject::State)

virtual const UStr *	getTextSeparator () const
	returns the text separator used by retrieveText() for separating enclosed children

UElem &	_setArmableAndSelectable (bool state)

virtual void	keyPressBehavior (UKeyEvent &)

virtual void	keyReleaseBehavior (UKeyEvent &)

virtual void	enterBehavior (UInputEvent &, bool is_browing)

virtual void	leaveBehavior (UInputEvent &, bool is_browing)

virtual void	armBehavior (UInputEvent &, bool is_browing)

virtual void	disarmBehavior (UInputEvent &, bool is_browing)

virtual void	actionBehavior (UInputEvent &)

Public Member Functions inherited from ubit::UNode
virtual UStr	getNodeValue () const
	return the XML node value.

virtual int	isDisplayable () const

virtual UNode *	toNode ()
	dynamic cast: returns this object if it derives from UNode and null otherwise.

virtual const UNode *	toNode () const
	dynamic cast: returns this object if it derives from UNode and null otherwise.

virtual bool	isChildOf (const UElem &parent, bool indirect=true) const
	returns true if this object a child of 'parent'. More...

UParentIter	pbegin () const
	returns an iterator to the beginning of the list of direct parents. More...

UParentIter	pend () const
	returns an iterator to the end of the parent list ( More...

virtual UParents &	parents () const
	returns the list of direct parents ( More...

virtual UElem *	getParent (int pos=0) const
	returns the Nth direct parent. More...

virtual bool	hasSceneGraphParent () const

template<class CC >
CC *	findParent () const
	< this object has at least one parent in the scene graph. More...

virtual int	getBoxParents (std::vector< UBox *> &parvect) const
	retrieves direct and indirect parents that are boxes.

virtual UBox *	getParent (const UView *) const
	returns the direct or indirect parent that contains this view. More...

virtual UView *	getParentView (const UView *) const
	returns the direct or indirect parent's view that contains this view. More...

virtual UBox *	getParent (const UInputEvent &) const

virtual UView *	getParentView (const UInputEvent &) const

virtual void	removeFromParents (bool update_parents=true)
	[impl] removes this object from all direct parents. More...

bool	isAutoUpdate () const
	return current update policy: see setAutoUpdate().

UNode &	setAutoUpdate (bool state=true)
	changes the update policy of this object when its is modified. More...

void	fireParents (const UCond &c, UNode *n) const

void	updateAutoParents (const UUpdate &m)

virtual void	addChangeCall (UCall &)

virtual UElem *	getSubGroup () const

void	_addAttr (const UChild &attribute)
	[impl] to be removed @.

UChildIter	_abegin () const
	[impl] to be removed @.

UChildIter	_aend () const
	[impl] to be removed @.

Public Member Functions inherited from ubit::UObject
	UObject (const UObject &)

UObject &	operator= (const UObject &)

virtual const UClass &	getClass () const
	instance method that returns the metaclass of this object. More...

const UStr &	getClassName () const
	returns getClass().getName().

virtual void	error (const char function_name, const char format,...) const
	prints out an error message. More...

virtual void	warning (const char function_name, const char format,...) const
	prints out a warning message: More...

bool	isDeletable () const
	checks if this object can be destroyed by 'delete'. More...

bool	isConst () const
	checks whether the content of this object can be modified ( More...

UObject &	setConst ()
	specifies that the content of this object cannot be modified. More...

bool	isAutoUpdate () const
	return current update policy: More...

UObject &	setAutoUpdate (bool state=true)
	changes the update policy of this object when its is modified. More...

bool	isIgnoringChangeCallbacks () const
	return true if change callbacks are fired.

UObject &	ignoreChangeCallbacks (bool state)
	change callbacks are not fired if argument is true.

virtual UAttr *	toAttr ()
	dynamic cast: returns this object if it derives from UAttr and null otherwise.

virtual const UAttr *	toAttr () const
	dynamic cast: returns this object if it derives from UAttr and null otherwise.

virtual UData *	toData ()
	dynamic cast: returns this object if it derives from UData and null otherwise.

virtual const UData *	toData () const
	dynamic cast: returns this object if it derives from UData and null otherwise.

virtual UStr *	toStr ()
	dynamic cast: returns this object if it derives from UStr and null otherwise.

virtual const UStr *	toStr () const
	dynamic cast: returns this object if it derives from UStr and null otherwise.

virtual UCall *	toCall ()
	dynamic cast: returns this object if it derives from UCall and null otherwise.

virtual const UCall *	toCall () const
	dynamic cast: returns this object if it derives from UCall and null otherwise.

virtual UMenu *	toMenu ()
	dynamic cast: returns this object if it derives from UMenu and null otherwise.

virtual const UMenu *	toMenu () const
	dynamic cast: returns this object if it derives from UMenu and null otherwise.

State	getState () const
	returns the current object state.

void	setState (State s)
	changes the object state.

PtrCount	getPtrCount () const
	[impl] returns the number of uptr<> smart pointers that are pointing to this object.

bool	checkConst () const
	[impl] produces an error if this object is logically constant ( More...

bool	isDestructed () const
	[impl] this object has been destructed (but memory has not been freed yet).

bool	isDestructing () const
	[impl] this object is being destructed (one of its destructors has been called).

void *	operator new (size_t)
	< [impl] returns true if there is at least one scene graph parent (redefined by UNode). More...

void	operator delete (void *)
	delete operator is forbidden on instances that derive from UObject.

void	addPtr () const
	[Impl] a uptr is added to this object.

void	removePtr () const
	[Impl] a uptr is removed from this object.

Static Public Member Functions
static UStyle *	createStyle ()

Static Public Member Functions inherited from ubit::UBox
static UStyle *	createStyle ()
	static function that returns the style of this class (see details!). More...

Static Public Member Functions inherited from ubit::UElem
static UStyle *	createStyle ()
	static function that returns the style of this class. More...

static void	closeWin (UInputEvent &, int status)
	closes the first window (UDialog, UMenu...) that contains this element. More...

Static Public Member Functions inherited from ubit::UObject
static const char *	getVersion ()
	returns the version of the Ubit package.

static const UClass &	Class ()
	class method that returns the metaclass of this class. More...

static UStyle *	createStyle ()

Protected Member Functions
virtual UView *	realizeSoftwin (UWin hardwin, UView hardwin_view, UDisp *, bool add_to_the_end)

virtual bool	realizeHardwin (char window_type)

virtual void	realizeChildren (UView *winview)

Protected Member Functions inherited from ubit::UBox
virtual void	addViewImpl (UView *)

virtual void	initChildViews (UElem *)

Protected Member Functions inherited from ubit::UElem
virtual int	_getTextLength (bool recursive) const

virtual char *	_getTextData (char *ptr, bool recursive) const

Protected Member Functions inherited from ubit::UNode
	UNode ()
	constructor, can anly be called by subclasses because UNode is abstract.

virtual	~UNode ()
	destructor, note that children are recursively destroyed except if pointed elsewhere ( More...

virtual void	addingTo (UChild &, UElem &parent)
	called when this object is added to a parent.

virtual void	removingFrom (UChild &, UElem &parent)
	called when this object is removed from a parent (SEE DETAILS IF YOU REDEFINE THIS METHOD). More...

Protected Attributes
Modes	wmodes

std::vector< UWinImpl * >	wimpl

Protected Attributes inherited from ubit::UBox
UView *	views

Protected Attributes inherited from ubit::UElem
Modes	emodes

long	callback_mask

UChildren	_children

Protected Attributes inherited from ubit::UNode
UParents	_parents

UChildren	_attributes

Protected Attributes inherited from ubit::UObject
PtrCount	ptr_count

Modes	omodes

State	ostate

Friends
class	UBox

class	UAppli

class	UAppliImpl

class	UHardwinImpl

class	USoftwinImpl

Additional Inherited Members
Public Types inherited from ubit::UElem
enum	{ REMOVE_FROM_PARENTS = -1 }

Public Types inherited from ubit::UNode
enum	NodeType { ELEMENT_NODE = 1, ATTRIBUTE_NODE = 2, TEXT_NODE = 3, CDATA_SECTION_NODE = 4, ENTITY_REFERENCE_NODE = 5, ENTITY_NODE = 6, PROCESSING_INSTRUCTION_NODE = 7, COMMENT_NODE = 8, DOCUMENT_NODE = 9, DOCUMENT_TYPE_NODE = 10, DOCUMENT_FRAGMENT_NODE = 11, NOTATION_NODE = 12 }
	redefines Class() and getClass() methods ( More...

enum	DisplayType { WINLIST =-1, UNDISPLAYBLE =0, ATTRIBUTE, DATA, INLINE, BLOCK, BORDER, HARDWIN, SOFTWIN }
	Ubit display types.

Public Types inherited from ubit::UObject
typedef unsigned char	State

typedef short	PtrCount

Static Public Attributes inherited from ubit::UObject
static UConst	UCONST
	UCONST can be given as an argument to some constructors to make the object constant. More...

Detailed Description

Base class for windows and menus.

UWin is the base class for all windows (UFrame, UDialog...) and menus (UMenu, UPopmenu, UCtlmenu...)

A UWin can be added as a child of any widget. If this widget is "armable", such as a button, this window is automatically opened when the widget is clicked. A UWin can also be added as a child of the UAppli or another UDisp if the application manges multiple displays. As other UNodes, windows can have several parents.

CLOSING BEHAVIOR:

by default, windows are hidden when they are closed (
See also
close()), except for the "Main Frame" (

UFrame) that quits the application.
this behavior can be changed by adding a UOn::close callback (
See also
: UOn) to the window (e.g. to save useful data before quitting)
LAYOUT:
the window size is computed the first time it appears on the screen (
See also
: show())
once computed, the size DOES NOT CHANGE automatically when children are added to/ removed from the window => children should be added BEFORE the first call to show()
to recompute size programatically, call: adjustSize() or setSize()

Constructor & Destructor Documentation

§ UWin()

UWin::UWin ( UArgs nodelist = UArgs::none )

creates a new Window;

See also: class UWin for details.

Member Function Documentation

§ adjustSize()

void UWin::adjustSize ( )

virtual

adjusts the size of the window according to its content.

By default, the size of a window does not change when children are added or removed. This function adjusts the size of a window to the size of its children

§ close()

void UWin::close ( int status = 0 )

virtual

closes the window.

this function is called when the close button of the window title is clicked. It can also be fired by a button of a modal window to specify a status that will be returned by showModal().

Behavior of close():

by default, close() hides the window, except if it is the "Main Frame" (
See also
UFrame) in which case close() quits the application
if the window has at least one UOn::close callback (
See also
: UOn), these callbacks are fired (the default behaviors are not performed in this case)
close() and showModal():
buttons of a modal window can call close(status) to specify the value returned by showModal() if this function was used. Typically, the "Cancel" button (or the close button of the window title) return 0, the "OK" button returns 1, etc.
by default, showModal() returns 0 if the window was closed by show(false)

notes:

UElem::closeWin() can be used as a callback of any (indirect) child of a window to close this window with the appropriate status
if close(status) is redefined in a subclass, this redefinition should call UWin::close(status) so that callbacks are correctly fired

Reimplemented in URem.

§ doUpdate()

void UWin::doUpdate	(	const UUpdate &	,
		UDisp *	= `null`
	)

virtual

updates the layout and/or the paint of this object right now.

this function is called when the main loop becomes idle for repainting the object. Usually, a client program should NOT call doUpdate() directly. Instead, it should call update() or update(const UUpdate&, UDisp*) that delay layout and repaint actions until the main loop becomes idle. This improves performance and makes double buffering possible.

Reimplemented from ubit::UBox.

§ getHardwin()

UHardwinImpl * UWin::getHardwin ( UDisp * disp = null ) const

[impl] returns the related hard window.

returns the associated hard window if isHardwin() is true, and the hard window that contains this soft window otherwise

§ isHardwin()

bool ubit::UWin::isHardwin ( ) const

inline

returns true if this is a "hard" window.

a hard window is native window that has its own graphics context.

See also: also: isSoftwin().

§ isSoftwin()

bool ubit::UWin::isSoftwin ( ) const

inline

returns true if this is a "soft" window.

a soft window simulates an window that is displayed inside a "hard" window (which is a UFrame or a UDialog)

See also: also: isHardwin().

§ realize()

bool UWin::realize ( )

virtual

[impl] initializes the window and its children.

this function called when the window is shown for the first time

Reimplemented in ubit::UFrame, ubit::UDialog, ubit::UMenu, and ubit::USubwin.

§ setPos()

virtual void ubit::UWin::setPos	(	UMouseEvent &	,
		float	x = `0`,
		float	y = `0`
	)

virtual

moves the upper left corner of the window to the event location.

(x, y) are added to the event location.

§ setSoftwin()

UWin & UWin::setSoftwin ( bool state = true )

virtual

sets the "soft window" mode if arg is true.

this mode can only be set before window initialization (ie. before the window is added to a visible object) see isSoftwin() for details.

§ show() [1/2]

virtual void ubit::UWin::show ( bool state = true )

inlinevirtual

shows/hides the window.

windows are not shown by default; show() must be called to make them visible. Besides, their size do not change after the first call to show(), except if the setSize() or adjustSize() method is called.

See also: also: showModal() to open a modal window.

Reimplemented from ubit::UElem.

Reimplemented in ubit::UFrame, ubit::UPiemenu, ubit::UMenu, and ubit::UDialog.

§ show() [2/2]

virtual void ubit::UWin::show	(	bool	state,
		UDisp *
	)

virtual

shows/hides the window on this display;

See also: : show(bool state);

Reimplemented in ubit::UFrame, ubit::UPiemenu, ubit::UMenu, and ubit::UDialog.

§ showModal()

int UWin::showModal ( UDisp * disp = null )

virtual

opens a window and locks the interaction with other widgets until this window is closed.

this function:

returns when the window is unshown by calling: show(false) or close(status)
returns a value that indicates which button button was clicked in the modal window. This value is 0 by default;
See also
close() for more details.

§ update()

virtual void ubit::UWin::update	(	const UUpdate &	update_options,
		UDisp *	= `null`
	)

virtual

indicates that the layout and/or the paint of this window will be updated.

this will be done when the main loop becomes idle.

the 1st arg. specify what must be updated and misc options (see UUpdate)
the 2nd arg. should be null (it will be used for differenciating window views on different displays in the future)

REMARK: This function does NOT change the size of the window. adjustSize() or setSize() must be called to do that

See also: also: repaint(), update(), show().

Reimplemented from ubit::UBox.

The documentation for this class was generated from the following files:

src/ubit/uwin.hpp
src/ubit/ubox.cpp
src/ubit/uwin.cpp

Classes

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

§ UWin()

Member Function Documentation

§ adjustSize()

§ close()

§ doUpdate()

§ getHardwin()

§ isHardwin()

§ isSoftwin()

§ realize()

§ setPos()

§ setSoftwin()

§ show() [1/2]

§ show() [2/2]

§ showModal()

§ update()