Matrix item class. More...

#include <ilviews/gadgets/matrix.h>

Inheritance diagram for IlvFilledLabelMatrixItem:

Public Member Functions
	IlvFilledLabelMatrixItem (IlvPalette palette, const char label, IlBoolean copy=IlTrue)
	Constructor. More...

	IlvFilledLabelMatrixItem (IlvMatrix matrix, const char label, IlBoolean copy=IlTrue)
	Constructor. More...

	IlvFilledLabelMatrixItem (const char label, IlvPalette palette, IlvPalette *invpal, IlBoolean copy=IlTrue)
	Constructor. More...

virtual IlvAbstractMatrixItem *	copy () const
	Copies this object. More...

virtual void	draw (const IlvMatrix , IlUShort, IlUShort, IlvPort , const IlvRect &, const IlvRect *) const
	Is called to draw the matrix item. More...

IlvPalette *	getInvertedPalette () const
	Returns the palette used to display this matrix item when it is selected. More...

virtual const char *	getLabel () const
	Returns the label that identifies this matrix item. More...

IlvPalette *	getPalette () const
	Returns the palette used to display this matrix item. More...

virtual void	minimumSize (const IlvMatrix *, IlvDim &, IlvDim &) const
	Returns the preferred size of the item. More...

virtual void	setBackground (IlvColor *)
	Sets the background color of this matrix item. More...

virtual void	setFont (IlvFont *)
	Sets the font of this matrix item. More...

virtual void	setForeground (IlvColor *)
	Sets the foreground color of this matrix item. More...

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

virtual void	setPalette (IlvPalette *)
	Sets the palette of this matrix item. More...

virtual void	write (IlvOutputFile &) const
	Writes an object description to a file. More...

Public Member Functions inherited from IlvLabelMatrixItem
	IlvLabelMatrixItem (const char *label, IlBoolean copy=IlTrue)
	Constructor. More...

Public Member Functions inherited from IlvAbstractMatrixItem
void	drawLabel (const char label, const IlvMatrix matrix, IlUShort col, IlUShort row, IlvPort dst, const IlvRect &bbox, const IlvRect clip=0) const
	Is called to draw the label of the matrix item. More...

virtual IlBoolean	handleSelectionDrawing () const
	Indicates whether the selection drawing is handled by the matrix item. More...

Additional Inherited Members
Static Public Member Functions inherited from IlvAbstractMatrixItem
static IlvAbstractMatrixItem *	readItem (IlvInputFile &file, IlvDisplay *display)
	Reads an object description from a file. More...

Detailed Description

Matrix item class.

Library: ilvadvgdt

Use this class to define a matrix item as a label with a filled background.

See also: IlvMatrix, IlvPalette.

Constructor & Destructor Documentation

IlvFilledLabelMatrixItem::IlvFilledLabelMatrixItem	(	IlvPalette *	palette,
		const char *	label,
		IlBoolean	copy = `IlTrue`
	)

Constructor.

Initializes a new instance of the class IlvFilledLabelMatrixItem.

Parameters

palette	The matrix item palette.
label	The matrix item label.
copy	Specifies whether a label should be copied. If the value is `IlFalse`, then you must allocate some memory for the label because in any case the label characters are deleted from the memory by the `IlvFilledLabelMatrixItem`.

IlvFilledLabelMatrixItem::IlvFilledLabelMatrixItem	(	IlvMatrix *	matrix,
		const char *	label,
		IlBoolean	copy = `IlTrue`
	)

Constructor.

Initializes a new instance of the class IlvFilledLabelMatrixItem.

Parameters

matrix	The matrix to which the item belongs. This parameter is used to compute the matrix item palette.
label	The matrix item label.
copy	Specifies whether a label should be copied. If the value is `IlFalse`, then you must allocate some memory for the label because in any case the label characters are deleted from the memory by the `IlvFilledLabelMatrixItem`.

IlvFilledLabelMatrixItem::IlvFilledLabelMatrixItem	(	const char *	label,
		IlvPalette *	palette,
		IlvPalette *	invpal,
		IlBoolean	copy = `IlTrue`
	)

Constructor.

Initializes a new instance of the class IlvFilledLabelMatrixItem.

Parameters

label	The matrix item label.
palette	The matrix item palette.
invpal	The inverted palette used by the matrix item when it is selected. When using other constructors, the inverted palette is automatically computed from the matrix item palette.
copy	Specifies whether a label should be copied. If the value is `IlFalse`, then you must allocate some memory for the label because in any case the label characters are deleted from the memory by the `IlvFilledLabelMatrixItem`.

Member Function Documentation

virtual IlvAbstractMatrixItem* IlvFilledLabelMatrixItem::copy ( ) const

virtual

Copies this object.

Allocates and returns a copy of this object.

Returns: A copy of the object.

See also: IlvPredefinedMatrixItemIOMembers().

Reimplemented from IlvLabelMatrixItem.

virtual void IlvFilledLabelMatrixItem::draw	(	const IlvMatrix *	matrix,
		IlUShort	col,
		IlUShort	row,
		IlvPort *	dst,
		const IlvRect &	bbox,
		const IlvRect *	clip
	)		const

virtual

Is called to draw the matrix item.

The default implementation of the method calls IlvAbstractMatrixItem::drawLabel.

Parameters

matrix	The matrix to which the item belongs.
col	The column where the matrix item is located.
row	The row where the matrix item is located.
dst	The destination drawing port.
bbox	The bounding box of the matrix item.
clip	The clipping area.

See also: IlvAbstractMatrix::drawItem, drawLabel().

Reimplemented from IlvAbstractMatrixItem.

IlvPalette* IlvFilledLabelMatrixItem::getInvertedPalette ( ) const

Returns the palette used to display this matrix item when it is selected.

Returns: The palette used to display this matrix item when it is selected.

See also: getPalette().

virtual const char* IlvFilledLabelMatrixItem::getLabel ( ) const

virtual

Returns the label that identifies this matrix item.

Returns: The label that identifies this matrix item. The returned string must not be deleted or modified.

See also: setLabel().

Reimplemented from IlvLabelMatrixItem.

IlvPalette* IlvFilledLabelMatrixItem::getPalette ( ) const

Returns the palette used to display this matrix item.

Returns: The palette used to display this matrix item.

See also: getInvertedPalette().

virtual void IlvFilledLabelMatrixItem::minimumSize	(	const IlvMatrix *	matrix,
		IlvDim &	width,
		IlvDim &	height
	)		const

virtual

Returns the preferred size of the item.

The preferred size is the size that the item must have for its content to be entirely visible. Uses width and height to return the preferred size of this item when stored in matrix. This method is called by the member functions IlvMatrix::getColumnFittingSize and IlvMatrix::getRowFittingSize.

Parameters

matrix	The matrix to which the item belongs.
width	The returned preferred width of the item.
height	The returned preferred height of the item.

See also: IlvMatrix::getColumnFittingSize(), IlvMatrix::getRowFittingSize().

Reimplemented from IlvAbstractMatrixItem.

virtual void IlvFilledLabelMatrixItem::setBackground ( IlvColor * color )

virtual

Sets the background color of this matrix item.

The default implementation does nothing.

Parameters

color The new background color.

See also: setPalette(), setForeground(), setFont(), IlvFilledLabelMatrixItem, IlvFilledIntMatrixItem, IlvFilledFloatMatrixItem, IlvFilledDoubleMatrixItem.

Reimplemented from IlvAbstractMatrixItem.

virtual void IlvFilledLabelMatrixItem::setFont ( IlvFont * font )

virtual

Sets the font of this matrix item.

The default implementation does nothing.

Parameters

font	The new font.

See also: setPalette(), setForeground(), setBackground(), IlvFilledLabelMatrixItem, IlvFilledIntMatrixItem, IlvFilledFloatMatrixItem, IlvFilledDoubleMatrixItem.

Reimplemented from IlvAbstractMatrixItem.

virtual void IlvFilledLabelMatrixItem::setForeground ( IlvColor * color )

virtual

Sets the foreground color of this matrix item.

The default implementation does nothing.

Parameters

color The new foreground color.

See also: setPalette(), setBackground(), setFont(), IlvFilledLabelMatrixItem, IlvFilledIntMatrixItem, IlvFilledFloatMatrixItem, IlvFilledDoubleMatrixItem.

Reimplemented from IlvAbstractMatrixItem.

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

virtual

Sets the label of the matrix item.

Parameters

label	The label of the matrix item.
copy	Specifies whether a label should be copied. If the value is `IlFalse`, then you must allocate some memory for the label because in any case the label characters are deleted from the memory by the `IlvAbstractMatrixItem`.

See also: getLabel().

Reimplemented from IlvLabelMatrixItem.

virtual void IlvFilledLabelMatrixItem::setPalette ( IlvPalette * palette )

virtual

Sets the palette of this matrix item.

The default implementation does nothing.

Parameters

palette The new palette.

See also: setBackground(), setForeground(), setFont(), IlvFilledLabelMatrixItem, IlvFilledIntMatrixItem, IlvFilledFloatMatrixItem, IlvFilledDoubleMatrixItem.

Reimplemented from IlvAbstractMatrixItem.

virtual void IlvFilledLabelMatrixItem::write ( IlvOutputFile & file ) const

virtual

Writes an object description to a file.

Writes out, in a file, the object description. This description contains all the information necessary to create an exact copy of this object by means of the member function readItem().

Parameters

file	The name of the file to be written to.

See also: DeclareMatrixItemInfoRO(), DeclareMatrixItemInfo(), IlvPredefinedMatrixItemIOMembers().

Reimplemented from IlvLabelMatrixItem.

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation