IlvAbstractMatrixItem Class Reference

Matrix item class. More...

#include <ilviews/gadgets/matrix.h>

Inheritance diagram for IlvAbstractMatrixItem:

List of all members.

Public Member Functions
virtual IlvAbstractMatrixItem *	copy () const
	Copies this object.
virtual void	draw (const IlvMatrix *matrix, IlUShort col, IlUShort row, IlvPort *dst, const IlvRect &bbox, const IlvRect *clip) const
	Is called to draw the matrix item.
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.
virtual const char *	getLabel () const
	Returns the label that identifies this matrix item.
virtual IlBoolean	handleSelectionDrawing () const
	Indicates whether the selection drawing is handled by the matrix item.
virtual void	minimumSize (const IlvMatrix *matrix, IlvDim &width, IlvDim &height) const
	Returns the preferred size of the item.
virtual void	setBackground (IlvColor *color)
	Sets the background color of this matrix item.
virtual void	setFont (IlvFont *font)
	Sets the font of this matrix item.
virtual void	setForeground (IlvColor *color)
	Sets the foreground color of this matrix item.
virtual void	setLabel (const char *label, IlBoolean copy=IlTrue)
	Sets the label of the matrix item.
virtual void	setPalette (IlvPalette *palette)
	Sets the palette of this matrix item.
virtual void	write (IlvOutputFile &file) const
	Writes an object description to a file.
Static Public Member Functions
static IlvAbstractMatrixItem *	readItem (IlvInputFile &file, IlvDisplay *display)
	Reads an object description from a file.
Friends
class	IlvMatrix

---

Detailed Description

Matrix item class.

Library: ilvadvgdt

The objects stored in a matrix are called matrix items. To handle these objects, the IlvMatrix class uses the IlvAbstractMatrixItem class, which encapsulates the matrix item parameters and behavior. Most of the member functions of this class are virtual. Each item stored and displayed in a matrix must be an instance of a subclass of IlvAbstractMatrixItem. The default implementations of the setPalette, setBackground, setForeground, setFont, and setLabel member functions in this abstract class, do nothing. Items may have specific client data. This data is managed at the IlvMatrix level by the member function IlvMatrix::getItemData and IlvMatrix::setItemData.

See also:

IlvBitmapMatrixItem, IlvFilledFloatMatrixItem, IlvFilledIntMatrixItem, IlvFilledLabelMatrixItem, IlvFloatMatrixItem, IlvGadgetItemMatrixItem, IlvGadgetMatrixItem, IlvGraphicMatrixItem, IlvIntMatrixItem, IlvLabelMatrixItem, IlvIntMatrixItem, IlvMatrix.

---

Member Function Documentation

virtual IlvAbstractMatrixItem* IlvAbstractMatrixItem::copy

(

)

const [virtual]

Copies this object.

Allocates and returns a copy of this object.

Returns:

A copy of the object.

See also:

IlvPredefinedMatrixItemIOMembers.

Reimplemented in IlvLabelMatrixItem, IlvFilledLabelMatrixItem, IlvBitmapMatrixItem, IlvIntMatrixItem, IlvFilledIntMatrixItem, IlvFloatMatrixItem, IlvDoubleMatrixItem, IlvFilledFloatMatrixItem, IlvFilledDoubleMatrixItem, IlvGraphicMatrixItem, IlvGadgetMatrixItem, and IlvGadgetItemMatrixItem.

virtual void IlvAbstractMatrixItem::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 in IlvFilledLabelMatrixItem, IlvBitmapMatrixItem, IlvFilledIntMatrixItem, IlvFilledFloatMatrixItem, IlvFilledDoubleMatrixItem, IlvGraphicMatrixItem, IlvGadgetMatrixItem, and IlvGadgetItemMatrixItem.

void IlvAbstractMatrixItem::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.

Parameters:

	label	The label to be drawn.
	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, draw

virtual const char* IlvAbstractMatrixItem::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 in IlvLabelMatrixItem, IlvFilledLabelMatrixItem, IlvBitmapMatrixItem, IlvIntMatrixItem, IlvFilledIntMatrixItem, IlvFloatMatrixItem, IlvDoubleMatrixItem, IlvFilledFloatMatrixItem, IlvFilledDoubleMatrixItem, IlvGraphicMatrixItem, IlvGadgetMatrixItem, and IlvGadgetItemMatrixItem.

virtual IlBoolean IlvAbstractMatrixItem::handleSelectionDrawing

(

)

const [virtual]

Indicates whether the selection drawing is handled by the matrix item.

Returns:

IlTrue if the selection drawing is handled by the matrix item and not by the matrix to which it belongs. In this case, the member function IlvMatrix::drawSelection is not called. The default implementation returns IlFalse.

See also:

IlvMatrix::drawSelection

Reimplemented in IlvGraphicMatrixItem, and IlvGadgetItemMatrixItem.

virtual void IlvAbstractMatrixItem::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 in IlvFilledLabelMatrixItem, IlvBitmapMatrixItem, IlvFilledIntMatrixItem, IlvFilledFloatMatrixItem, IlvFilledDoubleMatrixItem, IlvGraphicMatrixItem, IlvGadgetMatrixItem, and IlvGadgetItemMatrixItem.

static IlvAbstractMatrixItem* IlvAbstractMatrixItem::readItem	(	IlvInputFile &	file,
		IlvDisplay *	display
	)			[static]

Reads an object description from a file.

Reads an object description from the file input. It reads the information that was saved by the member function write to be able to create a new instance of this object. Usually, because of the availability of the constructor that expects an IlvInputFile, readItem should be equivalent to :

 IlvAbstractMatrixItem*
 MyClass::readItem(IlvInputFile& file, IlvDisplay* display)
 {
     return new MyClass(file, display);
 }

Parameters:

	file	The file to be read from.
	display	The display used to create the object.

See also:

DeclareMatrixItemInfoRO, DeclareMatrixItemInfo, IlvPredefinedMatrixItemIOMembers.

Warning:

[note] The readItem method is not capitalized like other static methods so that it is consistent with the write method.

Reimplemented in IlvLabelMatrixItem, IlvFilledLabelMatrixItem, IlvBitmapMatrixItem, IlvIntMatrixItem, IlvFilledIntMatrixItem, IlvFloatMatrixItem, IlvDoubleMatrixItem, IlvFilledFloatMatrixItem, IlvFilledDoubleMatrixItem, IlvGraphicMatrixItem, IlvGadgetMatrixItem, and IlvGadgetItemMatrixItem.

virtual void IlvAbstractMatrixItem::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 in IlvFilledLabelMatrixItem, IlvBitmapMatrixItem, IlvFilledIntMatrixItem, IlvFilledFloatMatrixItem, IlvFilledDoubleMatrixItem, IlvGraphicMatrixItem, and IlvGadgetItemMatrixItem.

virtual void IlvAbstractMatrixItem::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 in IlvFilledLabelMatrixItem, IlvFilledIntMatrixItem, IlvFilledFloatMatrixItem, IlvFilledDoubleMatrixItem, IlvGraphicMatrixItem, and IlvGadgetItemMatrixItem.

virtual void IlvAbstractMatrixItem::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 in IlvFilledLabelMatrixItem, IlvBitmapMatrixItem, IlvFilledIntMatrixItem, IlvFilledFloatMatrixItem, IlvFilledDoubleMatrixItem, IlvGraphicMatrixItem, and IlvGadgetItemMatrixItem.

virtual void IlvAbstractMatrixItem::setLabel	(	const char *	label,
		IlBoolean	copy = IlTrue
	)			[virtual]

Sets the label of the matrix item.

Parameters:

	label	The label of the matrix item.
	copy	A Boolean value specifying 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 in IlvLabelMatrixItem, IlvFilledLabelMatrixItem, IlvBitmapMatrixItem, IlvIntMatrixItem, IlvFilledIntMatrixItem, IlvFloatMatrixItem, IlvDoubleMatrixItem, IlvFilledFloatMatrixItem, IlvFilledDoubleMatrixItem, IlvGraphicMatrixItem, IlvGadgetMatrixItem, and IlvGadgetItemMatrixItem.

virtual void IlvAbstractMatrixItem::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 in IlvFilledLabelMatrixItem, IlvBitmapMatrixItem, IlvFilledIntMatrixItem, IlvFilledFloatMatrixItem, IlvFilledDoubleMatrixItem, IlvGraphicMatrixItem, and IlvGadgetItemMatrixItem.

virtual void IlvAbstractMatrixItem::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 in IlvLabelMatrixItem, IlvFilledLabelMatrixItem, IlvBitmapMatrixItem, IlvIntMatrixItem, IlvFilledIntMatrixItem, IlvFloatMatrixItem, IlvDoubleMatrixItem, IlvFilledFloatMatrixItem, IlvFilledDoubleMatrixItem, IlvGraphicMatrixItem, IlvGadgetMatrixItem, and IlvGadgetItemMatrixItem.