DTPAGE 

The DTPAGE structure describes the dialog box that is built from a display table by the BuildDisplayTableH3VFJX function.

Quick Info

typedef struct DTPAGE

{ 

     ULONG        cctl;

     LPTSTR       lpszResourceName;

     union

     { 

          LPTSTR              lpszComponent;

          ULONG               ulItemID;

      }

     LPDTCTL      lpctl;

}    DTPAGE, FAR *LPDTPAGE;

Members

cctl

Count of controls pointed to by the lpctl member.

lpszResourceName

Pointer to the name or integer identifier for the dialog box resource. The MAKEINTRESOURCE macro should be used with an integer identifer to guarantee correctness.

lpszComponent

Pointer to a string that appears in a Help file mapping entry in MAPISVC.INF.

ulItemID

Resource identifier from which the Help file name can be read.

lpctl

Pointer to a array of DTCTLFWJAXZ structures, one for each control on the page.

Remarks

To identify the Help file for the tabbed page, set either the lpszComponent member to a hard-coded string or the ulItemID member to an integer resource identifier. When an integer identifier is used, the BuildDisplayTableH3VFJX function obtains the name from the corresponding string resource.

Although BuildDisplayTable uses this structure to build the display table from control resources, the DTPAGE structure never appears in the display table itself. 

Each help file mapping entry in MAPISVC.INF consists of a component string, no longer than 30 characters, on the left side and a Help file path on the right. Both ulItemID and lpszResourceName are found in the hInstance parameter of BuildDisplayTable.

For an overview of display tables, see Display Tables12983_W. For information about implementing a display table, see Implementing a Display Table3Q3A1K.

See Also