Overview

XContainerInfo is a class to set/query general attributes for a XContainerControl. To make changes to the settings:

1. query the current setting via XContainerControl::GetInfo()
2. make the changes in the used instance of XContainerInfo
3. call XContainerControl::SetInfo() with the used instance of XContainerInfo

Functions

Parameters

char * theTitle

The title of the container. Default is empty.

LONG theStyle

style of the container. Valid styles are: CO_TEXT the container is in text-mode CO_NAME the container is in name-mode CO_ICON the container is in icon-mode CO_DETAIL the container is in detail-mode CO_FLOW arrange objects dynamicaly (text and name mode only) CO_MINI the container use small icons CO_TREE the container is in tree-mode CO_OWNERPAINTBACKGROUND the owner will draw the background (see XBackgroundDrawEvent and XBackgroundDrawHandler) CO_TREELINE draw the tree-line in tree-mode CO_DRAWBITMAP draw icons CO_DRAWICON draw bitmaps CO_TITLE show the container-title CO_TITLELEFT title is left-justified CO_TITLERIGHT title is right-justified CO_TITLECENTER title is centered CO_TITLESEPARATOR the title is drawn with a separator CO_TITLEREADONLY the title cannot been edited by the user CO_DETAILTITLES in detail-mode the titles of XContainerColumn are shown The attributes can be or-ed Default is CO_ICON.

Remarks

Constructor of XContainerInfo

Parameters

BOOL sort Set TRUE if the container items should be sorted when they are inserted. Therefor you must override the method XContainerObject::Sort. Default is TRUE.

Remarks

Enables sorting records when they are inserted.

Parameters

XSize * size buffer to hold the size

Remarks

Query the size of bitmaps/icons

Return-Value

LONG objectCount

Remarks

Query the count of objects in the container.

Parameters

XSize * size

Remarks

Set the size of bitmaps/icons

Parameters

XIcon * the new icon
XBitmap * the new bitmap

Remarks

Replace the collapsed-icon.
Replace the collapsed-bitmap.

Parameters

XIcon * the new icon
XBitmap * the new bitmap

Remarks

Replace the expanded-icon.
Replace the expanded-bitmap.

Parameters

SHORT spacing (in pixels)

Remarks

Set the vertical spacing between two objects.

Parameters

XSize * size

Remarks

Set the size of the expanded and collapsed bitmaps/icons in tree-view

Parameters

SHORT width (in pixels)

Remarks

Set the horizontal spacing between two levels in tree-view.

Parameters

SHORT width (in pixels)

Remarks

Set the width of the trees line in tree-view.

Parameters

BOOL enable TRUE=enable, FALSE=disable

Remarks

Enable/disable background drawing by the application. To draw the background you must install a XBackgroundDrawHandler

Return-Value

BOOL result

Remarks

Query if owner-draw for the background is enabled or not.

Parameters

LONG newAttributes attributes how the container should be displayed ( see XContainerInfo() )

Remarks

Specify here how the container should be displayed. After you have set up the XContainerInfo use XContainerColumn::SetInfo()

Return-Value

LONG theAttributes the attributes which are set for the container (can be or-ed). See XContainerInfo()

Remarks

Query the attributes of the container.

Parameters

XString * theTitleBuffer here the title will be stored

Remarks

Query the containers title

Parameters

char * theTitle

Remarks

Set the title of the container.

Return-Value

LONG the position in window-pixels

Remarks

Query the position of the splitbar of a container.

Parameters

XContainerColumn * theColumn the XContainerColumn after that the splitbar will be displayed

Remarks

Set a splitbar in a container.

Parameters

LONG position the position in window-pixels

Remarks

Set the position of the splitbar of a container.