Specify one of the following container views, which
determine the presentation format of items in a container:
CV_ICON
In the icon view, the container items are
represented as icon/text or bit-map/text pairs, with text beneath the icons
or bit maps. This is the default view. This view can be combined with the
CV_MINI style bit by using an OR operator (|).
CV_NAME
In the name view, the container items
are represented as icon/text or bit-map/text pairs, with text to the right
of the icons or bit maps. This view can be combined with the CV_MINI and
CV_FLOW style bits by using OR operators (|).
CV_TEXT
In the text view, the container items
are displayed as a list of text strings. This view can be combined with
the CV_FLOW style bit by using an OR operator (|).
CV_TREE
In the tree view, the container items
are represented in a hierarchical manner. The tree view has three forms,
which are defined in the following list. If you specify CV_TREE by itself,
the tree icon view is used.
-
Tree
icon view
The tree icon view is specified by using a logical OR operator to combine
the tree view with the icon view (CV_TREE | CV_ICON). Container items in
this view are represented as icon/text pairs or bit-map/text pairs, with
text to the right of the icons or bit maps. Also, a collapsed or expanded
icon or bit map is displayed to the left of parent items. If this icon or
bit map is a collapsed icon or bit map, selecting it will cause the
parent item to be expanded so that its child items are displayed below it.
If this icon or bit map is an expanded icon or bit map, selecting
it will cause the parent's child items to be removed from the display. The
default collapsed and expanded bit maps provided by the container use a
plus sign (+) and a minus sign (-), respectively, to indicate that items
can be added to or subtracted from the display.
-
Tree
name view
The tree name view is specified by using a logical OR operator to combine
the tree view with the name view (CV_TREE | CV_NAME). Container items in
this view are displayed as either icon/text pairs or bit-map/text pairs,
with text to the right of the icons or bit maps. However, the indicator
that represents whether an item can be collapsed or expanded, such as a
plus or minus sign, is included in the icon or bit map that represents that
item, not in a separate icon or bit map as in the tree icon and tree text
views. The container control does not provide default collapsed and expanded
bit maps for the tree name view.
-
Tree
text view
The tree text view is specified by using a logical OR operator to combine
the tree view with the text view (CV_TREE | CV_TEXT). Container items in
this view are displayed as a list of text strings. As in the tree icon view,
a collapsed or expanded icon or bit map is displayed to the left of parent
items.
CV_DETAIL
In the details view, the container
items are presented in columns. Each column can contain icons or bit maps,
text, numbers, dates, or times.
Specify
one or both of the following view styles by using an OR operator (|) to
combine them with the specified view. These view styles are optional.
CV_MINI
Produces a mini-icon whose size is based
on the Presentation Manager (PM) SV_CYMENU system value to produce a device-dependent
mini-icon. The CV_MINI view style bit is ignored when:
The text view (CV_TEXT), tree view (CV_TREE), or
details view (CV_DETAIL) are displayed
The CCS_MINIRECORDCORE style bit is specified.
If this style bit is not specified and the icon view (CV_ICON) or name
view (CV_NAME) is used, the default, regular-sized icon is used. The size
of regular-sized icons is based on the value in the slBitmapOrIcon field
of the CNRINFO
data structure. If this field is equal to 0, the PM SV_CXICON and SV_CYICON
system values for width and height, respectively, are used. Icon sizes are
consistent with PM-defined icon sizes for all devices.
CV_FLOW
Dynamically arranges container items
in columns in the name and text views. These are called flowed name and
flowed text views. If this style bit is set for the name view (CV_NAME)
or text view (CV_TEXT), the container items are placed in a single column
until the bottom of the client area is reached. The next container item
is placed in the adjacent column to the right of the filled column. This
process is repeated until all of the container items are positioned in the
container. The width of each column is determined by the longest text string
in that column. The size of the window determines the depth of the client
area. If this style bit is not specified, the default condition for the
name and text views is to vertically fill the container in a single column
without flowing the container items. If this style bit is set for the icon
view (CV_ICON) or details view (CV_DETAIL), it is ignored.
Specify
either of the following to indicate whether the container will display icons
or bit maps:
CA_DRAWICON
Icons are used for the icon, name,
tree, or details views. This is the default. This container attribute should
be used with the hptrIcon and hptrMiniIcon fields of the RECORDCORE
data structure.
CA_DRAWBITMAP
Bit maps are used for the icon,
name, tree, or details views. This container attribute can be used with
the hbmBitmap and hbmMiniBitmap fields of the RECORDCORE
data structure. Notes
If both the CA_DRAWICON and CA_DRAWBITMAP attributes
are specified, the CA_DRAWICON attribute is used.
If the CCS_MINIRECORDCORE style bit is specified
when a container is created, the hptrIcon field of the MINIRECORDCORE
data structure is used.
Specify
one of the following attributes to provide target emphasis for the name,
text, and details views. If neither ordered nor mixed target emphasis is
specified, the emphasis is drawn around the record.
Shows the relationship between all
items in the tree view.
Specify
the following to draw container records, paint the background of the container,
or both:
CA_OWNERDRAW
Ownerdraw for the container,
which allows the application to draw container records.
CA_OWNERPAINTBACKGROUND
Allows the application
to subclass the container and paint the background. If specified, and the
container is subclassed, the application receives the CM_PAINTBACKGROUND
message in the subclass procedure. Otherwise, the container paints the
background using the color specified by SYSCLR_WINDOW, which can be changed
by using the PP_BACKGROUNDCOLOR or PP_BACKGROUNDCOLORINDEX presentation
parameter in the WM_PRESPARAMCHANGED
(in Container Controls) message.
Specify
the following if the container is to have a title:
CA_CONTAINERTITLE
Allows you to include a container
title. The default is no container title.
Specify
one or both of the following container title attributes. These are valid
only if the CA_CONTAINERTITLE attribute is specified.
CA_TITLEREADONLY
Prevents the container title from
being edited directly. The default is to allow the container title to be
edited.
CA_TITLESEPARATOR
Puts a separator line between
the container title and the records beneath it. The default is no separator
line.
Specify
one of the following to position the container title. These are valid only
if the CA_CONTAINERTITLE attribute is specified.
CA_TITLECENTER
Centers the container title. This
is the default.
CA_TITLELEFT
Left-justifies the container
title.
CA_TITLERIGHT
Right-justifies the container
title.
Specify
the following to display column headings in the details view:
CA_DETAILSVIEWTITLES
Allows you to include column
headings in the details view. The default is no column headings.