Containers

Container Views

Table 23.0 Container's View 

View Type	Contents Displayed	Sample
Icon view	Displays either icons or bit maps, with text beneath the icons or bit maps, to represent container items. These are called icon/text or bit-map/text pairs. Each icon/text or bit-map/text pair represents one container item. This is the default view
Name view	Displays either icons or bit maps, with text to the right of the icons or bit maps, to represent container items. These are called icon/text or bit-map/text pairs. Each icon/text or bit-map/text pair represents one container item.
Text view	Displays a simple text list to represent container items.
Tree view	Displays a hierarchical view of the container items. Three types of Tree views are available: Tree text, Tree icon, and Tree name.
Details view	Displays detailed information about each container item. The same type of data is displayed for each container item, arranged in columns. The data in each column can  consist of an icon or bit map, text, numbers, dates, or time

Container Styles

LPs or 45s ?

typedef struct   _ITEMINFO
{  MINIRECORDCORE   mrcRecord;
   CHAR             achItem[256];
   ULONG            lUnitsSold;  
   float            fRevenue;
} ITEMNFO,*PITEMINFO;

   typedef struct _RECORDINSERT
   {
      ULONG       cb;
      PRECORDCORE pRecordOrder;
      PRECORDCORE pRecordParent;
      ULONG       fInvalidateRecord;
      ULONG       zOrder;
      ULONG       cRecordsInsert;
   } RECORDINSERT;
   typedef RECORDINSERT *PRECORDINSERT;

Half Full or Half Empty ?

   /**********************************************************************/
   /* CNRINFO data structure, describes the container control.           */
   /**********************************************************************/
   typedef struct _CNRINFO     /* ccinfo */
   {  ULONG       cb;                  /* size of CNRINFO struct        */
      PVOID       pSortRecord;         /* ptr to sort function,         */
       /*                                 RECORDCORE                    */
      PFIELDINFO  pFieldInfoLast;      /* pointer to last column in left pane of a split window. */
      PFIELDINFO  pFieldInfoObject;    /* Pointer to a column to represent an object.  This is   */
                                       /* the column which will receive IN-USE emphasis.         */
      PSZ         pszCnrTitle;         /* text for container title. One string separated by line */
                                       /* separators for multi-lines    */
      ULONG       flWindowAttr;        /* container attrs - CV_*, CA_*  */
      POINTL      ptlOrigin;           /* lower-left origin in virtual coordinates. CV_ICON view  */
      ULONG       cDelta;              /* Application defined threshold or number of records from */
                                       /* either end of the list.       */
      ULONG       cRecords;            /* number of records in container*/
      SIZEL       slBitmapOrIcon;      /* size of bitmap in pels        */
      SIZEL       slTreeBitmapOrIcon;  /* size of tree bitmaps in pels  */
      HBITMAP     hbmExpanded;         /* bitmap  for tree node         */
      HBITMAP     hbmCollapsed;        /* bitmap  for tree node         */
      HPOINTER    hptrExpanded;        /* icon    for tree node         */
      HPOINTER    hptrCollapsed;       /* icon    for tree node         */
      LONG        cyLineSpacing;       /* space between two rows        */
      LONG        cxTreeIndent;        /* indent for children           */
      LONG        cxTreeLine;          /* thickness of the Tree Line    */
      ULONG       cFields;             /* number of fields  in container*/
      LONG        xVertSplitbar;       /* position relative to the container (CV_DETAIL);         */
                                       /* if   0xFFFF then unsplit         */

   } CNRINFO;

   typedef CNRINFO *PCNRINFO;

CNRINFO  structure contains a large number of fields. Note that not every one of them needs to be initialized. Instead, only the needed fields are initialized; fields which were initialized are cited as a combination of flags specified in the second parameter of the CM_SETCNRINFO message. To change the vie to icon view, for example:

                  CNRINFO          ciInfo;
                  ciInfo.cb = sizeof(CNRINFO);
                  ciInfo.flWindowAttr = CV_ICON;
                  WinSendMsg(pcdData->hwndCnr, 
                             CM_SETCNRINFO, 
                             MPFROMP(&ciInfo), 
                             MPFROMLONG(CMA_FLWINDOWATTR));

Since we're talking about views of an object, let's look at the various combinations of view flags to specify the different view types. Table 23.2 provides a list of view flags.

Icon, Name, and Text Views

• The window size changes
• Container items are inserted, removed, sorted, invalidated, or filtered.
• The font or font size changes
• The window title text changes

CONTAIN1.C CONTAIN1.RC CONTAIN1.H CONTAIN1.MAK CONTAIN1.DEF

Icon View

Name/flowed View

Text/flowed view

            psiYears = (PSALESINFO)PVOIDFROMMR(
                           WinSendMsg(pcdData->hwndCnr, 
                                      CM_ALLOCRECORD,
                                      MPFROMLONG(ulExtra), 
                                      MPFROMSHORT(MAX_YEARS) ) );

            psiCYear = psiYears;
            for (usIndex = 0; usIndex < MAX_YEARS; usIndex++)
            {  initSalesInfo(pcdData, psiCYear,  usIndex);

               riRecord.pRecordParent = NULL;
               riRecord.cRecordsInsert = 1;

               WinSendMsg(pcdData->hwndCnr, 
                          CM_INSERTRECORD, 
                          MPFROMP(psiCYear), 
                          MPFROMP(&riRecord));

               psiCYear = (PSALESINFO) psiCYear->mrcStd.preccNextRecord;

            } /* endfor */

            WinSendMsg(hwndClient,
                       WM_COMMAND,
                       MPFROMSHORT(MI_ICON),
                       0);

            case  MI_ICON :
               {  CNRINFO          ciInfo;
                  ciInfo.cb = sizeof(CNRINFO);
                  ciInfo.flWindowAttr = CV_ICON;

                  WinSendMsg(pcdData->hwndCnr,
                             CM_SETCNRINFO,
                             MPFROMP(&ciInfo),
                             MPFROMLONG(CMA_FLWINDOWATTR));

                  WinSendMsg(pcdData->hwndCnr,
                             CM_ARRANGE,
                             NULL,
                             NULL);
               } 
               break;

Tree View

Details View

   typedef struct _FIELDINFO      /* fldinfo */
   {  ULONG      cb;                  /* size of FIELDINFO struct       */
      ULONG      flData;              /* attributes of field's data     */
      ULONG      flTitle;             /* attributes of field's title    */
      PVOID      pTitleData;          /* title data (default is string). If CFT_BITMAP, must be HBITMAP */
      ULONG      offStruct;           /* offset from RECORDCORE to data */
      PVOID      pUserData;           /* pointer to user data           */
      struct _FIELDINFO *pNextFieldInfo; /* pointer to next linked FIELDINFO structure  */
      ULONG      cxWidth;             /* width of field in pels         */
   } FIELDINFO;

LONG MyComp(WPObject *obj, PSZ str2)

Gotcha! If flData specifies CFA_STRING, then offStruct specifies the offset of the pointer to the text and not the text itself

Gotcha! The column heading data is not copied into the container's workspace. Thus they must be global, static, or dynamically allocated data.

Gotcha! A common mistake when specifying CFA_DATE or CFA_TIME for a column is to improperly convert an FDATE structure to a CDATE structure and FTIME structure to a CTIME  structure.

Splitbars

CONTAIN2.C CONTAIN2.RC CONTAIN2.H CONTAIN2.MAK CONTAIN2.DEF

Detail View

Tree View

As before, we allocate a number of records using the CM_ALLOCRECORD structure; withing the loop to initialize each record (which represents a year of sales figures), we allocate 12 records to represent each month initialize these records, and insert them into the container, specifying the year record previously inserted as the parent. This establishes a hierarchical structure that we may observe by placing the container in tree view.

               psiMonths = (PSALESINFO)PVOIDFROMMR(
                                     WinSendMsg(pcdData->hwndCnr, 
                                                CM_ALLOCRECORD,
                                                MPFROMLONG(ulExtra), 
                                                MPFROMSHORT(MAX_MONTHS)));
               psiCMonth = psiMonths;
               for (usIndex2 = 0; usIndex2 < MAX_MONTHS; usIndex2++)
               {  initSalesInfo(pcdData, 
                                psiCYear,
                                psiCMonth,
                                usIndex2);

                  psiCMonth = (PSALESINFO)
                     psiCMonth->mrcStd.preccNextRecord;
               } /* endfor  */

               riRecord.pRecordParent = (PRECORDCORE)psiCYear;
               riRecord.cRecordsInsert = MAX_MONTHS;

               WinSendMsg(pcdData->hwndCnr,
                          CM_INSERTRECORD,
                          MPFROMP(psiMonths),
                          MPFROMP(&riRecord));

   pfiInfo = (PFIELDINFO)PVOIDFROMMR(WinSendMsg(pcdData->hwndCnr,
                                                CM_ALLOCDETAILFIELDINFO,
                                                MPFROMLONG(MAX_COLUMNS),
                                                0));

   pfiCurrent->flData = CFA_BITMAPORICON|CFA_HORZSEPARATOR|CFA_CENTER|CFA_SEPARATOR;
   pfiCurrent->flTitle = CFA_STRING|CFA_CENTER;
   pfiCurrent->pTitleData = "Icon";
   pfiCurrent->offStruct = FIELDOFFSET(SALESINFO,
                                       mrcStd.hptrIcon);
......

   fiiInfo.cb = sizeof(fiiInfo);
   fiiInfo.pFieldInfoOrder = (PFIELDINFO)CMA_FIRST;
   fiiInfo.cFieldInfoInsert = MAX_COLUMNS;
   fiiInfo.fInvalidateFieldInfo = TRUE;

   WinSendMsg(pcdData->hwndCnr,
              CM_INSERTDETAILFIELDINFO,
              MPFROMP(pfiInfo),
              MPFROMP(&fiiInfo));

   memset(&ciInfo, 0, sizeof(ciInfo));
   ciInfo.cb = sizeof(CNRINFO);
   ciInfo.pFieldInfoLast = pfiLefty;
   ciInfo.xVertSplitbar = CX_SPLITBAR;

   WinSendMsg(pcdData->hwndCnr,
              CM_SETCNRINFO,
              MPFROMP(&ciInfo),
              MPFROMLONG(CMA_PFIELDINFOLAST|CMA_XVERTSPLITBAR));

Of Emphasis and Pop-ups

CONTAIN3.C CONTAIN3.RC CONTAIN3.H CONTAIN3.MAK CONTAIN3.DEF

                        psiSales = (PSALESINFO)PVOIDFROMMP(mpParm2);
                        if (psiSales != NULL)
                        {
                           if ((psiSales->mrcStd.flRecordAttr
                              &CRA_SELECTED) == 0)
                           {
                              WinSendMsg(pcdData->hwndCnr, 
                                         CM_SETRECORDEMPHASIS, 
                                         MPFROMP(psiSales), 
                                         MPFROM2SHORT(TRUE, CRA_SOURCE));
                              psiSales->bEmphasized = TRUE;
                           } else {
                             emphasizeRecs(pcdData->hwndCnr, TRUE);
                           }  /* endif */
                        } else {
                           WinSendMsg(pcdData->hwndCnr,
                                      CM_SETRECORDEMPHASIS,
                                      0,
                                      MPFROM2SHORT(TRUE, CRA_SOURCE));
                           pcdData->bCnrSelected = TRUE;
                        }  /* endif */

• If there is a record under the mouse and it is selected, give all selected records source emphasis.
• If there is a record under the mouse and it is not selected, give it source emphasis only.
• If there are no records under the mouse, give the entire container source emphasis.
  

Gotcha! The documentation does not state how the container is given source emphasis this is done by specifying NULL for the record pointer in mpParm1. The container does not keep track of whether it has source emphasis or not and blindly draws this emphasis using the XOR method. Thus, if two CM_SETRECORDEMPHASIS messages are sent, both specifying that source emphasis is to be removed from the container, no visible difference will be seen.

                        WinQueryPointerPos(HWND_DESKTOP, &ptlMouse);
                        WinMapWindowPoints(HWND_DESKTOP,
                                           hwndClient,
                                           &ptlMouse,
                                           1);

                        WinPopupMenu(hwndClient,
                                     hwndClient,
                                     pcdData->hwndMenu,
                                     ptlMouse.x,
                                     ptlMouse.y,
                                     M_VIEWS,
                                     PU_HCONSTRAIN  | PU_VCONSTRAIN   |
                                     PU_KEYBOARD    | PU_MOUSEBUTTON1 |
                                     PU_MOUSEBUTTON2| PU_NONE);

Direct Editing

   typedef struct _CNREDITDATA     /* cnredat */
   {  ULONG        cb;
      HWND         hwndCnr;
      PRECORDCORE  pRecord;
      PFIELDINFO   pFieldInfo;
      PSZ         *ppszText;  /* address of PSZ        */
      ULONG        cbText;    /* size of the new text  */
      ULONG        id;
   } CNREDITDATA;

Gotcha! The application must return TRUE from CN_REALLOCPSZ notifications, or else the container will discard the editing changes.

Of Sorting and Filtering

SHORT EXPENTRY pfnCompare(PRECORDCORE p1,
			  PRECORDCORE p2,
			  PVOID pStorage);

BOOL PFN pfnFilter(PRECORDCORE p,
		   PVOID pStorage);

            case  MI_SORTBYUNITS :
               {  USHORT           usId;
                  usId = MI_SORTBYUNITS;
                  WinSendMsg(pcdData->hwndCnr,
                             CM_SORTRECORD,
                             MPFROMP(sortRecords),
                             MPFROMP(&usId));
               }
               break;

SHORT EXPENTRY sortRecords(PSALESINFO psiFirst,
                           PSALESINFO psiSecond,
                           PUSHORT pusSortBy)
{
   switch (*pusSortBy)
   {
      case  MI_SORTBYUNITS :
         if (psiFirst->ulNumUnits < psiSecond->ulNumUnits)
         { return -1;

         } else
            if (psiFirst->ulNumUnits == psiSecond->ulNumUnits)
            { return 0;
            } else {
               return 1;
            }  /* endif */

      case  MI_SORTBYYEAR :
         return  strcmp(psiFirst->mrcStd.pszIcon, 
                        psiSecond->mrcStd.pszIcon);
      default  :
         return 0;
   } /* endswitch */
} 

            case  MI_FILTER300DOLLARS :
               {  USHORT           usId;
                  usId = MI_FILTER300DOLLARS;
                  WinSendMsg(pcdData->hwndCnr,
                             CM_FILTER,
                             MPFROMP(filterRecords),
                             MPFROMP(&usId));
               } 
               break;

BOOL EXPENTRY filterRecords(PSALESINFO psiInfo,PUSHORT pusFilterBy)
{  switch (*pusFilterBy)
   {
      case  MI_FILTER300DOLLARS :
         return (psiInfo->fSales > 300.0);
      case  MI_FILTER400DOLLARS :
         return (psiInfo->fSales > 400.0);
      case  MI_FILTER500DOLLARS :
         return (psiInfo->fSales > 500.0);
      case  MI_FILTERNONE :
         return  TRUE;
      default  :
         return  TRUE;
   } /* endswitch */
} 

Where Does Direct Manipulation Fit In ?

Summary