IlvDvActionDescriptor Class Reference

Set of description parameters associated with an action. More...

#include <ilviews/appframe/command.h>

Inheritance diagram for IlvDvActionDescriptor:

List of all members.

Public Types
enum	State { Active, Unactive, Unsensitive }
	Action descriptor date. More...
Public Member Functions
virtual IlvBitmap *	getBitmap (const IlSymbol *state=0) const =0
	Gets the bitmap of the action descriptor.
virtual const char *	getLabel () const =0
	Gets the label of the action.
virtual State	getState () const =0
	Returns the state of the action descriptor.
virtual void	setBitmap (IlvBitmap *bitmap, const IlSymbol *state=0)=0
	Sets the bitmap associated with the action descriptor, when it is in the state state. If state is omitted or set to 0, the normal state is assumed. The new bitmap is locked, and the previous bitmap is unlocked.
virtual void	setChecked (IlBoolean check=IlTrue)=0
	Sets whether the action descriptor is checked.
virtual void	setLabel (const char *label)=0
	Sets the label associated with the action descriptor to a copy of the label parameter.
virtual void	setState (State state)=0
	Sets the state of the action descriptor.
void	setValid (IlBoolean valid)
	Sets the action descriptor to valid or not valid.

---

Detailed Description

Set of description parameters associated with an action.

Library: ilvappframe

Stores the GUI parameters of an action used to initialize menu items associated with the action.

---

Member Enumeration Documentation

enum IlvDvActionDescriptor::State

Action descriptor date.

This enumeration indicates the different states that an action descriptor can have.

Enumerator:

Active	Active enumeration value. This enumeration value indicates that the action descriptor is in an active state. Corresponding menu items are not grayed and can be activated.
Unactive	Unactive enumeration value. This enumeration value indicates that the action descriptor is in a non-active state. Corresponding menu items are not grayed but can not be activated.
Unsensitive	Unsensitive enumeration value. This enumeration value indicates that the action descriptor is in an unsensitive state. Corresponding menu items are grayed and can not be activated.

---

Member Function Documentation

virtual IlvBitmap* IlvDvActionDescriptor::getBitmap

(

const IlSymbol *

state = 0

)

const [pure virtual]

Gets the bitmap of the action descriptor.

Parameters:

label

The new label for this action.

Returns:

The bitmap associated with the action descriptor, when it is in the state state. If state is omitted or set to 0, the normal state is assumed.

Implemented in IlvDvActionGadgetItem.

virtual const char* IlvDvActionDescriptor::getLabel

(

)

const [pure virtual]

Gets the label of the action.

Returns:

The label associated with the action.

Implemented in IlvDvActionGadgetItem.

virtual void IlvDvActionDescriptor::setBitmap	(	IlvBitmap *	bitmap,
		const IlSymbol *	state = 0
	)			[pure virtual]

Sets the bitmap associated with the action descriptor, when it is in the state state.
If state is omitted or set to 0, the normal state is assumed.
The new bitmap is locked, and the previous bitmap is unlocked.

Parameters:

	bitmap	The new bitmap for the action descriptor.
	state	The state that the given bitmap applies to.

Implemented in IlvDvActionGadgetItem.

virtual void IlvDvActionDescriptor::setChecked

(

IlBoolean

check = IlTrue

)

[pure virtual]

Sets whether the action descriptor is checked.

Checks the action descriptor if the check parameter is IlTrue. In this case, all related menu items are checked. These menu items are pushed if they are in a toolbar, and they are checked if they are in a popup menu.
If the valid parameter is IlFalse, the action descriptor is unchecked. All related menu items are unchecked. These menu items are unpushed if they are in a toolbar, and they are unchecked if they are in a popup menu.

Parameters:

valid

Indicates whether the action descriptor is to be checked or unchecked.

Implemented in IlvDvActionGadgetItem.

virtual void IlvDvActionDescriptor::setLabel

(

const char *

label

)

[pure virtual]

Sets the label associated with the action descriptor to a copy of the label parameter.

Parameters:

label

The new label for the action.

Implemented in IlvDvActionGadgetItem.

virtual void IlvDvActionDescriptor::setState

(

State

state

)

[pure virtual]

Sets the state of the action descriptor.

All menu items that correspond to this action descriptor will be modified with a new state and a new bitmap, according to the state that is specified.

Parameters:

state

Indicates the new state for the action descriptor.

Implemented in IlvDvActionGadgetItem.

void IlvDvActionDescriptor::setValid

(

IlBoolean

valid

)

Sets the action descriptor to valid or not valid.

If valid is IlTrue, the Active state is given to the action descriptor. Otherwise, the action descriptor is set to the Unsensitive state.

Parameters:

valid

Indicates whether the action descriptor is to be active or unsensitive.