Rogue Wave Views Gadgets Package API Reference Guide |
Rogue Wave Views Documentation Home |
Matrix item class. More...
#include <ilviews/gadgets/matrix.h>
Public Member Functions | |
IlvGadgetMatrixItem (IlvGadget *gadget) | |
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... | |
IlUShort | focusColumn () |
Returns the index of the column containing the matrix item. More... | |
IlUShort | focusRow () |
Returns the index of the row containing the matrix item. More... | |
IlvGadget * | getGadget () const |
Returns a pointer to the gadget stored in this matrix item. More... | |
virtual const char * | getLabel () const |
Returns the label that identifies this matrix item. More... | |
IlBoolean | hasFocus () const |
Indicates whether the gadget in the matrix item has the focus. More... | |
IlBoolean | isInteractive () const |
Indicates whether the gadget stored in this matrix item is active. More... | |
virtual void | minimumSize (const IlvMatrix *, IlvDim &w, IlvDim &h) const |
Returns the preferred size of the item. More... | |
void | setGadget (IlvGadget *gadget) |
Sets the gadget stored in this matrix item. More... | |
void | setInteractive (IlBoolean val) |
Specifies whether the gadget stored in this matrix item should be active. More... | |
virtual void | setLabel (const char *, IlBoolean copy=IlTrue) |
Sets the label of the matrix item. More... | |
virtual void | write (IlvOutputFile &) const |
Writes an object description to a file. More... | |
Public Member Functions inherited from IlvGraphicMatrixItem | |
IlvGraphicMatrixItem (IlvGraphic *graphic) | |
Constructor. More... | |
IlvGraphic * | getGraphic () const |
Returns a pointer to the graphic object stored in this matrix item. More... | |
virtual IlBoolean | handleSelectionDrawing () const |
Indicates whether the selection drawing is handled by the matrix 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... | |
void | setGraphic (IlvGraphic *graphic) |
Sets the graphic object stored in this matrix item. More... | |
virtual void | setPalette (IlvPalette *) |
Sets the palette of this matrix item. 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... | |
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... | |
Matrix item class.
Library: ilvadvgdt
Use this class to define a matrix item as a gadget. Gadgets stored in a matrix item are active.
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 IlvGraphicMatrixItem
and adds the following ones:
Name | Type | Equivalent methods |
---|---|---|
graphic | Object | getGadget() , setGadget() |
interactive | Boolean | isInteractive() , setInteractive() |
hasFocus | Boolean | hasFocus() |
focusRow | UInt | focusRow() |
focusColumn | UInt | focusColumn() |
IlvGadgetMatrixItem::IlvGadgetMatrixItem | ( | IlvGadget * | gadget | ) |
Constructor.
Initializes a new instance of the class IlvGadgetMatrixItem
.
gadget | The gadget encapsulated by this matrix item. |
|
virtual |
Copies this object.
Allocates and returns a copy of this object.
IlvPredefinedMatrixItemIOMembers()
. Reimplemented from IlvGraphicMatrixItem.
|
virtual |
Is called to draw the matrix item.
The default implementation of the method calls IlvAbstractMatrixItem::drawLabel
.
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. |
IlvAbstractMatrix::drawItem
, drawLabel()
. Reimplemented from IlvGraphicMatrixItem.
IlUShort IlvGadgetMatrixItem::focusColumn | ( | ) |
Returns the index of the column containing the matrix item.
This method must be called only when the item has the focus.
IlUShort IlvGadgetMatrixItem::focusRow | ( | ) |
Returns the index of the row containing the matrix item.
This method must be called only when the item has the focus.
IlvGadget* IlvGadgetMatrixItem::getGadget | ( | ) | const |
Returns a pointer to the gadget stored in this matrix item.
|
virtual |
Returns the label that identifies this matrix item.
setLabel()
. Reimplemented from IlvGraphicMatrixItem.
IlBoolean IlvGadgetMatrixItem::hasFocus | ( | ) | const |
Indicates whether the gadget in the matrix item has the focus.
IlTrue
if the gadget has the focus and IlFalse
otherwise. When a gadget has the focus, it receives all the keyboard events. IlBoolean IlvGadgetMatrixItem::isInteractive | ( | ) | const |
Indicates whether the gadget stored in this matrix item is active.
IlTrue
if the gadget stored in this matrix item is active. When a gadget is active, events are sent to its handleEvent()
method. setInteractive()
.
|
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
.
matrix | The matrix to which the item belongs. |
width | The returned preferred width of the item. |
height | The returned preferred height of the item. |
Reimplemented from IlvGraphicMatrixItem.
void IlvGadgetMatrixItem::setGadget | ( | IlvGadget * | gadget | ) |
Sets the gadget stored in this matrix item.
The old gadget that was stored in this matrix item is deleted.
gadget | The new gadget. |
getGadget()
. void IlvGadgetMatrixItem::setInteractive | ( | IlBoolean | val | ) |
Specifies whether the gadget stored in this matrix item should be active.
This method has the same function as IlvGadget::setActive()
. Though in this situation the information is directly managed by the IlvGadgetMatrixItem
instance.
val | Specifies whether the gadget stored in this matrix item should be active (IlTrue ) or not (IlFalse ). |
isInteractive()
, IlvGadget::isActive()
. Sets the label of the matrix item.
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 . |
getLabel()
. Reimplemented from IlvGraphicMatrixItem.
|
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()
.
file | The name of the file to be written to. |
Reimplemented from IlvGraphicMatrixItem.
© Copyright 2016, 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.