windows-nt/Source/XPSP1/NT/admin/netui/shellui/h/specdlg.hxx

354 lines
8.8 KiB
C++
Raw Normal View History

2020-09-26 03:20:57 -05:00
/**********************************************************************/
/** Microsoft Windows/NT **/
/** Copyright(c) Microsoft Corp., 1991 **/
/**********************************************************************/
/*
SpecDlg.hxx
This dialog contains the definition for the Permissions Special
dialog
FILE HISTORY:
Johnl 29-Aug-1991 Created
*/
#ifndef _SPECDLG_HXX_
#define _SPECDLG_HXX_
#include "permdlg.hxx"
#define CID_SPECIAL_BASE (CID_PERM_LAST)
/* The checkbox control IDs must be in consecutive order.
*/
#define COUNT_OF_CHECKBOXES 18
#define CHECK_PERM_1 (CID_SPECIAL_BASE+1)
#define CHECK_PERM_2 (CID_SPECIAL_BASE+2)
#define CHECK_PERM_3 (CID_SPECIAL_BASE+3)
#define CHECK_PERM_4 (CID_SPECIAL_BASE+4)
#define CHECK_PERM_5 (CID_SPECIAL_BASE+5)
#define CHECK_PERM_6 (CID_SPECIAL_BASE+6)
#define CHECK_PERM_7 (CID_SPECIAL_BASE+7)
#define CHECK_PERM_8 (CID_SPECIAL_BASE+8)
#define CHECK_PERM_9 (CID_SPECIAL_BASE+9)
#define CHECK_PERM_10 (CID_SPECIAL_BASE+10)
#define CHECK_PERM_11 (CID_SPECIAL_BASE+11)
#define CHECK_PERM_12 (CID_SPECIAL_BASE+12)
#define CHECK_PERM_13 (CID_SPECIAL_BASE+13)
#define CHECK_PERM_14 (CID_SPECIAL_BASE+14)
#define CHECK_PERM_15 (CID_SPECIAL_BASE+15)
#define CHECK_PERM_16 (CID_SPECIAL_BASE+16)
#define CHECK_PERM_17 (CID_SPECIAL_BASE+17)
#define CHECK_PERM_18 (CID_SPECIAL_BASE+18)
#define SLT_SUBJECT_NAME (CID_SPECIAL_BASE+20)
#define FRAME_PERMISSION_BOX (CID_SPECIAL_BASE+21)
/* BUTTON_PERMIT (aka "Other") and BUTTON_ALL (generic all) are in all
* of the NT special permission dialogs. The BUTTON_NOT_SPECIFIED button
* is only in the "New Item" special dialog.
*/
#define BUTTON_PERMIT (CID_SPECIAL_BASE+25)
#define BUTTON_ALL (CID_SPECIAL_BASE+26)
#define BUTTON_NOT_SPECIFIED (CID_SPECIAL_BASE+27)
#ifndef RC_INVOKED
/*************************************************************************
NAME: ACCESS_PERM_CHECKBOX
SYNOPSIS: This class is a checkbox that has a bitfield associated
with it.
INTERFACE:
ACCESS_PERM_CHECKBOX
Takes normal parameters plus the name of this checkbox and
the bitfield to associate this checkbox with.
QueryBitMask
Returns the bitmask this CHECKBOX is associated with.
See CHECKBOX for all other methods.
PARENT: CHECKBOX
USES: BITFIELD
CAVEATS:
NOTES:
HISTORY:
Johnl 30-Aug-1991 Created
**************************************************************************/
class ACCESS_PERM_CHECKBOX : public CHECKBOX
{
private:
BITFIELD _bitsMask ;
public:
ACCESS_PERM_CHECKBOX( OWNER_WINDOW * powin, CID cid,
const NLS_STR & nlsPermName,
BITFIELD & bitsMask ) ;
BITFIELD * QueryBitMask( void )
{ return &_bitsMask ; }
} ;
/*************************************************************************
NAME: SPECIAL_DIALOG
SYNOPSIS: This class is the "Special" dialog that the user will use
to check the individual access writes.
INTERFACE:
SetCheckBoxNames
Sets the name of each Checkbox based on the passed MASK_MAP
(looks for each PERMTYPE_SPECIAL item in the MASK_MAP and
consecutively sets the permission name). The name should have
the embedded '&' accelerator.
Resize
Given the current state of the dialog, resizes the checkbox and
repositions the contained controls so it is aesthetically
pleasing.
ApplyPermissionsToCheckBoxes
Checks the appropriate checkboxes based on the passed bitfield
QueryUserSelectedBits
Builds a bitfield from the checkboxes the user selected
QueryCheckBox
Returns a pointer to the checkbox at the passed index (checks
the index).
QueryCount
Returns the number of successfully constructed checkboxes
QueryAccessBits
Returns the Access permission map that this dialog is editting.
PARENT: PERM_BASE_DLG
USES: SLT, MASK_MAP, BITFIELD, ACCESS_PERMISSION, ACCESS_PERM_CHECKBOX
CAVEATS:
NOTES: This first ACCESS_PERM_CHECKBOX's CID in this dialog should start at
CHECK_PERM_1 and be numbered consecutively up to
(CHECK_PERM_1 + COUNT_OF_CHECKBOXES).
HISTORY:
Johnl 29-Aug-1991 Created
**************************************************************************/
class SPECIAL_DIALOG : public PERM_BASE_DLG
{
private:
//
// User/Group name we are editting
//
SLT _sltSubjectName ;
//
// The Bitfield/string pair map we are using.
//
MASK_MAP * _pAccessMaskMap ;
//
// Number of constructed checkboxes
//
UINT _cUsedCheckBoxes ;
//
// Pointer to the permission we are going to edit
//
BITFIELD * _pbitsAccessPerm ;
//
// Array of checkboxes (all checkboxes in this dialog are initially
// hidden and disabled)
//
ACCESS_PERM_CHECKBOX *_pAccessPermCheckBox ;
//
// The frame surrounding the checkboxes (we may need to resize).
//
CONTROL_WINDOW _cwinPermFrame ;
ULONG _ulHelpContext ;
protected:
virtual BOOL OnOK( void ) ;
virtual ULONG QueryHelpContext( void ) ;
APIERR SetCheckBoxNames( MASK_MAP * pAccessMaskMap ) ;
APIERR ApplyPermissionsToCheckBoxes( BITFIELD * bitmask ) ;
void Resize( void ) ;
ULONG QueryHelp( void ) const
{ return _ulHelpContext ; }
public:
SPECIAL_DIALOG( const TCHAR * pszDialogName,
HWND hwndParent,
const TCHAR * pszResourceType,
const TCHAR * pszResourceName,
const TCHAR * pszDialogTitle,
BITFIELD * pbitsAccessPerm,
MASK_MAP * pAccessMaskMap,
const TCHAR * pszSubjectTitle,
ULONG ulHelpContext ) ;
virtual ~SPECIAL_DIALOG() ;
void QueryUserSelectedBits( BITFIELD * pbitsUserSelected ) ;
ACCESS_PERM_CHECKBOX * QueryCheckBox( UINT index )
{ UIASSERT( index < QueryCount() ) ; return &_pAccessPermCheckBox[index] ; }
/* Returns the number of checkboxes that are in use
*/
UINT QueryCount( void )
{ return _cUsedCheckBoxes ; }
BITFIELD * QueryAccessBits( void )
{ return _pbitsAccessPerm ; }
/* Returns TRUE if a whole column of checkboxes is filled (thus we don't
* need to resize vertically).
*/
BOOL IsFilledVertically( void )
{ return (QueryCount() >= COUNT_OF_CHECKBOXES / 2 ) ; }
} ;
/*************************************************************************
NAME: NT_SPECIAL_DIALOG
SYNOPSIS: This class includes an "All" radio button choice that
corresponds to Generic All. It is used for all NT objects
except for the "New Item" permissions.
INTERFACE:
PARENT: SPECIAL_DIALOG
CAVEATS:
NOTES:
HISTORY:
Johnl 30-Mar-1992 Created
**************************************************************************/
class NT_SPECIAL_DIALOG : public SPECIAL_DIALOG
{
private:
MAGIC_GROUP _mgrpSelectionOptions ;
protected:
virtual BOOL OnOK( void ) ;
virtual ULONG QueryHelpContext( void ) ;
public:
NT_SPECIAL_DIALOG( const TCHAR * pszDialogName,
HWND hwndParent,
const TCHAR * pszResourceType,
const TCHAR * pszResourceName,
const TCHAR * pszDialogTitle,
BITFIELD * pbitsAccessPerm,
MASK_MAP * pAccessMaskMap,
const TCHAR * pszSubjectTitle,
ULONG ulHelpContext,
INT cMagicGroupButtons = 2,
CID cidDefaultMagicGroupButton = BUTTON_PERMIT) ;
~NT_SPECIAL_DIALOG() ;
BOOL IsAllSpecified( void )
{ return _mgrpSelectionOptions.QuerySelection() == BUTTON_ALL ; }
MAGIC_GROUP * QueryMagicGroup( void ) const
{ return &_mgrpSelectionOptions ; }
} ;
/*************************************************************************
NAME: NEW_OBJ_SPECIAL_DIALOG
SYNOPSIS: This dialog is essentially the SPECIAL_DIALOG except a
magic group has been added that allows the user to
specify the special permissions are not specified for
new files
INTERFACE: Same as SPECIAL_DIALOG except:
IsSpecified
Returns TRUE if the user has chosen the "Permit"
radio button, FALSE otherwise.
PARENT: SPECIAL_DIALOG
USES: MAGIC_GROUP
CAVEATS:
NOTES:
HISTORY:
Johnl 18-Nov-1991 Created
**************************************************************************/
class NEW_OBJ_SPECIAL_DIALOG : public NT_SPECIAL_DIALOG
{
protected:
virtual BOOL OnOK( void ) ;
virtual ULONG QueryHelpContext( void ) ;
public:
NEW_OBJ_SPECIAL_DIALOG( const TCHAR * pszDialogName,
HWND hwndParent,
const TCHAR * pszResourceType,
const TCHAR * pszResourceName,
const TCHAR * pszDialogTitle,
BITFIELD * pbitsAccessPerm,
MASK_MAP * pAccessMaskMap,
const TCHAR * pszSubjectTitle,
ULONG ulHelpContext,
BOOL fPermSpecified ) ;
~NEW_OBJ_SPECIAL_DIALOG() ;
BOOL IsNotSpecified( void )
{ return QueryMagicGroup()->QuerySelection() == BUTTON_NOT_SPECIFIED ; }
} ;
#endif // RC_INVOKED
#endif // _SPECDLG_HXX_