rwlogo
Rogue Wave Views 5.6

Rogue Wave Views
Data Access Package API Reference Guide

Product Documentation:

Rogue Wave Views
Documentation Home

IliGadgetSet Class Reference

Gadget class. More...

#include <ilviews/dataccess/gadgets/gadset.h>

Inheritance diagram for IliGadgetSet:
IlvGadget IlvSimpleGraphic IlvGraphic IliDbNavigator IliToggleSelector

List of all members.

Public Member Functions

 IliGadgetSet (IlvDisplay *display, const IlvRect &rect, IlUShort thickness=IlvDefaultGadgetThickness, IlvPalette *palette=0)
 Initializes an empty gadget set.
virtual void addObject (IlvGadget *obj, IlBoolean visible=IlTrue)
 Adds a gadget to the gadget set.
void disableToolTip ()
 Disables tooltip display.
void enableToolTip ()
 Enables tooltip display.
IlUInt getCardinal () const
 Returns the number of gadgets in the gadget set.
IlvGadgetgetFocusObject () const
 Returns the focus gadget of the gadget set or NULL if no focus gadget is defined.
IlInt getIndex (IlvGadget *g) const
 Returns the position of a gadget in the gadget set.
IlvGadgetgetObject (const char *name) const
 Returns a gadget.
IlvGadgetgetObject (IlUInt index) const
 Returns a gadget.
IlBoolean isObjectSensitive (IlvGadget *obj) const
 Returns IlTrue if gadget is sensitive to user interaction.
IlBoolean isVisible (const IlvGadget *) const
 Returns IlTrue if the gadget parameter belongs to the gadget set and if it is visible.
virtual void objectReceivedEvent (IlvGadget *obj)
 Called when a gadget received an event.
virtual void removeObject (IlvGadget *obj, IlBoolean deleteIt=IlTrue)
 Removes a gadget from the gadget set.
virtual IlBoolean setFocusObject (IlvGadget *obj)
 Sets the focus gadget.
void setObjectSensitive (IlvGadget *obj, IlBoolean active)
 Enables/disables user interaction.
void setVisible (IlvGadget *obj, IlBoolean visible)
 Shows/Hides a gadget.

Detailed Description

Gadget class.

Library: dbgadget

The IliGadgetSet defines a gadget that contains other gadgets. Each gadget is part of a gadget set which has:

In addition, one of the gadgets in a gadget set can be the focus gadget. A focus gadget is the gadget that will receive the focus if the gadget set is given the focus.


Constructor & Destructor Documentation

IliGadgetSet::IliGadgetSet ( IlvDisplay display,
const IlvRect rect,
IlUShort  thickness = IlvDefaultGadgetThickness,
IlvPalette palette = 0 
)

Initializes an empty gadget set.

Parameters:
display The display.
rect The location.
thickness The border thickness.
palette The palette.

Member Function Documentation

virtual void IliGadgetSet::addObject ( IlvGadget obj,
IlBoolean  visible = IlTrue 
) [virtual]

Adds a gadget to the gadget set.

Parameters:
obj The gadget.
visible The gadget visibility. The gadget set becomes the owner of the gadget.
void IliGadgetSet::enableToolTip (  ) 

Enables tooltip display.

The tooltip is displayed if the gadget under the mouse cursor has a tooltip, otherwise nothing is displayed.

IlUInt IliGadgetSet::getCardinal (  )  const

Returns the number of gadgets in the gadget set.

Returns:
The count.
IlvGadget* IliGadgetSet::getFocusObject (  )  const

Returns the focus gadget of the gadget set or NULL if no focus gadget is defined.

Returns:
The focus gadget of the gadget set or NULL if no focus gadget is defined.
IlInt IliGadgetSet::getIndex ( IlvGadget g  )  const

Returns the position of a gadget in the gadget set.

Parameters:
g The gadget.
Returns:
The position.
IlvGadget* IliGadgetSet::getObject ( const char *  name  )  const

Returns a gadget.

Parameters:
name The gadget name.
Returns:
The gadget or NULL if no such gadget is found.
IlvGadget* IliGadgetSet::getObject ( IlUInt  index  )  const

Returns a gadget.

Parameters:
index The gadget position.
Returns:
The gadget.
IlBoolean IliGadgetSet::isObjectSensitive ( IlvGadget obj  )  const

Returns IlTrue if gadget is sensitive to user interaction.

Parameters:
obj The gadget.
Returns:
IlTrue if gadget is sensitive to user interaction.
IlBoolean IliGadgetSet::isVisible ( const IlvGadget  )  const

Returns IlTrue if the gadget parameter belongs to the gadget set and if it is visible.

Returns:
IlTrue if the gadget parameter belongs to the gadget set and if it is visible.
virtual void IliGadgetSet::objectReceivedEvent ( IlvGadget obj  )  [virtual]

Called when a gadget received an event.

The callbacks of the gadget are called before this function. For example, if the gadget is a button, the callback of the button is called before this function. By default this function do nothing. In the IliDbNavigator class, this function calls the main callback.

Parameters:
obj The gadget.

Reimplemented in IliDbNavigator.

virtual void IliGadgetSet::removeObject ( IlvGadget obj,
IlBoolean  deleteIt = IlTrue 
) [virtual]

Removes a gadget from the gadget set.

Parameters:
obj The gadget.
deleteIt If IlTrue, the gadget is deleted.
virtual IlBoolean IliGadgetSet::setFocusObject ( IlvGadget obj  )  [virtual]

Sets the focus gadget.

Parameters:
obj The gadget.

Reimplemented in IliToggleSelector.

void IliGadgetSet::setObjectSensitive ( IlvGadget obj,
IlBoolean  active 
)

Enables/disables user interaction.

Parameters:
obj The gadget.
active If IlTrue, the gadget becomes sensitive to user interaction. Otherwise, it is not sensitive to user interaction.
void IliGadgetSet::setVisible ( IlvGadget obj,
IlBoolean  visible 
)

Shows/Hides a gadget.

Parameters:
obj The gadget.
visible If IlTrue, the gadget is visible.
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Friends

© Copyright 2012, Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave is a registered trademark of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.