|
|
/**********************************************************************//** Microsoft Windows/NT **//** Copyright(c) Microsoft Corp., 1991 **//**********************************************************************/
/*
bltdlg.hxx Dialog support for BLT
This file depends on bltcons.h, bltwin.hxx, uibuffer.hxx, and billions of other files.
FILE HISTORY RustanL 20-Nov-1990 Created RustanL 04-Mar-1991 Changed DIALOG_WINDOW::Process format beng 14-May-1991 Hacked for separate compilation terryk 28-Jul-1991 Added FilterMessage to DIALOG_WINDOW beng 30-Sep-1991 Added DLGLOAD declaration KeithMo 24-Mar-1992 Moved IDRESOURCE to BLTIDRES.HXX. KeithMo 07-Aug-1992 Redesigned help file management. KeithMo 13-Oct-1992 Moved PWND2HWND to BLTPWND.HXX.*/
#ifndef _BLT_HXX_
#error "Don't include this file directly; instead, include it through blt.hxx"
#endif // _BLT_HXX_
#ifndef _BLTDLG_HXX_
#define _BLTDLG_HXX_
#include "bltwin.hxx"
#include "bltevent.hxx"
#include "bltpump.hxx"
#include "bltidres.hxx"
#include "bltpwnd.hxx"
#include "uibuffer.hxx"
DLL_CLASS DIALOG_WINDOW; // forward decl's
DLL_CLASS DLGLOAD;DLL_CLASS ASSOCHWNDPDLG;
// Define an OWNER_WINDOW attribute which keeps the dialog hidden
#define OWIN_ATTR_HIDDEN ((DWORD)0x1)
enum DLG_PROCESS_STATE{ // Note. The following values are assumed to be in this order, i.e.,
// their values should reflect the chronological move through the
// states. DLG_PROCESS_STATE_ACTIVE is defined as 0 so as to increase
// the efficiency of the message loop in DIALOG_WINDOW::Process.
//
DLG_PROCESS_STATE_INITIALIZING = -1, DLG_PROCESS_STATE_ACTIVE = 0, DLG_PROCESS_STATE_DISMISSED = 1};
#if defined(UNICODE)
#define DLG_CHAR_SET_DEFAULT FALSE // unicode build
#else // !UNICODE
#define DLG_CHAR_SET_DEFAULT TRUE // ansi build
#endif // UNICODE
/*************************************************************************
NAME: DLGLOAD
SYNOPSIS: Loads a dialog from an application resource or template
INTERFACE: DLGLOAD() - ctor ~DLGLOAD() - ctor QueryHwnd() - returns window handle
PARENT: BASE
USES: IDRESOURCE
CAVEATS: For the private use of DIALOG_WINDOW, really
HISTORY: beng 30-Sep-1991 Created beng 01-Nov-1991 Uses IDRESOURCE; remove BUFFER ctor KeithMo 07-Feb-1993 Allow override of default charset.
**************************************************************************/
DLL_CLASS DLGLOAD: public BASE{private: HWND _hwnd;
public: DLGLOAD( const IDRESOURCE & idrsrcDlg, HWND hwndOwner, const PROC_INSTANCE & procinstDlg, BOOL fAnsiDialog ); DLGLOAD( const BYTE * pbTemplate, UINT cbTemplate, HWND hwndOwner, const PROC_INSTANCE & procinstDlg, BOOL fAnsiDialog ); ~DLGLOAD();
HWND QueryHwnd() const { return _hwnd; }};
/*************************************************************************
NAME: ASSOCHWNDPDLG
SYNOPSIS: Associate a dialog-pointer with a window
INTERFACE: HwndToPdlg()
PARENT: ASSOCHWNDTHIS
HISTORY: beng 30-Sep-1991 Created
**************************************************************************/
DLL_CLASS ASSOCHWNDPDLG: private ASSOCHWNDTHIS{NEWBASE(ASSOCHWNDTHIS)public: ASSOCHWNDPDLG( HWND hwnd, const DIALOG_WINDOW * pdlg ) : ASSOCHWNDTHIS( hwnd, pdlg ) { }
static DIALOG_WINDOW * HwndToPdlg( HWND hwnd ) { return (DIALOG_WINDOW *)HwndToThis(hwnd); }};
/********************************************************************
NAME: DIALOG_WINDOW
SYNOPSIS: Dialog window class
INTERFACE: DIALOG_WINDOW() - constructor ~DIALOG_WINDOW() - destructor QueryRobustHwnd() - virtual replacement of the owner_window class Process() - do a callback to the Dialog winproc FilterMessage() - filter out the proper message type.
Dismiss() - dismiss the dialog DismissMsg() - dismisses the dialog after presenting a message MayRun() - virtual callout; return FALSE to abort dialog after painted, but before run
PARENT: OWNER_WINDOW, HAS_MESSAGE_PUMP
USES: DLG_PROCESS_STATE, PROC_INSTANCE, ASSOCHWNDPDLG, DLGLOAD, IDRESOURCE
HISTORY: RustanL 20-Nov-1990 Created beng 14-May-1991 Added DlgProc member terryk 28-Jul-1991 Added FilterMessage function beng 30-Sep-1991 Win32 conversion beng 07-Oct-1991 Uses HAS_MESSAGE_PUMP beng 31-Oct-1991 Added dialog validation beng 01-Nov-1991 Uses IDRESOURCE; remove BUFFER ctor beng 30-Mar-1992 Added MayRun beng 18-May-1992 Added OnScrollBar{,Thumb} members KeithMo 07-Feb-1993 Allow override of default charset. JonN 03-Aug-1995 OnCtlColor
********************************************************************/
DLL_CLASS DIALOG_WINDOW : public OWNER_WINDOW, public HAS_MESSAGE_PUMP{private: // _procinstDlg is the proc instance of BltDlgProc.
// CODEWORK - should really be a static object.
//
PROC_INSTANCE _procinstDlg;
// This object loads the dialog from the named resource.
//
DLGLOAD _dlg;
// This object lets the window find its pwnd when it is entered
// from Win (which doesn't set up This pointers, etc.)
//
ASSOCHWNDPDLG _assocThis;
// _prstate is DLG_PROCESS_STATE_INITIALIZING until Process
// is called. Then, it turns DLG_PROCESS_STATE_ACTIVE. When Dismiss
// is called, the state is set to DLG_PROCESS_STATE_DISMISSED, where
// the state will stay until destruction.
//
DLG_PROCESS_STATE _prstate;
// _usRetVal indicates the return value of the dialog. Its value
// is defined only if _prstate == DLG_PROCESS_STATE_DISMISSED.
//
UINT _nRetVal;
// Respond to a request for help. This works in two phases:
// answer initial control request, and actually launch the help.
//
BOOL OnHelp(); VOID LaunchHelp();
// Validate each control in the dialog.
//
APIERR Validate();
// Layer over ASSOCHWNDPDLG: adds caching of most recent
//
static DIALOG_WINDOW * HwndToPwnd( HWND hwnd );
protected: DIALOG_WINDOW( const BYTE * pbTemplate, UINT cbTemplate, HWND hwndOwner, BOOL fAnsiDialog = DLG_CHAR_SET_DEFAULT );
// Client-defined callbacks.
virtual BOOL OnCommand( const CONTROL_EVENT & event ); virtual BOOL OnOK(); virtual BOOL OnCancel();
virtual BOOL OnTimer( const TIMER_EVENT & event );
virtual BOOL OnScrollBar( const SCROLL_EVENT & ); virtual BOOL OnScrollBarThumb( const SCROLL_THUMB_EVENT & );
virtual BOOL OnDlgActivation( const ACTIVATION_EVENT & ); virtual BOOL OnDlgDeactivation( const ACTIVATION_EVENT & );
// JonN 8/3/95 This can be used to set the background color of
// controls to other than the default, for example to
// change the default background color for a static text control
// to the same background as for an edit control. The virtual
// redefinition may return an HBRUSH or may change *pmsgid; if it
// returns NULL, be sure to call down to the original, otherwise
// CONTROL_WINDOW::OnCtlColor will not be called.
virtual HBRUSH OnCtlColor( HDC hdc, HWND hwnd, UINT * pmsgid );
// JonN 8/8/95 This can be used to respond to changes in the
// system colors.
virtual VOID OnSysColorChange();
virtual VOID OnControlError( CID cid, APIERR err ); virtual VOID OnValidationError( CID cid, APIERR err ); virtual const TCHAR * QueryHelpFile( ULONG nHelpContext ); virtual ULONG QueryHelpContext();
VOID Dismiss( UINT nRetVal = 0 ); VOID DismissMsg( MSGID msgid, UINT nRetVal = 0 );
virtual BOOL IsValid();
// Implementations supplied for HAS_MESSAGE_PUMP controls
virtual BOOL FilterMessage( MSG * ); virtual BOOL IsPumpFinished();
// Another client-defined callback
virtual BOOL MayRun();
public: DIALOG_WINDOW( const IDRESOURCE & idrsrcDialog, const PWND2HWND & wndOwner, BOOL fAnsiDialog = DLG_CHAR_SET_DEFAULT ); ~DIALOG_WINDOW();
// Replacement (virtual) from the OWNER_WINDOW class
//
virtual HWND QueryRobustHwnd() const;
APIERR Process( UINT * pnRetVal = NULL ); // UINT variant
APIERR Process( BOOL * pfRetVal ); // BOOL variant
static BOOL DlgProc( HWND hdlg, UINT nMsg, WPARAM wParam, LPARAM lParam );};
#endif // _BLTDLG_HXX_ - end of file
|
