View container class. More...

#include <ilviews/contain/contain.h>

Inheritance diagram for IlvContainer:

Public Member Functions
	IlvContainer (IlvAbstractView *parent, const IlvRect &size, IlBoolean useacc=IlTrue, IlBoolean visible=IlTrue)
	Constructor. More...

	IlvContainer (IlvDisplay *, IlvSystemView parent, const IlvRect &size, IlBoolean useacc=IlTrue, IlBoolean visible=IlTrue)
	Constructor. More...

	IlvContainer (IlvDisplay *, IlvSystemView w, IlBoolean useacc=IlTrue)
	Constructor. More...

	IlvContainer (IlvDisplay , const char name, const char *title, const IlvRect &dims, IlBoolean useacc=IlTrue, IlBoolean visible=IlTrue)
	Constructor. More...

	IlvContainer (IlvDisplay , const char name, const char *title, const IlvRect &dims, IlUInt properties, IlBoolean useacc=IlTrue, IlBoolean visible=IlTrue, IlvSystemView transientFor=0)
	Constructor. More...

virtual	~IlvContainer ()
	Destructor. More...

void	abortReDraw ()
	Aborts a redraw. More...

void	addAccelerator (IlvContainerAccelerator *accelerator)
	Adds or replaces a specified accelerator. More...

void	addAccelerator (IlvContainerAction action, IlvEventType type, IlUShort data=0, IlUShort modifiers=0, IlAny userArg=0, IlUShort optModifiers=0)
	Adds an accelerator to the container. More...

virtual void	addObject (IlvGraphic *obj, IlBoolean redraw=IlFalse)
	Adds an object to the top of the container list. More...

virtual void	addObject (const char objectName, IlvGraphic obj, IlBoolean redraw=IlFalse)
	Adds an object to the top of the container list and names the object. More...

virtual IlBoolean	addSmartSet (IlvSmartSet *, IlBoolean redraw=IlTrue)
	Adds a SmartSet. More...

void	addTransformer (const IlvTransformer &t)
	Adds to the transformation function. More...

virtual void	afterDraw (IlvPort dst, const IlvTransformer t=0, const IlvRegion *clip=0)
	Performs a specified draw after a redraw. More...

virtual void	applyToObject (IlvGraphic *obj, IlvApplyObject func, IlAny arg, IlBoolean reDraw=IlFalse)
	Applies a user function to an object. More...

void	applyToObjects (IlvApplyObject func, IlAny arg, IlBoolean redraw=IlFalse)
	Applies a user function to all objects. More...

void	applyToTaggedObjects (const IlSymbol *tag, IlvApplyObject func, IlAny arg, IlBoolean reDraw=IlFalse)
	Applies a user function to all objects with a specified tag. More...

virtual void	beforeDraw (IlvPort dst, const IlvTransformer t=0, const IlvRegion *clip=0)
	Performs a specified draw before a redraw. More...

void	bufferedDraw (const IlvRect &rect)
	Redraws a rectangle with double buffering. More...

void	bufferedDraw (const IlvRegion &region)
	Redraws a region with double buffering. More...

void	bufferedDraw (const IlvGraphic *object)
	Redraws an object with double buffering. More...

IlvGraphic *	contains (const IlvPoint &p) const
	Checks whether a point is in the container's objects. More...

virtual IlvViewInputFile *	createInputFile (istream &stream)
	Creates an input file. More...

void	disableRedrawTask ()
	Disactivates the lazy redraw mechanism. More...

virtual IlBoolean	dispatchToObjects (IlvEvent &event)
	Dispatches an event to an object. More...

virtual void	draw (const IlvRegion *region=0)
	Draws all objects in the container with a clipping region. More...

virtual void	draw (IlvPort dst, const IlvTransformer t=0, const IlvRegion *clip=0)
	Draws all objects with transformation and a clipping region. More...

void	draw (const IlvRect *rect)
	Draws all objects within a rectangle. More...

virtual void	fitToContents ()
	Resizes the container to fit the overall bounding box of the graphic objects. More...

virtual void	fitTransformerToContents (IlBoolean redraw=IlTrue)
	Resizes the objects to fit the container. More...

virtual void	flushRedraw ()
	Performs the actual redraw of invalid regions. More...

IlvContainerAccelerator *	getAccelerator (IlvEventType type, IlUShort button=0, IlUShort modifiers=0) const
	Gets an accelerator by event. More...

IlBoolean	getAccelerator (IlvContainerAction action, IlAny userarg, IlvEventType type, IlUShort buttonOrKey=0, IlUShort modifiers=0) const
	Gets an accelerator by action and user argument. More...

IlUInt	getCardinal () const
	Gets the number of objects in the container. More...

IlInt	getIndex (IlvGraphic *) const
	Gets an index. More...

IlvGraphic *	getObject (IlUInt index) const
	Gets an object by index. More...

IlvGraphic *	getObject (const char *) const
	Gets an object by name. More...

IlvViewObjectInteractor *	getObjectInteractor (const IlvGraphic *g) const
	Gets an object interactor. More...

const char *	getObjectName (const IlvGraphic *obj) const
	Gets an object name. More...

IlvGraphic const	getObjects (IlUInt &count) const
	Gets all objects in the container. More...

IlvSmartSet *	getSmartSet (const char *name) const
	Gets a SmartSet. More...

IlvGraphic const	getTaggedObjects (const IlSymbol *tag, IlUInt &count) const
	Gets all objects with a specified tag. More...

IlvTransformer *	getTransformer () const
	Gets the transformation function. More...

virtual void	handleExpose (IlvEvent &)
	Handles a newly exposed region. More...

virtual void	handleInput (IlvEvent &)
	Handles an input event. More...

virtual void	hide ()
	Hides the view. More...

void	initReDraw ()
	Initializes an invalidated region to empty. More...

virtual void	insertObject (IlvGraphic *obj, IlBoolean redraw=IlFalse)
	Inserts the object at the bottom of the container list. More...

void	invalidateRegion (const IlvGraphic *object)
	Invalidates an object's region. More...

void	invalidateRegion (const IlvRect &rect)
	Invalidates a rectangle's region. More...

void	invalidateRegion (const IlvRegion &rect)
	Invalidates a region.. More...

void	invalidateRegion (const IlvRegionUpdater &updater, const IlvGraphic *graphic=0)
	Updates the invalidated region. More...

IlBoolean	isDoubleBuffering () const
	Tests the double buffering setting. More...

IlBoolean	isInvalidating () const
	Indicates whether the container is in a phase of invalidating regions. More...

IlBoolean	isVisible (const IlvGraphic *obj) const
	Tests the visibility setting of an object. More...

virtual IlBoolean	read (istream &stream)
	Loads an Rogue Wave Views data file from the input stream. More...

virtual IlBoolean	readFile (const char *filename)
	Reads an Rogue Wave Views data file. More...

virtual void	reDraw (const IlvRegion *region=0)
	Redraws all objects in the container with a clipping region. More...

void	reDraw (const IlvRect *rect)
	Redraws all objects within a rectangle. More...

void	reDrawObj (IlvGraphic *obj)
	Redraws an object. More...

void	reDrawView (IlBoolean erase=IlTrue, IlBoolean buffered=IlFalse)
	Redraws a view. More...

void	registerCallback (const char *callbackName, IlvGraphicCallback callback)
	Registers a callback. More...

void	removeAccelerator (IlvContainerAccelerator *acc)
	Removes a specified accelerator. More...

void	removeAccelerator (IlvEventType type, IlUShort buttonOrKey=0, IlUShort modifiers=0)
	Removes an accelerator by event. More...

virtual IlBoolean	removeObject (IlvGraphic *obj, IlBoolean redraw=IlFalse)
	Removes an object from the container. More...

virtual void	removeObjects (IlBoolean destroy=IlTrue, IlBoolean redraw=IlTrue)
	Removes all objects from the container. More...

virtual IlBoolean	removeSmartSet (IlvSmartSet *)
	Removes a SmartSet. More...

void	removeTaggedObjects (const IlSymbol *tag, IlBoolean destroy=IlTrue, IlBoolean reDraw=IlTrue)
	Removes all objects with a specified tag. More...

virtual IlvGraphic *	replace (IlvGraphic oldObject, IlvGraphic newObject, IlBoolean redraw=IlFalse)
	Replaces an object. More...

virtual void	setBackground (IlvColor *c)
	Sets the background color of this view. More...

virtual void	setBackgroundBitmap (IlvBitmap *)
	Sets the background bitmap of this view. More...

IlBoolean	setDoubleBuffering (IlBoolean value)
	Sets double buffering. More...

IlBoolean	setObjectInteractor (IlvGraphic obj, IlvViewObjectInteractor inter)
	Sets an object interactor on a graphic object. More...

virtual void	setObjectName (IlvGraphic obj, const char s)
	Sets an object name. More...

virtual void	setTransformer (const IlvTransformer &)
	Applies another transformer to the coordinates provided for the drawing functions. More...

void	setTransformer (const IlvTransformer *t=0)
	Sets the transformation function. More...

virtual void	setVisible (IlvGraphic *obj, IlBoolean visible, IlBoolean redraw=IlFalse)
	Sets the visibility of an object. More...

virtual IlBoolean	shortCut (IlvEvent &event)
	Verbose: More...

virtual void	show ()
	Shows the view. More...

virtual void	swap (IlvGraphic , IlvGraphic )
	Swaps two objects. More...

void	translateView (IlvPos dx, IlvPos dy, IlBoolean redraw=IlTrue)
	Translates the current view. More...

void	unregisterCallback (const char *callbackName)
	Unregisters a callback. More...

void	visibleBBox (IlvRect &rect) const
	Determines the visible bounding box of the container. More...

void	zoomView (const IlvPoint &center, IlFloat scalex, IlFloat scaley=0.0, IlBoolean redraw=IlTrue)
	Zooms the current view. More...

Public Member Functions inherited from IlvDrawingView
	IlvDrawingView (IlvAbstractView *parent, const IlvRect &size, IlBoolean visible=IlTrue)
	Constructor. More...

	IlvDrawingView (IlvDisplay *display, IlvSystemView parent, const IlvRect &size, IlBoolean visible=IlTrue)
	Constructor. More...

	IlvDrawingView (IlvDisplay *display, IlvSystemView available)
	Constructor. More...

	IlvDrawingView (IlvDisplay display, const char name, const char *title, const IlvRect &size, IlBoolean visible=IlTrue)
	Constructor. More...

	IlvDrawingView (IlvDisplay display, const char name, const char *title, const IlvRect &size, IlUInt properties, IlBoolean visible=IlTrue, IlvSystemView transientFor=0)
	Constructor. More...

Public Member Functions inherited from IlvView
	IlvView (IlvAbstractView *parent, const IlvRect &size, IlBoolean visible=IlTrue)
	Constructor. More...

	IlvView (IlvDisplay *display, IlvSystemView available)
	Constructor. More...

	IlvView (IlvDisplay *display, IlvSystemView parent, const IlvRect &size, IlBoolean visible=IlTrue)
	Constructor. More...

	IlvView (IlvDisplay display, const char name, const char *title, const IlvRect &size, IlBoolean visible=IlTrue)
	Constructor. More...

	IlvView (IlvDisplay display, const char name, const char *title, const IlvRect &size, IlUInt properties, IlBoolean visible=IlTrue, IlvSystemView transientFor=0)
	Constructor. More...

void	addProperty (const IlSymbol *key, IlAny value)
	Adds a property to the view. More...

virtual IlBoolean	applyValue (const IlvValue &)
	Applies an accessor. More...

void	ensureInScreen (IlvPos xMargin=0, IlvPos yMargin=0)
	Ensures that the view remains visible. More...

const char *	getName () const
	Retrieves the name. More...

IlAny	getProperty (const IlSymbol *key) const
	Retrieves a property. More...

const char *	getTitle () const
	Retrieves the title of this view. More...

IlBoolean	hasProperty (const IlSymbol *key) const
	Checks the existence of a property. More...

void	iconBitmap (IlvBitmap image, IlvBitmap mask=0)
	Sets the icon aspect. More...

void	iconify ()
	Requests this window to iconify itself. More...

virtual IlBoolean	isIconified () const
	Retrieves the iconified state. More...

IlBoolean	isModal () const
	Queries the modality of this view. More...

IlBoolean	isVisible () const
	Retrieves the visibility. More...

virtual void	move (const IlvPoint &point)
	Moves the view. More...

virtual void	moveResize (const IlvRect &rect)
	Reshapes the view. More...

void	moveToMouse (IlvDirection justification=IlvCenter, IlvPos dx=0, IlvPos dy=0, IlBoolean ensureInScreen=IlTrue)
	Moves the view relative to the location of the mouse. More...

void	moveToScreen (IlvDirection justification=IlvCenter, IlvPos dx=0, IlvPos dy=0, IlBoolean ensureInScreen=IlTrue)
	Moves the view relative to the root window. More...

void	moveToView (const IlvView *view, IlvDirection justification=IlvCenter, IlvPos dx=0, IlvPos dy=0, IlBoolean ensureInScreen=IlTrue)
	Moves the view relative to another view. More...

virtual IlvValue &	queryValue (IlvValue &) const
	Retrieves the value of an accessor. More...

virtual void	removeDeleteCallback (IlvDestroyCallback del=0, IlAny userArg=0)
	Removes a Delete callback. More...

virtual void	removeDestroyCallback (IlvDestroyCallback destroy=0, IlAny userArg=0)
	Removes a Destroy callback. More...

virtual void	removeExposeCallback (IlvExposeCallback expose=0, IlAny userArg=0)
	Removes an Expose callback. More...

virtual void	removeInputCallback (IlvInputCallback input=0, IlAny userArg=0)
	Removes an Input callback. More...

IlBoolean	removeProperty (const IlSymbol *key)
	Removes a property. More...

virtual void	removeResizeCallback (IlvResizeCallback resize=0, IlAny userArg=0)
	Removes a Resize callback. More...

IlBoolean	replaceProperty (const IlSymbol *key, IlAny value)
	Replaces a property. More...

virtual void	resize (IlvDim w, IlvDim h)
	Resizes the view. More...

virtual void	setDeleteCallback (IlvDestroyCallback del, IlAny userArg=0)
	Sets a callback that watches for destruction. More...

virtual void	setDestroyCallback (IlvDestroyCallback destroy, IlAny userArg=0)
	Sets a callback for Destroy events. More...

virtual void	setExposeCallback (IlvExposeCallback expose, IlAny userArg=0)
	Sets a callback for Expose events. More...

void	setIconTitle (const char *title)
	Sets the iconified title of this view. More...

virtual void	setInputCallback (IlvInputCallback input, IlAny userArg=0)
	Sets a callback for Input events. More...

void	setMaximumSize (IlvDim w, IlvDim h)
	Sets the maximum size of this view. More...

void	setMinimumSize (IlvDim w, IlvDim h)
	Sets the minimum size of this view. More...

virtual void	setName (const char *name)
	Sets the name. More...

void	setProperty (const IlSymbol *key, IlAny value)
	Sets or removes a property. More...

virtual void	setResizeCallback (IlvResizeCallback resize, IlAny userArg=0)
	Sets a callback for Resize events. More...

void	setShapeMask (IlvBitmap *mask, IlBoolean useTitle=IlFalse)
	Sets a shape mask. More...

virtual void	setTitle (const char *title)
	Sets the title of the view. More...

virtual IlBoolean	showModal (IlBoolean doesGrab=IlFalse, IlvCursor *cursor=0)
	Shows the window in a modal mode. More...

Public Member Functions inherited from IlvAbstractView
virtual void	boundingBox (IlvRect &bbox) const
	Retrieves the relative dimensions of the view. More...

virtual IlBoolean	changeValue (const IlvValue &val)
	Changes the value of an accessor. More...

IlBoolean	enableMultitouch (IlBoolean enable)
	Allows the view to receive multitouch events. More...

void	ensureVisible (const IlvPoint &point)
	Ensures that a point remains visible. More...

void	ensureVisible (const IlvRect &rect)
	Ensures that a rectangle remains visible.: More...

virtual void	erase (const IlvRect &rect, IlBoolean reDraw=IlFalse)
	Erases an area of this view. More...

virtual void	erase (IlBoolean reDraw=IlFalse)
	Entirely erases the view. More...

virtual void	frameBBox (IlvRect &bbox) const
	Retrieves the dimension of the view frame. More...

IlvColor *	getBackground () const
	Retrieves the background color of this view. More...

IlvBitmap *	getBackgroundBitmap () const
	Gets the background bitmap of this view. More...

IlvCursor *	getCursor () const
	Retrieves the cursor currently set in this view. More...

IlvIntensity	getOpacity () const
	Returns the opacity level of the view. More...

IlvAbstractView *	getParent () const
	Gets the parent of this view. More...

IlvSystemView	getShellSystemView () const
	Gets the system-dependent identifier of the top shell of this view. More...

IlvSystemView	getSystemView () const
	Gets the system-dependent identifier of this view. More...

void	getTransparentColorKey (IlvIntensity &r, IlvIntensity &g, IlvIntensity &b) const
	Returns the color used as a key for transparency. More...

virtual void	globalBBox (IlvRect &bbox) const
	Retrieves the absolute dimensions of the view. More...

IlBoolean	hasGrab () const
	Queries if this view has the display grab. More...

IlBoolean	isLayered () const
	Returns whether the view is layered or not. More...

IlBoolean	isMultitouchEnabled ()
	Queries if the view is set to receive multitouch events. More...

virtual IlBoolean	isScrolled () const
	Queries for scrolling capabilities. More...

IlBoolean	isSensitive () const
	Retrieves the sensitivity of this view to input events. More...

virtual void	lower ()
	Pushes this view below the others. More...

virtual void	position (IlvPoint &position) const
	Retrieves the position of the view. More...

virtual void	raise ()
	Brings this view on top. More...

void	removeWindowProc (IlvWindowProc windowProc, IlAny procArgument=0)
	Removes a user-defined window procedure. More...

void	setCursor (IlvCursor *cursor)
	Sets the cursor for this view. More...

IlBoolean	setFocus ()
	Sets the input focus to this view. More...

void	setLayered (IlBoolean layered)
	Sets whether the window is layered or not. More...

void	setOpacity (IlvIntensity level)
	Sets the opacity value of the view. More...

void	setSensitive (IlBoolean sensitivity)
	Sets the sensitivity of this view to input events. More...

void	setTransparentColorKey (IlvIntensity r, IlvIntensity g, IlvIntensity b)
	Sets the transparency color key value. More...

void	setWindowProc (IlvWindowProc windowProc, IlAny procArgument=0)
	Sets a Windows window procedure. More...

virtual void	sizeVisible (IlvRect &rect) const
	Retrieves the visible part of the view. More...

Public Member Functions inherited from IlvSystemPort
	IlvSystemPort (IlvDisplay *display, IlvWindowsHandle HDC, IlvDim width=0, IlvDim height=0)
	Windows-specific constructor. More...

virtual void	clearArea (const IlvRect &, IlBoolean=IlFalse) const
	Clears a rectangular area of the screen. More...

virtual void	clearArea (const IlvRegion &, IlBoolean=IlFalse) const
	Clears a region of the screen. More...

virtual void	clip (const IlvRect *) const
	Limits the drawing to the given rectangular area. More...

virtual void	clip (const IlvRegion *) const
	Limits the drawing to the given region. More...

virtual IlUShort	depth () const
	Gives the depth of the port. More...

virtual void	drawArc (const IlvPalette *, const IlvRect &, IlFloat, IlFloat) const
	Draws an arc. More...

virtual void	drawBitmap (const IlvPalette , const IlvSystemPort , const IlvRect &, const IlvPoint &) const
	Draws an image. More...

virtual void	drawBitmap (const IlvPalette , const IlvBitmap , const IlvRect &, const IlvRegion *=0, IlvPosition=IlvCenter, IlBoolean=IlFalse) const
	Draws an image. More...

virtual void	drawIString (const IlvPalette , const IlvPoint &, const char , int, IlvPosition=IlvLeft) const
	Draws a string at the given position. More...

virtual void	drawLine (const IlvPalette *, const IlvPoint &, const IlvPoint &) const
	Draws a line between 2 points. More...

virtual void	drawPoint (const IlvPalette *, const IlvPoint &) const
	Draws a point at the given position. More...

virtual void	drawPoints (const IlvPalette , IlUInt, const IlvPoint ) const
	Draws a series of points. More...

virtual void	drawPolyLine (const IlvPalette , IlUInt, const IlvPoint ) const
	Draws a series of connected lines. More...

virtual void	drawPolyLine (const IlvPalette , const IlvPoint &, IlUInt, const IlvDeltaPoint ) const
	Draws a series of connected lines relatively to a reference. More...

virtual void	drawRectangle (const IlvPalette *, const IlvRect &) const
	Draws the given rectangle. More...

virtual void	drawRoundRectangle (const IlvPalette *, const IlvRect &, IlUShort) const
	Draws a round rectangle. More...

virtual void	drawSegments (const IlvPalette , IlUInt, const IlvPoint , const IlvPoint *) const
	Draws a set of segments. More...

virtual void	drawString (const IlvPalette , const IlvPoint &, const char , int, IlvPosition=IlvLeft) const
	Draws a string at the given position. More...

virtual void	drawTransformedString (const IlvPalette , const char , int, const IlvTransformer &, const IlvRegion *=0) const
	Draws a transformed string. More...

virtual void	drawTransparentBitmap (const IlvPalette , const IlvSystemPort , const IlvRect &, const IlvPoint &) const
	Draws a transparent bitmap. More...

virtual void	end ()
	Closed the dump device. More...

virtual void	fillArc (const IlvPalette *, const IlvRect &, IlFloat, IlFloat) const
	Fills the arc. More...

virtual void	fillPaths (const IlvPalette , IlUInt, const IlvPointArray ) const
	Fills the shape defined by the given paths. More...

virtual void	fillPolyLine (const IlvPalette , IlUInt, const IlvPoint , IlBoolean=IlFalse) const
	Fills a polygon. More...

virtual void	fillPolyLine (const IlvPalette , const IlvPoint &, IlUInt, const IlvDeltaPoint , IlBoolean=IlFalse) const
	Fills a polygon. More...

virtual void	fillRectangle (const IlvPalette *, const IlvRect &) const
	Fills the given rectangle. More...

virtual void	fillRoundRectangle (const IlvPalette *, const IlvRect &, IlUShort) const
	Fills a round rectangle. More...

IlvWindowsHandle	getDC () const
	Gets the Windows Handle Device Context. More...

virtual IlBoolean	initDevice (const char , IlvRect =0)
	Initializes the dump device. More...

virtual IlBoolean	isABitmap () const
	Indicates that this port is a bitmap (not a view or a dump device). More...

virtual IlBoolean	isASystemPort () const
	Indicates that this port is a true system port (not a dump device). More...

virtual IlBoolean	isBad () const
	Indicates whether this port is valid. More...

virtual IlBoolean	newPage () const
	Produces an output page and prepares for a new page. More...

void	releaseDC ()
	Releases the Windows Handle Device Context. More...

virtual void	send (const char *) const
	Sends character strings to an output device. More...

virtual void	stretchBitmap (const IlvPalette , const IlvPoint &, const IlvBitmap , const IlvTransformer &, const IlvRect *=0) const
	Stretches a bitmap. More...

virtual void	stretchBitmap (const IlvPalette , const IlvRect &, const IlvBitmap , const IlvRect *=0) const
	Stretches a bitmap. More...

virtual void	stretchBitmapData (const IlvPalette palette, const IlvBitmapData src, const IlvRect &from, const IlvRect &to, IlBoolean opaque=IlFalse) const
	Draws a bitmap data. More...

virtual void	stretchTransparentBitmap (const IlvPalette , const IlvPoint &, const IlvBitmap , const IlvTransformer &, const IlvRect *=0) const
	Stretches a transparent bitmap. More...

virtual void	stretchTransparentBitmap (const IlvPalette , const IlvRect &, const IlvBitmap , const IlvRect *=0) const
	Stretches a transparent bitmap. More...

Public Member Functions inherited from IlvPort
	IlvPort (IlvDisplay *display=0)
	Constructor. More...

void	composeAlpha (IlvIntensity alpha)
	Composes the current alpha value of the port. More...

virtual void	drawArrow (const IlvPalette *palette, const IlvPoint &from, const IlvPoint &to, IlFloat position) const
	Draws an arrow. More...

virtual void	drawBezier (const IlvPalette palette, IlUInt count, const IlvPoint points) const
	Draws a set of Bzier curves. More...

virtual void	drawClosedBezier (const IlvPalette palette, IlUInt count, const IlvPoint points) const
	Appends a closing curve to a set of Bézier curves. More...

virtual void	drawILabel (const IlvPalette palette, const char label, int length, const IlvRect &drawRect, const IlvRegion *clip=0, IlvPosition align=IlvCenter) const
	Draws a label in a rectangle. More...

virtual void	drawLabel (const IlvPalette palette, const char label, int length, const IlvRect &drawRect, const IlvRegion *clip=0, IlvPosition align=IlvCenter) const
	Draws a label in a rectangle. More...

virtual void	drawMarker (const IlvPalette *palette, const IlvPoint &location, IlvMarkerType type=IlvMarkerSquare, IlUShort size=IlvDefaultMarkerSize) const
	Draws a marker. More...

virtual void	drawMnemonicLabel (const IlvPalette palette, const char label, const IlvRect &drawRect, const IlvRegion *clip=0, IlvPosition align=IlvCenter, IlBoolean underline=IlTrue) const
	Draws an underlined letter in a label. More...

virtual void	drawOutlineRectangle (const IlvPalette outlinePalette, const IlvPalette fillPalette, const IlvRect &rect, const IlvRegion *clip=0) const
	Draws a rectangle with border effects. More...

virtual void	drawPaths (const IlvPalette palette, IlUInt count, const IlvPointArray paths) const
	Draws an array of paths as polylines. More...

virtual void	drawReliefDiamond (const IlvPalette , const IlvPalette invertedPalette, const IlvPalette topShade, const IlvPalette bottomShade, const IlvRect &bbox, IlUShort thickness, const IlvRegion *clip=0) const
	Draws a diamond with depth effects. More...

virtual void	drawReliefRectangle (const IlvPalette palette, const IlvPalette invertedPalette, const IlvPalette topShade, const IlvPalette bottomShade, const IlvRect &bbox, IlUShort thickness, const IlvRegion *clip=0) const
	Draws a filled rectangle with depth effects. More...

virtual void	drawShadowRectangle (const IlvPalette palette, const IlvPalette invertedPalette, const IlvRect &bbox, IlUShort thickness, IlvPosition shadowPosition, const IlvRegion *clip=0) const
	Draws a filled rectangle with its shadow. More...

virtual void	fillBezier (const IlvPalette palette, IlUInt count, const IlvPoint points) const
	Fills an area specified by a set of Bézier curves. More...

IlvIntensity	getAlpha () const
	Provides the alpha value of the port. More...

IlvAntialiasingMode	getAntialiasingMode () const
	Provides the anti-aliasing mode of the port. More...

IlvDisplay *	getDisplay () const
	Returns a pointer to the `IlvDisplay` of this port. More...

IlvDim	height () const
	Provides the height of the port. More...

virtual IlBoolean	isADevice () const
	Indicates that this port is a dump device. More...

void	setAlpha (IlvIntensity alpha)
	Sets the alpha value of the port. More...

void	setAntialiasingMode (IlvAntialiasingMode mode)
	Sets the anti-aliasing mode of the port. More...

void	size (IlvDim &w, IlvDim &h) const
	Gives the dimensions of the port. More...

IlvDim	width () const
	Provides the width of the port. More...

Static Public Member Functions
static IlvContainer *	GetContainer (const IlvGraphic *)
	Gets an object's container. More...

Protected Member Functions
virtual void	eraseRegion (const IlvRegion &region)
	Erases a region. More...

Detailed Description

View container class.

Library: views

A container coordinates the storage and the display of graphic objects.

See Also: IlvContainerAccelerator, IlvEvent, IlvGraphic, IlvTransformer, IlvContainerAction.

Constructor & Destructor Documentation

IlvContainer::IlvContainer	(	IlvAbstractView *	parent,
		const IlvRect &	size,
		IlBoolean	useacc = `IlTrue`,
		IlBoolean	visible = `IlTrue`
	)

Constructor.

Initializes a container that is a child of the parent view. The dimensions of the container are indicated by size. The new container is not visible if visible is set to IlFalse.

Parameters

parent	The parent view.
size	The dimensions of the container.
useacc	This optional Boolean parameter must be set to `IlFalse` if you do not want the default accelerators to be installed at creation time.
visible	A Boolean value specifying whether the container is to be initially visible (`IlTrue`) or invisible (`IlFalse`).

IlvContainer::IlvContainer	(	IlvDisplay *	,
		IlvSystemView	parent,
		const IlvRect &	size,
		IlBoolean	useacc = `IlTrue`,
		IlBoolean	visible = `IlTrue`
	)

Constructor.

Creates a container that is a child of the existing system view indicated by parent.

Parameters

display	The display instance.
parent	The parent system view.
size	The dimensions of the container.
useacc	This optional Boolean parameter must be set to `IlFalse` if you do not want the default accelerators to be installed at creation time.
visible	A Boolean value specifying whether the container is to be initially visible (`IlTrue`) or invisible (`IlFalse`).

IlvContainer::IlvContainer	(	IlvDisplay *	,
		IlvSystemView	w,
		IlBoolean	useacc = `IlTrue`
	)

Constructor.

Creates a new container object by using the existing system view available.

Parameters

display	The display instance.
available	The existing system view.
useacc	This optional Boolean parameter must be set to `IlFalse` if you do not want the default accelerators to be installed at creation time.

IlvContainer::IlvContainer	(	IlvDisplay *	,
		const char *	name,
		const char *	title,
		const IlvRect &	dims,
		IlBoolean	useacc = `IlTrue`,
		IlBoolean	visible = `IlTrue`
	)

Constructor.

Initializes a new container object by creating a new top window with the provided parameters.

Parameters

display	The display window.
name	The name of the view.
title	The title of this top window.
size	The initial location and size of the view, relative to the root window of display.
useacc	This optional Boolean parameter must be set to `IlFalse` if you do not want the default accelerators to be installed at creation time.

IlvContainer::IlvContainer	(	IlvDisplay *	,
		const char *	name,
		const char *	title,
		const IlvRect &	dims,
		IlUInt	properties,
		IlBoolean	useacc = `IlTrue`,
		IlBoolean	visible = `IlTrue`,
		IlvSystemView	transientFor = `0`
	)

Constructor.

Initializes a new container object by creating a new top window with the provided parameters. This constructor lets you specify top-level windows properties.

The useacc optional parameter must be set to IlFalse if you don't want the default accelerators to be installed at creation time.

Parameters

display	The display instance.
name	The name of the view.
title	The title of this top window.
size	The initial location and size of the view, relative to the root window of display.
properties	The properties of the view.
useacc	This optional Boolean parameter must be set to `IlFalse` if you do not want the default accelerators to be installed at creation time.
visible	A Boolean value specifying whether the view is to be initially visible (`IlTrue`) or invisible (`IlFalse`).
transientFor	The possible system view for which this view is transient. If unspecified or set to `0`, this view will not be transient for any view.

virtual IlvContainer::~IlvContainer ( )

virtual

Destructor.

The destructor deletes all the graphic objects managed by the container.

Member Function Documentation

void IlvContainer::abortReDraw ( )

Aborts a redraw.

Forgets all invalidated areas. If calls to initReDraw were embedded, they are all reset.

void IlvContainer::addAccelerator ( IlvContainerAccelerator * accelerator )

Adds or replaces a specified accelerator.

Installs an accelerator as a new accelerator in this container. If there already was a matching accelerator (same type, data (button or key), and modifiers), then the previous accelerator is removed (but not destroyed).

Parameters

accelerator The accelerator.

void IlvContainer::addAccelerator	(	IlvContainerAction	action,
		IlvEventType	type,
		IlUShort	data = `0`,
		IlUShort	modifiers = `0`,
		IlAny	userArg = `0`,
		IlUShort	optModifiers = `0`
	)

Adds an accelerator to the container.

Creates an IlvContainerAccelerator using the same arguments and adds it to the IlvContainer accelerator list (see the constructor for argument descriptions). When the container receives an event, it checks its accelerator list. If an appropriate accelerator is found, that is, accelerator->trigger(<event description>) returns IlTrue, then accelerator->activate is called.

Parameters

action	The user function used as the accelerator action.
type	The accelerator event type.
data	The accelerator event data (button or key).
modifiers	The accelerator mandatory event modifiers.
userArg	The accelerator action user argument.
optModifiers	The accelerator optional event modifiers.

virtual void IlvContainer::addObject	(	IlvGraphic *	obj,
		IlBoolean	redraw = `IlFalse`
	)

virtual

Adds an object to the top of the container list.

Adds obj to the set of objects managed by the IlvContainer object. The object is appended at the final position. In other words, the new object is placed "on top of" all the others.

Warning: [note] If the object has a name that is already in use in this container, the name is removed from the object.

Parameters

obj	The object to be added.
redraw	If set to `IlTrue` the container is updated.

virtual void IlvContainer::addObject	(	const char *	objectName,
		IlvGraphic *	obj,
		IlBoolean	redraw = `IlFalse`
	)

virtual

Adds an object to the top of the container list and names the object.

Calls addObject(obj, redraw) then setObjectName(name).

Warning: [note]If the object has a name that is already in use in this container, the name is removed from the object.

Parameters

name	The name of the object.
obj	The object to be added.
redraw	If set to `IlTrue` the container is redrawn. If it is set to `IlFalse`, the container will not be redrawn.

virtual IlBoolean IlvContainer::addSmartSet	(	IlvSmartSet *	,
		IlBoolean	redraw = `IlTrue`
	)

virtual

Adds a SmartSet.

Adds the SmartSet set to this container. This set must have a name. If there already is a SmartSet in this container with the same name, the SmartSet is renamed by adding 1 at the end of the name, or by incrementing the decimal value at the end of the name.

If the SmartSet contains objects that are not stored in this container, they are added to the container, and refresh is performed if redraw is set to IlTrue.

Parameters

set	A SmartSet to be added.
redraw	If set to `IlTrue` the container is redrawn. If it is set to `IlFalse`, the container will not be redrawn.

Returns: IlFalse on error, that is, if set contains objects located in another container.

void IlvContainer::addTransformer ( const IlvTransformer & t )

Adds to the transformation function.

Composes the current transformer with the one given in t and sets the resulting transformer as the new current one for this container object. The transformer is internally copied during this function call.

Parameters

t	The additional transformer.

virtual void IlvContainer::afterDraw	(	IlvPort *	dst,
		const IlvTransformer *	t = `0`,
		const IlvRegion *	clip = `0`
	)

virtual

Performs a specified draw after a redraw.

Acts in the same way as beforeDraw but is called after the objects in the container have been drawn. This lets you create additional drawings on top of the container objects.

Parameters

dst	The destination drawing port.
t	The transformation to be applied, or 0 if none.
clip	The clipping region, or 0 if none.

virtual void IlvContainer::applyToObject	(	IlvGraphic *	obj,
		IlvApplyObject	func,
		IlAny	arg,
		IlBoolean	reDraw = `IlFalse`
	)

virtual

Applies a user function to an object.

Applies the func user-defined function, typed IlvApplyObject, to the object obj which receives the additional arg parameter. You can set redraw to IlTrue to update the object's aspect automatically.

Parameters

obj	The object to which the function is applied.
func	The user function.
arg	A user argument passed with the user function.
reDraw	If set to `IlTrue` the object is redrawn. If it is set to `IlFalse`, the object will not be redrawn.

void IlvContainer::applyToObjects	(	IlvApplyObject	func,
		IlAny	arg,
		IlBoolean	redraw = `IlFalse`
	)

Applies a user function to all objects.

Applies the func user-defined function, typed IlvApplyObject, to each object of the IlvContainer which receives the additional arg parameter. You can set redraw to IlTrue to update the objects' aspect automatically. This redraws all the objects simultaneously (and not one by one).

Parameters

func	The user function.
arg	A user argument passed with the user function.
redraw	If set to `IlTrue` the container is redrawn. If it is set to `IlFalse`, the container will not be redrawn.

void IlvContainer::applyToTaggedObjects	(	const IlSymbol *	tag,
		IlvApplyObject	func,
		IlAny	arg,
		IlBoolean	reDraw = `IlFalse`
	)

Applies a user function to all objects with a specified tag.

Calls the IlvApplyObject function func on every object tagged with tag in the container. This function is similar to the method applyToObject.

Warning: [note] For all the applyTo... member functions, you must not select nor remove an object within an applicative function, and calls to applyTo... member functions should not be nested. Furthermore, when using these functions, you must not move an object from one layer to another.

Parameters

tag	The tag that defines the objects to be included.
func	The user function.
arg	A user argument passed with the user function.
reDraw	If set to `IlTrue` the container is redrawn. If it is set to `IlFalse`, the container will not be redrawn.

virtual void IlvContainer::beforeDraw	(	IlvPort *	dst,
		const IlvTransformer *	t = `0`,
		const IlvRegion *	clip = `0`
	)

virtual

Performs a specified draw before a redraw.

Called internally by a container just before it redraws the objects stored in it. Use this function if you need to draw something before the objects stored in the container are drawn. Use the dst parameter as the output port for your drawing functions. It may differ from the output port of the container draw.

The clip parameter gives the clipping region that should be used.

Parameters

dst	The destination drawing port.
t	The transformation to be applied, or 0 if none.
clip	The clipping region, or 0 if none.

void IlvContainer::bufferedDraw ( const IlvRect & rect )

Redraws a rectangle with double buffering.

Performs temporary drawing in a hidden pixmap, then displays the pixmap on the screen at once. The main difference with double buffering is whether the operation is localized to a rectangle (this member function), a region, or an object.

Parameters

rect	The rectangle to be redrawn with double buffering.

void IlvContainer::bufferedDraw ( const IlvRegion & region )

Redraws a region with double buffering.

Performs temporary drawing in a hidden pixmap, then displays the pixmap on the screen at once. The main difference with double buffering is whether the operation is localized to a rectangle, a region, or an object. This function draws the area included in region (in the coordinate system of the container).

Parameters

region The region to be redrawn with double buffering.

void IlvContainer::bufferedDraw ( const IlvGraphic * object )

Redraws an object with double buffering.

Performs temporary drawing in a hidden pixmap, then displays the pixmap on the screen at once. The main difference with double buffering is whether the operation is localized to a rectangle, a region, or an object. This function draws object (in the coordinate system of the object).

Parameters

object The object to be redrawn with double buffering.

IlvGraphic* IlvContainer::contains ( const IlvPoint & p ) const

Checks whether a point is in the container's objects.

Returns the topmost IlvGraphic object of this container that contains the given point, if such an object exists. If the object does not exist, the function returns 0.

Parameters

p	The point to be tested.

Returns: An object containing the given point, or 0 if none.

virtual IlvViewInputFile* IlvContainer::createInputFile ( istream & stream )

virtual

Creates an input file.

Creates an IlvViewInputFile from an input stream.

Parameters

stream The input stream.

Returns: An instance of the input file type corresponding to this type of container, opened in the stream stream.

void IlvContainer::disableRedrawTask ( )

Disactivates the lazy redraw mechanism.

This function prevents the lazy redraw task from happening when the process is idle. Any subsequent call to invalidateRegion() will restore the lazy redraw mechanism and reschedule the task.

virtual IlBoolean IlvContainer::dispatchToObjects ( IlvEvent & event )

virtual

Dispatches an event to an object.

Dispatches event to an object interactor if one exists.

Parameters

event The event.

Returns: IlFalse if the event is not handled by an interactor.

virtual void IlvContainer::draw ( const IlvRegion * region = 0 )

virtual

Draws all objects in the container with a clipping region.

Draws all the IlvGraphic objects that are stored in this IlvContainer object.

Parameters

clip	The clipping region, or 0 if none.

Reimplemented from IlvDrawingView.

virtual void IlvContainer::draw	(	IlvPort *	dst,
		const IlvTransformer *	t = `0`,
		const IlvRegion *	clip = `0`
	)

virtual

Draws all objects with transformation and a clipping region.

Draws all the objects that are stored in this IlvContainer object in the drawing port dst, with the transformer t and the clipping region clip. This virtual function lets you draw the container contents on any destination port, with any possible drawing parameters. It was designed for dumping.

Parameters

dst	The destination drawing port.
t	The transformation to be applied, or 0 if none.
clip	The clipping region, or 0 if none.

void IlvContainer::draw ( const IlvRect * rect )

Draws all objects within a rectangle.

Creates an IlvRegion from rect and calls the previous draw member function.

Parameters

rect	The initial rectangle stored in this region.

virtual void IlvContainer::eraseRegion ( const IlvRegion & region )

protectedvirtual

Erases a region.

Erases the region region.

Parameters

region The region to be erased.

virtual void IlvContainer::fitToContents ( )

virtual

Resizes the container to fit the overall bounding box of the graphic objects.

Resizes the container so it contains all the visible objects. However, the top left coordinates of the view remain at the same location.

virtual void IlvContainer::fitTransformerToContents ( IlBoolean redraw = IlTrue )

virtual

Resizes the objects to fit the container.

Computes a new transformer (scaling and translation only) for this container so that all objects that have the visibility attribute set to IlTrue can be seen in the view.

The computation is not always accurate: it assumes that the bounding box of a transformed graphic object is equal to the transformed bounding box, which is not true for non-zoomable objects. If there are such objects in the container, several calls to the method may be necessary to obtain the desired result.

Parameters

redraw If set to IlTrue the container is redrawn after the transformation. If it is set to IlFalse, the container will not be redrawn.

virtual void IlvContainer::flushRedraw ( )

virtual

Performs the actual redraw of invalid regions.

This function is called as an idle procedure just before a process becomes idle to handle all pending drawing tasks accumulated by calls to invalidateRegion(). You can call it if you want to force the refresh of your view at a given point in your program.

See Also: IlvEventLoop::addIdleProc.

Reimplemented from IlvPort.

IlvContainerAccelerator* IlvContainer::getAccelerator	(	IlvEventType	type,
		IlUShort	button = `0`,
		IlUShort	modifiers = `0`
	)		const

Gets an accelerator by event.

Returns a pointer to the IlvContainerAccelerator instance that matches this event. If an accelerator to match this event does not exist, then 0 is returned.

- Predefined accelerators for containers -

Event Type

Key or button

Action

IlvKeyUp

i

Sets the transformer to identity

IlvKeyDown

Right

Moves view to the left.

IlvKeyDown

Left

Moves view to the right.

IlvKeyDown

Down

Moves view to the top (decreasing x).

IlvKeyDown

Up

Moves view to the bottom (increasing x).

IlvKeyUp

Z

Zooms down into the view.

IlvKeyUp

U

Zooms out from the view.

IlvKeyDown

R

Rotates view 90 degrees counter-clockwise.

IlvKeyDown

f

Computes a new transformer so that every object can be seen.

Parameters

type	The accelerator event type.
button	The accelerator event data, or `0`.
mods	The accelerator mandatory event modifiers, or `0`.

Returns: A pointer to the IlvContainerAccelerator instance that matches this event, or 0 if none.

IlBoolean IlvContainer::getAccelerator	(	IlvContainerAction *	action,
		IlAny *	userarg,
		IlvEventType	type,
		IlUShort	buttonOrKey = `0`,
		IlUShort	modifiers = `0`
	)		const

Gets an accelerator by action and user argument.

Lets you query a container for a particular accelerator action and user argument. This function returns IlTrue if this accelerator exists in the container and fills in the action and userArg parameters if they are valid pointers (that is, non-0).

If no such accelerator exists, it returns IlFalse. You can thus test the existence of a particular accelerator by calling the * member function getAccelerator with 0 values for both action and userArg.

Parameters

action	The returned accelerator action, or `0`.
userArg	The returned user argument, or `0`.
type	The accelerator event type.
buttonOrKey	The accelerator event data, or `0`.
modifiers	The accelerator mandatory event modifiers, or `0`.

Returns: IlTrue if the accelerator exists orIlFalse if not.

IlUInt IlvContainer::getCardinal ( ) const

Gets the number of objects in the container.

Returns: The number of objects managed by the container view.

static IlvContainer* IlvContainer::GetContainer ( const IlvGraphic * )

static

Gets an object's container.

Use this static member function to retrieve the container where the specified object is stored. You cannot store an object in more than one container (or manager).

Parameters

obj	The object.

Returns: The container where obj is stored, or 0 if this object is not stored in any container.

IlInt IlvContainer::getIndex ( IlvGraphic * ) const

Gets an index.

Returns the index of object stored in the container list. The first object stored has 0 for index. If object is not located in this container, then the value -1 is returned, which must be considered as an error.

Parameters

object The object.

Returns: The index of the object, or -1 if the object is not in this container.

IlvGraphic* IlvContainer::getObject ( IlUInt index ) const

Gets an object by index.

Returns the object stored at index in the container list. If index is greater than the number of objects in the container, this member function returns 0.

Parameters

index The index of the object in the container list.

Returns: The object stored at index, or 0 if the index is invalid.

IlvGraphic* IlvContainer::getObject ( const char * ) const

Gets an object by name.

Attempts to return the object whose name is name. If no such object exists, then 0 is returned. If this name is shared by more than one object, the first object created in this container that has this name is returned.

Parameters

name	The name of the object.

Returns: The first object in the container with this name, or 0 if not found.

IlvViewObjectInteractor* IlvContainer::getObjectInteractor ( const IlvGraphic * g ) const

Gets an object interactor.

This method is obsolete. Use IlvGraphic::getInteractor.

See Also: IlvGraphic::getInteractor.

const char* IlvContainer::getObjectName ( const IlvGraphic * obj ) const

Gets an object name.

Returns the name of obj.

Parameters

obj	The object.

Returns: The name of obj.

IlvGraphic* const* IlvContainer::getObjects ( IlUInt & count ) const

Gets all objects in the container.

Returns an array of pointers to the objects stored in this container. count is set to the number of objects in this array. The returned array is stored in a temporary buffer. It must not be modified or deleted by the programmer. Moreover, other Rogue Wave Views routines can overwrite this buffer so it should be copied in a safe place if it needs to be persistent.

Parameters

count The returned number of objects in the array.

Returns: An array of pointers to the objects in the container.

IlvSmartSet* IlvContainer::getSmartSet ( const char * name ) const

Gets a SmartSet.

Parameters

name	The name of the SmartSet.

Returns: A pointer to the SmartSet called name in this container, or 0 if there is none.

IlvGraphic* const* IlvContainer::getTaggedObjects	(	const IlSymbol *	tag,
		IlUInt &	count
	)		const

Gets all objects with a specified tag.

Returns an array of pointers to the objects stored in this container and tagged with tag (or 0 if none are found). count is set to the number of objects in this array. The returned array is stored in a temporary buffer. It must not be modified or deleted by the programmer. Moreover, other Rogue Wave Views routines can overwrite this buffer so it should be copied in a safe place if it needs to be persistent.

Parameters

tag	The tag that defines the objects to be included.
count	The returned number of objects found.

Returns: An array of pointers to the objects in this container tagged with , or 0 if none.

IlvTransformer* IlvContainer::getTransformer ( ) const

Gets the transformation function.

Returns: The transformer associated with the container view. If 0 is returned, this container has no transformer associated with it; that is, there is identity.

virtual void IlvContainer::handleExpose ( IlvEvent & event )

virtual

Handles a newly exposed region.

This member function is called when this view reveals new regions that must be updated.

The default implementation calls reDraw with the relevant exposed region.

Parameters

event The event that is received for this expose event.

Reimplemented from IlvDrawingView.

virtual void IlvContainer::handleInput ( IlvEvent & event )

virtual

Handles an input event.

This member function is called when an input event (keystrokes or mouse events) is received by this view.

Its default implementation does nothing.

Parameters

event The input event that is received.

Reimplemented from IlvDrawingView.

virtual void IlvContainer::hide ( )

virtual

Hides the view.

Removes the window from the visible windows on your screen.

Reimplemented from IlvView.

void IlvContainer::initReDraw ( )

Initializes an invalidated region to empty.

Initializes the invalidated region to an empty region. These calls can be embedded, that is, if there has been a previous call to initReDraw and no matching reDrawView or abortReDraw, then this function does not reset the invalid region.

virtual void IlvContainer::insertObject	(	IlvGraphic *	obj,
		IlBoolean	redraw = `IlFalse`
	)

virtual

Inserts the object at the bottom of the container list.

Adds obj at the beginning of the list, so that the object is displayed behind all the other objects.

Parameters

obj	The object to be inserted.
redraw	If set to `IlTrue` the container is redrawn. If it is set to `IlFalse`, the container will not be redrawn.

void IlvContainer::invalidateRegion ( const IlvGraphic * object )

Invalidates an object's region.

Invalidates the area covered by object after it has been applied by the current container's transformer.

Parameters

object The object defining the invalid region.

void IlvContainer::invalidateRegion ( const IlvRect & rect )

Invalidates a rectangle's region.

Invalidates the rectangle rect in the view coordinate system.

Parameters

rect	The rectangle defining the invalid region.

void IlvContainer::invalidateRegion ( const IlvRegion & rect )

Invalidates a region..

Adds a rectangle to the update region and schedules a redraw task to happen before the process becomes idle.

Parameters

rect	The rectangle, specified in manager coordinates.

void IlvContainer::invalidateRegion	(	const IlvRegionUpdater &	updater,
		const IlvGraphic *	graphic = `0`
	)

Updates the invalidated region.

Uses the updater object to update the invalidated region and schedules a redraw task to happen before the process becomes idle.

Parameters

updater	The object used to update the invalidated region.
graphic	The `IlvGraphic` that requested the invalidation of this region.

See Also: IlvRegionUpdater::update.

IlBoolean IlvContainer::isDoubleBuffering ( ) const

Tests the double buffering setting.

Returns: A value that specifies whether (IlTrue) or not (IlFalse) this container is actually using double buffering.

IlBoolean IlvContainer::isInvalidating ( ) const

Indicates whether the container is in a phase of invalidating regions.

Returns: IlTrue if the container has scheduled some redraw task to perform when the process is idle.

IlBoolean IlvContainer::isVisible ( const IlvGraphic * obj ) const

Tests the visibility setting of an object.

Parameters

obj	The object.

Returns: The visibility state of obj, that is, IlTrue if the object is visible, or IlFalse if it is not.

virtual IlBoolean IlvContainer::read ( istream & stream )

virtual

Loads an Rogue Wave Views data file from the input stream.

Reads a set of IlvGraphic objects from the input stream specified in stream.

Parameters

stream The input stream.

virtual IlBoolean IlvContainer::readFile ( const char * filename )

virtual

Reads an Rogue Wave Views data file.

Reads a set of IlvGraphic objects from the file named filename. This member function returns IlTrue on success or IlFalse if there has been an error. This file is typically created through an IlvManager object. If the string filename is a relative path name, then the file is searched in each directory referenced in the display path. This function calls the member function IlvContainer::read.

Warning: [note] Unix platforms may not properly read files that have been generated on Windows in text mode. Refer to the member function IlvManager::save for more information. Rogue Wave Views Studio uses the text mode.

Parameters

filename The name of the file to be read from.

virtual void IlvContainer::reDraw ( const IlvRegion * region = 0 )

virtual

Redraws all objects in the container with a clipping region.

Erases the entire clipping region, calls the eraseRegion function, then calls the draw function, giving this region as a parameter.

Parameters

clip	The clipping region, or 0 if none.

Reimplemented from IlvDrawingView.

void IlvContainer::reDraw ( const IlvRect * rect )

Redraws all objects within a rectangle.

Creates an IlvRegion from rect and calls the previous reDraw member function.

Parameters

rect	The initial rectangle stored in this region.

void IlvContainer::reDrawObj ( IlvGraphic * obj )

Redraws an object.

Redraws the bounding box of the IlvGraphic object.

Parameters

obj	The object whose bounding box is to be redrawn.

void IlvContainer::reDrawView	(	IlBoolean	erase = `IlTrue`,
		IlBoolean	buffered = `IlFalse`
	)

Redraws a view.

Refreshes all the invalidated regions. The view is first erased if the parameter erase is set to IlTrue. The redrawing is buffered if the parameter buffered is set to IlTrue. The invalid region is reset to an empty region.

If there has been more than one call to initReDraw before reDrawView is called, this function does nothing.

Parameters

erase	A Boolean value indicating whether to erase the view (`IlTrue`) or not (`IlFalse`).
buffered	A Boolean value indicating whether the redraw is buffered (`IlTrue`) or not (`IlFalse`).

void IlvContainer::registerCallback	(	const char *	callbackName,
		IlvGraphicCallback	callback
	)

Registers a callback.

Associates the user function callback with the string callbackName. This string will be registered using the class IlSymbol.

Parameters

callbackName	The name under which the callback is registered.
callback	The callback to be registered.

void IlvContainer::removeAccelerator ( IlvContainerAccelerator * acc )

Removes a specified accelerator.

Removes this accelerator from the accelerator list of the container. The acc parameter is not deleted.

Parameters

acc	The accelerator to be removed.

void IlvContainer::removeAccelerator	(	IlvEventType	type,
		IlUShort	buttonOrKey = `0`,
		IlUShort	modifiers = `0`
	)

Removes an accelerator by event.

Removes the association between the event description and the action.

Parameters

type	The accelerator event type.
buttonOrKey	The accelerator event data (button or key).
modifiers	The accelerator mandatory event modifiers.

virtual IlBoolean IlvContainer::removeObject	(	IlvGraphic *	obj,
		IlBoolean	redraw = `IlFalse`
	)

virtual

Removes an object from the container.

Removes the association between the object and the container view. The object itself is not deleted.

When the object is removed from the container, all the properties related to the container are removed. However the other properties are retained (that is, the object name, its named properties, and so forth).

Parameters

obj	The object to be removed.
redraw	If set to `IlTrue` the container is redrawn. If it is set to `IlFalse`, the container will not be redrawn.

Returns: IlFalse if the object was not stored in this container.

virtual void IlvContainer::removeObjects	(	IlBoolean	destroy = `IlTrue`,
		IlBoolean	redraw = `IlTrue`
	)

virtual

Removes all objects from the container.

Removes the association of all objects with the container view. The objects themselves are not deleted if the destroy parameter is set to IlFalse.

Parameters

destroy	Set to `IlTrue` to delete the objects.
redraw	If set to `IlTrue` the container is redrawn. If it is set to `IlFalse`, the container will not be redrawn.

virtual IlBoolean IlvContainer::removeSmartSet ( IlvSmartSet * )

virtual

Removes a SmartSet.

Removes the SmartSet set from the container. The objects are renamed to their intrinsic name.

Parameters

set	A SmartSet to be removed.

Returns: IlFalse on error, that is, if set is not in the container.

void IlvContainer::removeTaggedObjects	(	const IlSymbol *	tag,
		IlBoolean	destroy = `IlTrue`,
		IlBoolean	reDraw = `IlTrue`
	)

Removes all objects with a specified tag.

Removes from the container all the objects tagged with tag. If destroy is IlTrue, the objects are deleted. If reDraw is IlTrue, the container redraws the applicable areas.

Parameters

tag	The tag that defines the objects to be included.
destroy	A Boolean value specifying whether to delete the objects `IlTrue` or not `IlFalse`.
reDraw	If set to `IlTrue` the container is redrawn. If it is set to `IlFalse`, the container will not be redrawn.

virtual IlvGraphic* IlvContainer::replace	(	IlvGraphic *	oldObject,
		IlvGraphic *	newObject,
		IlBoolean	redraw = `IlFalse`
	)

virtual

Replaces an object.

Replaces the IlvGraphic instance oldObject by the IlvGraphic object newObject. If redraw is IlTrue, the reDrawObj member function of the newObject is called.

Parameters

oldObject	The object to be replaced.
newObject	The new object.
redraw	If set to `IlTrue` the container is redrawn. If it is set to `IlFalse`, the container will not be redrawn.

virtual void IlvContainer::setBackground ( IlvColor * c )

virtual

Sets the background color of this view.

The color is used when erasing is required. Thus, a call to setBackground is effective only when regions are erased.

Parameters

c	The new background color of this view. This color is locked, and the previous color is unlocked.

Reimplemented from IlvAbstractView.

virtual void IlvContainer::setBackgroundBitmap ( IlvBitmap * b )

virtual

Sets the background bitmap of this view.

The bitmap provided (if it is not 0) is locked. The previous bitmap, if there was one, is unlocked. If the bitmap provided is 0, the background color is used to ( erase the view. To remove properly a background bitmap that was previously set, you must do the following:

view->setBackgroundBitmap(0); // Remove the background bitmap
manager->setBackground(view, view->getBackground()); // Update the manager
manager->draw(view, IlTrue); // Redraw the view

This code must be used also for containers (replaces manager by container in code).

Warning: [note] There is a limitation on Windows 95, because Windows 95 can only handle bitmaps with a size of 8x8.

Reimplemented from IlvAbstractView.

IlBoolean IlvContainer::setDoubleBuffering ( IlBoolean value )

Sets double buffering.

Use this member function to indicate whether or not this container should use double buffering.

Parameters

value A Boolean value indicating if this container should use double buffering (IlTrue) or not (IlFalse).

IlBoolean IlvContainer::setObjectInteractor	(	IlvGraphic *	obj,
		IlvViewObjectInteractor *	inter
	)

Sets an object interactor on a graphic object.

This method is obsolete. Use IlvGraphic::setInteractor.

See Also: IlvGraphic::setInteractor.

virtual void IlvContainer::setObjectName	(	IlvGraphic *	obj,
		const char *	s
	)

virtual

Sets an object name.

Gives a name to obj. This is done by copying the name argument. You are allowed to give the same name to two different objects but the getObject method will always return the first object whose name is name.

Parameters

obj	The object.
name	The name to be given to obj.

virtual void IlvContainer::setTransformer ( const IlvTransformer & t )

virtual

Applies another transformer to the coordinates provided for the drawing functions.

Parameters

t	The transformer that is applied.

Reimplemented from IlvSystemPort.

void IlvContainer::setTransformer ( const IlvTransformer * t = 0 )

Sets the transformation function.

Sets the transformer associated with the container view. A 0 value means no transformer, that is, the identity transformer. The transformer is internally copied during this function call.

Parameters

t	The transformation to be applied, or 0 if none.

virtual void IlvContainer::setVisible	(	IlvGraphic *	obj,
		IlBoolean	visible,
		IlBoolean	redraw = `IlFalse`
	)

virtual

Sets the visibility of an object.

Changes the visibility of obj to the value given in the visible parameter. This method only works with an object that is already in the container.

Parameters

obj	The object.
visible	A Boolean value indicating whether the object is to be visible (`IlTrue`) or invisible (`IlFalse`).
redraw	If set to `IlTrue` the container is redrawn. If it is set to `IlFalse`, the container will not be redrawn.

virtual IlBoolean IlvContainer::shortCut ( IlvEvent & event )

virtual

Verbose:

Dispatches event to an accelerator.

Parameters

event The incoming event.

Returns: IlTrue if the accelerator exists; otherwise, it returns IlFalse.

virtual void IlvContainer::show ( )

virtual

Shows the view.

Displays the window on the screen. A window can be created in such a way that you cannot see it upon creation, which allows you to draw on that window before it is displayed.

Reimplemented from IlvView.

virtual void IlvContainer::swap	(	IlvGraphic *	,
		IlvGraphic *
	)

virtual

Swaps two objects.

Interchanges the two objects obj1 and obj2 with respect to their order in the list of objects of the container, thus modifying the order in which objects are stacked.

Parameters

obj1	The first object.
obj2	The second object.

void IlvContainer::translateView	(	IlvPos	dx,
		IlvPos	dy,
		IlBoolean	redraw = `IlTrue`
	)

Translates the current view.

Composes the current transformer with a translation specified by dx and dy. Set the redraw parameter to IlFalse to prevent an immediate display update.

Parameters

dx	Translation along the horizontal axis.
dy	Translation along the vertical axis.
redraw	If set to `IlTrue` the container is redrawn after the transformation. If it is set to `IlFalse`, the container will not be redrawn.

void IlvContainer::unregisterCallback ( const char * callbackName )

Unregisters a callback.

Removes the callback function which has been registered with the name callbackName, from the callback list.

Parameters

callbackName The name of the callback to be removed.

void IlvContainer::visibleBBox ( IlvRect & rect ) const

Determines the visible bounding box of the container.

Returns the bounding box of all visible objects in the view coordinate system.

Parameters

rect	The returned visible bounding box.

void IlvContainer::zoomView	(	const IlvPoint &	center,
		IlFloat	scalex,
		IlFloat	scaley = `0.0`,
		IlBoolean	redraw = `IlTrue`
	)

Zooms the current view.

Composes the current transformer with a transformer that zooms by a factor of scaleX and scaleY, and leaves the center point in the container at its original place. If scaleY is 0, then we assume the scaling factor is the same in y as in x. Set the redraw parameter to IlFalse to prevent an immediate display update.

Parameters

center	The center point of the transformation.
scaleX	Zooming factor on the horizontal axis.
scaleY	Zooming factor on the vertical axis.
redraw	If set to `IlTrue` the container is redrawn after the transformation. If it is set to `IlFalse`, the container will not be redrawn.

Rogue Wave ViewsFoundation Package API Reference Guide

Public Member Functions

Static Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Event Type

Key or button

Action

Rogue Wave Views
Foundation Package API Reference Guide