rwlogo

Rogue Wave Views
Gadgets Package API Reference Guide

Product Documentation:

Rogue Wave Views
Documentation Home

 All Classes Files Functions Variables Typedefs Enumerations Enumerator Macros
List of all members | Public Member Functions
IlvTreePathGadgetItem Class Reference

Tree gadget item class with a pathname. More...

#include <ilviews/gadgets/filechoo.h>

Inheritance diagram for IlvTreePathGadgetItem:
IlvTreeGadgetItem IlvGadgetItem

Public Member Functions

 IlvTreePathGadgetItem (const char *label, IlvBitmap *bitmap=0, IlvPosition position=IlvRight, IlUShort spacing=IlvDefaultGadgetItemSpacing, IlBoolean copy=IlTrue)
 Constructor. More...
 
 IlvTreePathGadgetItem (const char *label, IlvGraphic *graphic, IlvPosition position=IlvRight, IlUShort spacing=IlvDefaultGadgetItemSpacing, IlBoolean copy=IlTrue)
 Constructor. More...
 
const IlPathNamegetPathName () const
 Returns the path. More...
 
void setPathName (const IlPathName &path)
 Sets the path. More...
 
- Public Member Functions inherited from IlvTreeGadgetItem
 IlvTreeGadgetItem (const char *label, IlvBitmap *bitmap=0, IlvPosition position=IlvRight, IlUShort spacing=IlvDefaultGadgetItemSpacing, IlBoolean copy=IlTrue)
 Constructor. More...
 
 IlvTreeGadgetItem (const char *label, IlvGraphic *graphic, IlvPosition position=IlvRight, IlUShort spacing=IlvDefaultGadgetItemSpacing, IlBoolean copy=IlTrue)
 Constructor. More...
 
 IlvTreeGadgetItem (IlvGraphic *graphic)
 Constructor. More...
 
 IlvTreeGadgetItem (IlvBitmap *bitmap)
 Constructor. More...
 
IlvTreeGadgetItemapplyToChildren (IlvApplyGadgetItem func, IlAny arg=0) const
 Applies the specified function to all the children of the tree gadget item. More...
 
virtual void deSelect ()
 Deselects the item. More...
 
void detach ()
 Detaches the item from its parent. More...
 
virtual void expand ()
 Expands the item. More...
 
void expandAll ()
 Expands the item and all its children. More...
 
virtual IlUInt getBitmapMask () const
 Returns the bitmap mask of the item. More...
 
IlUInt getCardinal () const
 Returns the number of children of the tree gadget item. More...
 
virtual IlvBitmapgetCurrentBitmap () const
 Returns the bitmap that is currently displayed by the item. More...
 
IlvTreeGadgetItemgetFirstChild () const
 Returns the first child of the item. More...
 
IlvTreeGadgetItemgetLastChild () const
 Returns the last child of the item. More...
 
IlvTreeGadgetItemgetNextSibling () const
 Returns the next sibling of the item. More...
 
IlvTreeGadgetItemgetParent () const
 Returns the parent of the item. More...
 
IlUInt getPosition () const
 Returns the position of the item in its parent list. More...
 
IlvTreeGadgetItemgetPrevSibling () const
 Returns the previous sibling of the item. More...
 
IlvTreeGadgetItemHoldergetTreeHolder () const
 Returns a pointer to the item holder. More...
 
IlBoolean hasChildren () const
 Indicates whether the item has children. More...
 
IlBoolean hasUnknownChildCount () const
 Indicates that the number of children is not known. More...
 
IlBoolean insertChild (IlvTreeGadgetItem *item, IlInt index=-1)
 Inserts the specified item in the list of children of this tree gadget item. More...
 
IlBoolean isAncestorOf (IlvTreeGadgetItem *item) const
 Indicates whether the item is an ancestor of the specified item. More...
 
IlBoolean isExpanded () const
 Indicates whether the item is expanded. More...
 
IlBoolean isFirstChild () const
 Indicates whether the item is the first child in its parent list. More...
 
IlBoolean isLastChild () const
 Indicates whether the item is the last child in its parent list. More...
 
IlBoolean isVisible () const
 Indicates whether the item is visible. More...
 
IlvTreeGadgetItemlastVisible () const
 Returns the last visible children of the item. More...
 
IlvTreeGadgetItemnextSelected () const
 Returns the next selected item. More...
 
IlvTreeGadgetItemnextVisible () const
 Returns the next visible item. More...
 
IlvTreeGadgetItempreviousVisible () const
 Returns the previous visible item. More...
 
virtual void select ()
 Selects the item. More...
 
void setUnknownChildCount (IlBoolean value)
 Specifies whether the item should behave as if it had children. More...
 
virtual void shrink ()
 Shrinks the item. More...
 
void sortChildren (IlUInt levels=(IlUInt)-1, IlvTreeGadgetItemCompareFunction func=0)
 Sorts the children of the tree gadget item. More...
 
- Public Member Functions inherited from IlvGadgetItem
 IlvGadgetItem (const char *label, IlvBitmap *bitmap=0, IlvPosition position=IlvRight, IlUShort spacing=4, IlBoolean copy=IlTrue)
 Constructor. More...
 
 IlvGadgetItem (const char *label, IlvGraphic *graphic, IlvPosition position=IlvRight, IlUShort spacing=4, IlBoolean copy=IlTrue)
 Constructor. More...
 
 IlvGadgetItem (IlvGraphic *graphic)
 Constructor. More...
 
 IlvGadgetItem (IlvBitmap *bitmap)
 Constructor. More...
 
virtual void activate ()
 Activates the item. More...
 
virtual IlvGadgetItemcopy () const
 Copies this object. More...
 
virtual void draw (IlvPort *dst, const IlvRect &rect, const IlvTransformer *t=0, const IlvRegion *clip=0) const
 Is called to draw the item. More...
 
virtual void drawLabel (IlvPort *dst, IlvPalette *palette, const IlvRect &rect, const IlvTransformer *t=0, const IlvRegion *clip=0) const
 Is called to draw the item label. More...
 
virtual void drawPicture (IlvPort *dst, const IlvRect &rect, const IlvTransformer *t=0, const IlvRegion *clip=0) const
 Is called to draw the item picture. More...
 
virtual void edit ()
 Edits the item label. More...
 
IlvBitmapgetBitmap (IlUShort index=(IlUShort) 0) const
 Returns the bitmap whose index is specified. More...
 
IlvBitmapgetBitmap (const IlSymbol *symbol) const
 Returns the bitmap corresponding to the specified symbol. More...
 
IlUShort getBitmapCount () const
 Returns the number of bitmaps used by this item. More...
 
IlAny getClientData () const
 Returns the client data of the item. More...
 
IlvGraphicgetGraphic () const
 Returns the IlvGraphic object associated with this item. More...
 
virtual IlUShort getHeight () const
 Returns the item height. More...
 
virtual IlvPalettegetHighlightTextPalette () const
 Returns the palette used to draw the label of highlighted items. More...
 
IlvGadgetItemHoldergetHolder () const
 Returns the item holder. More...
 
virtual IlvPalettegetInsensitivePalette () const
 Returns the palette used to draw a nonsensitive item. More...
 
const char * getLabel () const
 Returns the item label. More...
 
IlvAlignment getLabelAlignment () const
 Returns the label alignment. More...
 
void getLabelOrientation (IlvOrientation &orientation, IlBoolean &flip) const
 Returns the orientation of the item label. More...
 
IlvPosition getLabelPosition () const
 Returns the position of the label relative to the picture. More...
 
virtual const char * getMessage () const
 Returns the message of the item. More...
 
char getMnemonic () const
 Returns the mnemonic letter associated with the item. More...
 
const char * getName () const
 Returns the item name. More...
 
IlvNamedPropertygetNamedProperty (const IlSymbol *name) const
 Returns the property whose name is specified. More...
 
virtual IlvPalettegetNormalTextPalette () const
 Returns the default palette used to draw an item. More...
 
virtual IlvPalettegetOpaquePalette () const
 Returns the palette that is used to draw opaque items. More...
 
IlAny getProperty (const IlSymbol *key) const
 Returns the object property whose symbol is provided as the parameter. More...
 
virtual IlvPalettegetSelectionPalette () const
 Returns the palette used to draw selected items. More...
 
virtual IlvPalettegetSelectionTextPalette () const
 Returns the palette used to draw the label of selected items. More...
 
IlUShort getSpacing () const
 Returns the spacing between the label and the picture of the item. More...
 
virtual IlUShort getWidth () const
 Returns the item width. More...
 
IlBoolean hasProperty (const IlSymbol *key) const
 Indicates whether the item has the property whose symbol is specified. More...
 
virtual void highlight (IlBoolean value=IlTrue)
 Highlights the item. More...
 
IlBoolean isDragDropTarget () const
 Indicates whether the item is the target of a drag-and-drop operation. More...
 
IlBoolean isEditable () const
 Indicates whether the item can be edited. More...
 
IlBoolean isHighlighted () const
 Indicates whether the item is highlighted. More...
 
IlBoolean isOpaque () const
 Indicates whether the item is opaque. More...
 
virtual IlBoolean isSelectable () const
 Indicates whether the item can be selected. More...
 
IlBoolean isSelected () const
 Indicates whether the item is selected. More...
 
IlBoolean isSensitive () const
 Indicates whether the item is sensitive. More...
 
IlBoolean isShowingLabel () const
 Indicates whether the item label is visible. More...
 
IlBoolean isShowingPicture () const
 Indicates whether the item picture is visible. More...
 
virtual void itemRect (IlvRect &rect, const IlvRect &bbox) const
 Returns the item bounding bbox. More...
 
virtual void labelRect (IlvRect &rect, const IlvRect &bbox) const
 Returns the bounding box of the item label. More...
 
virtual void pictureRect (IlvRect &rect, const IlvRect &bbox) const
 Returns the bounding bbox of the item picture. More...
 
virtual void recomputeSize (IlBoolean redraw=IlTrue)
 Recomputes the item geometry. More...
 
void removeAllBitmaps ()
 Removes all the bitmaps associated with the item. More...
 
IlvNamedPropertyremoveNamedProperty (IlSymbol *name)
 Removes the specified named property from the object. More...
 
IlBoolean removeProperty (const IlSymbol *key)
 Removes a property from the object. More...
 
virtual void selectionRect (IlvRect &rect, const IlvRect &bbox) const
 Returns the bounding box of the item selection. More...
 
void setBitmap (IlUShort index, IlvBitmap *bitmap)
 Sets the specified bitmap to the item at the specified index. More...
 
void setBitmap (const IlSymbol *symbol, IlvBitmap *bitmap)
 Sets the specified bitmap to the item using the specified symbol. More...
 
void setBitmap (IlvBitmap *bitmap)
 Sets the sensitive bitmap of the item. More...
 
void setClientData (IlAny data)
 Sets the new client data for this item. More...
 
void setEditable (IlBoolean value)
 Specifies whether the item should be editable. More...
 
void setGraphic (IlvGraphic *graphic)
 Specifies the graphic object associated with this item. More...
 
virtual void setHighlightTextPalette (IlvPalette *palette)
 Sets the palette used to draw the label of highlighted items. More...
 
void setLabel (const char *label, IlBoolean copy=IlTrue)
 Sets the item label. More...
 
void setLabelAlignment (IlvAlignment alignment)
 Sets the label alignment. More...
 
void setLabelOrientation (IlvOrientation orientation, IlBoolean flip=IlFalse)
 Sets the orientation of the item label. More...
 
void setLabelPosition (IlvPosition position)
 Sets the label position relative to the picture. More...
 
void setName (const char *name)
 Sets the item name. More...
 
IlvNamedPropertysetNamedProperty (IlvNamedProperty *property)
 Sets the specified named property to the object. More...
 
virtual void setNormalTextPalette (IlvPalette *palette)
 Sets the default palette used to draw an item. More...
 
void setOpaque (IlBoolean value)
 Specifies whether the item should be opaque. More...
 
virtual void setOpaquePalette (IlvPalette *palette)
 Sets the palette used to draw opaque items. More...
 
void setProperty (const IlSymbol *key, IlAny value)
 Sets the property whose symbol is specified to the item. More...
 
virtual void setSelectionTextPalette (IlvPalette *palette)
 Sets the palette used to draw the label of selected items. More...
 
void setSensitive (IlBoolean value)
 Specifies whether the item should be sensitive or not. More...
 
void setSpacing (IlUShort spacing)
 Sets the spacing between the label and the picture of the item. More...
 
void showLabel (IlBoolean value=IlTrue)
 Specifies whether the item label should be shown. More...
 
void showPicture (IlBoolean value=IlTrue)
 Specifies whether the item picture should be shown. More...
 
virtual void write (IlvOutputFile &file) const
 Writes an object description to a file. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from IlvTreeGadgetItem
static IlSymbolExpandedBitmapSymbol ()
 Returns the symbol associated with the expanded bitmap. More...
 
- Protected Member Functions inherited from IlvTreeGadgetItem
virtual void computeSize (IlUShort &, IlUShort &) const
 Computes the item size. More...
 

Detailed Description

Tree gadget item class with a pathname.

Library: ilvadvgdt

This tree gadget item class is used by the IlvFileChooserTree objects to store a path for each item of the tree gadget.

See Also
IlvFileChooserTree, IlvTreeGadgetItem.

Constructor & Destructor Documentation

IlvTreePathGadgetItem::IlvTreePathGadgetItem ( const char *  label,
IlvBitmap bitmap = 0,
IlvPosition  position = IlvRight,
IlUShort  spacing = IlvDefaultGadgetItemSpacing,
IlBoolean  copy = IlTrue 
)

Constructor.

Initializes a new instance of the IlvTreePathGadgetItem class. This constructor allows you to specify both a label and a bitmap, as well as their relative alignment and spacing. The bitmap is locked.

Parameters
labelThe item label.
bitmapThe item sensitive bitmap.
positionThe label position relative to the picture.
spacingThe spacing between the label and the picture.
copySpecifies whether a label should be copied. If the value is IlFalse, then memory must be allocated for the label because the label characters are deleted from memory by the IlvTreePathGadgetItem.
IlvTreePathGadgetItem::IlvTreePathGadgetItem ( const char *  label,
IlvGraphic graphic,
IlvPosition  position = IlvRight,
IlUShort  spacing = IlvDefaultGadgetItemSpacing,
IlBoolean  copy = IlTrue 
)

Constructor.

Initializes a new instance of the IlvTreePathGadgetItem class. This constructor allows you to specify both a label and a graphic, as well as their relative alignment and spacing.

Parameters
labelThe item label.
graphicThe item picture.
positionThe label position relative to the picture.
spacingThe spacing between the label and the picture.
copySpecifies whether a label should be copied. If the value is IlFalse, then memory must be allocated for the label because the label characters are deleted from memory by the IlvTreePathGadgetItem.

Member Function Documentation

const IlPathName& IlvTreePathGadgetItem::getPathName ( ) const

Returns the path.

Returns
The full path corresponding to the label of the tree gadget item.
void IlvTreePathGadgetItem::setPathName ( const IlPathName path)

Sets the path.

Sets the full path corresponding to the label of the tree gadget item.

Parameters
pathThe path.

© Copyright 2015, 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.