Gadget class that displays a message and a bitmap. More...

#include <ilviews/gadgets/msglabel.h>

Inheritance diagram for IlvMessageLabel:

Public Member Functions
	IlvMessageLabel (IlvDisplay display, const char message, const IlvRect &rect, IlvAlignment alignment=IlvLeft, IlUShort thickness=0, IlvPalette *palette=0, IlBoolean copy=IlTrue)
	Constructor. More...

	IlvMessageLabel (IlvDisplay display, const IlvPoint &at, const char message, IlvAlignment alignment=IlvLeft, IlUShort thickness=0, IlvPalette *palette=0, IlBoolean copy=IlTrue)
	Constructor. More...

virtual IlvGadgetItem *	applyToItems (IlvApplyGadgetItem f, IlAny arg)
	Applies the specified function to all the items of the holder. More...

IlvAlignment	getAlignment () const
	Returns the alignment of the message label. More...

IlvBitmap *	getBitmap () const
	Returns the bitmap associated with the message label. More...

IlvBitmap *	getInsensitiveBitmap () const
	Returns the insensitive bitmap of the message label. More...

const char *	getLabel () const
	Returns the label stored in the message label. More...

virtual void	getLabelOrientation (IlvOrientation &orientation, IlBoolean &flip) const
	Returns the orientation of the label. More...

virtual IlvPosition	getLabelPosition () const
	Returns the position of the label relative to the bitmap of the message label. More...

const char *	getMessage () const
	Returns the translated message of the message label. More...

char	getMnemonic () const
	Returns the mnemonic associated with the message label. More...

virtual IlvPalette *	getNormalTextPalette () const
	Returns the default palette used to draw an item. More...

virtual IlvPalette *	getOpaquePalette () const
	Returns the opaque palette used to draw opaque items. More...

IlUShort	getSpacing () const
	Returns the spacing between the label and the bitmap of the message label. More...

void	setAlignment (IlvAlignment alignment)
	Sets the alignment of this message label. More...

void	setBitmap (IlvBitmap *bitmap)
	Sets the bitmap of the message label. More...

void	setInsensitiveBitmap (IlvBitmap *bitmap)
	Sets the insensitive bitmap of the message label. More...

void	setLabel (const char *label, IlBoolean copy=IlTrue)
	Sets the label of the message label. More...

void	setLabelOrientation (IlvOrientation orientation, IlBoolean flip=IlFalse, IlBoolean redraw=IlTrue)
	Sets the orientation of the label. More...

void	setLabelPosition (IlvPosition pos, IlBoolean redraw=IlTrue)
	Sets the position of the label relative to the bitmap of the message label. More...

void	setSpacing (IlUShort spacing, IlBoolean redraw=IlTrue)
	Sets the spacing between the label and the bitmap of the message label. More...

Public Member Functions inherited from IlvGadgetItemHolder
virtual IlvGadgetItem *	createItem (const char label, IlvGraphic graphic=0, IlvBitmap bitmap=0, IlvBitmap selbitmap=0, IlBoolean copy=IlTrue) const
	Returns a new gadget item. More...

virtual void	drawGadgetItem (const IlvGadgetItem item, IlvPort port, const IlvRect &rect, const IlvTransformer t=0, const IlvRegion clip=0) const
	Draws a specific gadget item. More...

IlvGadgetItem *	getCallbackItem () const
	Returns the item that triggered a callback. More...

IlvGadgetItem *	getDragDropTarget () const
	Returns the target item of a drag-and-drop operation. More...

IlvGraphic *	getDraggedImage () const
	Returns the graphic object used to draw the ghost image during a drag-and-drop operation. More...

IlvGadgetItem *	getDraggedItem () const
	Returns the item that is being dragged during a drag-and-drop operation. More...

IlvGadgetItem *	getEditedItem () const
	Returns the item that is being edited. More...

virtual IlvPalette *	getHighlightTextPalette () const
	Returns the highlight palette used to draw the label of highlighted items. More...

virtual IlvGadgetItem *	getItemByName (const char *name) const
	Returns the item whose name is specified. More...

IlvGadgetItem *	getToolTipItem () const
	Returns the item that is displaying a tooltip. More...

virtual void	initReDrawItems ()
	Begins a redraw session. More...

virtual void	recomputeAllItems ()
	Recomputes the size of all the items managed by the holder. More...

virtual void	reDrawItems ()
	Ends a redraw session. More...

void	setDragDropTarget (IlvGadgetItem *item)
	Sets the target item of a drag-and-drop operation. More...

void	setDraggedImage (IlvGraphic *graphic)
	Sets the graphic object used to draw the ghost image during a drag-and-drop operation. More...

void	setDraggedItem (IlvGadgetItem *item)
	Sets the dragged item. More...

Friends
class	IlvDefaultMessageLabelLFHandler

Additional Inherited Members
Static Public Member Functions inherited from IlvGadgetItemHolder
static IlSymbol *	AbortDragItemCallbackType ()
	Returns the callback type of the Abort Drag callback. More...

static IlSymbol *	AbortEditItemCallbackType ()
	Returns the callback type of the Abort Edit callback. More...

static IlSymbol *	ActivateCallbackType ()
	Returns the callback type of the Activate callback. More...

static IlSymbol *	DragItemCallbackType ()
	Returns the callback type of the Drag Item callback. More...

static IlSymbol *	EndDragItemCallbackType ()
	Returns the callback type of the End Drag callback. More...

static IlSymbol *	EndEditItemCallbackType ()
	Returns the callback type of the End Edit callback. More...

static IlSymbol *	StartDragItemCallbackType ()
	Returns the callback type of the Start Drag callback. More...

static IlSymbol *	StartEditItemCallbackType ()
	Returns the callback type of the Start Edit callback. More...

Protected Member Functions inherited from IlvGadgetItemHolder
virtual void	abortDragItem ()
	Is called when a drag-and-drop operation is aborted. More...

virtual void	abortEdit (IlvGadgetItem *item)
	Is called when the editing of the specified item is aborted. More...

virtual void	drawDraggedImage (const IlvPoint &point, const IlvTransformer *t)
	Is called to draw the ghost image during a drag-and-drop operation. More...

virtual void	endDragItem (const IlvPoint &point)
	Is called when a drag-and-drop operation is finished. More...

virtual void	endEdit (IlvGadgetItem *item)
	Is called after an item has been edited. More...

virtual void	itemActivated (IlvGadgetItem *item)
	Is called when an item is activated. More...

virtual void	itemDeSelected (IlvGadgetItem *item)
	Is called when an item is deselected. More...

virtual void	itemDragged (const IlvPoint &point)
	Is called each time the user moves the mouse during a drag-and-drop operation. More...

virtual void	itemHighlighted (IlvGadgetItem *item)
	Is called when an item is highlighted or unhighlighted. More...

virtual void	itemSelected (IlvGadgetItem *item)
	Is called when an item is selected. More...

virtual void	startDragItem (IlvGadgetItem *item)
	Is called when a drag-and-drop operation begins. More...

virtual void	startEdit (IlvGadgetItem *item)
	Is called when an item is edited. More...

Detailed Description

Gadget class that displays a message and a bitmap.

Library: ilvgadgt

The message label is a character string that can be translated to various languages to create localized applications. Translated strings are stored in a message database that can be associated with the current instance of IlvDisplay. Both sensitive and insensitive bitmaps can be specified for a message label. The insensitive bitmap will be used when the message label is insensitive. The message label can be placed to any position relative to the bitmap. The default IlvMessageLabel position is IlvCenter. This object has no associated default interactor.

- IlvMessageLabel -

See also: IlvMessageDatabase, IlvBitmap.

Accessors

Accessors provide a scriptable and uniform way to inspect and modify an object by using its base class methods IlvValueInterface::queryValue(), IlvValueInterface::queryValues(), IlvValueInterface::changeValue(), IlvValueInterface::changeValues(). This class inherits the accessors of its superclass IlvGadget and adds the following ones:

Name	Type	Equivalent methods
`alignment`	Direction	`getAlignment()`, `setAlignment()`
`bitmap`	Bitmap	`getBitmap()`, `setBitmap()`
`insensitiveBitmap`	Bitmap	`getInsensitiveBitmap()`, `setInsensitiveBitmap()`
`label`	String	`getLabel()`, `setLabel()`
`labelPosition`	Direction	`getLabelPosition()`, `setLabelPosition()`
`opaque`	Boolean	`isTransparent()`, `setTransparent()`
`spacing`	UInt	`getSpacing()`, `setSpacing()`
`labelOrientation`	Direction	`getLabelOrientation()`, `setLabelOrientation()`
`flipLabel`	Boolean	`getLabelOrientation()`, `setLabelOrientation()`

Styling

This class supports the following CSS properties:

Graphic property	CSS property	Type
Background color	`background-color`	Color
Text color	`color`	Color

Constructor & Destructor Documentation

IlvMessageLabel::IlvMessageLabel	(	IlvDisplay *	display,
		const char *	message,
		const IlvRect &	rect,
		IlvAlignment	alignment = `IlvLeft`,
		IlUShort	thickness = `0`,
		IlvPalette *	palette = `0`,
		IlBoolean	copy = `IlTrue`
	)

Constructor.

Initializes a new instance of the IlvMessageLabel class.

Parameters

display	The connection to the display.
message	The label of the message label.
rect	The size and position of the message label.
alignment	The alignment of the message label inside its bounding box.
thickness	The thickness of the message label.
palette	The palette used by the message label.
copy	A Boolean value specifying whether a message should be copied. If the value is `IlFalse`, then you must allocate some memory for the message because in any case the message characters are deleted from the memory by the IlvMessageLabel.

IlvMessageLabel::IlvMessageLabel	(	IlvDisplay *	display,
		const IlvPoint &	at,
		const char *	message,
		IlvAlignment	alignment = `IlvLeft`,
		IlUShort	thickness = `0`,
		IlvPalette *	palette = `0`,
		IlBoolean	copy = `IlTrue`
	)

Constructor.

Initializes a new instance of the IlvMessageLabel class. Since only the position of the object is given, its size is computed according to its contents.

Parameters

display	The connection to the display.
message	The label of the message label.
at	The position of the message label.
alignment	The alignment of the message label inside its bounding box.
thickness	The thickness of the message label.
palette	The palette used by the message label.
copy	A Boolean value specifying whether a message should be copied. If the value is `IlFalse`, then you must allocate some memory for the message because in any case the message characters are deleted from the memory by the IlvMessageLabel.

Member Function Documentation

virtual IlvGadgetItem* IlvMessageLabel::applyToItems	(	IlvApplyGadgetItem	func,
		IlAny	arg
	)

virtual

Applies the specified function to all the items of the holder.

Parameters

func	The function to be applied.
arg	The argument that will be passed to the function func.

Returns: The item that stopped the operation.

See also: IlvApplyGadgetItem, recomputeAllItems(), getItemByName().

Reimplemented from IlvGadgetItemHolder.

IlvAlignment IlvMessageLabel::getAlignment ( ) const

Returns the alignment of the message label.

Returns: The alignment value used to draw the message label inside its bounding box.

See also: setAlignment(), setLabelPosition().

IlvBitmap* IlvMessageLabel::getBitmap ( ) const

Returns the bitmap associated with the message label.

Returns: The bitmap used by this message label, or 0 if there is none.

See also: setBitmap(), setInsensitiveBitmap().

IlvBitmap* IlvMessageLabel::getInsensitiveBitmap ( ) const

Returns the insensitive bitmap of the message label.

The insensitive bitmap is displayed by the message label when it is set to insensitive. If only a sensitive bitmap is provided, and if the message label is set to insensitive, a default insensitive bitmap is automatically computed using the sensitive bitmap.

Returns: The bitmap used by this message label when set to insensitive or 0 if there is none.

See also: setInsensitiveBitmap(), setBitmap().

const char* IlvMessageLabel::getLabel ( ) const

Returns the label stored in the message label.

Returns: The label stored in the object or 0 if no label has been set.

See also: setLabel(), getMessage().

virtual void IlvMessageLabel::getLabelOrientation	(	IlvOrientation &	orientation,
		IlBoolean &	flip
	)		const

virtual

Returns the orientation of the label.

Parameters

orientation	The label orientation.
flip	A Boolean value specifying whether the label is drawn from top to bottom or from bottom to top.

See also: setLabelOrientation().

Reimplemented from IlvGadgetItemHolder.

virtual IlvPosition IlvMessageLabel::getLabelPosition ( ) const

virtual

Returns the position of the label relative to the bitmap of the message label.

Returns: The position of the label relative to the bitmap.

See also: setLabelPosition(), setAlignment().

Reimplemented from IlvGadgetItemHolder.

const char* IlvMessageLabel::getMessage ( ) const

Returns the translated message of the message label.

Returns: The definition of the message stored in this object translated in the current language or 0 if no label is associated with this message label. If the message stored in this object has no translation in the current language, the method simply returns the message itself.

See also: getLabel(), IlvMessageDatabase.

char IlvMessageLabel::getMnemonic ( ) const

Returns the mnemonic associated with the message label.

Returns: The mnemonic used by this message label or 0 if there is none.

See also: setLabel().

virtual IlvPalette* IlvMessageLabel::getNormalTextPalette ( ) const

virtual

Returns the default palette used to draw an item.

Returns: The default palette used to draw an item.

Implements IlvGadgetItemHolder.

virtual IlvPalette* IlvMessageLabel::getOpaquePalette ( ) const

virtual

Returns the opaque palette used to draw opaque items.

Returns: The opaque palette used to draw opaque items.

Reimplemented from IlvGadgetItemHolder.

IlUShort IlvMessageLabel::getSpacing ( ) const

Returns the spacing between the label and the bitmap of the message label.

Returns: The spacing between the label and the bitmap of this message label.

See also: setSpacing(), setLabelPosition().

void IlvMessageLabel::setAlignment ( IlvAlignment alignment )

Sets the alignment of this message label.

Sets the alignment of the whole message label inside its bounding box. Note that the message label is not redrawn.

Parameters

alignment The alignment of the message label. Valid values are: IlvLeft, IlvCenter, IlvRight.

See also: getAlignment(), getLabelPosition().

void IlvMessageLabel::setBitmap ( IlvBitmap * bitmap )

Sets the bitmap of the message label.

Allows you to set a bitmap to this message label. If the message label already owns a bitmap, this bitmap is unlocked. The new bitmap is locked. Note that the message label is not redrawn.

Parameters

bitmap The new bitmap.

See also: getBitmap(), getInsensitiveBitmap().

void IlvMessageLabel::setInsensitiveBitmap ( IlvBitmap * bitmap )

Sets the insensitive bitmap of the message label.

Allows you to set an insensitive bitmap for this message label. If the message label already owns an insensitive bitmap, this bitmap is unlocked. The new bitmap is locked.

Parameters

bitmap The new insensitive bitmap.

See also: getInsensitiveBitmap(), getBitmap().

void IlvMessageLabel::setLabel	(	const char *	label,
		IlBoolean	copy = `IlTrue`
	)

Sets the label of the message label.

Parameters

label	The new label to be set. `0` is a valid value.
copy	A Boolean value specifying whether a message should be copied. If the value is `IlFalse`, then you must allocate some memory for the message because in any case the message characters are deleted from the memory by the IlvMessageLabel.

See also: getLabel(), getMessage().

void IlvMessageLabel::setLabelOrientation	(	IlvOrientation	orientation,
		IlBoolean	flip = `IlFalse`,
		IlBoolean	redraw = `IlTrue`
	)

Sets the orientation of the label.

Parameters

orientation	The label orientation. Valid values are: `IlvHorizontal` and `IlvVertical`.
flip	A Boolean value specifying whether the label is drawn from top to bottom or from bottom to top.
redraw	A Boolean value specifying whether the message label should be redrawn.

See also: getLabelOrientation().

void IlvMessageLabel::setLabelPosition	(	IlvPosition	pos,
		IlBoolean	redraw = `IlTrue`
	)

Sets the position of the label relative to the bitmap of the message label.

Parameters

pos	The new position of the label. Valid positions are: `IlvLeft`, `IlvTopLeft`, `IlvTop`, `IlvTopRight`, `IlvRight`, `IlvBottomRight`, `IlvBottom`, `IlvBottomLeft`, `IlvCenter`.
redraw	A Boolean value specifying whether the message label should be redrawn.

See also: getLabelPosition(), getAlignment().

void IlvMessageLabel::setSpacing	(	IlUShort	spacing,
		IlBoolean	redraw = `IlTrue`
	)

Sets the spacing between the label and the bitmap of the message label.

Parameters

spacing	The new spacing.
redraw	A Boolean value specifying whether the message label should be redrawn.

See also: getSpacing(), getLabelPosition().

Public Member Functions

Friends

Additional Inherited Members

Detailed Description

Accessors

Styling

Constructor & Destructor Documentation

Member Function Documentation