windows-nt/Source/XPSP1/NT/printscan/publish/compstui.h
2020-09-26 16:20:57 +08:00

4077 lines
160 KiB
C

/*++
Copyright (c) 1990-1995 Microsoft Corporation
Module Name:
compstui.h
Abstract:
This module contains global header definition for the COMMON DRIVER UI
Author:
19-Jun-1995 Mon 11:52:01 created -by- Daniel Chou (danielc)
17-Aug-1995 Thu 14:59:28 updated -by- Daniel Chou (danielc)
Updated for the first draft.
23-Aug-1995 Wed 15:13:27 updated -by- Daniel Chou (danielc)
Updated for second draft
29-Aug-1995 Tue 11:33:24 updated -by- Daniel Chou (danielc)
Adding ExtChkBox for some TVOT_xxx type
31-Aug-1995 Thu 04:04:23 updated -by- Daniel Chou (danielc)
Making UNICODE type
01-Sep-1995 Fri 17:29:18 updated -by- Daniel Chou (danielc)
Change the API interface type, so that it can be dynamically called
and generate the property pages to be merge with the shell
05-Sep-1995 Tue 11:52:43 updated -by- Daniel Chou (danielc)
Rename to compspui.h and update the API entry structure
07-Sep-1995 Thu 14:46:55 updated -by- Daniel Chou (danielc)
rename to compstui.h and update comments
07-Sep-1995 Thu 16:07:31 updated -by- Daniel Chou (danielc)
Adding UNION type for pSel/Sel, pOldSel/OldSel
08-Sep-1995 Fri 09:23:38 updated -by- Daniel Chou (danielc)
Remove TypeIdx from OPTITEM and use pOptType, and remove all
pOptType passed in the CPSUICBPARAM and COMPROPSHEETUI structures
25-Sep-1995 Mon 19:39:45 updated -by- Daniel Chou (danielc)
add other related stuff.
26-Sep-1995 Tue 11:02:26 updated -by- Daniel Chou (danielc)
Add error codes for GETLASTERROR
27-Sep-1995 Wed 16:32:37 updated -by- Daniel Chou (danielc)
Move hWndParent, pTitle, hInst and TitleIconID out from
COMPROPSHEETUI to COMPROPSHEETUIHEADER.
28-Sep-1995 Thu 17:06:46 updated -by- Daniel Chou (danielc)
Add hInstCaller to COMPROPSHEETUI and add _COMPSTUI_ and cplusplus
stuff
28-Sep-1995 Thu 23:16:34 updated -by- Daniel Chou (danielc)
change tick count for trackbar/scrollbar to multiply factor. and
add the push button flag which can overwrite the update permission so
it can let user view the current setting from push button's dialog
display
07-Feb-1996 Wed 17:45:31 updated -by- Daniel Chou (danielc)
Change the API CommonPropSheetUI to CommonPropertySheetUI so that it
not using stack but message base, this way any caller can add/delete
pages as they want without worry about how many pages been added from
its children.
7:15 AM 2/14/2001 updated -by- Lazar Ivanov (LazarI)
Making compstui fusion aware. Attaching a fusion activation context
to the compstui handles and adding a new message for setting it called
CPSFUNC_SET_FUSION_CONTEXT. when a page is about to be created/inserted and
it doesn't specify an activation context in its PROPSHEETPAGE structure it
will be created into the parent's page activation context. if the parent's
activation context is not set then we look up the next parent and so on until
the top level parent is reached or until we find a parent with an activation
context properly set. if none of the parents have an activation context set,
then we force the default (NULL) activation context prior creating the page.
[Environment:]
NT Windows - Common Property Sheet UI DLL.
[Notes:]
Revision History:
--*/
#ifndef _COMPSTUI_
#define _COMPSTUI_
#ifdef __cplusplus
extern "C" {
#endif
#if (!defined(RC_INVOKED))
//
// For compilers that don't support nameless unions
//
#ifndef DUMMYUNIONNAME
#ifdef NONAMELESSUNION
#define DUMMYUNIONNAME u
#define DUMMYUNIONNAME2 u2
#define DUMMYUNIONNAME3 u3
#define DUMMYUNIONNAME4 u4
#else
#define DUMMYUNIONNAME
#define DUMMYUNIONNAME2
#define DUMMYUNIONNAME3
#define DUMMYUNIONNAME4
#endif
#endif
//
// Predefined ID for the TreeView Option Type
//
//
#define TVOT_2STATES 0
#define TVOT_3STATES 1
#define TVOT_UDARROW 2
#define TVOT_TRACKBAR 3
#define TVOT_SCROLLBAR 4
#define TVOT_LISTBOX 5
#define TVOT_COMBOBOX 6
#define TVOT_EDITBOX 7
#define TVOT_PUSHBUTTON 8
#define TVOT_CHKBOX 9
#define TVOT_LAST TVOT_CHKBOX
#define TVOT_NONE (TVOT_LAST + 1)
//
// Predefined ID for the TreeView Option Type
//
//
// TVOT_2STATES:
// Count = 2
// pOptParam[0]=pointer to the State 1 OPTPARAM
// pOptParam[1]=pointer to the State 2 OPTPARAM
//
// BegCtrlID = 2 States Group Box ID
// BegCtrlID+1= 2 States static Text
// BegCtrlID+2= state 1 Radio button ID
// BegCtrlID+3= state 1 icon control ID
// BegCtrlID+4= state 2 Radio button ID
// BegCtrlID+5= state 2 icon control ID
// BegCtrlID+6= Extended Check Box/Push Button control ID
// BegCtrlID+7= Extended Check Box/Push Button Icon control ID
//
// * For TVOT_3STATES, TVOT_3STATES, each of OPTPARAM consisted
//
// Style =Ignored
// pData =Pointer to the string to describe the state
// IconID=Icons resource ID, or common UI standard icon ID
// lParam=Ignored
//
// * OPTITEM's 'Sel' is the selection index range from 0 to 1
// * On the non-treeview page, this must be a auto radio button
//
//
// TVOT_3STATES:
// Count = 3
// pOptParam[0]=pointer to the State 1 OPTPARAM
// pOptParam[1]=pointer to the State 2 OPTPARAM
// pOptParam[2]=pointer to the State 3 OPTPARAM
//
// BegCtrlID = 3 States Group Box ID
// BegCtrlID+1= 3 States static Text
// BegCtrlID+2= state 1 Radio button ID
// BegCtrlID+3= state 1 icon control ID
// BegCtrlID+4= state 2 Radio button ID
// BegCtrlID+5= state 2 icon control ID
// BegCtrlID+6= state 3 Radio button ID
// BegCtrlID+7= state 3 icon control ID
// BegCtrlID+8= Extended Check Box/Push Button control ID
// BegCtrlID+9= Extended Check Box/Push Button Icon control ID
//
// * For TVOT_2STATES, TVOT_3STATES, each of OPTPARAM consisted
//
// Style =Ignored
// pData =Pointer to the string to describe the state
// IconID=Icons resource ID, or common UI standard icon ID
// lParam=Ignored
//
// * OPTITEM's 'Sel' is the selection index range from 0 to 1
// * On the non-treeview page, this must be a auto radio button
//
// ** For TVOT_2STATES, TVOT_3STSATES the 'Sel' field in the OPTITEM has
// following definitions
//
// State 1, Sel = 0
// State 2, Sel = 1
// State 3, Sel = 2
//
// for any selection which based on false/true, no/yes, off/ontrue/false,
// none/select then state 1 (sel=0) must always be the NO, FALSE, OFF or
// NONE type.
//
//
// TVOT_UDARROW:
// Count = 2
// pOptParam[0]=Pointer to the text of postfix and ICONS
// pOptParam[1]=Pointer to the help line text above the control and
// IconID = (SHORT)Low range of the up-down control
// lParam = (SHORT)High range of the up-down control
//
// * Low/High must in range of a 16-bit sign integer
//
// if pData pointed to no help text then common UI automatically
// set the (# - #) as help line
//
// BegCtrlID = udarrow Group Box ID
// BegCtrlID+1= udarrow title static title ID
// BegCtrlID+2= udarrow's editbox ID
// BegCtrlID+3= udarrow icon control ID
// BegCtrlID+4= udarrow postfix static text ID
// BegCtrlID+5= udarrow help static text ID
// BegCtrlID+6= udarrow arrow ID
// BegCtrlID+7= Extended Check Box/Push Button control ID
// BegCtrlID+8= Extended Check Box/Push Button Icon control ID
//
// * OPTITEM's 'Sel' is the selection index between Low/High range
// * Style field in the OPTPARAM is ignored
//
//
// TVOT_TRACKBAR:
// Count = 3
// pOptParam[0]=Pointer to the text for the selection postfix and ICONS
// pOptParam[1]=Pointer to the <Low Range Text> and
// IconID = (SHORT)Low range of the trackbar control
// lParam = (SHORT)High range of the trackbar control
//
// * Low/High must in range of a 16-bit sign integer
//
// pOptParam[2]=Pointer to the <High Range Text> and
// IconID = 'Sel' multiply factor for display
// lParam = Page Size (increment)
//
// if pData pointed to NULLt then common UI automatically
// set the Low/High range.
//
// BegCtrlID = trackbar Group Box ID
// BegCtrlID+1= trackbar static title ID
// BegCtrlID+2= trackbar(horizontal) ID (static FRAME to define size)
// BegCtrlID+3= trackbar icon control ID
// BegCtrlID+4= trackbar low range text control ID
// BegCtrlID+5= trackbar high range text control ID
// BegCtrlID+6= trackbar postfix ID
// BegCtrlID+7= Extended Check Box/Push Button control ID
// BegCtrlID+8= Extended Check Box/Push Button Icon control ID
//
// * OPTITEM's 'Sel' is the selection index between Low/High range
// * The multiply factor is used to multiply the current select with
// this factor and display it. typically this is one
// * the tick frequency is automatically to set to PageSize increment
// * Style field in the OPTPARAM is ignored
//
//
// TVOT_SCROLLBAR:
// Count = 3
// pOptParam[0]=Pointer to the text for the selection postfix and ICONS
// pOptParam[1]=Pointer to the <Low Range Text> and
// IconID = (SHORT)Low range of the scrollbar control
// lParam = (SHORT)High range of the scroll control
//
// * Low/High must in range of a 16-bit sign integer
//
// pOptParam[2]=Pointer to the <High Range Text> and
// IconID = 'Sel' multiply factor for display
// lParam = Page Size (increment)
//
// if pData pointed to NULLt then common UI automatically
// set the Low/High range.
//
//
// BegCtrlID = scrollbar(horizontal) group box ID
// BegCtrlID+1= scrollbar(horizontal) static text ID
// BegCtrlID+2= scrollbar(horizontal) ID
// BegCtrlID+3= scrollbar icon control ID
// BegCtrlID+4= scrollbar low range text control ID
// BegCtrlID+5= scrollbar high range text control ID
// BegCtrlID+6= scrollbar postfix control ID
// BegCtrlID+7= Extended Check Box/Push Button control ID
// BegCtrlID+8= Extended Check Box/Push Button Icon control ID
//
// * OPTITEM's 'Sel' is the selection index between Low/High range
// * The multiply factor is used to multiply the current select with
// this factor and display it. typically this is one
// * Style field in the OPTPARAM is ignored
//
//
//
// TVOT_LISTBOX:
// TVOT_COMBOBOX:
// Count = N
// pOptParam[0]=pointer to the first OPTPARAM (pData=string pointer)
// pOptParam[1]=pointer to the second OPTPARAM (pData=string pointer)
// .
// .
// pOptParam[N-1]=pointer to the N item string
//
// BegCtrlID = Listbox/ComboBox group box ID
// BegCtrlID+1= Listbox/ComboBox static title ID
// BegCtrlID+2= Listbox/Combobox ID
// BegCtrlID+3= Listbox/Combobox icon control ID
// BegCtrlID+4= Extended Check Box/Push Button control ID
// BegCtrlID+5= Extended Check Box/Push Button Icon control ID
//
// * for TVOT_LISTBOX, TVOT_COMBOBOX, the field used as
//
// Style =Ignored by the common UI
// pData =Pointer to the name of item
// IconID=Icon resource ID for the item
// lParam=ignored by the common UI
//
// * Only SINGLE selection is supported, to do a multiple selction use
// multiple OPTITEM and create a header for it
//
// * an OTLBCBS_SORT style can be specified in the OPTTYPE's LBCBStyle
// field, and the listbox or combobox will be sorted according to the
// item's string.
//
// * OPTITEM's 'Sel' is the selection index between Low/High range
//
// * for TVOT_LISTBOX, TVOT_COMBOBOX, when it get received the keyboard
// focus then common UI will call callback function (only if
// OPTIF_CALLBACK bit set) with reason of CPSUICB_REASON_LBCB_ACTIVE,
// this give caller a chance to modify following structure flags/pdata
// which associate with the current OPTITEM. The caller's callback
// function can ONLY modify the flags/data specified here.
//
// OPTTYPE pointed by the pOptType from OPTITEM
//
// Style: OTS_LBCB_SORT
// OTS_LBCB_INCL_ITEM_NONE
//
// OPTPARAMs pointed by the pOptParam from the OPTTYPE
//
// Flags: OPTPF_HIDE
// OPTPF_DISABLED
//
// pData: change string name
//
//
// * The TVOT_COMBOBOX typically only used in the tree-view if there is
// only one selection available for that item, when there is only one
// item then dropdown list will not enabled by the common UI
//
//
//
// TVOT_EDITBOX:
// Count = 2
// pOptParam[0]=Pointer to the text of postfix and ICONS
// pOptParam[1]=Pointer to the help line text above the control and
// IconID = Edit buffer sie in character pointed by pSel
// this is including the NULL terminator.
// lParam = ignored.
//
// BegCtrlID = editBox group Box ID
// BegCtrlID+1= editBox static title ID
// BegCtrlID+2= editbox ID
// BegCtrlID+3= editbox icon control ID
// BegCtrlID+4= editbox postfix ID
// BegCtrlID+5= editbox help ID
// BegCtrlID+6= Extended Check Box/Push Button control ID
// BegCtrlID+7= Extended Check Box/Push Button Icon control ID
//
// * Style field is ignored
//
// * pSel in the OPTITEM is the pointer to the editing string, the pSel
// must pointed to a buffer eqaul or larger than the count of the buffer
// (pOptParam[1]->IconID) size
//
//
// TVOT_PUSHBUTTON:
// Count = 1
//
// BegCtrlID = push button group box ID
// BegCtrlID+1= push button static text ID (Not used by common UI)
// BegCtrlID+2= push button ID
// BegCtrlID+3= push button icon control ID
// BegCtrlID+4= Extended Check Box/Push Button control ID
// BegCtrlID+5= Extended Check Box/Push Button Icon control ID
//
//
// PUSHBUTTON_TYPE_xxx specified the action and content of pData in the
// pOptParam[0] as describe in the following
//
// PUSHBUTTON_TYPE_DLGPROC
//
// This push button is designed to bring up caller's dialog box
//
// pOptParam[0].pData = Caller's DLGPROC
// pOptParam[0].Style = PUSHBUTTON_TYPE_DLGPROC
// pOptParam[0].IconID = Icon resource ID
// pOptParam[0].lParam = Caller's DIALOG resource template ID
// or handle to the DLGTEMPLATE depends
// on the OPTPF_USE_HDLGTEMPLATE flag
//
//
// The 'lParam' passed to the DLGPROC's WM_INITDIALOG is the
// CPSUICBPARAM structure pointer, and the reason field is set
// to CPSUICB_REASON_DLGPROC.
//
//
// PUSHBUTTON_TYPE_CALLBACK
//
// This push button is designed to have caller process the item
// which cannot accomplished with the dialog box along.
//
// pOptParam[0].pData = CPSUICALLBACK function pointer
// pOptParam[0].Style = PUSHBUTTON_TYPE_CALLBACK
// pOptParam[0].IconID = Icon resource ID
// pOptParam[0].lParam = Not Used;
//
// Durning the callback the Reason field in CPSUICBPARAM will
// set to CPSUICB_REASON_PUSHBUTTON.
//
// ** If pOptParam[0].pData callback function is NULL then common
// UI will call the pfnCallBack pointer set in the
// COMPROPSHEETUI structure if it is not NULL
//
// ** The callback function should put the result of the callback
// in the pSel/Sel of OPTITEM associate with the push button
//
// PUSHBUTTON_TYPE_HTCLRADJ
//
// This push button is designed to bring up halftone color
// adjustment dialog box.
//
// pOptParam[0].pData = pointer to COLORADJUSTMENT structure
// pOptParam[0].Style = PUSHBUTTON_TYPE_HTCLRADJ
// pOptParam[0].IconID = Icon resource ID
// pOptParam[0].lParam = Not Used;
//
//
// PUSHBUTTON_TYPE_HTSETUP
//
// This push button is designed to bring up device halftone
// setup dialog box.
//
// pOptParam[0].pData = pointer to DEVHTADJDATA structure
// pOptParam[0].Style = PUSHBUTTON_TYPE_HTSETUP
// pOptParam[0].IconID = Icon resource ID
// pOptParam[0].lParam = Not Used;
//
//
// * 'Sel' field in the OPTITEM for the PUSHBUTTON is the last returned
// LONG result from the called dialog box or funcitons. The result
// only valid if OPTIF_CHANGEONCE flag is set. The common UI will set
// OPTIF_CHANGEONCE if push button ever pushed.
//
// * Since common UI donot know the meaning of the return value and
// content of the called parameter, it is up to the caller to use
// callback function to determine the returned result.
//
// * When returned from the push button except push botton type
// PUSHBUTTON_TYPE_CALLBACK common ui will call the callback function
// if the OPTIF_CALLBACK flat is set. The callback reason is set to
// CPSUICB_REASON_SEL_CHANGED.
//
// * If the passed in CPSUIF_UPDATE_PERMISSION Flags in the COMPROPSHEETUI
// is clear then the callback function must ONLY display the dialog box
// and not changed any OPTITEM data if OTS_PUSH_ENABLE_ALWAYS
// flag is set in the OPTTYPE
//
//
// TVOT_CHKBOX:
// Count = 1
//
// pOptparam[0].Style = CHKBOXS_FALSE_TRUE False/True
// CHKBOXS_NO_YES, No/YES
// CHKBOXS_OFF_ON, Off/ON
// CHKBOXS_FALSEPDATA False/pData
// CHKBOXS_NO_PDATA No/pData
// CHKBOXS_OFF_PDATA Off/pData
// CHKBOXS_NONE_PDATA None/pData
// pOptParam[0].pData = Only used if Style is CHKBOXS_NONE_PDATA
// pOptParam[0].IconID = Icon resource ID
// pOptParam[0].lParam = Ignored
//
//
// BegCtrlID = check box group ID
// BegCtrlID+1= Check Box static text (not used by common UI)
// BegCtrlID+2= check box button ID
// BegCtrlID+3= check box icon control ID
// BegCtrlID+4= Extended Check Box/Push Button control ID
// BegCtrlID+5= Extended Check Box/Push Button Icon control ID
//
//
// * BegCtrlID only used if the OPTITEM/OPTTYPE is belong to the the DLGPAGE
// which has non-common UI dialog box template (DlgTemplateID in the DLGPAGE
// is not standard DP_STD_xxx common ui dialog box template). The common
// UI used this ID to managed caller's dialog boxes item's selections and
// initialization.
//
// * for each item, it has group box ID (BegCtrlID) and static text ctronl ID
// (BegCtrlID + 1). The common UI will set the text in one of these two
// control ID in followng seauence.
//
// 1) If group box control ID's window (BegCtrlID) is exist and the
// OPTITEM's flag OPTIF_NO_GROUPBOX_NAME is not set then common UI will
// set the pName from OPTITEM to the group box.
//
// 2) If the group box name is not set and static control ID's window
// (BegCtrlID + 1) is exist then common UI will set the pName from
// OPTITEM to the static text control.
//
// * for TVOT_TRACKBAR and TVOT_SCROLLBAR, if pName in the OPTITEM is set to
// either group box or static text control then common UI will also append
// the current selection position of trackbar or scroll bar to the pName.
//
// * If multiple OPTITEMs using the same POPTPARAM and need different
// BegCtrlID for each control then then a separate OPTTYPE structure should
// be generated but POPTPARAM pointed to the same OPTPARAM[]
//
// * If a BegCtrlID+N is not used then skip that ID in your dialog box
// template
//
//
#define CHKBOXS_FALSE_TRUE 0
#define CHKBOXS_NO_YES 1
#define CHKBOXS_OFF_ON 2
#define CHKBOXS_FALSE_PDATA 3
#define CHKBOXS_NO_PDATA 4
#define CHKBOXS_OFF_PDATA 5
#define CHKBOXS_NONE_PDATA 6
#define PUSHBUTTON_TYPE_DLGPROC 0
#define PUSHBUTTON_TYPE_CALLBACK 1
#define PUSHBUTTON_TYPE_HTCLRADJ 2
#define PUSHBUTTON_TYPE_HTSETUP 3
#define MAX_RES_STR_CHARS 160
//
// Common Printer UI's LPTSTR
//
// All string pointer in common printer UI structures can be either a real
// memory pointer or a string resource ID. These are applied to LPTSTR type.
//
// The LPTSTR is defined to identify that the pointer can be a real string
// pointer or a resource ID (either common printer UI provided ID or caller's
// own resource ID). common UI using following logic to get the final string.
//
// LPTSTR pData;
//
// if ((pData & ~(ULONG_PTR)0xFFFF) != 0) then pData is a NULL terminated
// string pointer
//
// ELSE
//
// (pData & (ULONG_PTR)0xFFFF) = Resource ID
//
// if (Resource ID is within the common UI string resource ID range)
// then it load the string from common UI DLL
//
// ELSE
//
// it load string from caller's resource
//
//
// * You can use MAKEINTRESOURCE(StrResID) to set this field
//
// * The MAX characters loaded by the common UI from the resource is defined
// as MAX_RES_STR_CHARS
//
// * You cannot use LPTSTR as resource ID for the TVOT_EDITBOX style's
// pSel in the OPTITEM, this pointer must be a real buffer pointer
//
//
//
// ICONs
//
// Common UI using two types of Icons, One is 32x32 and the other is 16x16
// plus if any monochrome icon with 32x32 and 16x16 sizes.
//
// The 16x16 icon when displayed on the screen is using 16x17 pixel space,
// this is ensure that downware adjacent icon is not crowded together.
//
// In common UI, if you need to passed a ICON ID, it can either passed a
// common UI's predefined ID or caller's own ICON resource ID.
//
//
// * You can use to imagedit or any other Window icon editor to create the
// icon, each icon file should have one unique icon resource ID which is
// not overlay with the standard common UI IDI_CPSUI_xxx identifier. For
// each icon file, its should have both 32x32 and 16x16 size icon on
// different display. (ie. monochrome).
//
// Common UI will try to load the correct size of icon from the icon
// resource, but it will stretch them if the size is not found.
//
//
//
// Flags for the OPTTYPE
//
//
#define OPTPF_HIDE 0x01
#define OPTPF_DISABLED 0x02
#define OPTPF_ICONID_AS_HICON 0x04
#define OPTPF_OVERLAY_WARNING_ICON 0x08
#define OPTPF_OVERLAY_STOP_ICON 0x10
#define OPTPF_OVERLAY_NO_ICON 0x20
#define OPTPF_USE_HDLGTEMPLATE 0x40
typedef struct _OPTPARAM {
WORD cbSize; // size of this structure
BYTE Flags; // OPTPF_xxxx flags
BYTE Style; // style use in this structure
LPTSTR pData; // pointer to the data
ULONG_PTR IconID; // iconID;
LPARAM lParam; // parameter used
ULONG_PTR dwReserved[2]; // reserved dword, must be 0
} OPTPARAM, *POPTPARAM;
//
// OPTPARAM
//
// The OPTPARAM structure is used to describe each slectable item in the
// common UI such as 'letter', 'legal' in the form slection list box
//
// cbSize - size of this structure
//
// Flags - defined as OPTPF_xxxx
//
// OPTPF_HIDE
//
// Specified hide this listed selection item and not
// availabe for user to select. This only available to
// following TVOT_xxx types
//
// TVOT_3STATES
// TVOT_LISTBOX
// TVOT_COMBOBOX
//
// If all the seclection items are OPTPF_HIDE then the
// OPTITEM is automatically hided by the common UI, if
// TVOT_3STATES has 2 states hide then an error is
// returned
//
//
// OPTPF_DISABLED
//
// Specified this listed selection item is disabled and
// not availabe for user to select. This only available
// to following TVOT_xxx types
//
// TVOT_2STATES
// TVOT_3STATES
// TVOT_LISTBOX
// TVOT_COMBOBOX
//
//
// OPTPF_ICONID_AS_HICON
//
// If this flag is set then IconID DWORD field is treated
// as a handle to the icon rather then the resource ID
//
//
// OPTPF_OVERLAY_WARNING_ICON
//
// If this bit is set then this OPTPARAM item's icon will
// be overlaied by a common UI's IDI_CPSUI_WARNING icon.
//
//
// OPTPF_OVERLAY_STOP_ICON
//
// If this bit is set then this OPTPARAM item's icon will
// be overlaied by a common UI's IDI_CPSUI_STOP icon.
//
//
// OPTPF_OVERLAY_NO_ICON
//
// If this bit is set then this OPTPARAM item's icon will
// be overlaied by a common UI's IDI_CPSUI_NO icon.
//
//
// Style - Style for the OPTPARAM, it depends on the TVOT_xxx type as
// describe below
//
// TVOT_PUSBUTTON
//
// it can be one of PUSHBUTTON_TYPE_xxxx.
//
// other TVOT_xxxx
//
// this fields is not used.
//
//
// pData - Is either a pointer to the item name (string) or it is
// used to describe other data.
//
// * If the pData in the OPTPARAM is supposed to be a static
// pointer to a string and the string is a common UI
// standard resource ID then common UI will check if pData
// is equal to IDS_CPSUI_NOTINSTALLED, if true then
// common UI will overaly a not installed icon on top of
// the OPTPARAM's Icon. This will not applied to the
// TVOT_EDITBOX type since the pData is not a static text
// pointer or a string resource ID.
//
// ** See LPTSTR description above
//
// IconID - This is the icon identifier, which can be a common strandard
// IDI_CPSUI_xxx icon ID, caller's own icon resource ID, or a
// handle to the caller defined icon if OPTPF_ICONID_AS_HICON
// flag is set, in any case if the IconID is zero then it
// indicated no icon.
//
// lParam - Extra data used by the OPTPARAM, it depends on the TVOT_xxx
// type.
//
// dwReserved[]- Reserved DWORDs, must be 0
//
//
#define OPTTF_TYPE_DISABLED 0x01
#define OPTTF_NOSPACE_BEFORE_POSTFIX 0x02
#define OTS_LBCB_SORT 0x0001
#define OTS_LBCB_PROPPAGE_LBUSECB 0x0002
#define OTS_LBCB_PROPPAGE_CBUSELB 0x0004
#define OTS_LBCB_INCL_ITEM_NONE 0x0008
#define OTS_LBCB_NO_ICON16_IN_ITEM 0x0010
#define OTS_PUSH_INCL_SETUP_TITLE 0x0020
#define OTS_PUSH_NO_DOT_DOT_DOT 0x0040
#define OTS_PUSH_ENABLE_ALWAYS 0x0080
typedef struct _OPTTYPE {
WORD cbSize;
BYTE Type; // TVOT_xxxx type of OPTIONS
BYTE Flags; // OPTTF_xxx flags
WORD Count; // Count of pOptParam passed
WORD BegCtrlID; // start of item's group window ID
POPTPARAM pOptParam; // pointer to the OPTPARAM
WORD Style; // option type style as OTS_xxxx
WORD wReserved[3]; // wReserved, must be 0
ULONG_PTR dwReserved[3]; // DWORD reserved field (must be 0)
} OPTTYPE, *POPTTYPE;
//
// OPTTYPE
//
// The OPTTYPE structure is used to describe a set of selection and its
// select method, such as Form/Tray assignment. It has a pointer to a set
// of selection item (OPTPARAM)
//
//
// cbSize - size of this structure
//
// Type - Specified the option type using predefined ID as TVOT_xxxx
//
// Flags - currently only one flag is defined
//
//
// OPTTF_TYPE_DISABLED
//
// The whole OPTTYPE's OPTPARAMs are disabled, and non of
// the selection in the OPTTYPE can be selected
//
//
// OPTTF_NOSPACE_BEFORE_POSTFIX
//
// This bit only valid if the OPTTYPE's pOptParam item
// specified a postfix string as describe in the above
// section. If this flag is set then it asked common UI
// do not add a space character before the postfix string
// when it combine the pName in the OPTITEM and postfix
// string. Typeically this bit is not set for the
// postfix string, but sometime it may be required not to
// add a space character in front of it, such as '%'
// postfix string.
//
//
// Count - Count of item pointed by pOptParam. Some predefined number
// must be set according to the TVOT_XXX description.
//
// BegCtrlID - Only used if the OPTITEM/OPTTYPE is belong to the the DLGPAGE
// which has non-common UI dialog box template (DlgTemplateID
// in the DLGPAGE is not standard DP_STD_xxx common ui dialog
// box template). The common UI used this ID to managed
// caller's dialog boxes item's selections and initialization.
//
// Each OPTITEM has predefined number of window ID which
// associated with that item, the BegCtrlID specified the start
// control window ID. Each control window ID in the OPTITEM
// must have the control ID sequence as describe in the TVOT_xxx
// above.
//
// pOptParam - Pointer to array of OPTPARAM to describe each selectable item
//
// Style - Specified the style of type of control box, certain style
// only apply to centain type of TVOT_xxxx.
//
// OTS_LBCB_xxx only applied to TVOT_LISTBOX, TVOT_COMBOBOX
// OTS_PUSH_xxx only applied to TVOT_PUSHBUTTON
//
//
// OTS_LBCB_SORT
//
// Specified that the listbox or combobox item is sorted
// in ascending order based on the pData string
//
//
// OTS_LBCB_PROPAGE_LBUSECB
//
// Used when Type is TVOT_LISTBOX, if it specified and
// this OPTTYPE also on the non-treeview user defined
// property sheet page dialog then common UI assume
// control is comobobox instead of listbox on the non-
// treeview page
//
//
// OTS_LBCB_PROPAGE_CBUSELB
//
// Used when Type is TVOT_COMBOBOX, if it specified and
// this OPTTYPE also on the non-treeview user defined
// property sheet page dialog then common UI assume
// control is listbox instead of combobox on the non-
// treeview page
//
//
// OTS_LBCB_INCL_ITEM_NONE
//
// when this flag is specified, the common ui will
// automatically add a 'None' selection to the listbox or
// combobox. The 'Sel' will set to -1 if 'none' is
// selection is selected by the user. It will also
// validate the 'Sel' durning the initialization, any
// out of range value will be set to -1 (None).
//
//
// OTS_LBCB_NO_ICON16_IN_ITEM
//
// By default, each listbox, combox will have a small
// icon (16x16) in front of item text. by specified this
// bit, the listbox/combobox will not includes icons
// in the listbox/combobox.
//
// If clear then it specified that in the listbox/combobox
// to have 16x16 Icon added to the front of each item
//
//
// OTS_PUSH_INCL_SETUP_TITLE
//
// If specified for the push button then it automatically
// add the 'Setup' to the end of push botton text.
//
//
// OTS_PUSH_NO_DOT_DOT_DOT
//
// If specified then common UI will not add '...' to the
// end of the pName in the OPTITEM and push button name
//
//
// OTS_PUSH_ENABLE_ALWAYS
//
// This flag specified that even update permissio is not
// allowed, it still let user push the push button, if
// this flag is set then callback function or dialog box
// proc must disable all the control which let user
// modified the content, but just let user view the
// current setting.
//
//
// wReserved[] - Reserved fields, must be 0
//
// dwReserved[]- Reserved fields, must be 0
//
//
//
// Following are flags for the EXTPUSH
//
#define EPF_PUSH_TYPE_DLGPROC 0x0001
#define EPF_INCL_SETUP_TITLE 0x0002
#define EPF_NO_DOT_DOT_DOT 0x0004
#define EPF_ICONID_AS_HICON 0x0008
#define EPF_OVERLAY_WARNING_ICON 0x0010
#define EPF_OVERLAY_STOP_ICON 0x0020
#define EPF_OVERLAY_NO_ICON 0x0040
#define EPF_USE_HDLGTEMPLATE 0x0080
typedef struct _EXTPUSH {
WORD cbSize; // size of the structure
WORD Flags; // EPCBF_xxx flags
LPTSTR pTitle; // extended push botton title
union {
DLGPROC DlgProc; // pointer to the dialog box proc
FARPROC pfnCallBack; // callback function pointer
} DUMMYUNIONNAME;
ULONG_PTR IconID; // icon to be used
union {
WORD DlgTemplateID; // dialog box template ID
HANDLE hDlgTemplate; // handle to the dialog template
} DUMMYUNIONNAME;
ULONG_PTR dwReserved[3]; // reserved field, must be 0
} EXTPUSH, *PEXTPUSH;
//
// EXTPUSH structure is used to describe the extened push button available
// on OPTITEM/OPTITEM, each OPTTYPE can optional have either one extended check
// box or one extended push button callback.
//
//
// cbSize - size of this structure
//
// Flags - flags for the EXTPUSH as EPF_xxxx
//
// EPF_PUSH_TYPE_DLGPROC
//
// If this bit is set then it specified the extended
// push button is type of DLGPROC and DlgProc and
// DlgTemplateID is valid for common UI to call.
//
// If this bit is clear then it specfied the extended
// push button is the callback style and pfnCallBack
// should be called by the common UI
//
//
// EPF_INCL_SETUP_TITLE
//
// If specified for the extended push button then it
// automatically add the 'Setup' to the end of
// extended push button's title
//
//
// EPF_NO_DOT_DOT_DOT
//
// If specified then common UI will not add '...' to
// the end of the pTitle in the EXTPUSH.
//
//
// EPF_ICONID_AS_HICON
//
// If this flag is set then IconID DWORD field is
// treated as a handle to the icon rather then the
// resource ID.
//
//
// EPF_OVERLAY_WARNING_ICON
//
// If this bit is set then this EXTPUSH's icon will be
// overlaied by a common UI's IDI_CPSUI_WARNING icon.
//
//
// EPF_OVERLAY_STOP_ICON
//
// If this bit is set then this EXTPUSH's icon will be
// overlaied by a common UI's IDI_CPSUI_STOP icon.
//
//
// EPF_OVERLAY_NO_ICON
//
// If this bit is set then this EXTPUSH's icon will be
// overlaied by a common UI's IDI_CPSUI_NO icon.
//
//
// pTitle - Pointed to extended push botton title
//
// ** See LPTSTR description above
//
// DlgProc - Pointer to the DLGPROC function supplied by the caller.
// When user push the button the common UI will call
// DialogBoxParam() with this fucction pointer and passed
// CPSUICBPARAM structure pointer to the WM_INITDIALOG with
// the Reason set to CPSUICB_REASON_EXTPUSH. If this
// filed is NULL then common UI assumed that EXTPUSH is
// disabled (OPTIF_EXT_DISABLED | OPTIF_EXT_HIDE), this
// fields only used if EPF_PUSH_TYPE_DLGPROC flag is set
//
// pfnCallBack - Pointer to CPSUICALLBACK function, this only used if
// EPF_PUSH_TYPE_DLGPROC bit is clear, duringing callback
// it passed the CPSUICBPARAM pointer as parameter
//
// IconID - This is the icon identifier, which can be a common
// strandard IDI_CPSUI_xxx icon ID, caller's own icon
// resource ID, or a handle to the caller defined icon if
// EPF_ICONID_AS_HICON flag is set, in any case if the
// IconID is zero then it indicated no icon.
//
// DlgTemplateID - Specified the ressource ID for the dilaog box. If the
// DlgTemplateID = 0 then common UI will call the DlgProc
// with following parameter.
//
// DlgProc(hDlg, WM_USER, NULL, (LPARAM)pCPSUICBPaam);
//
// hDlgTemplate - Handle to the DLGTEMPLATE which will be use for pop up
// dialog box
//
// wReserved[] - WORD reserved field, must be 0
//
// dwReserved[] - DWORD reserved field, must be 0
//
//
//
//
// Following are flags for the EXTCHKBOX
//
#define ECBF_CHECKNAME_AT_FRONT 0x0001
#define ECBF_CHECKNAME_ONLY_ENABLED 0x0002
#define ECBF_ICONID_AS_HICON 0x0004
#define ECBF_OVERLAY_WARNING_ICON 0x0008
#define ECBF_OVERLAY_ECBICON_IF_CHECKED 0x0010
#define ECBF_OVERLAY_STOP_ICON 0x0020
#define ECBF_OVERLAY_NO_ICON 0x0040
#define ECBF_CHECKNAME_ONLY 0x0080
typedef struct _EXTCHKBOX {
WORD cbSize; // size of the structure
WORD Flags; // ECBF_xxx flags
LPTSTR pTitle; // extended checkbox title
LPTSTR pSeparator; // pointer to separator string for treeview
LPTSTR pCheckedName; // string to be displayed when checked
ULONG_PTR IconID; // icon to be used
WORD wReserved[4]; // reserved word, must be 0
ULONG_PTR dwReserved[2]; // reserved field, must be 0
} EXTCHKBOX, *PEXTCHKBOX;
//
// EXTCHKBOX structure is used to describe the extened check box available on
// OPTITEM/OPTITEM, each OPTTYPE can optional have one extended check box.
// When using EXTCHKBOX the selection item can be checked or not checked
// based on user input.
//
//
// cbSize - size of this structure
//
// Flags - flags for the EXTCHKBOX as ECBF_xxxx
//
// ECBF_CHECKNAME_AT_FRONT
//
// This flag specified how to display item's name and its
// checked name in the treeview display. If this flag is
// set then the checked name is display in front of
// separator name, otherwise the checked name is displayed
// after the separator. For Example.
//
// Flag Set: pCheckedName pSeparator SelectName
// Flag Clear: SelectName pSeparator pCheckedName
//
//
// ECBF_CHECKNAME_ONLY_ENABLED
//
// If set then it specified that in the treeview display,
// it will only show the pCheckedName if this extended
// check box is visible and enabled. Some items may not
// desired to display the pCheckedName if the extended
// check box is disabled, such as Copy/Collate checkbox.
//
//
// ECBF_ICONID_AS_HICON
//
// If this flag is set then IconID DWORD field is treated
// as a handle to the icon rather then the resource ID
//
//
// ECBF_OVERLAY_WARNING_ICON
//
// If this bit is set then this EXTCHKBOX's icon will
// be overlaied by a common UI's IDI_CPSUI_WARNING icon.
//
//
// ECBF_OVERLAY_ECBICON_IF_CHECKED
//
// This bit specified to overlay the ExtChkBox's Icon to
// the OPTITEM's icon (or OPTPARAM) if the the extended
// checked box is checked
//
//
// ECBF_OVERLAY_STOP_ICON
//
// If this bit is set then this EXTCHKBOX's icon will
// be overlaied by a common UI's IDI_CPSUI_STOP icon.
//
//
// ECBF_OVERLAY_NO_ICON
//
// If this bit is set then this EXTCHKBOX's icon will
// be overlaied by a common UI's IDI_CPSUI_NO icon.
//
//
// pTitle - Pointed to extended check box title
//
// ** See LPTSTR description above
//
// pSeparator - Pointer to the separator to be used in the treeview
// display or the static title control in the non-treeview
// page,
//
// pCheckedName- Pointed to the name to be displayed in the treeview if item
// is checked. pCheckedName is added according to the
// pSeparator and the ECBF_CHECKNAME_AT_FRONT flags.
//
// * If the pCheckedName is equal to IDS_CPSUI_NOTINSTALLED
// then common UI will automatically overaly a not installed
// icon on top of the extended check box Icon.
//
// ** See LPTSTR description above
//
// IconID - This is the icon identifier, which can be a common strandard
// IDI_CPSUI_xxx icon ID, caller's own icon resource ID, or a
// handle to the caller defined icon if ECBF_ICONID_AS_HICON
// flag is set, in any case if the IconID is zero then it
// indicated no icon.
//
// wReserved[] - WORD reserved field, must be 0
//
// dwReserved[]- DWORD reserved field, must be 0
//
//
// Following the the Flags for the OPTITEM
//
#define OPTIF_COLLAPSE 0x00000001L
#define OPTIF_HIDE 0x00000002L
#define OPTIF_CALLBACK 0x00000004L
#define OPTIF_CHANGED 0x00000008L
#define OPTIF_CHANGEONCE 0x00000010L
#define OPTIF_DISABLED 0x00000020L
#define OPTIF_ECB_CHECKED 0x00000040L
#define OPTIF_EXT_HIDE 0x00000080L
#define OPTIF_EXT_DISABLED 0x00000100L
#define OPTIF_SEL_AS_HICON 0x00000200L
#define OPTIF_EXT_IS_EXTPUSH 0x00000400L
#define OPTIF_NO_GROUPBOX_NAME 0x00000800L
#define OPTIF_OVERLAY_WARNING_ICON 0x00001000L
#define OPTIF_OVERLAY_STOP_ICON 0x00002000L
#define OPTIF_OVERLAY_NO_ICON 0x00004000L
#define OPTIF_INITIAL_TVITEM 0x00008000L
#define OPTIF_HAS_POIEXT 0x00010000L
#define OPTIF_MASK 0x0001ffffL
#define DMPUB_NONE 0
#define DMPUB_FIRST 1
#define DMPUB_ORIENTATION 1
#define DMPUB_SCALE 2
#define DMPUB_COPIES_COLLATE 3
#define DMPUB_DEFSOURCE 4
#define DMPUB_PRINTQUALITY 5
#define DMPUB_COLOR 6
#define DMPUB_DUPLEX 7
#define DMPUB_TTOPTION 8
#define DMPUB_FORMNAME 9
#define DMPUB_ICMMETHOD 10
#define DMPUB_ICMINTENT 11
#define DMPUB_MEDIATYPE 12
#define DMPUB_DITHERTYPE 13
#define DMPUB_OUTPUTBIN 14
#define DMPUB_QUALITY 15
#define DMPUB_NUP 16
#define DMPUB_PAGEORDER 17
#define DMPUB_LAST 17
#define DMPUB_OEM_PAPER_ITEM 97
#define DMPUB_OEM_GRAPHIC_ITEM 98
#define DMPUB_OEM_ROOT_ITEM 99
#define DMPUB_USER 100
#define MAKE_DMPUB_HIDEBIT(DMPub) (DWORD)(((DWORD)0x01 << ((DMPub) - 1)))
#define IS_DMPUB_HIDDEN(dw, DMPub) (BOOL)((DWORD)(dw) & \
MAKE_DMPUB_HIDEBIT(DMPub))
//
// DMPUB_xxxx is used in OPTITEM to identify if the item is a DEVMODE public
// field. Following it identify which field correspond to the DMPUB_xxxx
//
//
// DMPUB_ORIENTATION - dmOrientation
//
// DMPUB_SCALE - dmScale
//
// DMPUB_COPIES_COLLATE- dmCopies/dmCollate
//
// DMPUB_DEFSOURCE - dmDefSource (Should only used form by caller)
//
// DMPUB_PRINTQUALITY - dmPrintQuality
//
// DMPUB_COLOR - dmColor
//
// DMPUB_DUPLEX - dmDuplex
//
// DMPUB_TTOPTION - dmTTOption
//
// DMPUB_FORMNAME - dmFormName
//
// DMPUB_ICMMETHOD - dmICMMethod
//
// DMPUB_ICMINTENT - dmICMIntent
//
// DMPUB_MEDIATYPE - dmMediaType
//
// DMPUB_DITHERTYPE - dmDitherType
//
// DMPUB_USER - Anything greater than or equal to DMPUB_USER can be
// used by the caller.
//
// DMPUB_OUTPUTBIN - Private
//
// DMPUB_QUALITY - Private
//
// DMPUB_NUP - Private
//
// DMPUB_PAGEORDER - Private
//
// When common UI is called for the 'Document Properties' (DEVMODE), it will
// group some of public items together simillar to the following in the
// treeview. How it group is common UI version dependent and caller should not
// concern its placement
//
// Paper/Output (Add in by the common UI)
// Document Form (DMPUB_FORMNAME)
// Output Bin (DMPUB_OUTPUTBIN)
// Orientation (DMPUB_ORIENTATION)
// Source (DMPUB_DEFSOURCE)
// Media (DMPUB_MEDIATYPE)
// Number of Copies (DMPUB_COPIES_COLLATE)
// Page Order (DMPUB_PAGEORDER)
// Page Per Sheet (DMPUB_NUP)
// Duplex (DMPUB_DUPLEX)
//
// Graphic (Add in by the common UI)
// Print Quality (DMPUB_PRINTQUALITY)
// Quality Settings (DMPUB_QUALITY)
// Color (DMPUB_COLOR)
// Image Color Matching (Add in by the common UI)
// ICM Method (DMPUB_ICMMETHOD)
// ICM Intent (DMPUB_ICMINTENT)
// Scaling (DMPUB_SCALE)
// Dithering (DMPUB_DITHERTYPE)
// TrueType Option (DMPUB_TTOPTION)
//
// Options
// Halftone Color Adjustment...
// ALL Other Caller's Document sticky options
//
//
// For 'Document Properties' the standard page 1 (user friendly page) will
// consist following items if it appear in the OPTITEM array passed by the
// caller. These items must have following predefined TVOT_xxx type
// defined here and specified in the OPTTYPE's Type field.
//
// All DMPUB_xxx (except >= DMPUB_USER) public ID must have following
// TVOT_xxxx type specified, else a CPDU_INVALID_DMPUB_TVOT error is returned
//
// DMPUB_ORIENTATION - TVOT_2STATES/TVOT_3STATES
// DMPUB_SCALE - TVOT_UDARROW
// DMPUB_COPIES_COLLATE - TVOT_UDARROW + EXTCHKBOX (Collate)
// DMPUB_DEFSOURCE - TVOT_LISTBOX
// DMPUB_PRINTQUALITY - TVOT_LISTBOX
// DMPUB_COLOR - TVOT_2STATES
// DMPUB_DUPLEX - TVOT_2STATES/TVOT_3STATES
// DMPUB_TTOPTION - TVOT_LISTBOX
// DMPUB_FORMNAME - TVOT_LISTBOX
// DMPUB_ICMMETHOD - TVOT_2STATES/TVOT_3STATES
// DMPUB_ICMINTENT - TVOT_2STATES/TVOT_3STATES
// DMPUB_MEDIATYPE - TVOT_LISTBOX
// DMPUB_DITHERTYPE - TVOT_LISTBOX
//
//
#define OIEXTF_ANSI_STRING 0x0001
typedef struct _OIEXT {
WORD cbSize;
WORD Flags;
HINSTANCE hInstCaller;
LPTSTR pHelpFile;
ULONG_PTR dwReserved[4];
} OIEXT, *POIEXT;
//
// OIEXT is a data structure used as extension to the OPTITEM data structure
//
//
// cbSize - sizeof this structure
//
// Flags - One or more of OIEXTF_xxxx may be specified.
//
// OIEXTF_ANSI_STRING
//
// Specified that LPTSTR in this data structure is a ansi
// string (not UNICODE). This bit only checked if the
// LPTSTR is not the resource string ID
//
// hInstCaller - DLL instance handle, when this hInst is not NULL then all
// resource string and icon loading for this OPTITEM and its
// OPTTYPE, OPTPARAM are loaded from this hInstCaller Handle.
// If this filed is NULL then it will use the hInstCaller handle
// specified in the COMPROPSHEETUI data structure
//
// pHelpFile - Resource string ID or pointer to the help file for this
// OPTITEM. If this pointer is NULL then help file for the
// help index is assume specified in the pHelpFile field in the
// COMPROPSHEETUI data structure.
//
// dwReserved - These fields are not used now, and must 0
//
typedef struct _OPTITEM {
WORD cbSize; // size of this structure
BYTE Level; // level in the tree view
BYTE DlgPageIdx; // Index to the pDlgPage
DWORD Flags; // OPTIF_xxxx flags
ULONG_PTR UserData; // caller's own data
LPTSTR pName; // name of the item
union {
LONG Sel; // current selection (index)
LPTSTR pSel; // current selection (pStr)
} DUMMYUNIONNAME;
union {
PEXTCHKBOX pExtChkBox; // Pointer to EXTCHKBOX structure
PEXTPUSH pExtPush; // Pointer to EXTPUSH
} DUMMYUNIONNAME2;
POPTTYPE pOptType; // pointer to OPTTYPE structure
DWORD HelpIndex; // Help file index
BYTE DMPubID; // Devmode public filed ID
BYTE UserItemID; // caller's own item ID
WORD wReserved; // reserved WORD field, must be 0
POIEXT pOIExt; // Optitem extension pointer
ULONG_PTR dwReserved[3]; // reserved DWORD fields (must be 0)
} OPTITEM, *POPTITEM;
//
// OPTITEM is to describe each treeview item's name, selection type and
// possible selection
//
// cbSize - sizeof this structure
//
// Level - The level in the treeview, the root should have lowest
// number and number should start with level 0. the maximum
// number of levels are 256.
//
// DlgPageIdx - Zero-based index to the DLGPAGE araay pointee by
// pDlgPage. The Maximum index is MAX_DLGPPAGE_COUNT, if
// pDlgPage is a standard CPSUI_PDLGPAGE_xxxx then this
// field is automatically set the common UI
//
// Flags - OPTIF_xxxx flags as describe above
//
// OPTIF_COLLAPSE
//
// Collaspe treeview item and its children so it is
// not expanded initially.
//
//
// OPTIF_HIDE
//
// Hide this item from the treeview
//
//
// OPTIF_CALLBACK
//
// Callback to the caller when user making some
// changes a pointer (pfnCallBack) must provided and
// process as defined by the common UI.
//
//
// OPTIF_CHANGED
//
// This item was changed and need to re-display. this
// flag only used when caller returned from callback
// funciton.
//
//
// OPTIF_CHANGEONCE
//
// This item has been changed at least once.
//
//
// OPTIF_DISABLED
//
// Disable this item so it become not selectable.
//
//
// OPTIF_ECB_CHECKED
//
// Specified the associated extended check box is
// in checked state.
//
//
// OPTIF_EXT_HIDE
//
// Hide the extended check box/extended push botton.
//
//
// OPTIF_EXT_DISABLED
//
// The Extended check box/push botton is disabled and
// not selectable
//
//
// OPTIF_SEL_AS_HICON
//
// This flag only used if this item has no type,
// pOptType=NULL that is, when pOptType is NULL then
// 'Sel' field is the IconID. if flag is set then it
// indicate 'pSel' is the Icon handle rather
// than the icon resource ID specified in Sel.
//
//
// OPTIF_EXT_IS_EXTPUSH
//
// Specified that pExtPush should be used when this
// pointer is not NULL, if this pointer is not NULL
// and this flag is clear then pExtChkBox is assumed.
//
//
// OPTIF_NO_GROUPBOX_NAME
//
// Specified that do not overwrite the group box title
// text, if group box ID is defined. See the TVOT_xx
// description above.
//
//
// OPTIF_OVERLAY_WARNING_ICON
//
// If this bit is set then this header OPTITEM's icon
// will be overlaied by a common UI's
// IDI_CPSUI_WARNING icon. This bit only used if this
// item has no type, pOptType is NULL that is.
//
//
// OPTIF_OVERLAY_STOP_ICON
//
// If this bit is set then this header OPTITEM's icon
// will be overlaied by a common UI's IDI_CPSUI_STOP
// icon. This bit only used if this item has no type,
// pOptType is NULL that is.
//
//
// OPTIF_OVERLAY_NO_ICON
//
// If this bit is set then this header OPTITEM's icon
// will be overlaied by a common UI's IDI_CPSUI_NO
// icon. This bit only used if this item has no type,
// pOptType is NULL that is.
//
//
// OPTIF_INITIAL_TVITEM
//
// Specified that this item will be the initial item
// to be selected and display on the treeview page.
// If the selected item is currently a child or
// collapse then common UI will expand the selection
// then scroll it into view.
//
// If this flag is clear or the set item is in hide
// status common UI will pick the initial item to
// display.
//
// OPTIF_HAS_POIEXT
//
// Specified that pOIExt field is a valid pointer that
// points to OIEXT data structure. The pOIExt only
// used by the common UI if this bit is set.
//
//
// UserData - a 32-bit number used by the caller and common UI will not
// modify it.
//
// pName - Pointer to the item's name, such as 'Upper Tray',
// 'Memory' or it is used as data as describe in
// OPTPARAM/OPTTYPE structure
//
// ** See LPTSTR description above
//
// pSel
// Sel - Current selection for this item. This is a union field
// which can be a pointer to a string or a LONG index
// selection.
//
// ** If pOptType field is NULL then 'Sel' is the icon ID
// to be used for the header.
//
// pExtPush
// pExtChkBox - Pointer to either EXTPUSH or EXTCHKBOX data structure,
// if this pointer is NULL then this item does not have
// ectended check box/push botton associate with it.
//
// When an extended check box is associate with the
// OPTTYPE, the OPTIF_EXT_IS_EXTPUSH must not set, the
// OPTIF_ECB_CHECKED flag specified if the extended check
// box is checked or not checked.
//
// When an Extended push botton is associated with the
// OPTTYPE, the OPTIF_EXT_IS_EXTPUSH flag must set.
//
// The following flags are used in both EXTCHKBOX or
// EXTPUSH
//
// OPTIF_EXT_HIDE,
// OPTIF_EXT_DISABLED
// OPTIF_EXT_CHANGEONCE
//
//
// pOptType - Pointer to the OPTTYPE structure to describe the display
// and selections of the item. If this pointer is NULL
// then this this item does not have any selection. and it
// is used as sub-items' header.
//
// * When pOptType is NULL then the 'Sel' is the Icon ID.
//
//
// HelpIndex - a index to the help file for context sensitive help
// if HelpInex=0 then there is no help for this item
//
// DMPubID - specified if this item is one of the public fields in the
// DEVMODE structure and supported by the common UI.
//
// DMPUB_NONE - Not DEVMODE public fields
// DMPUB_ORIENTATION - dmOrientation
// DMPUB_SCALE - dmScale
// DMPUB_COPIES_COLLATE - dmCopies/dmCollate
// DMPUB_DEFSOURCE - dmDefSource
// DMPUB_PRINTQUALITY - dmPrintQuality
// DMPUB_COLOR - dmColor
// DMPUB_DUPLEX - dmDuplex
// DMPUB_TTOPTION - dmTTOption
// DMPUB_FORMNAME - dmFormName
// DMPUB_ICMMETHOD - dmICMMethod
// DMPUB_ICMINTENT - dmICMIntent
// DMPUB_MEDIATYPE - dmMediaType
// DMPUB_DITHERTYPE - dmDitherType
//
// ** for most of DMPUB_FIRST to DMPUB_LAST each OPTITEM's
// pName is automatically set to the standard
// IDS_CPSUI_xxx for the consistancy reason, the
// standard pName is set according to following table.
//
// DMPUB_ORIENTATION - IDS_CPSUI_ORIENTATION
// DMPUB_SCALE - IDS_CPSUI_SCALING
// DMPUB_COPIES_COLLATE - IDS_CPSUI_COPIES
// DMPUB_DEFSOURCE - IDS_CPSUI_SOURCE
// DMPUB_PRINTQUALITY - IDS_CPSUI_PRINTQUALITY
// IDS_CPSUI_RESOLUTION
// DMPUB_COLOR - IDS_CPSUI_COLOR_APPERANCE
// DMPUB_DUPLEX - IDS_CPSUI_DUPLEX
// DMPUB_TTOPTION - IDS_CPSUI_TTOPTION
// DMPUB_FORMNAME - IDS_CPSUI_FORMNAME
// DMPUB_ICMMETHOD - IDS_CPSUI_ICMMETHOD
// DMPUB_ICMINTENT - IDS_CPSUI_ICMINTENT
// DMPUB_MEDIATYPE - IDS_CPSUI_MEDIA
// DMPUB_DITHERTYPE - IDS_CPSUI_DITHERING
//
// for DMPUB_PRINTQUALITY, if the pName is not one of
// IDS_CPSUI_PRINTQUALITY or IDS_CPSUI_RESOLUTION then
// common UI will automatically default the pName to
// IDS_CPSUI_RESOLUTION.
//
// Each pData (OPTPARAM) selection in OPTPARAM which
// OPTITEM's pOptType pointed to should use as much
// as IDS_CPSUI_xxx standard name as possible.
//
//
// ** for DMPUB_COPIES_COLLATE the common UI automatically
// doing the following before the callback
//
// 1) Enable/Disable the collate extended check box if
// OPTIF_EXT_HIDE is not specified and pExtChkBox
// is not NULL in the OPTITEM.
//
// 2) Automatically change the postfix for this item
// to be 'Copy' if selection is one, and 'Copies'
// if selection is greater than one in the treeview
// page, and it will also set the postfix in
// standard document property page if the postfix
// ID is provided (BegCtrlID + 4)
//
//
// ** for DMPUB_COLOR the common UI automatically doing
// the following before the callback, the gray
// selection must be Sel=0 and Color slection must be
// Sel=1
//
// 1) Calling halftone color adjustment with current
// color/mono selection
//
// 2) Disable ICM when color is not selected
//
//
// ** Please see above DMPUB_xx description for details.
//
// UserItemID - This is a byte ID intented to be used by the caller to
// identify the item
//
// wReserved - WORD reserved. Must be zero
//
// pOIExt - Pointer to the OIEXT data structure to specified that
// it has a OPTITEM extenstion structure.
//
// dwReserved[] - DWORD reserved and must be 0
//
//
//
// predefined ID for call back reason
//
#define CPSUICB_REASON_SEL_CHANGED 0
#define CPSUICB_REASON_PUSHBUTTON 1
#define CPSUICB_REASON_ECB_CHANGED 2
#define CPSUICB_REASON_DLGPROC 3
#define CPSUICB_REASON_UNDO_CHANGES 4
#define CPSUICB_REASON_EXTPUSH 5
#define CPSUICB_REASON_APPLYNOW 6
#define CPSUICB_REASON_OPTITEM_SETFOCUS 7
#define CPSUICB_REASON_ITEMS_REVERTED 8
#define CPSUICB_REASON_ABOUT 9
#define CPSUICB_REASON_SETACTIVE 10
#define CPSUICB_REASON_KILLACTIVE 11
//
// predefined ID for call back action
//
#define CPSUICB_ACTION_NONE 0
#define CPSUICB_ACTION_OPTIF_CHANGED 1
#define CPSUICB_ACTION_REINIT_ITEMS 2
#define CPSUICB_ACTION_NO_APPLY_EXIT 3
#define CPSUICB_ACTION_ITEMS_APPLIED 4
typedef struct _CPSUICBPARAM {
WORD cbSize; // size of this structure
WORD Reason; // CPSUICB_REASON_XXXXX callback reason
HWND hDlg; // handle of the dialog box
POPTITEM pOptItem; // pOptItem field from COMPROPSHEETUI
WORD cOptItem; // cOptItem field from COMPROPSHEETUI
WORD Flags; // flags field from COMPROPSHEETUI
POPTITEM pCurItem; // current selected item of callback
union {
LONG OldSel; // Last selection (index)
LPTSTR pOldSel; // Last selection (pStr)
} DUMMYUNIONNAME;
ULONG_PTR UserData; // UserData in the COMPROPSHEETUI struct.
ULONG_PTR Result; // OUT parameter for the APPLYNOW
} CPSUICBPARAM, *PCPSUICBPARAM;
typedef LONG (APIENTRY *_CPSUICALLBACK)(PCPSUICBPARAM pCPSUICBParam);
#define CPSUICALLBACK LONG APIENTRY
//
// CPSUICBPARAM is used when commom UI callback to the caller, this structure
// describe the nature of callback and passed all necessary parameter for the
// caller to make changes in the pOptItem and passed an action back to the
// commom UI to redisplay the tree or page 1 data
//
//
// cbSize - must be CPSUICBPARAM
//
// Reason - defined the nature of the callback
//
// CPSUICB_REASON_SEL_CHANGED
//
// User make change to the pCurItem. if the item is
// DMPUB_COPIES_COLLATE then common UI automatically
// change the collate extended check box without callback
// to the caller of the extended check box changes
//
//
// CPSUICB_REASON_PUSHBUTTON
//
// User push the push button and push button item is set
// to PUSHBUTTON_TYPE_CALLBACK.
//
//
// CPSUICB_REASON_ECB_CHANGED
//
// User make change to the extended checked box (i.e. it
// eiterh checked or not checked) EXTCHKBOX in the
// pCurItem passed in the call back parameter.
//
//
// CPSUICB_REASON_DLGPROC
//
// The callback reason is PUSHBUTTON_TYPE_DLGPROC
//
//
// CPSUICB_REASON_UNDO_CHANGES
//
// This callback currently is not implmented.
//
//
// CPSUICB_REASON_EXTPUSH
//
// The callback is result of user push the extend push
// button.
//
//
// CPSUICB_REASON_APPLYNOW
//
// The user press the apply now button. Durning callback
// the pCurItem is set to equal to pOptItem in this
// structure and 'OldSel' is set to the active DlgPageIdx
// (compare to the OPTITEM's DlgPageIdx) which the page
// user hitting the apply now button if the page is
// non-treeview page, otherwise the 'OldSel' is set to -1
// (for treeview page) to indicate all valid item should
// be apply now, if the callback return
// CPSUICB_ACTION_NONE then the common UI will exit the
// property sheet and returned CPSUI_OK back to the
// caller, and if the callback function returned
// CPSUICB_ACTION_NO_APPLY_EXIT then common UI will not
// exit the property sheet and callback function must
// pop-up messages dialog box to tell user why it cannot
// exist the property sheet until certain action is take
// by the user.
//
//
// CPSUICB_REASON_OPTITEM_SETFOCUS
//
// This callback reason is used when an OPTITEM is getting
// the keyboard focus. and give the callback function a
// chance to examine the item.
//
//
// CPSUICB_REASON_ITEMS_REVERTED
//
// This callback reason is used when user changed items
// and decided to revert changes from the parent item in
// the treeview. The callback funciton is called after
// all revertable items are reverted to its original.
//
// The CPSUICBPARAM's pCurItem is same as pOptItem and
// 'OldSel' field is same as cOptItem field. for each of
// reverted item, the OPTIF_CHANGED bit will be set in the
// OPTITEM by the common UI to indicate the item is revert
// by the common UI. The callback function MUST NOT
// reset this bit if it is set.
//
//
// CPSUICB_REASON_ABOUT
//
// This callback reason is used when user hit 'About...'
// push button in the treeview page, and the flag
// CPSUIF_ABOUT_CALLBACK is set. The pCurItem is set to
// same as pOptItem and 'pOldSel' is a pointer pointed to
// original copy of COMPROPSHEETUI data structure which
// passed to the common UI.
//
//
// CPSUICB_REASON_SETACTIVE
// CPSUICB_REASON_KILLACTIVE
//
// The current property sheet is gaining or loosing focus,
// the pCurItem is set to equal to pOptItem in this
// structure and 'OldSel' is set to the current active
// DlgPageIdx (compare to the OPTITEM's DlgPageIdx).
// if the page is non-treeview page, otherwise the
// 'OldSel' is set to -1 (for treeview page).
//
// hDlg - The handle to the dialog box (Properties page TAB) current
// active for the callback.
//
// Durning the callback the caller must not change the
// DWLP_USERDATA on hDlg, otherwise the common UI will be crash.
// If callback function need to get/set DWLP_USERDATA it should
// call common UI's SetCPSUIUserData() and GetCPSUIUserData()
// functions instead.
//
// pCurItem - Pointed to POPTITEM which the callback is generated for.
//
// pOldSel
// OldSel - The last OPTITEM's pSel/Sel field before the change was made
// by the user. The pOldSel/OldSel only valid if the callback
// reason is CPSUICB_REASON_SEL_CHANGED, this give the callback
// function a chance to check against the previous item
// selection. This is a union field which can be a pointer to
// a string or a LONG index selection.
//
// UserData - a 32-bit user defined data in the COMPROPSHEETUI structure,
// commom UI will not changed it.
//
// Result - When the reason is CPSUICB_REASON_APPLYNOW, the callback
// function MUST set the requested result for the caller into
// 'Result' field when it returned a value other than the
// CPSUICB_ACTION_NO_APPLY_EXIT and common UI will send the
// 'Result' field value to this page's parent.
//
// The called function should save the current result of
// pOptItem. The default 'Result' is set to CPSUI_OK (1) from
// common UI. This function can alter this result before it
// return back to to the common UI.
//
//
// Return Values:
//
// CPSUICB_ACTION_NONE - No action need to be take by the
// common UI.
//
// CPSUICB_ACTION_OPTIF_CHANGED - Ask the common UI to examine the
// OPTIF_CHANGED flag in the OPTITEM
// data structure. if the flag is set
// then that item is assume need to be
// re-display because of OPTITEM's Flags
// field changed or item's selection
// changed. This is different from
// CPSUICB_ACTION_REINIT_ITEMS which
// it assume OPTTYPE or OPTPARAM data
// also changed.
//
//
// CPSUICB_ACTION_REINIT_ITEMS - Ask the common UI to examine the
// OPTIF_CHANGED flag in the OPTITEM
// data structure. if the flag is set
// then that item is assume need to be
// re-initialized in the dilaog box
// control. This happened if item's
// OPTTYPE or OPTPARAMs flag/pdata
// changed.
//
//
// CPSUICB_ACTION_NO_APPLY_EXIT - This return value only valid durning
// CPSUICB_REASON_APPLYNOW callback
// reason, it tell common UI it has
// some constraints in its OPTITEM which
// must correct or confirm by the user
// before exit. The callback function
// must display and/or have user taking
// some actions before return this
// action to the common UI
//
// CPSUICB_ACTION_ITEMS_APPLIED - When responsed to the
// CPSUICB_REASON_APPLYNOW, if the
// returned action is
// CPSUICB_ACTION_ITEMS_APPLIED then
// common UI will reset OPTIF_CHANGEONCE
// bit and save the new default for the
// future undo operations.
//
//
#define DP_STD_TREEVIEWPAGE 0xFFFF
#define DP_STD_DOCPROPPAGE2 0xFFFE
#define DP_STD_DOCPROPPAGE1 0XFFFD
#define DP_STD_RESERVED_START 0xFFF0
#define MAX_DLGPAGE_COUNT 64
#define DPF_ICONID_AS_HICON 0x0001
#define DPF_USE_HDLGTEMPLATE 0x0002
typedef struct _DLGPAGE {
WORD cbSize; // size of this structure
WORD Flags; // DPF_xxxx flags
DLGPROC DlgProc; // caller's dialog box subclass procedue
LPTSTR pTabName; // pointer to the tab name
ULONG_PTR IconID; // icon to be used
union {
WORD DlgTemplateID; // dialog box template ID
HANDLE hDlgTemplate; // handle to the dialog template
} DUMMYUNIONNAME;
} DLGPAGE, *PDLGPAGE;
//
// DLGPAGE structure describe non-treeview page characteristics
//
//
// cbSize - size of this structure
//
// Flags - DPF_xxxx flags
//
// DPF_ICONID_AS_HICON
//
// If this flag is set then IconID DWORD field is
// treated as a handle to the icon rather then the
// resource ID
//
//
// DlgProc - caller's supplied DLGPROC for sub-class the page
// dialog box processing,
//
// if DlgProc is not NULL then common UI do the following
// according the the message received except for the
// DP_STD_xxx pages
//
//
// WM_INITDIALOG
//
// Common UI initialize the dialog box and then call
// DlgProc(WM_INITDIALOG) the DlgProc should return
// exactly the behavior for the WM_INITDIALOG
//
// The lParam in the WM_INITDIALOG data structure is
// a pointer to the PROPSHEETPAGE data structure.
//
// the lParam field in the PROPSHEETPAGE (lParam
// passed to the WM_INITDIALOG) is the UserData
// defined in COMPROPSHEETUI data structure
//
// To access to the PSPINFO data structure which
// associate with this page, use the common UI macro
// PPSPINFO_FROM_WM_INITDIALOG_LPARAM(lParam) where
// lParam is the parameter passed to the
// WM_INITDIALOG message.
//
// The subclass function should save these pointers
// for its later use, but it MUST NOT modified the
// content of the PSPINFO data structure or system
// may crashed.
//
//
// OTHER DIALOG MESSAGES
//
// Iit call DlgProc() and if it returned the value is
// non-zero then common UI assume DlgProc() processed
// the message and will not process this message.
//
// If the returned vlaue from DlgProc() is zero then
// common UI will process this message.
//
//
// * Durning the DlgProc the caller must not change the
// DWLP_USERDATA on hDlg, otherwise the common UI will
// be crash. If caller need to get/set DWLP_USERDATA it
// should call common UI's SetCPSUIUserData() and
// GetCPSUIUserData() instead.
//
// pTabName - Pointer to a string to describe the TAB title
//
// IconID - This is the icon identifier, which can be a common
// strandard IDI_CPSUI_xxx icon ID, caller's own icon
// resource ID, or a handle to the caller defined icon if
// DPF_ICONID_AS_HICON flag is set, in any case if the
// IconID is zero then it indicated no icon.
//
// DlgTemplateID - The template id to be use for the ProPage, it can be
// one of DP_STD_xxxx, the DP_STD_xxx has 240 x 240 dialog
// box units.
//
//
// DP_STD_TREEVIEWPAGE
//
// Specified that this page is a standard treeview
// page provided by the common ui. The treeview page
// is a page using treeview display all valid OPTITEM
// passed to the common UI. User can modify every
// valid selectable OPTITEM from the treeview page.
//
// DP_STD_DOCPROPPAGE
//
// Specified that this page is a standard document
// property page provided by the common UI
//
// hDlgTemplate - Handle to the DLGTEMPLATE which will be use for pop up
// dialog box
//
//
// wReserved[]
// dwReserved[] - Reserved fields, must be 0
//
//
// ** Tips of designing the dialog box controls
//
// When designing the dialog box controls, each OPTITEM is correspoonds
// to one input control plus one extended check box or extended push
// button. Since common UI will automatically disable and remove
// OPTIF_HIDE items item from the property sheet and dynamically move
// other controls, the following tips of designing the dialog box controls
// should follow.
//
// * Each item should have one input control plus optional of extended
// check box/push botton, one icon control and other static controls
//
// * Each item should occupied whole horizontal spaces of the property
// sheet, items must not overlay in vertical direction.
//
// * for TVOT_2STATES, TVOT_3STATES, if it araange radio buttons from
// left to right in state order (ie. from first state's OPTPARAM to
// last state's OPTPARAM) then the radio buttons and icons should
// aligned in the Y coordinate. If it arrange radio buttons from top
// to bottom (ie. from first state's OPTPARAM to last state's OPTPARAM)
// then the radio buttons and icons should aligned in the X coordinate.
//
// common UI will automatically hide/move the radio buttons to compact
// the dialog box controls. If radio buttons/icons are arranged in
// top/down order and there is other controls obscure in Y direction
// then radio buttons will only be re-arranged but not remove any white
// spaces in Y direction.
//
// * If multiple items shared one group box, then the group box must
// belongs to the first item (topmost in the dialog box group) in the
// group, the group box must large enough to cover all the items in
// side the group box.
//
//
#define CPSUIF_UPDATE_PERMISSION 0x0001
#define CPSUIF_ICONID_AS_HICON 0x0002
#define CPSUIF_ABOUT_CALLBACK 0x0004
#define CPSUI_PDLGPAGE_DOCPROP (PDLGPAGE)1
#define CPSUI_PDLGPAGE_ADVDOCPROP (PDLGPAGE)2
#define CPSUI_PDLGPAGE_PRINTERPROP (PDLGPAGE)3
#define CPSUI_PDLGPAGE_TREEVIEWONLY (PDLGPAGE)4
//
// For compatible misspelling #define
//
#define CPSUI_PDLGPAGE_TREEVIWONLY CPSUI_PDLGPAGE_TREEVIEWONLY
typedef struct _COMPROPSHEETUI {
WORD cbSize; // size of this structure
WORD Flags; // CPSUIF_xxxx flags
HINSTANCE hInstCaller; // caller's hInstance
LPTSTR pCallerName; // pointer to the caller's name
ULONG_PTR UserData; // caller's own data
LPTSTR pHelpFile; // pointer to the help file
_CPSUICALLBACK pfnCallBack; // callback function pointer
POPTITEM pOptItem; // pointer to POPTITEM array
PDLGPAGE pDlgPage; // pointer to the DLGPAGE array
WORD cOptItem; // count of pOptItem array
WORD cDlgPage; // count of pDlgPage array
ULONG_PTR IconID; // icon to be used
LPTSTR pOptItemName; // pointer to the optitem's data name
WORD CallerVersion; // version for the caller apps
WORD OptItemVersion; // version for the optitem name
ULONG_PTR dwReserved[4]; // reserved, must be 0
} COMPROPSHEETUI, *PCOMPROPSHEETUI;
//
// COMPROPSHEETUI data structure is used when calling common UI to display dialog
// box of properties pages.
//
//
// Size - Must be sizeof (COMPROPSHEETUI)
//
// Flags - can be one or more of following
//
// CPSUIF_UPDATE_PERMISSION
//
// Specified the any valid pOptItem items are
// changeable by the user.
//
//
// CPSUIF_ICONID_AS_HICON
//
// If this flag is set then IconID DWORD field is
// treated as a handle to the icon rather then the
// resource ID
//
//
// CPSUIF_ABOUT_CALLBACK
//
// If this flag bit is set, then when user hit
// 'About...' button in the treeview tab, it will
// call the callback function with a reason of
// CPSUICB_REASON_ABOUT, and callback MUST handle
// the about which pop-up dialog box to show user
// the information about the caller and OPTITEMs.
//
// If this bit is not set then common UI will call
// the ShellAbout() with formatted caller Name and
// pOptItemName with version numbers.
//
//
// hInstCaller - the caller's handle to its instance. Commom UI use
// this handle to load caller's icon and other resources.
//
// pCallerName - Pointer to the caller's NULL terminated caller's
// name, most time this is driver's name,
// such as 'Postscript Driver'
//
// UserData - a 32-bit number used by the caller and common UI will
// not modify it. this 32-bit number is passed back to
// the caller durning the callback function
//
// pHelpFile - specified a standard microsoft help file (path/file)
// for using in the common UI. in OPTITEM specified
// HelpIndex for help in each item.
//
// pfnCallBack - Pointer to _CPSUICALLBACK callback function. Common
// UI only callback to the caller if an OPTIF_CALLBACK
// is set OPTITEM data structure's flag fields and the
// item selection is changed by the user.
//
// pOptItem - Pointer to array of OPTITEM structure to be displayed
// by the common UI
//
// pDlgPage - Pointer to array of DLGPAGE structure to describe
// each property sheet page infomation, the following
// are the standard common ui DLGPAGEs. When specified
// CPSUI_PDLGPAGE_xxxx, the common UI will automatically
// modify DlgPageIdx field in the OPTITEM, caller must
// set the iStartPage correctly.
//
// CPSUI_PDLGPAGE_DOCPROP
//
// specified this a common ui standard document
// property sheets. This includes two property
// sheets, 1) Page Setup 2) Advance (TreeView)
//
//
// CPSUI_PDLGPAGE_ADVDOCPROP
//
// Specified this is a treeview page only UI
// provided by the common UI, this only has one
// treeview page with tab of 'Advance'
//
//
// CPSUI_PDLGPAGE_PRINTERPROP
//
// Specified this is a common UI standard printer
// property sheet. This only has one treeview
// page with tab of 'Device Options'
//
//
// CPSUI_PDLGPAGE_TREEVIEWONLY
//
// Specified this is a treeview page only UI
// provided by the common UI, this only has one
// treeview page
//
//
//
// cOptItem - Count of OPTITEM pointed by the pOptItem above
//
// cDlgPage - Count of DLGPAGE pointed by the pDlgPage. If
// pDlgPage is one of the CPSUI_PDLGPAGE_xxxx then this
// field is ignored by the common UI.
//
// IconID - This is the icon identifier, which can be a common
// strandard IDI_CPSUI_xxx icon ID, caller's own icon
// resource ID, or a handle to the caller defined icon
// if CPSUIF_ICONID_AS_HICON flag is set, in any case
// if the IconID is zero then it indicated no icon.
//
// pOptItemName - Pointer to the pOptItem data NULL terminated name,
// most time this is device name, such as 'HP 4si'
//
// CallerVersion - Version for the caller, the HIBYTE(CallerVersion) is
// the major version, and LOBYTE(CallerVersion) is the
// minor version, such as 0x310 display as 3.16, 0x3ff
// display as 3.255 and 0x30a display as 3.10
//
// OptItemVersion - Version for the OPTITEM's data, the
// HIBYTE(OptItemVersion) is the major version, and
// LOBYTE(OptItemVersion) is the minor version, such as
// 0x310 display as 3.16, 0x3ff display as 3.255 and
// 0x30a display as 3.10.
//
// dwReserved[4] - reserved fields, must be 0
//
//
// ** pTitlee and TitleBarIcon only used if CommonPrinterPropSheetUI()
// is the last one the Property sheet UI chain and call the PropertySheet()
//
//
#define CPSFUNC_ADD_HPROPSHEETPAGE 0
#define CPSFUNC_ADD_PROPSHEETPAGEW 1
#define CPSFUNC_ADD_PCOMPROPSHEETUIA 2
#define CPSFUNC_ADD_PCOMPROPSHEETUIW 3
#define CPSFUNC_ADD_PFNPROPSHEETUIA 4
#define CPSFUNC_ADD_PFNPROPSHEETUIW 5
#define CPSFUNC_DELETE_HCOMPROPSHEET 6
#define CPSFUNC_SET_HSTARTPAGE 7
#define CPSFUNC_GET_PAGECOUNT 8
#define CPSFUNC_SET_RESULT 9
#define CPSFUNC_GET_HPSUIPAGES 10
#define CPSFUNC_LOAD_CPSUI_STRINGA 11
#define CPSFUNC_LOAD_CPSUI_STRINGW 12
#define CPSFUNC_LOAD_CPSUI_ICON 13
#define CPSFUNC_GET_PFNPROPSHEETUI_ICON 14
#define CPSFUNC_ADD_PROPSHEETPAGEA 15
#define CPSFUNC_INSERT_PSUIPAGEA 16
#define CPSFUNC_INSERT_PSUIPAGEW 17
#define CPSFUNC_SET_PSUIPAGE_TITLEA 18
#define CPSFUNC_SET_PSUIPAGE_TITLEW 19
#define CPSFUNC_SET_PSUIPAGE_ICON 20
#define CPSFUNC_SET_DATABLOCK 21
#define CPSFUNC_QUERY_DATABLOCK 22
#define CPSFUNC_SET_DMPUB_HIDEBITS 23
#define CPSFUNC_IGNORE_CPSUI_PSN_APPLY 24
#define CPSFUNC_DO_APPLY_CPSUI 25
#define CPSFUNC_SET_FUSION_CONTEXT 26
#define MAX_CPSFUNC_INDEX 26
#ifdef UNICODE
#define CPSFUNC_ADD_PCOMPROPSHEETUI CPSFUNC_ADD_PCOMPROPSHEETUIW
#define CPSFUNC_ADD_PFNPROPSHEETUI CPSFUNC_ADD_PFNPROPSHEETUIW
#define CPSFUNC_LOAD_CPSUI_STRING CPSFUNC_LOAD_CPSUI_STRINGW
#define CPSFUNC_ADD_PROPSHEETPAGE CPSFUNC_ADD_PROPSHEETPAGEW
#define CPSFUNC_INSERT_PSUIPAGE CPSFUNC_INSERT_PSUIPAGEW
#define CPSFUNC_SET_PSUIPAGE_TITLE CPSFUNC_SET_PSUIPAGE_TITLEW
#else
#define CPSFUNC_ADD_PCOMPROPSHEETUI CPSFUNC_ADD_PCOMPROPSHEETUIA
#define CPSFUNC_ADD_PFNPROPSHEETUI CPSFUNC_ADD_PFNPROPSHEETUIA
#define CPSFUNC_LOAD_CPSUI_STRING CPSFUNC_LOAD_CPSUI_STRINGA
#define CPSFUNC_ADD_PROPSHEETPAGE CPSFUNC_ADD_PROPSHEETPAGEA
#define CPSFUNC_INSERT_PSUIPAGE CPSFUNC_INSERT_PSUIPAGEA
#define CPSFUNC_SET_PSUIPAGE_TITLE CPSFUNC_SET_PSUIPAGE_TITLEA
#endif
//
// for the CPSFUNC_SET_RESULT
//
#define SR_OWNER 0
#define SR_OWNER_PARENT 1
typedef struct _SETRESULT_INFO {
WORD cbSize;
WORD wReserved;
HANDLE hSetResult;
LRESULT Result;
} SETRESULT_INFO, *PSETRESULT_INFO;
//
// This is for CPSFUNC_INSERT_PSUIPAGE
//
#define HINSPSUIPAGE_FIRST (HANDLE)0xFFFFFFFE
#define HINSPSUIPAGE_LAST (HANDLE)0xFFFFFFFF
#define HINSPSUIPAGE_INDEX(i) (HANDLE)MAKELONG(i, 0);
#define PSUIPAGEINSERT_GROUP_PARENT 0
#define PSUIPAGEINSERT_PCOMPROPSHEETUI 1
#define PSUIPAGEINSERT_PFNPROPSHEETUI 2
#define PSUIPAGEINSERT_PROPSHEETPAGE 3
#define PSUIPAGEINSERT_HPROPSHEETPAGE 4
#define PSUIPAGEINSERT_DLL 5
#define MAX_PSUIPAGEINSERT_INDEX 5
#define INSPSUIPAGE_MODE_BEFORE 0
#define INSPSUIPAGE_MODE_AFTER 1
#define INSPSUIPAGE_MODE_FIRST_CHILD 2
#define INSPSUIPAGE_MODE_LAST_CHILD 3
#define INSPSUIPAGE_MODE_INDEX 4
typedef struct _INSERTPSUIPAGE_INFO {
WORD cbSize;
BYTE Type;
BYTE Mode;
ULONG_PTR dwData1;
ULONG_PTR dwData2;
ULONG_PTR dwData3;
} INSERTPSUIPAGE_INFO, *PINSERTPSUIPAGE_INFO;
//
// for the CPSFUNC_SET_HSTARTPAGE
//
#define SSP_TVPAGE 10000
#define SSP_STDPAGE1 10001
#define SSP_STDPAGE2 10002
typedef LONG_PTR (CALLBACK *PFNCOMPROPSHEET)(HANDLE hComPropSheet,
UINT Function,
LPARAM lParam1,
LPARAM lParam2);
typedef struct _PSPINFO {
WORD cbSize;
WORD wReserved;
HANDLE hComPropSheet;
HANDLE hCPSUIPage;
PFNCOMPROPSHEET pfnComPropSheet;
} PSPINFO, *PPSPINFO;
//
// PPSPINFO_FROM_WM_INITDIALOG_LPARAM(lParam) macro retrieve a pointer to the
// PSPINFO data structure. the lParam must be the lParam passed to the
// WM_INITDIALOG, otherwise the system can failed
//
#define PPSPINFO_FROM_WM_INITDIALOG_LPARAM(lParam) \
(PPSPINFO)((LPBYTE)lParam + ((LPPROPSHEETPAGE)lParam)->dwSize)
//
// PSPINFO
//
// This structure is used durning property sheet page's WM_INITDIALOG message.
// At WM_INITDIALOG, the lParam is a pointer to the PROPSHEETPAGE, and
// lParam field in the PROPSHEETPAGE is a pointer to the PSPINFO. the
// original lParam in the PROPSHEETPAGE is saved in the lParam field in the
// PSPINFO data structure.
//
// When process WM_INITDIALOG message, it should save the lParam (PSPINFO
// structure pointer) for later to call common UI callback functions.
//
//
// cbSize - Size of this structure in bytes
//
// wReserved - Reserved, must be set to zero
//
// hComPropSheet - Handle to the parent page which is the hComPropSheet
// passed to the CPSFUNC_ADD_PROPSHEETPAGE
//
// hCPSUIPage - Handle to the this added common UI property sheet page.
//
// pfnComPropSheet - Pointer to the common UI callback function, using this
// function pointer to do CPSFUNC_xxxx
//
//
typedef struct _CPSUIDATABLOCK {
DWORD cbData;
LPBYTE pbData;
} CPSUIDATABLOCK, *PCPSUIDATABLOCK;
#define APPLYCPSUI_NO_NEWDEF 0x00000001
#define APPLYCPSUI_OK_CANCEL_BUTTON 0x00000002
//
// PFNCOMPROPSHEET function descriptions
//
// For each function index, it passed a handle, a Function Index and two (2)
// long parameters, the 'hComPropSheet' handle passed must be the handle passed
// from common UI when common UI called the caller supplied function
//
// pfnPropSheetUI(pPropSheetUIData);
//
// Following are the description of each function index
//
//
// -------------------------------------------------------------------------
// Function = CPSFUNC_ADD_HPROPSHEETPAGE
//
// This function add a page to the hComPropSheet using handle to the
// PROPSHEETPAGE
//
//
// Parameters:
//
// lParam1 - is a handle to the PROPSHEETPAGE that created by the caller
// using CreatePropertySheetPage()
//
// lParam2 - Not used, must be 0
//
//
// Return Value:
//
// The return value is the handle of newly added common property sheet
// page, if return value is NULL then function failed.
//
//
// -------------------------------------------------------------------------
// Function = CPSFUNC_ADD_PROPSHEETPAGE
//
// This function add a page to the hComPropSheet using PROPSHEETPAGE
// data structure.
//
//
// Parameters:
//
// lParam1 - is a pointer to PROPSHEETPAGE data structure
//
// lParam2 - Not used.
//
//
// Return Value:
//
// The return value is the handle of newly added common property sheet
// page, if return value is NULL then function failed.
//
//
// -------------------------------------------------------------------------
// Function = CPSFUNC_ADD_PCOMPROPSHEETUI
//
// This function add propety page(s) to the hComPropSheet handle using
// COMPROPSHEETUI data structure.
//
//
// Parameters:
//
// lParam1 - is a pointer to COMPROPSHEETUI data structure
//
// lParam2 - pointer to a 32-bit location that received the total pages
// added by the COMPROPSHEETUI data structure if sucessful else
// it contains the ERR_CPSUI_xxx error codes.
//
//
// Return Value:
//
// The return value is the handle of newly added common property sheet
// page(s), if return value is NULL then function failed.
//
//
// -------------------------------------------------------------------------
// Function = CPSFUNC_ADD_PFNPROPSHEETUI
//
// This function add property page(s) to the hChild handle using
// lParam1 as PFNPROPSHEETUI function pointer and lParam2 as the function
// parameter. The common UI call supplied function as following
//
// PROPSHEETUI_INFO PSUIInfo;
//
// PSUIInfo.cbSize = sizeof(PROPSHEETUI_INFO);
// PSUIInfo.Version = PROPSHEETUI_INFO_VERSION;
// PSUIInfo.Flags = (Ansi) ? 0: PSUIINFO_UNICODE;
// PSUIInfo.Reason = PROPSHEETUI_REASON_INIT;
// PSUIInfo.hComPropSheet = hComPropSheet;
// PSUIInfo.pfnComPropSheet = ComPropSheetUICallBack;
// PSUIInfo.lParamInit = lParam2;
// PSUIInfo.UserData = 0;
// PSUIInfo.Result = 0;
//
// ((PFNPROPSHEETUI)lParam1)(&PSUIInfo, lParam2);
//
//
// If the pfnPropSheetUI() need to add/delete any common UI pages then
// it must use hComPropSheet as its handle when calling the
// ComPropSheetUICallBack().
//
//
// Parameters:
//
// lParam1 - a PFNPROPSHEETUI function pointer.
//
// lParam2 - a 32-bit data that will be used as lParam when calling
// PFNPROPSHEETUI function pointer.
//
//
// Return Value:
//
// The return value is the newly added property pages function handle, if
// return value is NULL then function failed or no page is added.
//
//
//
// -------------------------------------------------------------------------
// Function = CPSFUNC_DELETE_HCOMPROPSHEET
//
// This function delete child property page(s) from hComPropSheet parent
// using the child handle passed.
//
//
// Parameters:
//
// lParam1 - the handle of common property sheet pages that to be deleted.
// This handle must be the handle returned from CPSFUNC_ADD_xxx
// functions.
//
// lParam2 - not used, must be 0
//
// Return Value:
//
// The return value is greater than zero if function sucessful, and less
// or equal to zero if the function failed.
//
// -------------------------------------------------------------------------
// Function = CPSFUNC_GET_PAGECOUNT
//
// This function return total property sheet pages belongs to a common
// UI property sheet page handle hComPropSheet
//
//
// Parameters:
//
// lParam1 - not used, must be 0
//
// lParam2 - not used, must be 0.
//
//
// Return Value:
//
// The return value is total page count if function sucessful or zero if
// function failed.
//
//
// -------------------------------------------------------------------------
// Function = CPSFUNC_SET_RESULT
//
// This function set the result of property sheet page to its owner that
// added this page by CPSFUNC_ADD_xxx function indices
//
// Parameters:
//
// lParam1 - Handle to the common UI property sheet page that setting the
// result. If this handle is NULL then it is treated as
// equal to the hComPropSheet.
//
// lParam2 - a 32-bit DWORD result to be set.
//
//
// Return Value:
//
// > 0: Successful, return value is total count of parents set the result
// = 0: There is no owner or parent for the lParam1 handle.
// < 0: function failed because of invalid lParam1 handle.
//
//
// -------------------------------------------------------------------------
// Function = CPSFUNC_SET_HSTARTPAGE
//
//
// Parameters:
//
// lParam1 - the handle of common property sheet pages that to be set
// as initial page that appear when the property sheet dialog
// boxes is created. This handle must be the handle returned
// from CPSFUNC_ADD_xxx functions.
//
// If lParam1 is NULL then lParam2 is a string pointer to the
// page name (tab) that to be set for the start page
//
// lParam2 - a LONG number to specified the children index. if lParam1
// handle is a parent then lParam2 specified zero base children
// index for using as start page.
//
// It also can be one of following special index
//
// SSP_TVPAGE
//
// set to the treeview page, this only valid if lParam1
// handle was added by the CPSFUNC_ADD_PCOMPROPSHEETUI.
//
// SSP_STDPAGE
//
// Set to the standard document property sheet page
// (Page 1 user friendly page). this only valid if
// lParam1 handle was added by the
// CPSFUNC_ADD_PCOMPROPSHEETUI.
//
//
// Return Value:
//
// The return value is greater than zero if function sucessful, and less
// or equal to zero if the function failed. This function can only be
// called when the property sheet is not display yet so the place to
// call is during the PROPSHEETUI_REASON_GET_INFO_HEADER callback.
//
// -------------------------------------------------------------------------
// Function = CPSFUNC_GET_HPSUIPAGES
//
// This function return array of children HPROPSHEETPAGE belongs to
// the parent hComPropSheet UI property sheet page handle hComPropSheet
//
//
// Parameters:
//
// lParam1 - Pointer to an array of HPROPSHEETPAGE that to be stored
// the handle upon return.
//
// lParam2 - Count of HPROPSHEETPAGE array pointed by the lParam1
//
//
// Return Value:
//
// The return value is total HPROPSHEETPAGE stored in the array pointed
// by the lParam1. To get all hPropSheetPage for any common property
// sheet handle's (hCPSUIPage) children, it can use following sequence.
//
// if ((cPage = pfnComPropSheet(hComPropSheet,
// CPSFUNC_GET_PAGECOUNT,
// (LPARAM)hCPSUIPage,
// 0L)) &&
// (phPage = ALLOCMEM(cPage * sizeof(HANDLE)))) {
//
// pfnComPropSheet(hCPSUIPage,
// CPSFUNC_GET_HPSUIPAGES,
// (LPARAM)phPage,
// (LPARAM)cPage);
// }
//
// -------------------------------------------------------------------------
// Function = CPSFUNC_LOAD_CPSUI_STRING
//
// This function load the common property sheet UI resource string
//
// Parameters:
//
// lParam1 - Pointer to LPTSTR string which will stored the loaded
// resource string from the common property sheet UI DLL.
//
// lParam2 - LOWORD(lParam2) = Count of characters (includes null
// terminator) which pointed by the lParam1
//
// HIWORD(lParam2) = Common property sheet UI predefined string
// resource ID as IDS_CPSUI_xxxx
//
//
// Return Value:
//
// > 0: Total characters stored in the string pointed by the lParam1, this
// is not includes the null terminator
// = 0: Invalid IDS_CPSUI_xxx passed from HIWORD(lParam)
// < 0: Either lParam1 is NULL or count of character is 0 from
// LOWORD(lParam2)
//
//
// -------------------------------------------------------------------------
// Function = CPSFUNC_LOAD_CPSUI_ICON
//
// This function load the common property sheet UI resource icon.
//
// Parameters:
//
// lParam1 - Common property sheet UI predefined icon resource ID as
// IDI_CPSUI_xxxx.
//
// lParam2 - LOWORD(lParam2) = cx icon size in pixel. If zero then
// SM_CXICON is used
// HIWORD(lParam2) = cy icon size in pixel. If zero then
// SM_CYICON is used
//
//
// Return Value:
//
// Return value is the handle to the hIcon if function succeed, a NULL
// if function failed. The caller must call DestroyIcon() when it no
// longer need to use the hIcon returned
//
//
// -------------------------------------------------------------------------
// Function = CPSFUNC_GET_PFNPROPSHEETUI_ICON
//
// This function let the caller return hIcon of its children pages that
// was added by CPSFUNC_ADD_PFNPROPSHEETUI
//
// Parameters:
//
// lParam1 - Handle of common property sheet pages that the hIcon will be
// queried. This handle must be the handle returned from
// CPSFUNC_ADD_PFNPROPSHEETUI function.
//
// lParam2 - LOWORD(lParam2) = cx icon size in pixel. If zero then
// SM_CXICON is used
// HIWORD(lParam2) = cy icon size in pixel. If zero then
// SM_CYICON is used
//
//
// Return Value:
//
// Return value is the handle to the hIcon if function succeed, a NULL
// if function failed. The caller must call DestroyIcon() when it no
// longer need to use the hIcon returned
//
//
// -------------------------------------------------------------------------
// Function = CPSFUNC_INSERT_PSUIPAGE
//
// This function let the caller insert common property sheet pages at
// set position. The hComPropSheet must be the parent handle.
//
// Parameters:
//
// lParam1 - Handle of common property sheet pages that the page position
// will be inserted. This handle must be the handle returned
// from previous CPSFUNC_ADD_xxx or CPSFUNC_INSERT_PSUIPAGE that
// added or inserted using the hComPropSheet if the Mode field
// in INSPSUIPAGE_INFO data structure is one of the follwing
//
// INSPSUIPAGE_MODE_BEFORE
// INSPSUIPAGE_MODE_AFTER - Common UI page handle
//
// INSPSUIPAGE_MODE_INDEX - the lParam1 is an zero based
// child index.
//
// INSPSUIPAGE_MODE_FIRST_CHILD
// INSPSUIPAGE_MODE_LAST_CHILD - The lParam1 is ignonred.
//
//
// If lParam1 is a valid common property sheet page handle then
// it is the child page handle of hComPropSheet that added by
// CPSFUNC_ADD_xxx or inserted by CPSFUNC_INSERT_PSUIPAGE.
//
// lParam2 - A pointer that points to INSERTPSUIPAGE_INFO data structure.
// Fields must set according to the following.
//
// cbSize - size of this structure
//
// Type - Type of page(s) to be inserted. It can be one
// of the following
//
// PSUIPAGEINSERT_GROUP_PARENT
//
// Insert a group parent that can be used to insert
// new pages under it. This is typically used when
// a set of common UI pages must be group together and
// can be deleted later using a single group parent
// handle without individual deleting each page.
//
// This handle can be nested. After this function
// returned the group parent handle, it can be used
// as hComPropSheet handle (first parameter in the
// common UI callback) as parent handle so insertion
// will be inserted at level below returned group
// parent handle.
//
//
// PSUIPAGEINSERT_PCOMPROPSHEETUI
//
// Insert pages using COMPROPSHEETUI data structure,
// dwData1 is a pointer to the COMPROPSHEETUI data
// structure.
//
//
// PSUIPAGEINSERT_PFNPROPSHEETUI
//
// Insert pages using PFNPROPSHEETUI function pointer.
// The dwData1 is a PFNPROPSHEETUI function pointer.
// The common UI will call this pfnPropSheetUI()
// function pointer with PROPSHEETUI_REASON_INIT to
// have it add pages.
//
// When common UI call pfnPropSheetUI() (dwData1) it
// also passed a 32-bit parameter from the dwData2
// field in INSERTPSUIPAGE_INFO data structure.
//
//
// PSUIPAGEINSERT_PROPSHEETPAGE
//
// Insert pages using PROPSHEETPAGE data structure.
// The dwData1 is a pointer to the PROPSHEETPAGE
// data structure.
//
//
// PSUIPAGEINSERT_HPROPSHEETPAGE
//
// Insert pages using HPROPSHEETPAGE handle. The
// dwData1 is a PROPSHEETPAGE handle which was
// created by CreatePropertySheetPage().
//
//
// PSUIPAGEINSERT_DLL
//
// Insert pages from a dynnmaic link library. The
// dwData1 is a pointer to a null terminated string
// that specified the dynamic link library file name.
//
// The dwData2 is a pointer to a null terminated ASCII
// string that specified the pfnPropSheetUI function
// name. (MUST BE ASCII STRING)
//
// Common UI will do a LoadLibrary((LPTSTR)dwData1),
// pfnPropSheetUI = GetProcAddress((LPTSTR)dwData2)
// then call the pfnPropSheetUI with a lParam from
// dwData3. The called reason from common UI is
// set to PROPSHEETUI_REASON_INIT.
//
// Using this method insert pages will guaranteed that
// library will be unload correctly.
//
//
// Mode - Insert Mode, it can be one of the following
//
//
// INSPSUIPAGE_MODE_BEFORE
//
// Insert pages before the common property sheet page
// handle specified by lParam1
//
//
// INSPSUIPAGE_MODE_AFTER
//
// Insert pages after the common property sheet page
// handle specified by lParam1
//
//
// INSPSUIPAGE_MODE_FIRST_CHILD
//
// Insert pages as the first child of hComPropSheet
// parent handle, the lParam1 is ignored
//
//
// INSPSUIPAGE_MODE_LAST_CHILD
//
// Insert pages as the last child of hComPropSheet
// parent handle, the lParam1 is ignored
//
//
// INSPSUIPAGE_MODE_INDEX
//
// Insert pages as a zero base child index of its
// parent handle specified by hComPropSheet.
//
// The lParam1 is the zero based index special handle
// that must generated by HINSPSUIPAGE_INDEX(Index)
// macro. If the index is greater than or equal to
// the total count of children then it will treat the
// mode same as INSPSUIPAGE_MODE_LAST_CHILD
//
//
// dwData1
// dwData2
// dwData3 - 32-bit data associate with the 'Type' field
// as following
//
//
// PSUIPAGEINSERT_GROUP_PARENT
//
// dwData1 = Not used, must be 0
// dwData2 = Not used, must be 0
// dwData3 = Not used, must be 0
//
//
// PSUIPAGEINSERT_PCOMPROPSHEETUI
//
// dwData1 = pointer to COMPORPSHEETUI data structure.
// dwData2 = at return if sucessful, it contains total
// page added. If failed, it contains the
// ERR_CPSUI_xxx codes
// dwData3 = Not used, must be 0
//
//
// PSUIPAGEINSERT_PFNPROPSHEETUI
//
// dwData1 = PFNPROPSHEETUI function pointer
// dwData2 = 32-bit parameter passed to pfnPropSheetUI
// dwData3 = Not used, must be 0
//
//
// PSUIPAGEINSERT_PROPSHEETPAGE
//
// dwData1 = Pointer to PROPSHEETPAGE data structure.
// dwData2 = not used, must be 0
// dwData3 = not used, must be 0
//
//
// PSUIPAGEINSERT_HPROPSHEETPAGE
//
// dwData1 = Is the HPROPSHEETPAGE handle that created
// by a call to CreatePropertySheetPage().
// dwData2 = not used, must be 0
// dwData3 = not used, must be 0
//
//
// PSUIPAGEINSERT_DLL
//
// dwData1 = Pointer to a null terminated dynamic link
// library filename.
// dwData2 = Pointer to a null terminated function
// name (PFNPROPSHEETUI) in the dynamin link
// library.
// dwData3 = 32-bit parameter passed to pfnPropSheetUI
// (PFNPROPSHEETUI) function from dwData2
//
//
// Return Value:
//
// The return value is the handle of newly added common property sheet
// page(s), if return value is NULL then function failed.
//
//
// -------------------------------------------------------------------------
// Function = CPSFUNC_SET_PSUIPAGE_TITLE
//
// This function let the caller set a new title for a particular common
// UI page title (on the property sheet page tab)
//
// Parameters:
//
// lParam1 - the handle of common property sheet pages that title to be
// set. This handle must be the handle returned from following
//
// CPSFUNC_ADD_PROPSHEETPAGE
// CPSFUNC_ADD_HPROPSHEETPAGE
// CPSFUNC_INSERT_PSUIPAGE with type of
// PSUIPAGEINSERT_PROPSHEETPAGE or
// PSUIPAGEINSERT_HPROPSHEETPAGE
//
// lParam2 - Pointer to a null terminated string for the new title
//
//
// Return Value:
//
// The return value is greater than zero if function sucessful, and less
// or equal to zero if the function failed.
//
// This function will returned 0 if the property sheet pages is not
// currently displayed.
//
//
// -------------------------------------------------------------------------
// Function = CPSFUNC_SET_PSUIPAGE_ICON
//
// This function let the caller set a new icon for a particular common
// UI page icon (on the property sheet page tab)
//
// Parameters:
//
// lParam1 - the handle of common property sheet pages that icon to be
// set. This handle must be the handle returned from following
//
// CPSFUNC_ADD_PROPSHEETPAGE
// CPSFUNC_ADD_HPROPSHEETPAGE
// CPSFUNC_INSERT_PSUIPAGE with type of
// PSUIPAGEINSERT_PROPSHEETPAGE or
// PSUIPAGEINSERT_HPROPSHEETPAGE
//
// lParam2 - Handle to Icon, this icon is best as 16x16 icon otherwise it
// will be stretch to 16x16 (pixel).
//
//
// Return Value:
//
// The return value is greater than zero if function sucessful, and less
// or equal to zero if the function failed.
//
// This function will returned 0 if the property sheet pages is not
// currently displayed.
//
// After this function is successful set the icon, the caller can destroy
// the hIcon using DestroyIcon() if the hIcon is created by CreateIcon().
// If the hIcon (lParam2) passed is using LoadIcon() then it does not need
// to destroy the icon.
//
// -------------------------------------------------------------------------
//
// Function = CPSFUNC_SET_DATABLOCK
//
// This function let the caller register a new data block so it can be
// later query by other pages in the property sheet, this function should
// call durning PSN_KILLACTIVE message
//
// Parameters:
//
// lParam1 - pointer CPSUIDATABLOCK structure which speicifed the buffer
// and size for queried datablock identify by lParam2 to be set.
//
// lParam2 - DWORD Identifier of data block to be set
//
//
// Return Value:
//
// The return value is greater than zero if function sucessful which
// indicate total bytes of data block registered. If return value is less
// or equal to zero then function failed and data block is not registered.
//
// If lParam1 is NULL, (lParam1)->cbData or (lParam1)->pbbData is NULL
// it return a -1 to indicate an error parameter passed.
//
// -------------------------------------------------------------------------
//
// Function = CPSFUNC_QUERY_DATABLOCK
//
// This function let the caller query a registered data block so it can
// used this data block to communicate between property sheet pages.
// This function should call durning PSN_SETACTIVE message
//
// Parameters:
//
// lParam1 - pointer CPSUIDATABLOCK structure which speicifed the buffer
// and size for queried datablock identify by lParam2
//
// lParam2 - DWORD Identifier of data block to be queried
//
//
// Return Value:
//
// The return value is greater than zero if function sucessful which
// indicate total bytes of data block copied into the pointer pointed by
// the lParam1. If return value is less or equal to zero then function
// failed and data block is not copied to diciate the spcified datablock
// Identifier (lParam2) is not found.
//
// If CPSUIDATABLOCK pointer (lParam1) is NULL, (lParam1)->cbData or
// (lParam1)->pbData is NULL then return value is the total bytes required
// to copy the specified datablock identifier, if return value is less or
// equal to zero then it indicate the spcified datablock identifier is
// not found.
//
// -------------------------------------------------------------------------
//
// Function = CPSFUNC_SET_DMPUB_HIDEBITS
//
// This function let the caller hide a set of predefined OPTITEMS in the
// pages that was created using PSUIPAGEINSERT_PCOMPROPSHEETUI or
// CPSFUNC_ADD_PCOMPROPSHEETUI with pDlgPage equal to
// CPSUI_PDLGPAGE_DOCPROP or CPSUI_PDLGPAGE_ADVDOCPROP.
//
// This function MUST called BEFORE the DOCPROP or ADVDOCPROP property
// sheet pages are added using PSUIPAGEINSERT_PCOMPROPSHEETUI or
// CPSFUNC_ADD_PCOMPROPSHEETUI.
//
// Parameters:
//
// lParam1 - prdefined bit array masks to specified which DOCPROP item to
// be hidden. Each DMPUB item bit can be generate using macro
// MAKE_DMPUB_HIDEBIT() and all items can be OR together.
//
// lParam2 - Not used, MUST be 0
//
//
// Return Value:
//
// The return value is equal to lParam1 if this function is called before
// DOCPROP or ADVDOCPROP pages are added. Return value is zero if these
// pages already added which means failure.
//
// -------------------------------------------------------------------------
//
// Function = CPSFUNC_IGNORE_CPSUI_PSN_APPLY
//
// This function let caller control how CPSUI process PSN_APPLY messages
// for pages added through CPSFUNC_ADD_PCOMPROPSHEETUI or
// CPSFUNC_INSERT_PSUIPAGE with type of PSUIPAGEINSERT_PROPSHEETPAGE.
//
// If this function never called, the Default CPSUI behavior is to process
// PSN_APPLY messages.
//
// Parameters:
//
// lParam1 - Handle to the page returned from pages added by using
// CPSFUNC_ADD_PCOMPROPSHEETUI or CPSFUNC_INSERT_PSUIPAGE with
// type of PSUIPAGEINSERT_PROPSHEETPAGE.
//
// lParam2 - A non-zero value indicate to IGNORE the PSN_APPLY messages
// for pages handle of lParam1.
//
// A zero value to have CPSUI nomally process (not ignored) the
// PSN_APPLY messages for pages handle of lParam1.
//
// WARNING: if a PSN_APPLY messages are ignored, the caller must
// simulate a PSN_APPLY using CPSFUNC_DO_APPLY_CPSUI
// function or all changes WILL NOT applied, this is
// true even user hit 'OK' button.
//
// Return Value:
//
// the return value is zero if function failed, or non-zero to indicate
// the function is successful.
//
// -------------------------------------------------------------------------
//
// Function = CPSFUNC_DO_APPLY_CPSUI
//
// This function let caller simulate an apply (PSN_APPLY) to the pages
// which added through CPSFUNC_ADD_PCOMPROPSHEETUI or
// CPSFUNC_INSERT_PSUIPAGE with type of PSUIPAGEINSERT_PROPSHEETPAGE.
//
// Parameters:
//
// lParam1 - Handle to the page returned from pages added by using
// CPSFUNC_ADD_PCOMPROPSHEETUI or CPSFUNC_INSERT_PSUIPAGE with
// type of PSUIPAGEINSERT_PROPSHEETPAGE.
//
// lParam2 - 32-bit flag to indicate how to do apply, currently only
//
// APPLYCPSUI_NO_NEWDEF
//
// The APPLYCPSUI_NO_NEWDEF bit specified that after the
// apply is done the undo buffer for all OPTITEMs still
// remain unchanged, this make next undo still possible.
//
// If APPLYCPSUI_NO_NEWDEF bit is clear then undo buffers
// are re-initialized after apply is done, the current
// changes for all OPTITEMs become the new undo default.
//
//
// APPLYCPSUI_OK_CANCEL_BUTTON
//
// If bit is set then it specified the apply is simulate
// a user hit 'Ok' or 'Cancel' button, if this bit is
// clear then it simulate a user hit 'Close' or 'Apply'
// button. If caller getting a PSN_APPLY message, it can
// simulated using passed PSHNOTIFY (passed as lParam in
// WM_NOTIFY message) structure to determine how to set
// this bit as follow.
//
// if PSHNOTIFY.lParam == 0, then clear this bit
// otherwise set this bit.
//
//
// Return Value:
//
// the return value is less or equal to zero if it encounter an error and
// apply failed (the active page will be switch to these pages).
//
// If return value is greater than zero then changes were applied and
// function sucessful.
//
// -------------------------------------------------------------------------
//
// Function = CPSFUNC_SET_FUSION_CONTEXT
//
// This function is used to set a fusion activation context for
// the specified page.
//
// Parameters:
//
// lParam1 - handle to fusion context. compstui duplicates the handle
// prior attaching it to its internal structures, so the caller
// is not bound to keep the handle around. we release the
// passed in context handle when the compstui handle is deleted.
//
// lParam2 - not used
//
// Return Value:
//
// the return value is less or equal to zero if it encounter an error and/or
// something failed (look up the last error for details).
//
// If return value is greater than zero then the call was sucessful.
//
// -------------------------------------------------------------------------
//
#define PROPSHEETUI_REASON_INIT 0
#define PROPSHEETUI_REASON_GET_INFO_HEADER 1
#define PROPSHEETUI_REASON_DESTROY 2
#define PROPSHEETUI_REASON_SET_RESULT 3
#define PROPSHEETUI_REASON_GET_ICON 4
#define MAX_PROPSHEETUI_REASON_INDEX 4
#define PROPSHEETUI_INFO_VERSION 0x0100
#define PSUIINFO_UNICODE 0x0001
typedef struct _PROPSHEETUI_INFO {
WORD cbSize;
WORD Version;
WORD Flags;
WORD Reason;
HANDLE hComPropSheet;
PFNCOMPROPSHEET pfnComPropSheet;
LPARAM lParamInit;
ULONG_PTR UserData;
ULONG_PTR Result;
} PROPSHEETUI_INFO, *PPROPSHEETUI_INFO;
//
// For the PROPSHEETUI_REASON_GET_ICON call which lParam is a pointer to
// PROPSHEETUI_GETICON_INFO
//
typedef struct _PROPSHEETUI_GETICON_INFO {
WORD cbSize;
WORD Flags;
WORD cxIcon;
WORD cyIcon;
HICON hIcon;
} PROPSHEETUI_GETICON_INFO, *PPROPSHEETUI_GETICON_INFO;
typedef LONG (FAR *PFNPROPSHEETUI)(PPROPSHEETUI_INFO pPSUIInfo,
LPARAM lParam);
//
// PFNPROPSHEETUI
//
// This function is user defined function which will be called by the common
// UI when a caller wish to include the executable property sheets.
//
// pPSUIInfo - Pointer to PROPSHEETUI_INFO below for description of
// PROPSHEETUI_INFO.
//
// If this pointer is NULL then this function is not called from
// common UI, and lParam should be used to determined the
// action and outcome of this funciton.
//
// lParam - A LPARAM intented for this funciton depends on the reason.
// If pPSUIInfo is NULL then this function is not called from
// common UI, the lParam is the parameter which agreed with
// the caller.
//
// if pPSUIInfo is not NULL then this function assume the call
// is from the common UI. lParam has following meanion depends
// on the reason field.
//
// PROPSHEETUI_REASON_INIT
//
// The lParam is either passed from CPSFUNC_ADD_PFNPROPSHEETUI
// callback function's second parameter (lParam2) or it is
// from CommonPropertySheetUI()'s lParam (seccond parameter)
// without any modification.
//
// The lParam MUST NOT be a variable or a pointer to memory
// block which resides on the caller function's stack, since
// after this function exit, the lParam will become invalid
// and can cause fatal system error.
//
// The lParam parameter is copied to the lParamInit field in
// PROPSHEETUI_INFO data structure. The lParamInit field
// will be passed to all subsequent pfnPropSheetUI() calls
// without any modification.
//
//
// PROPSHEETUI_REASON_GET_INFO_HEADER:
//
// lParam is a pointer to the PROPSHEETUI_INFO_HEADER data
// structure. this function must correctly fill this structure
// fields before it returned.
//
//
// PROPSHEETUI_REASON_DESTROY
//
// lParam is zero to indicate the destroy is cause either by a
// caller calling CPSFUNC_DELETE_HCOMPROPSHEET or failed
// in caller's CPSFUNC_ADD_xxxx.
//
// lParam is non zero to indicate the destroy is cause by
// exiting from the property sheet user interface.
//
//
// PROPSHEETUI_REASON_SET_RESULT
//
// lParam is a pointer to SETRESULT_INFO data structure.
// Fields in SETRESULT_INFO data structure is set to following
//
// hSetResult: Handle to the common UI property sheet
// pages which added by the CPSFUNC_ADD_xxx
// callback function indices.
//
// Result: The result from the hSetResult to be set.
// When return greater than zero then Result
// in this field is set to its parent.
//
//
// PROPSHEETUI_REASON_GET_ICON
//
// lParam is a pointer to PROPSHEETUI_GETICON_INFO data
// structure. Fields in PROPSHEETUI_GETICON_INFO data
// structure are set to following
//
// cxIcon = cx Icon size in pixel
// cyIcon = cy Icon size in pixel
// hIcon = Initial to NULL, and this function must put
// the created icon handle in this field before
// returned.
//
//
// PROPSHEETUI_INFO
//
// This structure is used when common UI calling the caller passed function
// entry point PFNPROPSHEETUI, the pfnPropSheetUI() return a LONG to
// indicate result of this function.
//
// When the pfnPropSheetUI() returned, it must also put the required result
// in the Result field, each PROPSHEETUI_REASON_xxx has different required
// result as describe below.
//
//
//
// cbSize - sizeof this structure (PROPSHEETUI_INFO)
//
// Version - the PROPSHEETUI_INFO data structure version. Current
// version is set to PROPSHEETUI_INFO_VERSION
//
// Flags - One or more following is may be defined
//
// PSUIINFO_UNICODE
//
// The caller's executable was original compiled was
// intented using unicode.
//
//
// Reason - Following reasons are defined.
//
// PROPSHEETUI_REASON_INIT
//
// When first time the pfnPropSheetUI() called, this
// reason is used to have the function initialize
// itself and use the pfnComPropSheet() function
// pointer provided to add new pages to the
// hComPropSheet handle passed. The UserData in this
// data structure is initially set equal to zero (0).
//
// * Return > 0 to indicate sucesful and <= 0 to
// indicate error.
//
// *NOTE*
//
// The lParam MUST NOT be a variable or a pointer to
// memory block which resides on the caller function's
// stack, since after this function exit, the lParam
// will become invalid and can cause fatal system
// error.
//
// If this function reason returned failed ( <= 0),
// this function (pfnPropSheetUI) will received a
// PROPSHEETUI_REASON_DESTROY function reason right
// after this function reason returned.
//
//
// PROPSHEETUI_REASON_GET_INFO_HEADER
//
// It is called after the PROPSHEETUI_REASON_INIT is
// successful returned. This reason is used to asked
// the function fill in the PROPSHEETUI_INFO_HEADER
// for pop-up the property sheet dialog boxes.
//
// lParam in this reason is a pointer to the
// PROPSHEETUI_INFO_HEADER data structure, following
// fields are requrested to be filled in.
//
// Flags - PSUIHDRF_xxx flags
// pTitle - The property sheet title
// hWndParent - handle to the parent of property
// sheet pages.
// hInst - Instance data handle for this
// function.
// hIcon
// IconID - Icon used on the title bar.
//
// * Return > 0 to indicate sucesful and pop-up the
// property sheet dialog boxes or returned <= 0 to
// indicate error (not property sheet UI appeared)
//
//
// PROPSHEETUI_REASON_DESTROY
//
// When the property sheet ready to dismissed or the
// caller is delete the common UI pages added by the
// pfnPropSheetUI(), the common UI will call this
// entry point to have it de-initialized itself and
// free up all the memory used for this function
// instance. The UserData field passed is the
// 'UserData' field which returned from previous
// PROPSHEETUI_REASON_xxxx.
//
// When this function called, all hComPropSheet's
// children are desotroyed and children's common UI
// handles are not longer valid.
//
// * Return > 0 to indicate sucesful and <= 0 to
// indicate error.
//
//
// PROPSHEETUI_REASON_SET_RESULT
//
// The reason is used when an added handle from
// CPSFUNC_ADD_xxxx whant to return the result to
// this pfnPropSheetUI() caller.
//
// The lParam in second parameter is a pointer to a
// SETRESULT_INFO data structure.
//
// hSetResult: specified the common UI property
// sheet page handle which added by
// this function using
// CPSFUNC_ADD_xxx indicies.
//
// Result: Specified the Result to be set to
// this pfnPropSheetUI() form the
// hSetResult property sheet page
// handle. If return value is greater
// than zero then the value in this
// Result field will be set to its
// parent if one exist, at this case
// this function can alter the Result
// field value for its parent.
//
// * Returned greater than zero to continue send to
// its parent, else it stop sending the Result filed
// value to its parent.
//
//
// PROPSHEETUI_REASON_GET_ICON
//
// The reason is used to retrived the Icon which
// represent this pfnPropSheetUI().
//
// lParam is a pointer to PROPSHEETUI_GETICON_INFO '
// data structure. Fields in PROPSHEETUI_GETICON_INFO
// data structure are set to following
//
// cxIcon = cx Icon size in pixel
// cyIcon = cy Icon size in pixel
// hIcon = Initial to NULL, and this function
// must put the created icon handle in
// this field before return.
//
//
// * Return > 0 to indicate sucesful (hIcon is the
// requested icon handle). Return = 0 to indicate
// no icon available, or return < 0 to indicate an
// error.
//
// *NOTE*
//
// * For all PROPSHEETUI_REASON_xxx, the function can set new
// user defined DWORD data in the PROPSHEETUI_INFO data
// structure's UserData field.
//
// * For all PROPSHEETUI_REASON_xxx, the function can set new
// pfnPropSheetUI() DWORD result in PROPSHEETUI_INFO data
// structure's Result field.
//
//
// hComPropSheet - Handle to the COMPROPSHEETPAGE which this function should
// used as hComPropSheet parameter when calling
// pfnComPropSheet() to add or delete common UI property
// sheet pages. The hComPropSheet is the instance handle to
// pfnPropSheetUI() function.
//
// pfnComPropSheet - Pointer to the common UI callback function which for the
// pfnPropSheetUI() to add, delete, set user data, for a
// completed set of callback, see CPSFUNC_xxx descriptions
// above.
//
// lParamInit - The lParam originally passed duning the the first call
// reason PROPSHEETUI_REASON_INIT. The lParamInit will be
// passed to each PROPSHEETUI_REASON_xxx calls.
//
// UserData - the UserData field is an IN and OUT parameter for each
// of the Reason,
//
// PROPSHEETUI_REASON_INIT
//
// IN: Initial set to zero (0).
//
// OUT: Specified new callee's own user data which
// will be passed back to other reason calls.
//
//
// PROPSHEETUI_REASON_DESTROY
// PROPSHEETUI_REASON_SET_RESULT
// PROPSHEETUI_REASON_GET_INFO_HEADER
//
// IN: The UserData specified at time when returned
// from the previous PROPSHEETUI_REASON_xxx
//
// OUT: Specified new callee's own user data which
// will be passed back to other reason calls.
//
//
// Result - The Result field is an IN and OUT parameter for each of
// the reason.
//
// PROPSHEETUI_REASON_INIT
//
// IN: Set to zero (0).
//
// OUT: Set to default result of this PropSheetUI()
// function.
//
//
// PROPSHEETUI_REASON_DESTROY
// PROPSHEETUI_REASON_GET_INFO_HEADER
// PROPSHEETUI_REASON_SET_RESULT
//
// IN: The current 'Result' returned from previous
// PROPSHEETUI_REASON_xxx function.
//
// OUT: Set the new result of this PropSheetUI()
// function.
//
//
#define PSUIHDRF_OBSOLETE 0x0001
#define PSUIHDRF_NOAPPLYNOW 0x0002
#define PSUIHDRF_PROPTITLE 0x0004
#define PSUIHDRF_USEHICON 0x0008
#define PSUIHDRF_DEFTITLE 0x0010
#define PSUIHDRF_EXACT_PTITLE 0x0020
typedef struct _PROPSHEETUI_INFO_HEADER {
WORD cbSize;
WORD Flags;
LPTSTR pTitle;
HWND hWndParent;
HINSTANCE hInst;
union {
HICON hIcon;
ULONG_PTR IconID;
} DUMMYUNIONNAME;
} PROPSHEETUI_INFO_HEADER, *PPROPSHEETUI_INFO_HEADER;
//
// PROPSHEETUI_INFO_HEADER
//
// This data structure is used when common UI ready to pop-up the property
// sheet page dialog boxes and it asked caller to provide more information.
//
// Common property sheet UI passed this data structure as lParam when it call
// provided pfnPropSheetUI() with PROPSHEETUI_REASON_GET_INFO_HEADER reason.
//
//
// cbSize - size of this structure
//
// Flags - PSUIHDRF_xxxx flags
//
// PSUIHDRF_OBSOLETE
//
// Not used, must not set this bit
//
//
// PSUIHDRF_NOAPPLYNOW
//
// Remove 'Apply Now' button.
//
//
// PSUIHDRF_PROPTITLE
//
// Automatically include 'Properties' in the title bar
//
//
// PSUIHDRF_USEHICON
//
// If this bit is specified then hIcon union field is
// a valid handle to the icon otherwise the IconID is
// the either caller's resource ID or common UI standard
// icon ID.
//
// PSUIHDRF_DEFTITLE
//
// Automatically include 'Default' in the title bar, the
// 'Default' always added right after pTitle and before
// 'Properties' if PSUIHDRF_PROPTITLE flag is set.
//
// PSUIHDRF_EXACT_PTITLE
//
// This flag indicate the pTitle set in this structure
// will be use without any modification by the compstui
// ie. compstui will not modified pTitle in any way and
// it will ignored PSUIHDRF_PROPTITLE, PSUIHDRF_DEFTITLE
//
//
// pTitle - Pointer to the NULL terminated caption name for the
// property sheets.
//
// ** See LPTSTR typedef description above
//
// hWndParent - The handle of the window which will be parent of the common
// UI property sheets, if NULL then current active window for
// the calling thread is used.
//
// hInst - the caller's handle to its instance. Commom UI use this
// handle to load caller's icon and other resources.
//
// hIcon
// IconID - Specified the icon which put on the title bar, it either a
// handle to the icon or a icon resource ID depends on the
// PSUIHDRF_USEHICON flag.
//
//
// LONG
// CommonPropertySheetUI(
// HWND hWndOwner,
// PFNPROPSHEETUI pfnPropSheetUI,
// LPARAM lParam,
// LPDWORD pResult
// );
//
//
// The CommonPropSheetUI is the main entry point for the common property sheet
// user interface. The original caller that wish to using common UI to pop-up
// property sheet will call this function and passed its own PFNPROPSHEETUI
// function address and a long parameter.
//
// If pfnPropSheetUI function return a LONG number greater than zero (0) then
// common UI will pop-up the property sheet page dialog boxes, when Property
// sheet pages is finished. (either hit Ok or Cancel) it will return the
// result of CPSUI_xxxx back to the caller.
//
// If pfnPropSheetUI function return a LONG number equal or less than zero (0)
// then it will return the CPSUI_CANCEL back to caller without pop-up the
// property sheet page dialog boxes.
//
//
// Parameters:
//
// hWndOwner - Window handle for the owner of this proerty sheet
// pages dialog boxes.
//
// pfnPropSheetUI - a PFNPROPSHEETUI function pointer which is used by
// the caller to add its property sheet pages.
//
// lParam - a long parameter will be passed to the pfnPropSheetUI
// funciton. The common UI called the pfnPropSheetUI as
//
// PROPSHEETUI_INFO PSUIInfo;
//
// pfnPropSheetUI(&PSUIInfo, lParam);
//
// The caller must use pfnComPropSheet() to add/delete
// pages. When it is done adding pages, it retuned
// greater than zero to indicate successful, and return
// less or equal to zero to indicate failure.
//
// pResult - a pointer to DWORD which received the final result
// of pfnPropSheetUI() funciton, this result is a copy
// from Result field of PROPSHEETUI_INFO data structure
// which passed to the pfnPropSheetUI() as the first
// parameter. The pResult only will be set if the
// returned value from CommonPropertySheetUI() is not
// ERR_CPSUI_xxx.
//
// if pResult is NULL then common UI will not return
// pfnPropSheetUI()'s result back.
//
//
// Return Value:
//
// LONG - < 0 - property page does not displayed and
// ERR_CPSUI_xxx is the error code
// CPSUI_OK - property page displayed.
// CPSUI_RESTARTWINDOWS - property page displayed and need to
// restart window to take effect
// CPSUI_REBOOTSYSTEM - property page dispalyed and need
// to reboot system to take effect
//
//
LONG
APIENTRY
CommonPropertySheetUIA(
HWND hWndOwner,
PFNPROPSHEETUI pfnPropSheetUI,
LPARAM lParam,
LPDWORD pResult
);
LONG
APIENTRY
CommonPropertySheetUIW(
HWND hWndOwner,
PFNPROPSHEETUI pfnPropSheetUI,
LPARAM lParam,
LPDWORD pResult
);
#ifdef UNICODE
#define CommonPropertySheetUI CommonPropertySheetUIW
#else
#define CommonPropertySheetUI CommonPropertySheetUIA
#endif
//
// GetCPSUIUserData() and SetCPSUIUserData() is used for the pages added
// by the CPSFUNC_ADD_PCOMPROPSHEETUI. The caller add this function and has
// sub class dialog procedure should not set DWLP_USERDATA but calling these
// function instead, otherwise the system can failed.
//
ULONG_PTR
APIENTRY
GetCPSUIUserData(
HWND hDlg
);
BOOL
APIENTRY
SetCPSUIUserData(
HWND hDlg,
ULONG_PTR CPSUIUserData
);
#define CPSUI_CANCEL 0
#define CPSUI_OK 1
#define CPSUI_RESTARTWINDOWS 2
#define CPSUI_REBOOTSYSTEM 3
#define ERR_CPSUI_GETLASTERROR -1
#define ERR_CPSUI_ALLOCMEM_FAILED -2
#define ERR_CPSUI_INVALID_PDATA -3
#define ERR_CPSUI_INVALID_LPARAM -4
#define ERR_CPSUI_NULL_HINST -5
#define ERR_CPSUI_NULL_CALLERNAME -6
#define ERR_CPSUI_NULL_OPTITEMNAME -7
#define ERR_CPSUI_NO_PROPSHEETPAGE -8
#define ERR_CPSUI_TOO_MANY_PROPSHEETPAGES -9
#define ERR_CPSUI_CREATEPROPPAGE_FAILED -10
#define ERR_CPSUI_MORE_THAN_ONE_TVPAGE -11
#define ERR_CPSUI_MORE_THAN_ONE_STDPAGE -12
#define ERR_CPSUI_INVALID_PDLGPAGE -13
#define ERR_CPSUI_INVALID_DLGPAGE_CBSIZE -14
#define ERR_CPSUI_TOO_MANY_DLGPAGES -15
#define ERR_CPSUI_INVALID_DLGPAGEIDX -16
#define ERR_CPSUI_SUBITEM_DIFF_DLGPAGEIDX -17
#define ERR_CPSUI_NULL_POPTITEM -18
#define ERR_CPSUI_INVALID_OPTITEM_CBSIZE -19
#define ERR_CPSUI_INVALID_OPTTYPE_CBSIZE -20
#define ERR_CPSUI_INVALID_OPTTYPE_COUNT -21
#define ERR_CPSUI_NULL_POPTPARAM -22
#define ERR_CPSUI_INVALID_OPTPARAM_CBSIZE -23
#define ERR_CPSUI_INVALID_EDITBOX_PSEL -24
#define ERR_CPSUI_INVALID_EDITBOX_BUF_SIZE -25
#define ERR_CPSUI_INVALID_ECB_CBSIZE -26
#define ERR_CPSUI_NULL_ECB_PTITLE -27
#define ERR_CPSUI_NULL_ECB_PCHECKEDNAME -28
#define ERR_CPSUI_INVALID_DMPUBID -29
#define ERR_CPSUI_INVALID_DMPUB_TVOT -30
#define ERR_CPSUI_CREATE_TRACKBAR_FAILED -31
#define ERR_CPSUI_CREATE_UDARROW_FAILED -32
#define ERR_CPSUI_CREATE_IMAGELIST_FAILED -33
#define ERR_CPSUI_INVALID_TVOT_TYPE -34
#define ERR_CPSUI_INVALID_LBCB_TYPE -35
#define ERR_CPSUI_SUBITEM_DIFF_OPTIF_HIDE -36
#define ERR_CPSUI_INVALID_PUSHBUTTON_TYPE -38
#define ERR_CPSUI_INVALID_EXTPUSH_CBSIZE -39
#define ERR_CPSUI_NULL_EXTPUSH_DLGPROC -40
#define ERR_CPSUI_NO_EXTPUSH_DLGTEMPLATEID -41
#define ERR_CPSUI_NULL_EXTPUSH_CALLBACK -42
#define ERR_CPSUI_DMCOPIES_USE_EXTPUSH -43
#define ERR_CPSUI_ZERO_OPTITEM -44
#define ERR_CPSUI_FUNCTION_NOT_IMPLEMENTED -9999
#define ERR_CPSUI_INTERNAL_ERROR -10000
#endif // (!defined(RC_INVOKED))
//
//****************************************************************************
//* *
//* Common Property Sheet UI resource ID for the ICONs and STRINGs *
//* *
//* The Resource ID from 64000 to 65535 are reserved for common UI and must *
//* not used as caller resource ID else the string, icon loading will not be *
//* correct. *
//* *
//****************************************************************************
//
//
// Common UI standard 32x32, 16x16 color and monochrome Icon IDs
//
#define IDI_CPSUI_ICONID_FIRST 64000
#define IDI_CPSUI_EMPTY 64000
#define IDI_CPSUI_SEL_NONE 64001
#define IDI_CPSUI_WARNING 64002
#define IDI_CPSUI_NO 64003
#define IDI_CPSUI_YES 64004
#define IDI_CPSUI_FALSE 64005
#define IDI_CPSUI_TRUE 64006
#define IDI_CPSUI_OFF 64007
#define IDI_CPSUI_ON 64008
#define IDI_CPSUI_PAPER_OUTPUT 64009
#define IDI_CPSUI_ENVELOPE 64010
#define IDI_CPSUI_MEM 64011
#define IDI_CPSUI_FONTCARTHDR 64012
#define IDI_CPSUI_FONTCART 64013
#define IDI_CPSUI_STAPLER_ON 64014
#define IDI_CPSUI_STAPLER_OFF 64015
#define IDI_CPSUI_HT_HOST 64016
#define IDI_CPSUI_HT_DEVICE 64017
#define IDI_CPSUI_TT_PRINTASGRAPHIC 64018
#define IDI_CPSUI_TT_DOWNLOADSOFT 64019
#define IDI_CPSUI_TT_DOWNLOADVECT 64020
#define IDI_CPSUI_TT_SUBDEV 64021
#define IDI_CPSUI_PORTRAIT 64022
#define IDI_CPSUI_LANDSCAPE 64023
#define IDI_CPSUI_ROT_LAND 64024
#define IDI_CPSUI_AUTOSEL 64025
#define IDI_CPSUI_PAPER_TRAY 64026
#define IDI_CPSUI_PAPER_TRAY2 64027
#define IDI_CPSUI_PAPER_TRAY3 64028
#define IDI_CPSUI_TRANSPARENT 64029
#define IDI_CPSUI_COLLATE 64030
#define IDI_CPSUI_DUPLEX_NONE 64031
#define IDI_CPSUI_DUPLEX_HORZ 64032
#define IDI_CPSUI_DUPLEX_VERT 64033
#define IDI_CPSUI_RES_DRAFT 64034
#define IDI_CPSUI_RES_LOW 64035
#define IDI_CPSUI_RES_MEDIUM 64036
#define IDI_CPSUI_RES_HIGH 64037
#define IDI_CPSUI_RES_PRESENTATION 64038
#define IDI_CPSUI_MONO 64039
#define IDI_CPSUI_COLOR 64040
#define IDI_CPSUI_DITHER_NONE 64041
#define IDI_CPSUI_DITHER_COARSE 64042
#define IDI_CPSUI_DITHER_FINE 64043
#define IDI_CPSUI_DITHER_LINEART 64044
#define IDI_CPSUI_SCALING 64045
#define IDI_CPSUI_COPY 64046
#define IDI_CPSUI_HTCLRADJ 64047
#define IDI_CPSUI_HALFTONE_SETUP 64048
#define IDI_CPSUI_WATERMARK 64049
#define IDI_CPSUI_ERROR 64050
#define IDI_CPSUI_ICM_OPTION 64051
#define IDI_CPSUI_ICM_METHOD 64052
#define IDI_CPSUI_ICM_INTENT 64053
#define IDI_CPSUI_STD_FORM 64054
#define IDI_CPSUI_OUTBIN 64055
#define IDI_CPSUI_OUTPUT 64056
#define IDI_CPSUI_GRAPHIC 64057
#define IDI_CPSUI_ADVANCE 64058
#define IDI_CPSUI_DOCUMENT 64059
#define IDI_CPSUI_DEVICE 64060
#define IDI_CPSUI_DEVICE2 64061
#define IDI_CPSUI_PRINTER 64062
#define IDI_CPSUI_PRINTER2 64063
#define IDI_CPSUI_PRINTER3 64064
#define IDI_CPSUI_PRINTER4 64065
#define IDI_CPSUI_OPTION 64066
#define IDI_CPSUI_OPTION2 64067
#define IDI_CPSUI_STOP 64068
#define IDI_CPSUI_NOTINSTALLED 64069
#define IDI_CPSUI_WARNING_OVERLAY 64070
#define IDI_CPSUI_STOP_WARNING_OVERLAY 64071
#define IDI_CPSUI_GENERIC_OPTION 64072
#define IDI_CPSUI_GENERIC_ITEM 64073
#define IDI_CPSUI_RUN_DIALOG 64074
#define IDI_CPSUI_QUESTION 64075
#define IDI_CPSUI_FORMTRAYASSIGN 64076
#define IDI_CPSUI_PRINTER_FOLDER 64077
#define IDI_CPSUI_INSTALLABLE_OPTION 64078
#define IDI_CPSUI_PRINTER_FEATURE 64079
#define IDI_CPSUI_DEVICE_FEATURE 64080
#define IDI_CPSUI_FONTSUB 64081
#define IDI_CPSUI_POSTSCRIPT 64082
#define IDI_CPSUI_TELEPHONE 64083
#define IDI_CPSUI_DUPLEX_NONE_L 64084
#define IDI_CPSUI_DUPLEX_HORZ_L 64085
#define IDI_CPSUI_DUPLEX_VERT_L 64086
#define IDI_CPSUI_LF_PEN_PLOTTER 64087
#define IDI_CPSUI_SF_PEN_PLOTTER 64088
#define IDI_CPSUI_LF_RASTER_PLOTTER 64089
#define IDI_CPSUI_SF_RASTER_PLOTTER 64090
#define IDI_CPSUI_ROLL_PAPER 64091
#define IDI_CPSUI_PEN_CARROUSEL 64092
#define IDI_CPSUI_PLOTTER_PEN 64093
#define IDI_CPSUI_MANUAL_FEED 64094
#define IDI_CPSUI_FAX 64095
#define IDI_CPSUI_PAGE_PROTECT 64096
#define IDI_CPSUI_ENVELOPE_FEED 64097
#define IDI_CPSUI_FONTCART_SLOT 64098
#define IDI_CPSUI_LAYOUT_BMP_PORTRAIT 64099
#define IDI_CPSUI_LAYOUT_BMP_ARROWL 64100
#define IDI_CPSUI_LAYOUT_BMP_ARROWS 64101
#define IDI_CPSUI_LAYOUT_BMP_BOOKLETL 64102
#define IDI_CPSUI_LAYOUT_BMP_BOOKLETP 64103
#define IDI_CPSUI_ICONID_LAST 64103
//
// Common UI standard String IDs
//
#define IDS_CPSUI_STRID_FIRST 64700
#define IDS_CPSUI_SETUP 64700
#define IDS_CPSUI_MORE 64701
#define IDS_CPSUI_CHANGE 64702
#define IDS_CPSUI_OPTION 64703
#define IDS_CPSUI_OF 64704
#define IDS_CPSUI_RANGE_FROM 64705
#define IDS_CPSUI_TO 64706
#define IDS_CPSUI_COLON_SEP 64707
#define IDS_CPSUI_LEFT_ANGLE 64708
#define IDS_CPSUI_RIGHT_ANGLE 64709
#define IDS_CPSUI_SLASH_SEP 64710
#define IDS_CPSUI_PERCENT 64711
#define IDS_CPSUI_LBCB_NOSEL 64712
#define IDS_CPSUI_PROPERTIES 64713
#define IDS_CPSUI_DEFAULTDOCUMENT 64714
#define IDS_CPSUI_DOCUMENT 64715
#define IDS_CPSUI_ADVANCEDOCUMENT 64716
#define IDS_CPSUI_PRINTER 64717
#define IDS_CPSUI_AUTOSELECT 64718
#define IDS_CPSUI_PAPER_OUTPUT 64719
#define IDS_CPSUI_GRAPHIC 64720
#define IDS_CPSUI_OPTIONS 64721
#define IDS_CPSUI_ADVANCED 64722
#define IDS_CPSUI_STDDOCPROPTAB 64723
#define IDS_CPSUI_STDDOCPROPTVTAB 64724
#define IDS_CPSUI_DEVICEOPTIONS 64725
#define IDS_CPSUI_FALSE 64726
#define IDS_CPSUI_TRUE 64727
#define IDS_CPSUI_NO 64728
#define IDS_CPSUI_YES 64729
#define IDS_CPSUI_OFF 64730
#define IDS_CPSUI_ON 64731
#define IDS_CPSUI_DEFAULT 64732
#define IDS_CPSUI_ERROR 64733
#define IDS_CPSUI_NONE 64734
#define IDS_CPSUI_NOT 64735
#define IDS_CPSUI_EXIST 64736
#define IDS_CPSUI_NOTINSTALLED 64737
#define IDS_CPSUI_ORIENTATION 64738
#define IDS_CPSUI_SCALING 64739
#define IDS_CPSUI_NUM_OF_COPIES 64740
#define IDS_CPSUI_SOURCE 64741
#define IDS_CPSUI_PRINTQUALITY 64742
#define IDS_CPSUI_RESOLUTION 64743
#define IDS_CPSUI_COLOR_APPERANCE 64744
#define IDS_CPSUI_DUPLEX 64745
#define IDS_CPSUI_TTOPTION 64746
#define IDS_CPSUI_FORMNAME 64747
#define IDS_CPSUI_ICM 64748
#define IDS_CPSUI_ICMMETHOD 64749
#define IDS_CPSUI_ICMINTENT 64750
#define IDS_CPSUI_MEDIA 64751
#define IDS_CPSUI_DITHERING 64752
#define IDS_CPSUI_PORTRAIT 64753
#define IDS_CPSUI_LANDSCAPE 64754
#define IDS_CPSUI_ROT_LAND 64755
#define IDS_CPSUI_COLLATE 64756
#define IDS_CPSUI_COLLATED 64757
#define IDS_CPSUI_PRINTFLDSETTING 64758
#define IDS_CPSUI_DRAFT 64759
#define IDS_CPSUI_LOW 64760
#define IDS_CPSUI_MEDIUM 64761
#define IDS_CPSUI_HIGH 64762
#define IDS_CPSUI_PRESENTATION 64763
#define IDS_CPSUI_COLOR 64764
#define IDS_CPSUI_GRAYSCALE 64765
#define IDS_CPSUI_MONOCHROME 64766
#define IDS_CPSUI_SIMPLEX 64767
#define IDS_CPSUI_HORIZONTAL 64768
#define IDS_CPSUI_VERTICAL 64769
#define IDS_CPSUI_LONG_SIDE 64770
#define IDS_CPSUI_SHORT_SIDE 64771
#define IDS_CPSUI_TT_PRINTASGRAPHIC 64772
#define IDS_CPSUI_TT_DOWNLOADSOFT 64773
#define IDS_CPSUI_TT_DOWNLOADVECT 64774
#define IDS_CPSUI_TT_SUBDEV 64775
#define IDS_CPSUI_ICM_BLACKWHITE 64776
#define IDS_CPSUI_ICM_NO 64777
#define IDS_CPSUI_ICM_YES 64778
#define IDS_CPSUI_ICM_SATURATION 64779
#define IDS_CPSUI_ICM_CONTRAST 64780
#define IDS_CPSUI_ICM_COLORMETRIC 64781
#define IDS_CPSUI_STANDARD 64782
#define IDS_CPSUI_GLOSSY 64783
#define IDS_CPSUI_TRANSPARENCY 64784
#define IDS_CPSUI_REGULAR 64785
#define IDS_CPSUI_BOND 64786
#define IDS_CPSUI_COARSE 64787
#define IDS_CPSUI_FINE 64788
#define IDS_CPSUI_LINEART 64789
#define IDS_CPSUI_ERRDIFFUSE 64790
#define IDS_CPSUI_HALFTONE 64791
#define IDS_CPSUI_HTCLRADJ 64792
#define IDS_CPSUI_USE_HOST_HT 64793
#define IDS_CPSUI_USE_DEVICE_HT 64794
#define IDS_CPSUI_USE_PRINTER_HT 64795
#define IDS_CPSUI_OUTBINASSIGN 64796
#define IDS_CPSUI_WATERMARK 64797
#define IDS_CPSUI_FORMTRAYASSIGN 64798
#define IDS_CPSUI_UPPER_TRAY 64799
#define IDS_CPSUI_ONLYONE 64800
#define IDS_CPSUI_LOWER_TRAY 64801
#define IDS_CPSUI_MIDDLE_TRAY 64802
#define IDS_CPSUI_MANUAL_TRAY 64803
#define IDS_CPSUI_ENVELOPE_TRAY 64804
#define IDS_CPSUI_ENVMANUAL_TRAY 64805
#define IDS_CPSUI_TRACTOR_TRAY 64806
#define IDS_CPSUI_SMALLFMT_TRAY 64807
#define IDS_CPSUI_LARGEFMT_TRAY 64808
#define IDS_CPSUI_LARGECAP_TRAY 64809
#define IDS_CPSUI_CASSETTE_TRAY 64810
#define IDS_CPSUI_DEFAULT_TRAY 64811
#define IDS_CPSUI_FORMSOURCE 64812
#define IDS_CPSUI_MANUALFEED 64813
#define IDS_CPSUI_PRINTERMEM_KB 64814
#define IDS_CPSUI_PRINTERMEM_MB 64815
#define IDS_CPSUI_PAGEPROTECT 64816
#define IDS_CPSUI_HALFTONE_SETUP 64817
#define IDS_CPSUI_INSTFONTCART 64818
#define IDS_CPSUI_SLOT1 64819
#define IDS_CPSUI_SLOT2 64820
#define IDS_CPSUI_SLOT3 64821
#define IDS_CPSUI_SLOT4 64822
#define IDS_CPSUI_LEFT_SLOT 64823
#define IDS_CPSUI_RIGHT_SLOT 64824
#define IDS_CPSUI_STAPLER 64825
#define IDS_CPSUI_STAPLER_ON 64826
#define IDS_CPSUI_STAPLER_OFF 64827
#define IDS_CPSUI_STACKER 64828
#define IDS_CPSUI_MAILBOX 64829
#define IDS_CPSUI_COPY 64830
#define IDS_CPSUI_COPIES 64831
#define IDS_CPSUI_TOTAL 64832
#define IDS_CPSUI_MAKE 64833
#define IDS_CPSUI_PRINT 64834
#define IDS_CPSUI_FAX 64835
#define IDS_CPSUI_PLOT 64836
#define IDS_CPSUI_SLOW 64837
#define IDS_CPSUI_FAST 64838
#define IDS_CPSUI_ROTATED 64839
#define IDS_CPSUI_RESET 64840
#define IDS_CPSUI_ALL 64841
#define IDS_CPSUI_DEVICE 64842
#define IDS_CPSUI_SETTINGS 64843
#define IDS_CPSUI_REVERT 64844
#define IDS_CPSUI_CHANGES 64845
#define IDS_CPSUI_CHANGED 64846
#define IDS_CPSUI_WARNING 64847
#define IDS_CPSUI_ABOUT 64848
#define IDS_CPSUI_VERSION 64849
#define IDS_CPSUI_NO_NAME 64850
#define IDS_CPSUI_SETTING 64851
#define IDS_CPSUI_DEVICE_SETTINGS 64852
#define IDS_CPSUI_STDDOCPROPTAB1 64853
#define IDS_CPSUI_STDDOCPROPTAB2 64854
#define IDS_CPSUI_PAGEORDER 64855
#define IDS_CPSUI_FRONTTOBACK 64856
#define IDS_CPSUI_BACKTOFRONT 64857
#define IDS_CPSUI_QUALITY_SETTINGS 64858
#define IDS_CPSUI_QUALITY_DRAFT 64859
#define IDS_CPSUI_QUALITY_BETTER 64860
#define IDS_CPSUI_QUALITY_BEST 64861
#define IDS_CPSUI_QUALITY_CUSTOM 64862
#define IDS_CPSUI_OUTPUTBIN 64863
#define IDS_CPSUI_NUP 64864
#define IDS_CPSUI_NUP_NORMAL 64865
#define IDS_CPSUI_NUP_TWOUP 64866
#define IDS_CPSUI_NUP_FOURUP 64867
#define IDS_CPSUI_NUP_SIXUP 64868
#define IDS_CPSUI_NUP_NINEUP 64869
#define IDS_CPSUI_NUP_SIXTEENUP 64870
#define IDS_CPSUI_SIDE1 64871
#define IDS_CPSUI_SIDE2 64872
#define IDS_CPSUI_BOOKLET 64873
#define IDS_CPSUI_STRID_LAST 64873
#ifdef __cplusplus
}
#endif
#endif // _COMPSTUI