SftBox/OCX 5.0 - Combo Box Control

SftBoxItems.ItemImageLeaf Property

Defines the default graphic used to display a leaf item's item image.

Syntax

Get

Put

object

A SftBoxItems object.

refImageObj

Defines the default graphic used to display a leaf item's item image.

Comments

The ItemImageLeaf property defines the default graphic used to display a leaf item's item image.

The ItemPictureLeaf property is used to define the default item graphic displayed for an item which doesn't have any dependents.

The Items.ItemImageExpandable, Items.ItemImageExpanded and ItemImageLeaf properties must each be set to a valid image, otherwise they have no effect.

Sample bitmaps can be found in the directory \Program Files\Softelvdm\SftBox OCX 5.0\Samples\Bitmaps. E.g., ItemLeaf.bmp and ItemLeaf2.bmp contain suitable sample images for the ItemImageLeaf property.

When using fixed height items (see Items.Style), all graphics used in a combo box control as Item.Image, Items.ItemImageExpandable, Items.ItemImageExpanded and ItemImageLeaf properties at the same time must be the same size (height and width). The dimensions of the graphics are used to calculate the minimum dimension for items, so graphics used as item graphics are never clipped vertically. To change the item graphic size, all item graphics must be removed first using the Items.ClearItemImages method.

When using variable height items (see Items.Style), the graphics used can be of varying size. The item height is adjusted automatically, so graphics are never clipped vertically.

If an item is disabled (see Item.Enabled property), the graphic is drawn in a "grayed" fashion.

The ItemPictureLeaf property can be set to the value Nothing (NULL). Default item graphics are then no longer displayed. The Item.Image properties remain unchanged.

The VAlignStyle property can be used to define the vertical alignment of item graphics.

If the image object refImageObj defines a bitmap, the top, left pixel of the bitmap must contain the bitmap's background color. This color will be replaced throughout the bitmap with the actual background (see Bitmap Transparency).

See Also SftBoxItems Object | Object Hierarchy