flWindowAttr (ULONG)

Window attributes.

Consists of container window attributes.

• 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.

  CA_ORDEREDTARGETEMPH

  Shows where a container record can be dropped during direct manipulation by drawing a line beneath the record. Ordered target emphasis does not apply to the icon and tree views.
  CA_MIXEDTARGETEMPH
  Shows where a container record can be dropped during direct manipulation either by drawing a line between two items or by drawing lines around the container record. Mixed target emphasis does not apply to the icon and tree views.
  
  Specify the following attribute to draw lines that show the relationship between items in the tree view.

  CA_TREELINE

  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)
  
  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.

  ---

  [Back] [Next]