Control - Cool Bar

images\btn_ctrl_coolbar.gif Provides a modern, "railbar" look and the ability to create user configurable toolbars like those in IE. Requires installation of Internet Explorer 3.0 or greater on both the development machine and the run-time machine.

 

The CoolBar is a container that can host child controls; however, a CoolBar can only host controls that expose a window handle (so, no windowless lightweight controls as are found on the frequently used Tools toolbar in Manifold). The resizable regions in a CoolBar are called bands. Each band can host a child control.

 

Properties

 

In addition to the properties listed below, a Control tab provides access to certain frequently used form properties for this control. See the Form Properties topic for information on those properties.

 

 

CoolBar

General

 

ImageList

ImageList to use for the CoolBar.

Orientation

Vertical or Horizontal

Picture

Image to use to "tile" CoolBar. Calls Picture and Color (see below) properties dialog.

EmbossPicture

Convert picture to monochrome 3D look.

EmbossHighlight

Color to use for embossing highlights. Available when EmbossPicture is used.

EmbossShadow

Color to use for embossing shadows. Available when EmbossPicture is used.

ForeColor

Foreground color (text).

BackColor

Background color of coolbar.

BandBorders

True - Apply 3D borders between band rows.

FixedOrder

True - User cannot rearrange bands at run time. False - User can rearrange bands.

VariantHeight

True (Default) - Band heights may vary. False - Band heights are all the same.

 

 

Bands

 

Index

Integer that uniquely identifies a band object in the CoolBar collection. Numbered in order of creation from the first band object, which is always 1.

Child

Loaded with controls drawn on this CoolBar. Choose a control from the Child list and press Apply to associate it with this band.

Style

BandNormal (Default) Band can be resized. BandFixedSize Band can not be resized.

UseCoolBarPicture

Tile this band with the coolbar picture.

EmbossPicture

Show picture in two colors. Available if UseCoolBarPicture is not checked.

EmbossHighlight

Color to use for embossing highlights. Available when EmbossPicture is used.

EmbossShadow

Color to use for embossing shadows. Available when EmbossPicture is used.

UseCoolbarColors

Use the same colors as defined for CoolBar

ForeColor

Foreground color. Available when UseCoolbarColors is not checked.

BackColor

Background color. Available when UseCoolbarColors is not checked.

Caption

Text for band caption.

Width

Width of this band.

MinWidth

Minimum width allowed during resizing.

MinHeight

Minimum height allowed during resizing.

Key

A unique string that identifies each band object.

Tag

Stores a string available for the programmer to use as desired. Often used to store an identification string of some sort.

Image

Image from ImageList to use for this band. Image will be displayed at run time between the move handle and the caption.

Visible

True - Band is visible. False - It isn't.

AllowVertical

True (Default) - This band will be displayed if CoolBar in vertical orientation. False - Will not be displayed when vertical.

NewRow

Place on new row.

FixedBackground

True (Default) - background picture is fixed on resize. False - retile background picture on resize.

 

 

Color

 

Back Color

Color to be used for the band's background.

EmbossHighlight

Color to use for "light" color.

EmbossShadow

Color to use for "dark" color.

Fore Color

Color to be used for the band's foreground, the color of the text caption.

Color Set

Choose from Standard Colors (standard Windows non-dithered colors) or Windows System Colors. The latter will be defined by the user's Control Panel settings and is normally the setting used so that the form changes appearance like the rest of Windows if the Control Panel settings are changed.

Color Palette

Displays available colors. Click on the property to be changed to highlight it in the Properties pane, click on the desired color in the Color Palette pane and then press Apply.

Edit Custom Color

Change the custom color presented in the Color Palette when the Color Set is set to Windows System Colors.